Skip to content

Commit bbeaba5

Browse files
authored
ADD: configuration.html: Section 'Miscellaneous': Some details about thumbnails. (#47)
ADD: configxml.html: DefaultTextEncoding. Small cosmetic fix. ADD: variables.html: Note about file list encoding (%L and %F).
1 parent 4da9060 commit bbeaba5

File tree

6 files changed

+58
-8
lines changed

6 files changed

+58
-8
lines changed

doc/en/configuration.html

+2-1
Original file line numberDiff line numberDiff line change
@@ -790,7 +790,8 @@ <h2><a name="settings">2. Configuration</a></h2>
790790
<p><span class="italic">Show warning messages ("OK" button only)</span>&nbsp;&ndash; shows warning messages if enabled. (For example, if Double Commander cannot set some property or attribute of a file due to file system restrictions in the target directory.)</p>
791791
<p><span class="italic">Always go to the root of a drive when changing drives</span>&nbsp;&ndash; If unchecked, Double Commander will go to the last open directory on this drive (in this case, you can go to the root directory of the drive by pressing its button twice).</p>
792792
<p><span class="italic">Show current directory in the main window title bar</span>&nbsp;&ndash; If enabled, Double Commander will display the name of the current folder and the active panel path in the main window title bar.</p>
793-
<p><span class="italic">Thumbnails</span>&nbsp;&ndash; Here you can enable to save cache of thumbnails of images and set their size. The <span class="italic">Remove thumbnails for no longer existing files</span> button will help to remove obsolete thumbnails.</p>
793+
<p><span class="italic">Thumbnails</span>&nbsp;&ndash; Here you can enable to save cache of thumbnails of images and set their size. The thumbnail cache directory can be found in the <a href="#ConfigDC">Configuration</a> section. Double Commander uses PNG or JPEG (only for *.bmp, *.jpg and *.jpeg) formats. The thumbnail name is the MD5 sum of the full name of the source file. The full name of the source file, its size and modification date will be added to the file.</p>
794+
<p>The <span class="italic">Remove thumbnails for no longer existing files</span> button will help to remove obsolete thumbnails.</p>
794795
<p><span class="italic">File comments (descript.ion)</span>&nbsp;&ndash; Here you can set the default encoding for existing file comments (OEM, ANSI or UTF-8) and the encoding for new files (UTF-8 BOM, UTF-16 LE or UTF-16 BE).</p>
795796
<p>The next group of parameters is used for import from Total Commander and export <a href="directoryhotlist.html#exportimporttc">Directory Hotlist</a> and <a href="toolbar.html">toolbar</a>: <span class="italic">TC executable</span>, <span class="italic">Configuration file</span> and <span class="italic">Toolbar output path</span> </p>
796797
<br>

doc/en/configxml.html

+26-3
Original file line numberDiff line numberDiff line change
@@ -423,6 +423,29 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
423423
<td class="hintcell">Windows only: use uppercase letters in the <a href="help.html#iface_drive_pane">drives button bar</a> and in the <a href="help.html#iface_drive_btn">drives list</a>. <code>False</code> by default.</td>
424424
</tr>
425425

426+
<tr>
427+
<td class="cmdcell"><div class="firstcolumnaleft">&lt;DefaultTextEncoding&gt;<br><small>from &lt;Miscellaneous&gt;</small></div></td>
428+
<td class="hintcell">
429+
By default (NONE), the built-in file viewer and the built-in editor use automatic encoding detection, but you can specify one of the supported single-byte encodings as the default value.
430+
The list of supported encodings can be viewed, for example, in the internal editor in the "Encoding" menu. Special values are also available:<br>
431+
<table class="innercmddesc">
432+
<tr class="rowinnerdesc">
433+
<th class="innerdescheader">Value</th>
434+
<th class="innerdescheader">Description</th>
435+
</tr>
436+
<tr>
437+
<td class="innerdescvaluecell">ANSI</td>
438+
<td class="innerdescdesccell">Default system ANSI encoding (depends on user locale).</td>
439+
</tr>
440+
<tr>
441+
<td class="innerdescvaluecell">OEM</td>
442+
<td class="innerdescdesccell">Default system OEM (DOS) encoding (depends on user locale).</td>
443+
</tr>
444+
</table>
445+
This parameter does not affect the automatic detection of multibyte encodings (UTF-8, UTF-16 and others).
446+
</td>
447+
</tr>
448+
426449
<tr>
427450
<td class="cmdcell"><div class="firstcolumnaleft">Attribute <i>Save</i><br><small>from &lt;SyncDirs&gt;&lt;Asymmetric&gt;</small></div></td>
428451
<td class="hintcell">
@@ -442,15 +465,15 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
442465
</tr>
443466
<tr>
444467
<td class="innerdescdesccell">&lt;Left&gt;</td>
445-
<td class="innerdescdesccell">files selected for copying or deleting on the left</td>
468+
<td class="innerdescdesccell">Files selected for copying or deleting on the left.</td>
446469
</tr>
447470
<tr>
448471
<td class="innerdescdesccell">&lt;Right&gt;</td>
449-
<td class="innerdescdesccell">files selected for copying or deleting on the right</td>
472+
<td class="innerdescdesccell">Files selected for copying or deleting on the right.</td>
450473
</tr>
451474
<tr>
452475
<td class="innerdescdesccell">&lt;Unknown&gt;</td>
453-
<td class="innerdescdesccell">files with the same names, but not identical</td>
476+
<td class="innerdescdesccell">Files with the same names, but not identical.</td>
454477
</tr>
455478
</table>
456479
</td>

doc/en/variables.html

+1
Original file line numberDiff line numberDiff line change
@@ -327,6 +327,7 @@ <h2><a name="listoffiles">9. List of files</a></h2>
327327
<td class="hintcell">File name of file list of selected items with just their relative path name</td>
328328
</tr>
329329
</table>
330+
<p>Double Commander will use the ANSI system encoding in Windows or the default system encoding in Unix-like systems (in GNU/Linux distributions it is usually UTF-8).</p>
330331
<p class="navback"><a href="#topofpage">(back to top)</a></p>
331332
</div>
332333

doc/ru/configuration.html

+2-1
Original file line numberDiff line numberDiff line change
@@ -790,7 +790,8 @@ <h2><a name="settings">2. Настройки</a></h2>
790790
<p><span class="italic">Показывать некритические сообщения об ошибках (с одной кнопкой "ОК")</span>&nbsp;&ndash; если программа совершит действие или операцию с ошибкой и при этом не произойдёт никаких фатальных потерь, то будет показано окно с текстом ошибки и одной кнопкой "ОК". Иначе ошибка выводится не будет. (Например, если Double Commander не может установить какое-либо свойство или атрибут файла из-за ограничений файловой системы в целевом каталоге.)</p>
791791
<p><span class="italic">При смене диска всегда переходить в корневой каталог</span>&nbsp;&ndash; Если не отмечено, Double Commander будет переходить в последний открытый каталог этого диска (в этом случае вы можете перейти в корневой каталог диска, дважды нажав его кнопку).</p>
792792
<p><span class="italic">Показывать текущий каталог в заголовке окна</span>&nbsp;&ndash; Если включено, Double Commander будет отображать в заголовке окна имя текущей папки и путь активной панели.</p>
793-
<p><span class="italic">Эскизы</span>&nbsp;&ndash; Здесь вы можете включить сохранение кэша миниатюр изображений и установить их размер. Кнопка <span class="italic">Удалить эскизы для отсутствующих файлов</span> поможет удалить устаревшие эскизы.</p>
793+
<p><span class="italic">Эскизы</span>&nbsp;&ndash; Здесь вы можете включить сохранение кэша миниатюр изображений и установить их размер. Каталог для хранения кэша эскизов можно узнать в разделе <a href="#ConfigDC">Конфигурация</a>. Double Commander использует форматы PNG или JPEG (только для *.bmp, *.jpg и *.jpeg). В качестве имени эскиза используется MD5-сумма полного имени исходного файла. В файл будут добавлены полное имя исходного файла, его размер и дата модификации.</p>
794+
<p>Кнопка <span class="italic">Удалить эскизы для отсутствующих файлов</span> поможет удалить устаревшие эскизы.</p>
794795
<p><span class="italic">Комментарии к файлам (descript.ion)</span>&nbsp;&ndash; Здесь вы можете установить кодировку по умолчанию для файлов с комментариями (OEM, ANSI или UTF-8) и кодировку для новых файлов (UTF-8 BOM, UTF-16 LE или UTF-16 BE).</p>
795796
<p>Следующая группа параметров используется для импортирования из Total Commander и экспортирования <a href="directoryhotlist.html#exportimporttc">избранных каталогов</a> и <a href="toolbar.html">панели инструментов</a>: <span class="italic">Исполняемый файл TC</span>, <span class="italic">Файл настроек</span> и <span class="italic">Каталог с панелями инструментов</span>.</p>
796797
<br>

doc/ru/configxml.html

+26-3
Original file line numberDiff line numberDiff line change
@@ -421,6 +421,29 @@ <h2><a name="manualed">3. Параметры, изменяемые вручну
421421
<td class="hintcell">Только Windows: использовать заглавные буквы в <a href="help.html#iface_drive_pane">панели кнопок дисков</a> и в <a href="help.html#iface_drive_btn">списке дисков</a>. По умолчанию <code>False</code>.</td>
422422
</tr>
423423

424+
<tr>
425+
<td class="cmdcell"><div class="firstcolumnaleft">&lt;DefaultTextEncoding&gt;<br><small>в &lt;Miscellaneous&gt;</small></div></td>
426+
<td class="hintcell">
427+
По умолчанию (NONE) встроенная программа просмотра файлов и встроенный редактор используют автоматическое определение кодировки, но вы можете указать одну из поддерживаемых однобайтовых кодировок как значение по умолчанию.
428+
Список поддерживаемых кодировок можно посмотреть, например, во встроенном редакторе в меню "Кодировка". Также доступны специальные значения:<br>
429+
<table class="innercmddesc">
430+
<tr class="rowinnerdesc">
431+
<th class="innerdescheader">Значение</th>
432+
<th class="innerdescheader">Описание</th>
433+
</tr>
434+
<tr>
435+
<td class="innerdescvaluecell">ANSI</td>
436+
<td class="innerdescdesccell">Системная кодировка ANSI по умолчанию (зависит от локали).</td>
437+
</tr>
438+
<tr>
439+
<td class="innerdescvaluecell">OEM</td>
440+
<td class="innerdescdesccell">Системная кодировка OEM (DOS) по умолчанию (зависит от локали).</td>
441+
</tr>
442+
</table>
443+
Этот параметр не затрагивает автоматическое определение многобайтовых кодировок (UTF-8, UTF-16 и другие).
444+
</td>
445+
</tr>
446+
424447
<tr>
425448
<td class="cmdcell"><div class="firstcolumnaleft">Атрибут <i>Save</i><br><small>в &lt;SyncDirs&gt;&lt;Asymmetric&gt;</small></div></td>
426449
<td class="hintcell">
@@ -440,15 +463,15 @@ <h2><a name="manualed">3. Параметры, изменяемые вручну
440463
</tr>
441464
<tr>
442465
<td class="innerdescdesccell">&lt;Left&gt;</td>
443-
<td class="innerdescdesccell">файлы, выбранные для копирования или удаления слева</td>
466+
<td class="innerdescdesccell">Файлы, выбранные для копирования или удаления слева.</td>
444467
</tr>
445468
<tr>
446469
<td class="innerdescdesccell">&lt;Right&gt;</td>
447-
<td class="innerdescdesccell">файлы, выбранные для копирования или удаления справа</td>
470+
<td class="innerdescdesccell">Файлы, выбранные для копирования или удаления справа.</td>
448471
</tr>
449472
<tr>
450473
<td class="innerdescdesccell">&lt;Unknown&gt;</td>
451-
<td class="innerdescdesccell">файлы с одинаковыми именами, но не идентичные</td>
474+
<td class="innerdescdesccell">Файлы с одинаковыми именами, но не идентичные.</td>
452475
</tr>
453476
</table>
454477
</td>

doc/ru/variables.html

+1
Original file line numberDiff line numberDiff line change
@@ -327,6 +327,7 @@ <h2><a name="listoffiles">9. Список файлов</a></h2>
327327
<td class="hintcell">Файл со списком имён выделенных файлов с относительным путём</td>
328328
</tr>
329329
</table>
330+
<p>Double Commander будет использовать системную кодировку ANSI в Windows или системную кодировку по умолчанию в Unix-подобных системах (в дистрибутивах GNU/Linux это обычно UTF-8).</p>
330331
<p class="navback"><a href="#topofpage">(наверх)</a></p>
331332
</div>
332333

0 commit comments

Comments
 (0)