Warning, /utilities/krusader/doc/handbook/konfigurator.docbook is written in an unsupported language. File is not indexed.

0001 <!--
0002     SPDX-FileCopyrightText: 2000-2003 Shie Erlich <erlich@users.sourceforge.net>
0003     SPDX-FileCopyrightText: 2000-2003 Rafi Yanai <yanai@users.sourceforge.net>
0004     SPDX-FileCopyrightText: 2004-2010 Frank Schoolmeesters <codeknight@users.sourceforge.net>
0005     SPDX-FileCopyrightText: 2000-2022 Krusader Krew <https://krusader.org>
0006 -->
0007 <chapter id="konfigurator">
0008   <title>Konfigurator: &krusader;'s Configuration
0009   Center</title>
0010   <indexterm>
0011     <primary>Configure</primary>
0012     <secondary>Krusader</secondary>
0013   </indexterm>
0014   <para>Konfigurator is &krusader;s configuration
0015   center. When running &krusader;, use
0016                 <menuchoice>
0017                  <guimenu>Settings</guimenu>
0018                  <guimenuitem>Configure &krusader;...</guimenuitem>
0019                 </menuchoice>, and it will start Konfigurator.
0020   There you can modify the way &krusader; works
0021   and customize it to your own needs. At any time, pressing the
0022   <guibutton>Apply</guibutton> button applies the changes, pressing
0023   <guibutton>Close</guibutton> closes Konfigurator, and pressing
0024   <guibutton>Defaults</guibutton> re-applies &krusader;'s
0025   <quote>factory</quote> settings. Konfigurator is divided into pages, each
0026   containing items related to that page. For some changes to the
0027   &GUI;, you have to close and restart
0028   &krusader;.</para>
0029 
0030 <note>
0031  <para>Since &krusader;-1.80.0 the <link linkend="key_bindings">Key-Bindings</link> and <link linkend="mainwindow">Main Toolbar</link>-<link linkend="actions_toolbar">Actions Toolbar</link>
0032        have received their own configuration windows and so they are not a part anymore of Konfigurator,
0033        you can configure them now via the <link linkend="settings-menu"><guimenu>Settings</guimenu> menu</link>.</para>
0034 </note>
0035 
0036   <sect1 id="konfig-startup">
0037     <title>Startup</title>
0038     <figure id="screenshot-kgstartup" float="1">
0039       <title>Startup configuration</title>
0040       <mediaobject>
0041         <imageobject>
0042           <imagedata fileref="kgstartup.png"></imagedata>
0043         </imageobject>
0044         <textobject>
0045           <phrase>Startup configuration</phrase>
0046         </textobject>
0047       </mediaobject>
0048     </figure>
0049     <para>The startup page determines the way that
0050     &krusader; looks (and works) when it is launched. It
0051     is divided into two main parts:</para>
0052     <variablelist>
0053       <varlistentry>
0054         <term>
0055           <guilabel>General</guilabel>
0056         </term>
0057         <listitem>
0058           <itemizedlist>
0059             <listitem>
0060               <para>
0061               <guilabel>Startup Profile</guilabel>: Starts the
0062               selected
0063               <link linkend="panel_profiles">Panel profile</link> at
0064               startup.
0065               <guilabel>&lt;Last
0066               session&gt;</guilabel> is a special Panel
0067               Profile, it is saved automatically when closing
0068               &krusader;.</para>
0069             </listitem>
0070             <listitem>
0071               <para>
0072               <guilabel>Show splashscreen</guilabel>: Displays a
0073               splash screen when starting
0074               &krusader;.</para>
0075             </listitem>
0076             <listitem>
0077               <para>
0078               <guilabel>Single Instance Mode</guilabel>: Allows
0079               only one &krusader; instance to run.</para>
0080             </listitem>
0081             <listitem>
0082               <para>
0083               <guilabel>Fallback Icon Theme</guilabel>: Allows
0084               you to configure a fallback icon theme for &krusader;.
0085               Whenever icon is not found in system icon theme,
0086               this theme will be used as a fallback.
0087               If the fallback theme does not contain the icon,
0088               Breeze or Oxygen will be used if any of these are present.</para>
0089             </listitem>
0090           </itemizedlist>
0091         </listitem>
0092       </varlistentry>
0093       <varlistentry>
0094         <term>
0095           <guilabel>User Interface</guilabel>
0096         </term>
0097         <listitem>
0098           <para>Determines which parts of the user interface are
0099           visible after start-up.
0100           <itemizedlist>
0101             <listitem>
0102               <para>
0103               <guilabel>Save last position, size and panel
0104               settings</guilabel>: When launched,
0105               &krusader; resizes itself to the size it
0106               was when last shut-down. &krusader; also
0107               appears in the same location on the screen, having
0108               panels sorted and aligned as they were. If this
0109               option is unchecked, you can use the menu
0110                 <menuchoice>
0111                   <guimenu>Window</guimenu>
0112                   <guimenuitem>Save Position</guimenuitem>
0113                 </menuchoice>
0114               option to manually set
0115               &krusader; size and position at
0116               start-up.</para>
0117             </listitem>
0118             <listitem>
0119               <para>
0120               <guilabel>Update default panel settings</guilabel>: If checked,
0121               the default panel settings will be updated after
0122               start-up.</para>
0123             </listitem>
0124             <listitem>
0125               <para>
0126               <guilabel>Start to system tray</guilabel>: if checked,
0127               &krusader; starts to tray (if minimize to
0128               tray is set), without showing the main window.</para>
0129             </listitem>
0130             <listitem>
0131               <para>
0132               <guilabel>Save component settings on exit</guilabel>: If
0133               checked, restores the user interface components to
0134               their condition when last shut-down.</para>
0135             </listitem>
0136             <listitem>
0137               <para>
0138               <guilabel>Show function keys</guilabel>: If checked,
0139               the <link linkend="fnkeys">FN Keys Bar</link> is visible after
0140               start-up.</para>
0141             </listitem>
0142             <listitem>
0143               <para>
0144               <guilabel>Show statusbar</guilabel>: If checked, the
0145               <link linkend="mainwindow">Statusbar</link> is visible after
0146               start-up. Available only if the <guilabel>Save component settings on exit</guilabel> item is unchecked.</para>
0147             </listitem>
0148             <listitem>
0149               <para>
0150               <guilabel>Show command line</guilabel>: If checked,
0151               the <link linkend="cmdline">Command Line</link> is visible after
0152               start-up. Available only if the <guilabel>Save component settings on exit</guilabel> item is unchecked.</para>
0153             </listitem>
0154             <listitem>
0155               <para>
0156               <guilabel>Show embedded terminal</guilabel>: If
0157               checked, the <link linkend="termemu">Terminal emulator</link> is visible
0158               after start-up. Available only if the <guilabel>Save component settings on exit</guilabel> item is unchecked.</para>
0159             </listitem>
0160           </itemizedlist></para>
0161         </listitem>
0162       </varlistentry>
0163     </variablelist>
0164   </sect1>
0165   <sect1 id="konfig-panel">
0166     <title>Panel</title>
0167     <para>Here you can determine the look and feel of panel -
0168     which means finetuning the application to your needs. The page
0169     is divided into six tabs:
0170     <guilabel>General</guilabel>,
0171     <guilabel>View</guilabel>,
0172     <guilabel>Buttons</guilabel>,
0173     <guilabel>Selection Mode</guilabel>,
0174     <guilabel>Media Menu</guilabel>,
0175     and <guilabel>Layout</guilabel>:</para>
0176 
0177     <sect2 id="konfig-panel-general">
0178       <title>General</title>
0179       <itemizedlist>
0180         <title>
0181           <guilabel>Navigator bar</guilabel>
0182         </title>
0183         <listitem>
0184           <para>
0185           <guilabel>Edit Mode by default</guilabel>: If checked, show editable path in Navigator bar by default.</para>
0186         </listitem>
0187         <listitem>
0188           <para>
0189           <guilabel>Show full path by default</guilabel>: If checked, always show full path in Navigator bar by default.</para>
0190         </listitem>
0191       </itemizedlist>
0192       <itemizedlist>
0193         <title>
0194           <guilabel>Operation</guilabel>
0195         </title>
0196         <listitem>
0197           <para>
0198           <guilabel>Autoselect Folders</guilabel>: When
0199           <link linkend="edit-menu">you select a group of
0200           files</link> (either by using <guilabel>Select Group</guilabel> or by using
0201           <guilabel>Select All</guilabel>), &krusader; checks this option. If
0202           checked, the folders matching the select criteria are
0203           also selected. Otherwise, only files are selected.</para>
0204         </listitem>
0205         <listitem>
0206           <para>
0207           <guilabel>Rename selects extension</guilabel>: When
0208           <link linkend="renaming">you rename a file</link>, the whole text is selected.
0209           If you want <trademark class="copyright">Total Commander</trademark> like
0210           renaming of just the name, without extension, deselect this item.</para>
0211         </listitem>
0212         <listitem>
0213           <para>
0214           <guilabel>Unselect files before copy/move</guilabel>: If checked,
0215           &krusader; remove the selection marks from files or folders before
0216           <link linkend="copying">copying or moving</link> them to
0217           the new location.</para>
0218         </listitem>
0219         <listitem>
0220           <para>
0221           <guilabel>Filter dialog remembers settings</guilabel>: If checked,
0222           the filter dialog will be opened with the last filter settings that where
0223           applied to the panel.</para>
0224         </listitem>
0225       </itemizedlist>
0226       <itemizedlist>
0227         <title>
0228           <guilabel>Tabs</guilabel>
0229         </title>
0230         <listitem>
0231           <para>
0232           <guilabel>Use fullpath tab names</guilabel>: If checked,
0233           display the full path in the <link linkend="folder-tabs">Folder tabs</link>;
0234           otherwise only the last part of the path is
0235           displayed.</para>
0236         </listitem>
0237         <listitem>
0238           <para>
0239           <guilabel>Expanding tabs</guilabel>: If checked,
0240           &krusader; expands the <link linkend="folder-tabs">folder tabs</link> to fill the whole bar.</para>
0241         </listitem>
0242         <listitem>
0243           <para>
0244           <guilabel>Close tab by double click</guilabel>: If checked,
0245           &krusader; allows closing the <link linkend="folder-tabs">folder tabs</link> by double-clicking on them.</para>
0246         </listitem>
0247         <listitem>
0248           <para>
0249           <guilabel>Insert tabs after current</guilabel>: If checked,
0250           &krusader; inserts new tabs to the right of the current one instead of placing them into the end of the <link linkend="folder-tabs">Tab bar</link>.</para>
0251         </listitem>
0252         <listitem>
0253           <para>
0254           <guilabel>Duplicate active tab by click</guilabel>: Lets you select the active tab duplication mode (<guimenuitem>Disabled</guimenuitem> (no clicking association), <guimenuitem>Alt+Click</guimenuitem> or <guimenuitem>Ctrl+Click</guimenuitem>).</para>
0255         </listitem>
0256         <listitem>
0257           <para>
0258           <guilabel>Tab Bar position</guilabel>: Lets you choose <link linkend="folder-tabs">Tab bar</link> position (<guimenuitem>Bottom</guimenuitem> or <guimenuitem>Top</guimenuitem>).</para>
0259         </listitem>
0260         <listitem>
0261           <para>
0262           <guilabel>Show close tab buttons</guilabel>: If checked,
0263           &krusader; displays close buttons on <link linkend="folder-tabs">tabs</link>.</para>
0264         </listitem>
0265         <listitem>
0266           <para>
0267           <guilabel>Show new tab button</guilabel>: If checked,
0268           &krusader; displays new tab button on the <link linkend="folder-tabs">Tab bar</link>.</para>
0269         </listitem>
0270         <listitem>
0271           <para>
0272           <guilabel>Show Tab Bar on single tab</guilabel>: If checked,
0273           &krusader; displays the Tab Bar even if there is only one <link linkend="folder-tabs">tab</link> on the panel.</para>
0274         </listitem>
0275         <listitem>
0276           <para>
0277           <guilabel>New tab button duplicates a tab</guilabel>: If checked,
0278           new tab button duplicates a <link linkend="folder-tabs">tab</link>, otherwise it opens a tab in home folder.</para>
0279         </listitem>
0280       </itemizedlist>
0281       <itemizedlist>
0282         <title>
0283           <guilabel>Search bar</guilabel>
0284         </title>
0285         <listitem>
0286           <para>
0287           <guilabel>Start by typing</guilabel>: allows to select if
0288           <link linkend="quicksearch">quick search</link> feature is
0289           used. When checked, you can open search bar and start searching
0290           by typing something while viewing folder contents in the active panel.</para>
0291         </listitem>
0292         <listitem>
0293           <para>
0294           <guilabel>Case sensitive</guilabel>: When you
0295           use the <link linkend="quicksearch">search</link>
0296           or <link linkend="quickfilter">filter</link> feature:
0297           If checked (the &UNIX; default), all files
0298           beginning with capital letters appear before files
0299           beginning with lower case letters; otherwise, all files
0300           beginning with a specified letter (capital or otherwise)
0301           will be displayed together.</para>
0302         </listitem>
0303         <listitem>
0304           <para>
0305           <guilabel>Up/Down cancels search</guilabel>: Pressing &Up; or &Down; key cancels <link linkend="quicksearch">search</link> bar.</para>
0306         </listitem>
0307         <listitem>
0308           <para>
0309               <guilabel>Folder navigation with Right Arrow</guilabel>: If checked, pressing the &Right; key enters folder if no search text editing intention is captured.
0310           </para>
0311         </listitem>
0312         <listitem>
0313           <para>
0314           <guilabel>Position</guilabel>: Lets you choose <link linkend="quicksearch">search</link>
0315           and <link linkend="quickfilter">filter</link> bar position (<guimenuitem>Bottom</guimenuitem> or <guimenuitem>Top</guimenuitem>).</para>
0316         </listitem>
0317         <listitem>
0318           <para>
0319             <guilabel>Default mode</guilabel>: Lets you choose the search bar default mode between <link linkend="quicksearch">Search</link>, <guilabel>Select</guilabel>
0320           and <link linkend="quickfilter">Filter</link>. You can change the mode later using the search bar itself.</para>
0321         </listitem>
0322       </itemizedlist>
0323       <itemizedlist>
0324         <title>
0325           <guilabel>Bookmark Search</guilabel>
0326         </title>
0327         <listitem>
0328           <para>
0329           <guilabel>Always show search bar</guilabel>: If checked, make <link linkend="bookman">bookmark search bar</link> always visible.</para>
0330         </listitem>
0331         <listitem>
0332           <para>
0333           <guilabel>Search in special items</guilabel>: If checked, <link linkend="bookman">bookmark search</link> is also applied to special items in bookmark menu like <guimenuitem>Trash</guimenuitem>, <guimenuitem>Popular &URL;s</guimenuitem>, <guimenuitem>Jump Back</guimenuitem>, &etc;</para>
0334         </listitem>
0335       </itemizedlist>
0336       <itemizedlist>
0337         <title>
0338           <guilabel>Status/Totalsbar</guilabel>
0339         </title>
0340         <listitem>
0341           <para>
0342           <guilabel>Show size in bytes too</guilabel>: If checked,
0343           &krusader; displays size in bytes on statusbar or totalsbar.</para>
0344         </listitem>
0345         <listitem>
0346           <para>
0347           <guilabel>Show space information</guilabel>: If checked,
0348               &krusader; displays free/total disk space in the Status-/Totalsbar.</para>
0349         </listitem>
0350       </itemizedlist>
0351     </sect2>
0352     <sect2 id="konfig-panel-view">
0353       <title>View</title>
0354       <itemizedlist>
0355         <title>
0356           <guilabel>General</guilabel>
0357         </title>
0358         <listitem>
0359           <para>
0360           <guilabel>View font</guilabel>: Allows you to change the
0361           font used inside the file lists.</para>
0362         </listitem>
0363         <listitem>
0364           <para>
0365           <guilabel>Tooltip delay (msec)</guilabel>: Allows you to configure the delay in milliseconds
0366           between the moment you have stopped mouse pointer above an item in a file list and the moment when the tooltip will be shown.</para>
0367         </listitem>
0368         <listitem>
0369           <para>
0370           <guilabel>Use human readable file size</guilabel>: If
0371           checked, the file size appears in kB, Mb
0372           &etc;, and not in bytes (default).</para>
0373         </listitem>
0374         <listitem>
0375           <para>
0376           <guilabel>Numeric permissions</guilabel>: <guilabel>Permission</guilabel>
0377           column shows octal numbers '<literal>0755</literal>' instead of '<literal>rwxr-xr-x</literal>'.</para>
0378         </listitem>
0379         <listitem>
0380           <para>
0381           <guilabel>Show hidden files</guilabel>: If checked,
0382           &krusader; displays the <quote>dot-files</quote> which are
0383           otherwise hidden.</para>
0384         </listitem>
0385         <listitem>
0386           <para>
0387           <guilabel>Load the user defined folder icons</guilabel>: If checked,
0388         &krusader; loads the user defined folder icons.</para>
0389         </listitem>
0390         <listitem>
0391           <para>
0392           <guilabel>Always show current item</guilabel>: If checked,
0393         &krusader; shows current item border decoration in inactive panel.</para>
0394         </listitem>
0395         <listitem>
0396           <para>
0397           <guilabel>Sort method</guilabel>
0398             <itemizedlist>
0399              <listitem>
0400               <para>
0401                 <guilabel>Krusader (default)</guilabel>:
0402                 the comparison used so far. Uses comparison using locale rules (even context rules).
0403               </para>
0404              </listitem>
0405              <listitem>
0406               <para>
0407                 <guilabel>Alphabetical</guilabel>:
0408                 strings are compared character by character (no context rules from locale applied).
0409                 Alphabet characters are compared using locale rules,
0410                 special characters are compared by the character code.
0411               </para>
0412              </listitem>
0413              <listitem>
0414               <para>
0415                 <guilabel>Alphabetical and numbers</guilabel>:
0416                 the same as above, but if the names contains numbers, the numbers are compared
0417                 numerically instead of alphabetically.
0418               </para>
0419              </listitem>
0420              <listitem>
0421               <para>
0422                 <guilabel>Character code</guilabel>:
0423                 comparison by character code (quick).
0424               </para>
0425              </listitem>
0426              <listitem>
0427               <para>
0428                 <guilabel>Character code and numbers</guilabel>:
0429                 the same as above, but with numerical comparison of numbers.
0430               </para>
0431              </listitem>
0432            </itemizedlist>
0433             </para>
0434         </listitem>
0435         <listitem>
0436           <para>
0437           <guilabel>Case sensitive sorting</guilabel>: If checked
0438           (the &UNIX; default), all files beginning with
0439           capital letters appear before files beginning with
0440           non-capital letters; otherwise, all files beginning with
0441           a specified letter (capital or otherwise) appear
0442           together.</para>
0443         </listitem>
0444         <listitem>
0445           <para>
0446           <guilabel>Always sort dirs by name</guilabel>: Sorts
0447           folders by name, regardless of the sort
0448           column.</para>
0449         </listitem>
0450         <listitem>
0451           <para>
0452           <guilabel>Show folders first</guilabel>: If checked
0453           folders have precedence in folder lists.</para>
0454         </listitem>
0455         <listitem>
0456           <para>
0457           <guilabel>Locale aware sorting</guilabel>: Sorts
0458           files and folders according to the current locale settings.</para>
0459         </listitem>
0460       </itemizedlist>
0461       <itemizedlist>
0462         <title>
0463           <guilabel>View modes</guilabel>
0464         </title>
0465        <listitem>
0466           <para>
0467           <guilabel>Default view mode</guilabel>: Allows you to
0468           change the default view mode. You can choose <guimenuitem>Detailed View</guimenuitem> or <guimenuitem>Brief View</guimenuitem>. On tabs of both view modes you can define the following options.</para>
0469         </listitem>
0470         <listitem>
0471           <para>
0472           <guilabel>Default icon size</guilabel>: Allows you to
0473           change the size of the icons in the file lists. The
0474           available sizes are 12x12, 16x16, 22x22, 32x32, 48x48, 64x64, 128x128 and 256x256
0475           pixels.</para>
0476         </listitem>
0477         <listitem>
0478           <para>
0479           <guilabel>Use icons in the filenames</guilabel>: If checked,
0480           show the icons in file names and folders.</para>
0481         </listitem>
0482         <listitem>
0483           <para>
0484           <guilabel>Show previews by default</guilabel>: If checked,
0485           show the previews of file contents.</para>
0486         </listitem>
0487         <listitem>
0488           <para>To configure the columns use the right click menu in the panel when viewing files.
0489           The left and right panel use their own columns independently.
0490           The following columns are available:
0491           <itemizedlist>
0492             <listitem>
0493               <para>
0494                 <guilabel>Name</guilabel>: Shows the filename without the part after the last dot,
0495                 this latter part is displayed in the <guilabel>Ext</guilabel> column. When the <guilabel>Ext</guilabel> column is made hidden,
0496                 the complete filename is shown in the <guilabel>Name</guilabel> column like &eg; &konqueror; does.
0497               </para>
0498             </listitem>
0499             <listitem>
0500               <para>
0501               <guilabel>Ext</guilabel>: Shows the last part of the
0502               filename (the part after the last dot) in the <guilabel>Ext</guilabel>
0503               column, and not as a complete filename in the <guilabel>Name</guilabel> column
0504               like &eg; &konqueror; does.
0505               </para>
0506             </listitem>
0507             <listitem>
0508               <para>
0509               <guilabel>Type</guilabel>: Shows the &MIME; type
0510               field.</para>
0511             </listitem>
0512             <listitem>
0513               <para>
0514               <guilabel>Size</guilabel>: Shows the size
0515               field.</para>
0516             </listitem>
0517             <listitem>
0518               <para>
0519               <guilabel>Modified</guilabel>: Shows the modified
0520               date and time field.</para>
0521             </listitem>
0522             <listitem>
0523               <para>
0524               <guilabel>Perms</guilabel>: Shows the full permissions,
0525               &eg;, '<literal>rwxr-xr-x</literal>' or as octal numbers
0526               '<literal>0755</literal>' instead with enable/disable
0527               <guilabel>Numeric Permissions</guilabel> in
0528               <guilabel>Panel View</guilabel> Tab.</para>
0529             </listitem>
0530             <listitem>
0531               <para>
0532               <guilabel>rwx</guilabel>: Shows only the rights of
0533               the current user, &eg;, <quote>-rw</quote>.</para>
0534             </listitem>
0535             <listitem>
0536               <para>
0537               <guilabel>Owner</guilabel>: Shows the owner
0538               field.</para>
0539             </listitem>
0540             <listitem>
0541               <para>
0542               <guilabel>Group</guilabel>: Shows the group
0543               field.</para>
0544             </listitem>
0545           </itemizedlist></para>
0546         </listitem>
0547       </itemizedlist>
0548       <tip>
0549         <para>Uncheck the columns not in use. This allows more
0550         space for columns in use.</para>
0551       </tip>
0552     </sect2>
0553     <sect2 id="konfig-panel-buttons">
0554       <title>Buttons</title>
0555       <para>
0556       <guilabel>Toolbar buttons have icons</guilabel>: If checked,
0557       &krusader; displays icons on toolbar buttons.</para>
0558       <para>
0559       <guilabel>Show Media Button</guilabel>: If checked,
0560       &krusader; displays media button.</para>
0561       <para>
0562       <guilabel>Show Back Button</guilabel>: If checked,
0563       &krusader; displays back button.</para>
0564       <para>
0565       <guilabel>Show Forward Button</guilabel>: If checked,
0566       &krusader; displays forward button.</para>
0567       <para>
0568       <guilabel>Show History Button</guilabel>: If checked,
0569       &krusader; displays history button.</para>
0570       <para>
0571       <guilabel>Show Bookmarks Button</guilabel>: If checked,
0572       &krusader; displays bookmarks button.</para>
0573       <para>
0574       <guilabel>Show Panel Toolbar</guilabel>: If checked,
0575       &krusader; displays the Panel Toolbar.</para>
0576       <para>You can make the buttons on the
0577       <guilabel>Panel Toolbar</guilabel> visible or hidden:
0578       <itemizedlist>
0579         <title>
0580           <guilabel>Visible Panel Toolbar buttons</guilabel>
0581         </title>
0582         <!-- not in master <listitem>
0583           <para>
0584           <guilabel>Clear Location Toolbar</guilabel> button: Clears
0585           the <link linkend="list_panel">Location Toolbar</link></para>
0586         </listitem> -->
0587         <listitem>
0588           <para>
0589           <guilabel>Equal button (=)</guilabel></para>
0590         </listitem>
0591         <listitem>
0592           <para>
0593           <guilabel>Up button (..)</guilabel></para>
0594         </listitem>
0595         <listitem>
0596           <para>
0597           <guilabel>Home button (~)</guilabel></para>
0598         </listitem>
0599         <listitem>
0600           <para>
0601           <guilabel>Root button (/)</guilabel></para>
0602         </listitem>
0603         <listitem>
0604           <para>
0605           <guilabel>Toggle-button for sync-browsing</guilabel>: If
0606           checked, shows the <link linkend="panel_toolbar">Sync-browsing</link>
0607           button.</para>
0608         </listitem>
0609       </itemizedlist></para>
0610     </sect2>
0611     <sect2 id="konfig-selection_modes">
0612       <title>Selection Mode</title>
0613       <para>Here you can configure the selection modes.
0614       <itemizedlist id="selection_modes">
0615         <title>
0616           <guilabel>General</guilabel>
0617         </title>
0618         <listitem>
0619           <para>
0620           <guilabel>&krusader; Mode</guilabel>: The way
0621           &krusader; has worked from day one. Both mouse
0622           keys allow selecting files. To select more than one file,
0623           hold the &Ctrl; key and click the
0624           &LMB;. Right-click menu appears with a short
0625           click on the &RMB;.</para>
0626         </listitem>
0627         <listitem>
0628           <para>
0629           <guilabel>&konqueror; Mode</guilabel>: pressing the
0630           &LMB; selects files --
0631           <!-- Openjade does not like an application element for "Konqueror" here -->
0632           you can click and select multiple files. Right-click menu
0633           appears with a short click on the
0634           &RMB;.</para>
0635         </listitem>
0636         <listitem>
0637           <para>
0638           <guilabel>Total commander Mode</guilabel>: Pressing the
0639           &RMB; selects multiple files
0640           <!-- Openjade does not like an trademark element for "Total commander" here -->
0641           and the right-click menu appears with
0642           <guilabel>pressing and holding</guilabel> the
0643           &RMB;. The &LMB; does not select,
0644           but sets the current file without affecting the current
0645           selection.</para>
0646         </listitem>
0647         <listitem>
0648           <para>
0649           <guilabel>Ergonomic Mode</guilabel>:
0650           The &LMB; does not select, but sets the current file without affecting the current selection.
0651           The &RMB; invokes the context-menu. You can select with &Ctrl; key and the left button.</para>
0652         </listitem>
0653         <listitem>
0654           <para>
0655           <guilabel>Custom Selection Mode</guilabel>: Create your
0656           own selection style!</para>
0657         </listitem>
0658       </itemizedlist>
0659       <itemizedlist>
0660         <title>
0661           <guilabel>Details</guilabel>
0662         </title>
0663         <listitem>
0664           <para>
0665           <guilabel>Double-click selects (classic)</guilabel>: A
0666           single click on a file will select and focus, a double
0667           click opens the file or steps into the folder.</para>
0668         </listitem>
0669         <listitem>
0670           <para>
0671           <guilabel>Obey global selection policy</guilabel>:
0672           Pressing the &LMB; selects files -- Use
0673           global setting: <menuchoice><guimenu>Input Devices</guimenu> <guimenuitem>Mouse
0674           </guimenuitem></menuchoice> module in the &plasma; &systemsettings;.</para>
0675         </listitem>
0676         <listitem>
0677           <para>Custom Selection Mode items:
0678           <itemizedlist>
0679             <listitem>
0680               <para>
0681                 <guilabel>Based on &plasma;'s selection mode</guilabel>
0682               </para>
0683             </listitem>
0684             <listitem>
0685               <para>
0686                 <guilabel>&LMB; selects</guilabel>
0687               </para>
0688             </listitem>
0689             <listitem>
0690               <para>
0691                 <guilabel>&LMB; preserves selection</guilabel>
0692               </para>
0693             </listitem>
0694             <listitem>
0695               <para>
0696                   <guilabel>&Shift;/&Ctrl; + left clicking selects</guilabel>
0697               </para>
0698             </listitem>
0699             <listitem>
0700               <para>
0701                 <guilabel>&RMB; selects</guilabel>
0702               </para>
0703             </listitem>
0704             <listitem>
0705               <para>
0706                 <guilabel>&RMB; preserves selection</guilabel>
0707               </para>
0708             </listitem>
0709             <listitem>
0710               <para>
0711                   <guilabel>&Shift;/&Ctrl; + right clicking selects</guilabel>
0712               </para>
0713             </listitem>
0714             <listitem>
0715               <para>
0716                 <guilabel>Spacebar moves down</guilabel>
0717               </para>
0718             </listitem>
0719             <listitem>
0720               <para>
0721                 <guilabel>Insert moves down</guilabel>
0722               </para>
0723             </listitem>
0724             <listitem>
0725               <para>
0726                 <guilabel>Right-clicking pops context menu
0727                 immediately</guilabel>
0728               </para>
0729             </listitem>
0730             <listitem>
0731               <para>
0732                   <guilabel>A plain mouse button resets selection</guilabel> - resets selection on a mouse click without modifiers (&ie; &Shift; or &Ctrl;). Selection with &Shift;/&Ctrl; for the mouse button has to be enabled for this setting to work.
0733               </para>
0734             </listitem>
0735           </itemizedlist></para>
0736         </listitem>
0737       </itemizedlist></para>
0738     </sect2>
0739     <sect2 id="konfig-panel-mediamenu">
0740       <title>Media Menu</title>
0741       <para>Using this tab you can select the <link linkend="media_button">Media button</link> menu contents:
0742       <itemizedlist>
0743         <listitem>
0744           <para>
0745           <guilabel>Show Mount Path</guilabel>: show the mount path of partition if checked.</para>
0746         </listitem>
0747         <listitem>
0748           <para>
0749           <guilabel>Show File System Type</guilabel>: show the file system type of partition if checked.</para>
0750         </listitem>
0751         <listitem>
0752           <para>
0753               <guilabel>Hide SquashFS entries</guilabel>: <ulink url="https://snapcraft.io/">Snap</ulink> creates many <ulink url="https://en.wikipedia.org/wiki/SquashFS">SquashFS</ulink>-mounted partitions, which are almost useless in the <link linkend="list_panel">Media Menu</link>, because <application>snap</application> manages them. It is possible to hide SquashFS mounts by checking this item.</para>
0754         </listitem>
0755         <listitem>
0756           <para>
0757               <guilabel>Hide following mountpoints</guilabel>: this list allows to exclude unwanted items from <link linkend="list_panel">Media Menu</link>. Press the <guibutton>+</guibutton> button above the list to add some mount point you want to ignore. Should you decide to remove the added mount point from the list just click on it and press the <guibutton>-</guibutton> button.
0758           </para>
0759         </listitem>
0760         <listitem>
0761           <para>
0762           <guilabel>Show Size:</guilabel> allows selection of the size representation in media menu. Can be <guimenuitem>Always</guimenuitem> (default, always show the size of partition), <guimenuitem>When Device has no Label</guimenuitem> (show the size for partitions with no label only) or <guimenuitem>Never</guimenuitem> (never show the size in media menu).</para>
0763         </listitem>
0764       </itemizedlist></para>
0765     </sect2>
0766     <sect2 id="konfig-panel-layout">
0767       <title>Layout</title>
0768       <para>You can choose the layout and frame settings:
0769       <itemizedlist>
0770         <listitem>
0771           <para>
0772           <guilabel>Layout:</guilabel> allows to define layout. The default options are <guimenuitem>Default</guimenuitem>, <guimenuitem>Compact</guimenuitem>, and <guimenuitem>Classic</guimenuitem>.</para>
0773         </listitem>
0774         <listitem>
0775           <para>
0776           <guilabel>Frame Color:</guilabel> defines frame color. Can be <guimenuitem>Defined by Layout</guimenuitem>, <guimenuitem>None</guimenuitem>, or <guimenuitem>Statusbar</guimenuitem>.</para>
0777         </listitem>
0778         <listitem>
0779           <para>
0780           <guilabel>Frame Shape:</guilabel> defines frame color. Can be <guimenuitem>Defined by Layout</guimenuitem>, <guimenuitem>None</guimenuitem>, <guimenuitem>Box</guimenuitem>, or <guimenuitem>Panel</guimenuitem>.</para>
0781         </listitem>
0782         <listitem>
0783           <para>
0784           <guilabel>Frame Shadow:</guilabel> defines frame color. Can be <guimenuitem>Defined by Layout</guimenuitem>, <guimenuitem>None</guimenuitem>, <guimenuitem>Raised</guimenuitem>, or <guimenuitem>Sunken</guimenuitem>.</para>
0785         </listitem>
0786       </itemizedlist></para>
0787     </sect2>
0788   </sect1>
0789   <sect1 id="konfig-color">
0790     <title>Colors</title>
0791     <para>This page configures the colors of the
0792     <link linkend="list_panel">List Panel</link> and the
0793     <link linkend="synchronizer">Synchronizer</link>. The
0794     <guilabel>&kde; default colors</guilabel> is the default color
0795     configuration.</para>
0796 
0797     <variablelist>
0798       <varlistentry>
0799         <term>
0800           <guilabel>General</guilabel>
0801         </term>
0802         <listitem>
0803           <itemizedlist>
0804             <listitem>
0805               <para>
0806               <guilabel>Use the default &kde; colors</guilabel>: this
0807               is the default, it uses &plasma; color
0808               defined in the &systemsettings;.</para>
0809             </listitem>
0810             <listitem>
0811               <para>
0812               <guilabel>Use Alternate Background color</guilabel>:
0813               If checked, the
0814               <guilabel>Background</guilabel> color and the
0815               <guilabel>Alternate background</guilabel> color
0816               alternates line by line. When you do not use the
0817               &plasma; default colors, you can configure
0818               the alternate colors in the
0819               <guilabel>Colors</guilabel> box.</para>
0820             </listitem>
0821             <listitem>
0822               <para>
0823               <guilabel>Show current item even if not
0824               focused</guilabel>: If checked, shows the last cursor
0825               position in the non active list panel. This option is
0826               only available when you do not use the
0827               &plasma; default colors.</para>
0828             </listitem>
0829             <listitem>
0830               <para>
0831               <guilabel>Dim the colors of the inactive
0832               panel</guilabel>: If checked, the colors of the
0833               inactive panel are dimmed. These settings can be
0834               configured in the
0835               <guilabel>Inactive</guilabel> tab of the
0836               <guilabel>Colors</guilabel> box. This option is only
0837               available when you do not use the &plasma;
0838               default colors.</para>
0839             </listitem>
0840           </itemizedlist>
0841         </listitem>
0842       </varlistentry>
0843       <varlistentry>
0844         <term>
0845           <guilabel>Colors</guilabel>
0846         </term>
0847         <listitem>
0848           <para>Configure the colors the way you like, you can see
0849           the result in the
0850           <guilabel>Preview</guilabel> section. The following items
0851           of the active and inactive panel can be
0852           configured:</para>
0853           <itemizedlist>
0854             <listitem>
0855               <para>
0856                 <guilabel>Foreground</guilabel>
0857               </para>
0858             </listitem>
0859             <listitem>
0860               <para>
0861                 <guilabel>Folder foreground</guilabel>
0862               </para>
0863             </listitem>
0864             <listitem>
0865               <para>
0866                 <guilabel>Executable foreground</guilabel>
0867               </para>
0868             </listitem>
0869             <listitem>
0870               <para>
0871                 <guilabel>Symbolic link foreground</guilabel>
0872               </para>
0873             </listitem>
0874             <listitem>
0875               <para>
0876                 <guilabel>Invalid symlink foreground</guilabel>
0877               </para>
0878             </listitem>
0879             <listitem>
0880               <para>
0881                 <guilabel>Background</guilabel>
0882               </para>
0883             </listitem>
0884             <listitem>
0885               <para>
0886                 <guilabel>Alternate background</guilabel>
0887               </para>
0888             </listitem>
0889             <listitem>
0890               <para>
0891                 <guilabel>Selected foreground</guilabel>
0892               </para>
0893             </listitem>
0894             <listitem>
0895               <para>
0896                 <guilabel>Selected background</guilabel>
0897               </para>
0898             </listitem>
0899             <listitem>
0900               <para>
0901                 <guilabel>Alternate selected background</guilabel>
0902               </para>
0903             </listitem>
0904             <listitem>
0905               <para>
0906                 <guilabel>Current foreground</guilabel>
0907               </para>
0908             </listitem>
0909             <listitem>
0910               <para>
0911                 <guilabel>Selected current foreground</guilabel>
0912               </para>
0913             </listitem>
0914             <listitem>
0915               <para>
0916                 <guilabel>Current background</guilabel>
0917               </para>
0918             </listitem>
0919             <listitem>
0920               <para>
0921                 <guilabel>Rename foreground</guilabel>
0922               </para>
0923             </listitem>
0924             <listitem>
0925               <para>
0926                 <guilabel>Rename background</guilabel>
0927               </para>
0928             </listitem>
0929           </itemizedlist>
0930           <para>The following items of the
0931           <link linkend="synchronizer">Synchronizer</link> can be configured:</para>
0932           <itemizedlist>
0933             <listitem>
0934               <para>
0935                 <guilabel>Equals foreground</guilabel>
0936               </para>
0937             </listitem>
0938             <listitem>
0939               <para>
0940                 <guilabel>Equals background</guilabel>
0941               </para>
0942             </listitem>
0943             <listitem>
0944               <para>
0945                 <guilabel>Differing foreground</guilabel>
0946               </para>
0947             </listitem>
0948             <listitem>
0949               <para>
0950                 <guilabel>Differing background</guilabel>
0951               </para>
0952             </listitem>
0953             <listitem>
0954               <para>
0955                 <guilabel>Copy to left foreground</guilabel>
0956               </para>
0957             </listitem>
0958             <listitem>
0959               <para>
0960                 <guilabel>Copy to left background</guilabel>
0961               </para>
0962             </listitem>
0963             <listitem>
0964               <para>
0965                 <guilabel>Copy to right foreground</guilabel>
0966               </para>
0967             </listitem>
0968             <listitem>
0969               <para>
0970                 <guilabel>Copy to left background</guilabel>
0971               </para>
0972             </listitem>
0973             <listitem>
0974               <para>
0975                 <guilabel>Delete foreground</guilabel>
0976               </para>
0977             </listitem>
0978             <listitem>
0979               <para>
0980                 <guilabel>Delete background</guilabel>
0981               </para>
0982             </listitem>
0983           </itemizedlist>
0984         </listitem>
0985       </varlistentry>
0986       <varlistentry>
0987         <term>
0988           <guilabel>Preview</guilabel>
0989         </term>
0990         <listitem>
0991           <para>Here you see a preview of the configured
0992           colors.</para>
0993         </listitem>
0994       </varlistentry>
0995       <varlistentry>
0996         <term>
0997           <guilabel>Color schemes</guilabel>
0998         </term>
0999         <listitem>
1000           <para>With the
1001           <guibutton>Import Color Scheme</guibutton> and
1002           <guibutton>Export Color Scheme</guibutton> buttons you can
1003           load and save a Color Scheme profile. This allows
1004           &krusader; to use <trademark class="copyright">Total Commander</trademark>,
1005           <application>Midnight Commander</application>, foo-commander or your own custom color
1006           profile. The Color Schemes are stored in
1007           <filename>/usr/share/krusader</filename>, the
1008           <filename>foo.color</filename> is a binary file that holds
1009           the color scheme.</para>
1010           <tip>
1011             <para><application>Midnight Commander</application> and <trademark class="copyright">Total Commander</trademark> Color
1012             scheme files are provided. Please
1013             <link linkend="help_krusader">upload your favorite
1014             Color schemes</link> so that they become available for
1015             the &krusader; community. Thanks!</para>
1016           </tip>
1017         </listitem>
1018       </varlistentry>
1019     </variablelist>
1020   </sect1>
1021 <sect1 id="konfig-general">
1022     <title>General</title>
1023     <para>Here you configure the basic operations. The page is divided into three tabs:
1024     <guilabel>General</guilabel>,
1025     <guilabel>Viewer/Editor</guilabel>,
1026     and <guilabel>Atomic extensions</guilabel>.</para>
1027     <sect2 id="konfig-general-general">
1028       <title>General</title>
1029       <para>The following options determine basic aspects of operation:</para>
1030       <itemizedlist>
1031         <listitem>
1032           <para>
1033             <guilabel>Warn on exit</guilabel>: if checked, &krusader;
1034             warns you every time when exit action is triggered.
1035           </para>
1036         </listitem>
1037         <listitem>
1038           <para>
1039             <guilabel>Show and close to tray</guilabel>: If checked, the &krusader;
1040         icon will appear in the system tray.
1041         When you minimize &krusader;, it will not appear in the taskbar.
1042         It also will not exit if you close the main window.
1043         Instead you can quit &krusader; by selecting <menuchoice><guimenu>File</guimenu>
1044         <guimenuitem>Quit</guimenuitem></menuchoice> menu item or the context menu of the tray icon.
1045           </para>
1046         </listitem>
1047         <listitem>
1048           <para>
1049             <guilabel>Use &MIME; type magic</guilabel>: &MIME; type magic is
1050             a mechanism which allows &krusader; to inspect
1051             the files in the panels and determine their type even if
1052             the file has no identifying extension. For example, if you
1053             take an image file - <filename>image1.jpg</filename> - and rename it to
1054             <filename>image1</filename>, &krusader; will still know it is an
1055             image file and work with it accordingly. However, this mode
1056             of operation is slower (while refreshing the panel, or
1057             changing folders), so try &krusader; with
1058             and without &MIME; type magic and decide what is best for
1059             you.</para>
1060          </listitem>
1061          <listitem>
1062            <para>
1063              <guilabel>Temp Folder</guilabel>: this option selects
1064              the base folder for &krusader;'s temporary
1065              files. The actual files will be created in separate
1066              folders under the 'Temp folder', so that each user
1067              running &krusader; will have their own temporary
1068              subfolders under the chosen folder.
1069              <note>
1070                <para>You must choose a temporary folder to which all
1071                  users running &krusader; have full
1072                  permissions!</para>
1073              </note>
1074            </para>
1075          </listitem>
1076       </itemizedlist>
1077       <para>
1078         <guilabel>Delete mode</guilabel> (<guilabel>Delete files/Move to trash</guilabel>): when
1079         &krusader; deletes files it can either <emphasis>really</emphasis>
1080         delete them or move them to the trash folder, thereby
1081         making them available via &plasma;'s trash.
1082       </para>
1083       <para>
1084         <guilabel>External Terminal</guilabel>: choose which terminal
1085         emulator will be used when &krusader; opens a
1086         console window (via <keycap>F9</keycap>, or <menuchoice><guimenu>Tools</guimenu>
1087         <guimenuitem>Start Terminal</guimenuitem></menuchoice>
1088         menu option).
1089       </para>
1090       <para>
1091         <guilabel>Embedded Terminal sends Chdir on panel
1092         change</guilabel>: if unchecked, there will be no
1093         <command>cd</command> command sent to the Terminal Emulator
1094         if the panel folder changes.</para>
1095       <para>
1096         <guilabel>Active panel follows Embedded Terminal working directory</guilabel>: if unchecked, active panel
1097         stays unchanged while the user navigates in the embedded terminal (using cd, popd, etc).
1098       </para>
1099       <para>
1100         <guilabel>Toggle Fullscreen Embedded Terminal</guilabel>: if checked,
1101           &krusader; shows fullscreen terminal in
1102           <application>Midnight Commander</application> style (Terminal is shown
1103           instead of &krusader; window).
1104       </para>
1105     </sect2>
1106     <sect2 id="konfig-general-viewer">
1107        <title>Viewer/Editor</title>
1108       <para>Here you can change the viewer and editor settings:
1109       </para>
1110       <itemizedlist>
1111       <listitem>
1112         <para>
1113           <guilabel>Internal editor and viewer opens each file in separate window</guilabel>: check this
1114           item if you want each file to be opened in a separate window. If unchecked, each file will be
1115           opened in a tab in the same Viewer/Editor window. Every tab in such a window can be closed,
1116           among other common methods, by clicking on the tab with the &MMB;.
1117         </para>
1118       </listitem>
1119       <listitem>
1120         <para>
1121           <guilabel>Hide the tab bar when only one tab is opened</guilabel>: check this
1122           item if you want the Viewer/Editor tab bar to be hidden if only one tab is open.
1123         </para>
1124       </listitem>
1125       <listitem>
1126         <para>
1127         <guilabel>Default viewer mode</guilabel>:
1128         <itemizedlist>
1129         <listitem>
1130          <para>
1131          <guilabel>Generic mode</guilabel>: use the systems default viewer.</para>
1132         </listitem>
1133         <listitem>
1134          <para>
1135          <guilabel>Text mode</guilabel>: view the file in text-only mode.</para>
1136         </listitem>
1137         <listitem>
1138          <para>
1139          <guilabel>Hex mode</guilabel>: view the file in hex-only mode.</para>
1140         </listitem>
1141         <listitem>
1142          <para>
1143          <guilabel>Lister mode</guilabel>: Fast text/hexadecimal viewer for huge filesizes.
1144          &krusader; lister never loads the whole file into memory, just a little part of it, and uses caching for faster scrolling.
1145          Remote files are downloaded, but during the download, viewing the downloaded part is possible.
1146          If a file constantly changes, then it can also be viewed, lister will always see its current state.</para>
1147         </listitem>
1148         <listitem>
1149          <para>
1150          <guilabel>Use lister if the text file is bigger than: 10 MB (default value)</guilabel>:
1151          checks whether a text file is bigger than 10 MB (configurable), and if yes,
1152          then &krusader; Lister is used instead of &plasma;'s default viewer.</para>
1153         </listitem>
1154         <listitem>
1155          <para>
1156            <guilabel>Use Okteta as Hex viewer</guilabel>:
1157            if checked (default option), use &plasma; hex editor <ulink url="https://docs.kde.org/index.php?application=okteta">Okteta</ulink> to view
1158            raw data. To use this option you should install <application>Okteta</application> package first.</para>
1159         </listitem>
1160         </itemizedlist>
1161       </para>
1162       </listitem>
1163       <listitem>
1164         <para>
1165         <guilabel>Editor</guilabel>: choose what editor will be
1166           used when editing a file (via <keycap>F4</keycap>). Default the internal viewer is used,
1167         this is the &plasma;'s default viewer.</para>
1168       </listitem>
1169     </itemizedlist>
1170     </sect2>
1171     <sect2 id="konfig-general-atomic">
1172       <title>Atomic extensions</title>
1173         <para>
1174         <guilabel>Atomic extensions</guilabel>: predefined atomic extensions like <literal role="extension">.tar.gz</literal>
1175         are shown as one part in the <guilabel>Ext</guilabel> Column of the <link linkend="list_panel">List Panel</link>.</para>
1176       </sect2>
1177   </sect1>
1178   <sect1 id="konfig-advanced">
1179     <title>Advanced</title>
1180     <para>This page handles more advanced issues, so you should
1181     double-check your actions here: modifying settings here
1182     <remark>makes &krusader; a more powerful and
1183     dangerous tool.</remark></para>
1184 
1185     <para>The page is divided into three parts:</para>
1186     <variablelist>
1187       <varlistentry>
1188         <term>
1189           <guilabel>General</guilabel>
1190         </term>
1191         <listitem>
1192           <itemizedlist>
1193             <!-- not in master <listitem>
1194               <para>
1195               <guilabel>Preserve attributes for local copy/move
1196               (slower)</guilabel>: If checked,
1197               &krusader; will try to preserve all
1198               attributes (time, owner, group) of the local files
1199               according to the source file depending on your
1200               <link linkend="copying">permissions</link>.</para>
1201             </listitem> -->
1202             <listitem>
1203               <para>
1204               <guilabel>Automount filesystems</guilabel>: this
1205               makes &krusader; try to mount a file system
1206               before entering it. For example, if you click on
1207               <filename class="directory">/mnt/cdrom</filename> (and
1208               <filename class="directory">
1209               /mnt/cdrom</filename> appears in
1210               <filename class="directory">/etc/fstab</filename> as a
1211               mount point), &krusader; will check if it
1212               is mounted. If not, it will try and mount it for you
1213               and then enter, so that you would see the contents of
1214               your &CD-ROM;. Note, however, that &krusader;
1215               will NOT unmount when exiting
1216               <filename class="directory">
1217               /mnt/cdrom</filename>.</para>
1218             </listitem>
1219             <!-- not in master <listitem>
1220               <para>
1221               <guilabel>Do not use KDE media protocol for the
1222               Media button (if it is buggy or missing)</guilabel>:
1223               If checked, &krusader; will not use
1224               &kde; media protocol for the
1225               <link linkend="list_panel">Media button</link>.
1226               Choose this when the media protocol is buggy (in some
1227               older &kde; versions) or if you have no
1228               kdebase package installed on your system.</para>
1229             </listitem> -->
1230             <listitem>
1231               <para>
1232               <guilabel>MountMan will not (un)mount the following
1233               mount points</guilabel>: If you have file systems that
1234               you do not want to accidentally unmount (or mount)
1235               then enter a list of mount points separated by commas
1236               (&eg;
1237               <literal>/, /boot, /tmp</literal>) and
1238               <link linkend="mount-man">MountMan</link> will not try to (un)mount
1239               them.</para>
1240             </listitem>
1241           </itemizedlist>
1242         </listitem>
1243       </varlistentry>
1244       <varlistentry>
1245         <term>
1246           <guilabel>Confirmations</guilabel>
1247         </term>
1248         <listitem>
1249           <para>By checking the options in this section,
1250           &krusader; will ask for confirmation before
1251           doing a specific action; otherwise, the following actions
1252           will be done without warning:</para>
1253           <itemizedlist>
1254             <listitem>
1255               <para>Deleting non-empty folders</para>
1256             </listitem>
1257             <listitem>
1258               <para>Deleting files</para>
1259             </listitem>
1260             <listitem>
1261               <para>Copying files</para>
1262             </listitem>
1263             <listitem>
1264               <para>Moving files</para>
1265             </listitem>
1266           </itemizedlist>
1267         </listitem>
1268       </varlistentry>
1269       <varlistentry>
1270         <term>
1271           <guilabel>Fine-Tuning</guilabel>
1272         </term>
1273         <listitem>
1274           <itemizedlist>
1275             <listitem>
1276               <para>
1277               <guilabel>Icon cache size (KB)</guilabel>:
1278               &krusader; uses an icon cache, so it will not
1279               have to reload icons that have been used before. Of
1280               course, as the cache grows bigger, it can store more
1281               icons and further speed operations, but the memory
1282               footprint of &krusader; will become
1283               bigger.</para>
1284             </listitem>
1285             <listitem>
1286               <para>
1287               <guilabel>Arguments of updatedb</guilabel>: sets
1288               additional arguments for
1289               <command>updatedb</command>, please read the manpages
1290               for more information.</para>
1291             </listitem>
1292           </itemizedlist>
1293         </listitem>
1294       </varlistentry>
1295     </variablelist>
1296   </sect1>
1297   <sect1 id="konfig-archives">
1298     <title>Archives</title>
1299     <para>
1300       This page configures some aspects of archive handling in &krusader;.
1301     </para>
1302     <variablelist>
1303       <varlistentry>
1304         <term>
1305           <guilabel>krarc ioslave</guilabel>
1306         </term>
1307         <listitem>
1308           <para>
1309             <guilabel>Enable Write Support</guilabel>: this
1310             option allows you to enable writing files into an archive.
1311               <warning>
1312                 <para>The down side is that if a power failure occurs
1313                   during the process, the files that were moved might
1314                   already be deleted, but not yet packed into the archive.
1315                   Moving archives into themselves will delete them.
1316                 </para>
1317               </warning>
1318             </para>
1319           </listitem>
1320         </varlistentry>
1321               <varlistentry>
1322         <term>
1323           <guilabel>Archive handling</guilabel>
1324         </term>
1325         <listitem>
1326           <para>
1327             <guilabel>Browse Archives As Folders</guilabel>: if checked, &krusader;
1328         will handle the archives transparently and let you open them as folders;
1329         otherwise, &krusader; will attempt to invoke an application which opens archives of that type.
1330             </para>
1331           </listitem>
1332         </varlistentry>
1333         <varlistentry>
1334           <term>
1335             <guilabel>Fine-Tuning</guilabel>
1336           </term>
1337           <listitem>
1338       <itemizedlist>
1339         <!-- not in master <listitem>
1340           <para>
1341           <guilabel>Allow moving into archives</guilabel>: this
1342           option allows you to move files into an archive (as
1343           opposed to just copying into the archive). The down side
1344           is that if a power failure occurs during the process, the
1345           files that were moved might already be deleted, but not
1346           yet packed into the archive.
1347           <note>
1348             <para>If such a thing happens, the file(s) are NOT
1349             LOST. They were actually moved into a subfolder in
1350             &krusader;'s
1351             <link linkend="konfig-general">temp folder</link>.
1352             You can search the folder and recover your
1353             files.</para>
1354           </note></para>
1355         </listitem> -->
1356         <listitem>
1357           <para>
1358           <guilabel>Test archive after packing</guilabel>:
1359           this option automatically runs a test on a newly packed
1360           archive. It is safer, but takes longer.</para>
1361         </listitem>
1362         <listitem>
1363           <para>
1364           <guilabel>Test archives before unpacking</guilabel>:
1365           this option automatically runs a test before unpacking.
1366           Some corrupted archives might cause a crash; therefore, it is
1367           better to test archives before unpacking.</para>
1368         </listitem>
1369       </itemizedlist>
1370     </listitem>
1371   </varlistentry>
1372   </variablelist>
1373   </sect1>
1374   <sect1 id="konfig-dependencies">
1375     <title>Dependencies page</title>
1376     <para>This page configures the full path of the external
1377     applications. It is even possible to configure the full path of
1378     &krusader;!</para>
1379     <para>
1380       <emphasis role="bold">General tab</emphasis>
1381     </para>
1382     <para>Here you can configure the full path of the following external applications:</para>
1383     <informaltable>
1384       <tgroup cols="2">
1385         <tbody>
1386           <row>
1387             <entry>application</entry>
1388             <entry>configurable full path</entry>
1389           </row>
1390           <row>
1391             <entry>
1392               <para>
1393                 <command>kdesu</command>
1394               </para>
1395             </entry>
1396             <entry>
1397               <para>
1398                 <filename class="directory">
1399                   <replaceable>/usr/bin/kdesu</replaceable>
1400                 </filename>
1401               </para>
1402             </entry>
1403           </row>
1404           <row>
1405             <entry>
1406               <para>
1407                 <command>kget</command>
1408               </para>
1409             </entry>
1410             <entry>
1411               <para>
1412                 <filename class="directory">
1413                   <replaceable>/usr/bin/kget</replaceable>
1414                 </filename>
1415               </para>
1416             </entry>
1417           </row>
1418           <row>
1419             <entry>
1420               <para>
1421                 <command>mailer</command>
1422               </para>
1423             </entry>
1424             <entry>
1425               <para>
1426                 <filename class="directory">
1427                   <replaceable>/usr/bin/kmail</replaceable>
1428                 </filename>
1429               </para>
1430             </entry>
1431           </row>
1432           <row>
1433             <entry>
1434               <para>diff utility</para>
1435             </entry>
1436             <entry>
1437               <para>
1438                 <filename class="directory">
1439                   <replaceable>/usr/bin/kompare</replaceable>
1440                 </filename>
1441               </para>
1442             </entry>
1443           </row>
1444           <row>
1445             <entry>
1446               <command>krename</command>
1447             </entry>
1448             <entry>
1449               <para>
1450                 <filename class="directory">
1451                   <replaceable>/usr/bin/krename</replaceable>
1452                 </filename>
1453               </para>
1454             </entry>
1455           </row>
1456           <row>
1457             <entry>
1458               <para>
1459                 <command>krusader</command>
1460               </para>
1461             </entry>
1462             <entry>
1463               <para>
1464                 <filename class="directory">
1465                   <replaceable>/usr/bin/krusader</replaceable>
1466                 </filename>
1467               </para>
1468             </entry>
1469           </row>
1470           <row>
1471             <entry>
1472               <para>
1473                 <command>locate</command>
1474               </para>
1475             </entry>
1476             <entry>
1477               <para>
1478                 <filename class="directory">
1479                   <replaceable>/usr/bin/locate</replaceable>
1480                 </filename>
1481               </para>
1482             </entry>
1483           </row>
1484           <row>
1485             <entry>
1486               <para>
1487                 <command>mount</command>
1488               </para>
1489             </entry>
1490             <entry>
1491               <para>
1492                 <filename class="directory">
1493                   <replaceable>/bin/mount</replaceable>
1494                 </filename>
1495               </para>
1496             </entry>
1497           </row>
1498           <row>
1499             <entry>
1500               <para>
1501                 <command>umount</command>
1502               </para>
1503             </entry>
1504             <entry>
1505               <para>
1506                 <filename class="directory">
1507                   <replaceable>/bin/umount</replaceable>
1508                 </filename>
1509               </para>
1510             </entry>
1511           </row>
1512           <row>
1513             <entry>
1514               <para>
1515                 <command>updatedb</command>
1516               </para>
1517             </entry>
1518             <entry>
1519               <para>
1520                 <filename class="directory">
1521                   <replaceable>/usr/bin/updatedb</replaceable>
1522                 </filename>
1523               </para>
1524             </entry>
1525           </row>
1526         </tbody>
1527       </tgroup>
1528     </informaltable>
1529     <tip>
1530       <para>By default &kompare; is used as external diff utility but you can also
1531       use your favorite diff utility &eg;
1532       <ulink url="http://furius.ca/xxdiff/"><application>xxdiff</application></ulink> or <ulink url="https://www.kde.org/applications/development/kdiff3/"><application>KDiff3</application></ulink>, just fill
1533       in the full path and enjoy.</para>
1534     </tip>
1535     <para>
1536       <emphasis role="bold">Packers tab</emphasis>
1537     </para>
1538     <para>In the
1539     <guilabel>Packers</guilabel> tab you will see a list of
1540     archive formats. Some are filled and some are empty. The
1541     ones that are available (filled) are supported by
1542     &krusader;. For them, &krusader;
1543     will handle the archives transparently and let you open them as
1544     folders (provided you have checked the <guilabel>Browse Archives As Folders</guilabel>
1545     item in the <link linkend="konfig-archives">Archives</link> section); otherwise, &krusader; will attempt to
1546     invoke an application which opens archives of that type. If a
1547     certain archive item is empty, it means that
1548     &krusader; could not find the appropriate executables
1549     in the configured path. The next archives are supported: ace,
1550     arj, bzip2, deb, gzip, iso, lha, lzma, rar, rpm, tar, xz, zip and
1551     7z.</para>
1552     <informaltable>
1553       <tgroup cols="2">
1554         <tbody>
1555           <row>
1556             <entry>packer</entry>
1557             <entry>configurable full path</entry>
1558           </row>
1559           <row>
1560             <entry>
1561               <para>
1562                 <command>7z</command>
1563               </para>
1564             </entry>
1565             <entry>
1566               <para>
1567                 <filename class="directory">
1568                   <replaceable>usr/bin/7z</replaceable>
1569                 </filename>
1570               </para>
1571             </entry>
1572           </row>
1573           <row>
1574             <entry>
1575               <para>
1576                 <command>arj</command>
1577               </para>
1578             </entry>
1579             <entry>
1580               <para>
1581                 <filename class="directory">
1582                   <replaceable>usr/bin/arj</replaceable>
1583                 </filename>
1584               </para>
1585             </entry>
1586           </row>
1587           <row>
1588             <entry>
1589               <para>
1590                 <command>bzip2</command>
1591               </para>
1592             </entry>
1593             <entry>
1594               <para>
1595                 <filename class="directory">
1596                   <replaceable>usr/bin/bzip2</replaceable>
1597                 </filename>
1598               </para>
1599             </entry>
1600           </row>
1601           <row>
1602             <entry>
1603               <para>
1604                 <command>cpio</command>
1605               </para>
1606             </entry>
1607             <entry>
1608               <para>
1609                 <filename class="directory">
1610                   <replaceable>/bin/cpio</replaceable>
1611                 </filename>
1612               </para>
1613             </entry>
1614           </row>
1615           <row>
1616             <entry>
1617               <para>
1618                 <command>dpkg</command>
1619               </para>
1620             </entry>
1621             <entry>
1622               <para>
1623                 <filename class="directory">
1624                   <replaceable>/bin/dpkg</replaceable>
1625                 </filename>
1626               </para>
1627             </entry>
1628           </row>
1629           <row>
1630             <entry>
1631               <para>
1632                 <command>gzip</command>
1633               </para>
1634             </entry>
1635             <entry>
1636               <para>
1637                 <filename class="directory">
1638                   <replaceable>/usr/bin/gzip</replaceable>
1639                 </filename>
1640               </para>
1641             </entry>
1642           </row>
1643           <row>
1644             <entry>
1645               <para>
1646                 <command>lha</command>
1647               </para>
1648             </entry>
1649             <entry>
1650               <para>
1651                 <filename class="directory">
1652                   <replaceable>/usr/bin/lha</replaceable>
1653                 </filename>
1654               </para>
1655             </entry>
1656           </row>
1657           <row>
1658             <entry>
1659               <para>
1660                 <command>lzma</command>
1661               </para>
1662             </entry>
1663             <entry>
1664               <para>
1665                 <filename class="directory">
1666                   <replaceable>/usr/bin/lzma</replaceable>
1667                 </filename>
1668               </para>
1669             </entry>
1670           </row>
1671           <row>
1672             <entry>
1673               <para>
1674                 <command>rar</command>
1675               </para>
1676             </entry>
1677             <entry>
1678               <para>
1679                 <filename class="directory">
1680                   <replaceable>/usr/bin/rar</replaceable>
1681                 </filename>
1682               </para>
1683             </entry>
1684           </row>
1685           <row>
1686             <entry>
1687               <para>
1688                 <command>tar</command>
1689               </para>
1690             </entry>
1691             <entry>
1692               <para>
1693                 <filename class="directory">
1694                   <replaceable>/bin/tar</replaceable>
1695                 </filename>
1696               </para>
1697             </entry>
1698           </row>
1699           <row>
1700             <entry>
1701               <para>
1702                 <command>unace</command>
1703               </para>
1704             </entry>
1705             <entry>
1706               <para>
1707                 <filename class="directory">
1708                   <replaceable>/usr/bin/unace</replaceable>
1709                 </filename>
1710               </para>
1711             </entry>
1712           </row>
1713           <row>
1714             <entry>
1715               <para>
1716                 <command>unarj</command>
1717               </para>
1718             </entry>
1719             <entry>
1720               <para>
1721                 <filename class="directory">
1722                   <replaceable>/usr/bin/unarj</replaceable>
1723                 </filename>
1724               </para>
1725             </entry>
1726           </row>
1727           <row>
1728             <entry>
1729               <para>
1730                 <command>unrar</command>
1731               </para>
1732             </entry>
1733             <entry>
1734               <para>
1735                 <filename class="directory">
1736                   <replaceable>/usr/bin/unrar</replaceable>
1737                 </filename>
1738               </para>
1739             </entry>
1740           </row>
1741           <row>
1742             <entry>
1743               <para>
1744                 <command>unzip</command>
1745               </para>
1746             </entry>
1747             <entry>
1748               <para>
1749                 <filename class="directory">
1750                   <replaceable>/usr/bin/unzip</replaceable>
1751                 </filename>
1752               </para>
1753             </entry>
1754           </row>
1755           <row>
1756             <entry>
1757               <para>
1758                 <command>zip</command>
1759               </para>
1760             </entry>
1761             <entry>
1762               <para>
1763                 <filename class="directory">
1764                   <replaceable>/usr/bin/zip</replaceable>
1765                 </filename>
1766               </para>
1767             </entry>
1768           </row>
1769           <row>
1770             <entry>
1771               <para>
1772                 <command>xz</command>
1773               </para>
1774             </entry>
1775             <entry>
1776               <para>
1777                 <filename class="directory">
1778                   <replaceable>/usr/bin/xz</replaceable>
1779                 </filename>
1780               </para>
1781             </entry>
1782           </row>
1783         </tbody>
1784       </tgroup>
1785     </informaltable>
1786     <note>
1787       <para>&krusader; may not be compatible with ACE despite our
1788       best efforts. Unace uses closed source and contains
1789       additional lines that make Unace get into infinite loop if
1790       the stdin is redirected to somewhere else. It works in the
1791       same manner as 'su', where you cannot enter the password only
1792       from the stdin. &krusader; &gt;= 1-51
1793       emulates the command line environment to enable co-operation
1794       with Unace, but we have noticed that Unace always changes its
1795       output format from release to release, making co-operation
1796       almost impossible.</para>
1797     </note>
1798     <para>
1799       <emphasis role="bold">Checksum Utilities tab</emphasis>
1800     </para>
1801     <para>Here you can configure the full path of the following
1802     external
1803     <link linkend="checksum">Checksum Utilities</link>:
1804     <informaltable>
1805       <tgroup cols="3">
1806         <tbody>
1807           <row>
1808             <entry>Checksum Utilities</entry>
1809             <entry>configurable full path</entry>
1810             <entry>supported checksums</entry>
1811           </row>
1812           <row>
1813             <entry>
1814               <para>
1815                 <command>md5sum</command>
1816               </para>
1817             </entry>
1818             <entry>
1819               <para>
1820                 <filename class="directory">
1821                   <replaceable>/usr/bin/md5sum</replaceable>
1822                 </filename>
1823               </para>
1824             </entry>
1825             <entry>
1826               <para>md5</para>
1827             </entry>
1828           </row>
1829           <row>
1830             <entry>
1831               <para>
1832                 <command>sha1sum</command>
1833               </para>
1834             </entry>
1835             <entry>
1836               <para>
1837                 <filename class="directory">
1838                   <replaceable>/usr/bin/sha1sum</replaceable>
1839                 </filename>
1840               </para>
1841             </entry>
1842             <entry>
1843               <para>sha1</para>
1844             </entry>
1845           </row>
1846           <row>
1847             <entry>
1848               <para>
1849                 <command>md5deep</command>
1850               </para>
1851             </entry>
1852             <entry>
1853               <para>
1854                 <filename class="directory">
1855                   <replaceable>/usr/bin/md5deep</replaceable>
1856                 </filename>
1857               </para>
1858             </entry>
1859             <entry>
1860               <para>md5</para>
1861             </entry>
1862           </row>
1863           <row>
1864             <entry>
1865               <para>
1866                 <command>sha1deep</command>
1867               </para>
1868             </entry>
1869             <entry>
1870               <para>
1871                 <filename class="directory">
1872                   <replaceable>/usr/bin/sha1deep</replaceable>
1873                 </filename>
1874               </para>
1875             </entry>
1876             <entry>
1877               <para>sha1</para>
1878             </entry>
1879           </row>
1880           <row>
1881             <entry>
1882               <para>
1883                 <command>sha224sum</command>
1884               </para>
1885             </entry>
1886             <entry>
1887               <para>
1888                 <filename class="directory">
1889                   <replaceable>/usr/bin/sha224sum</replaceable>
1890                 </filename>
1891               </para>
1892             </entry>
1893             <entry>
1894               <para>sha224</para>
1895             </entry>
1896           </row>
1897           <row>
1898             <entry>
1899               <para>
1900                 <command>sha256sum</command>
1901               </para>
1902             </entry>
1903             <entry>
1904               <para>
1905                 <filename class="directory">
1906                   <replaceable>/usr/bin/sha256sum</replaceable>
1907                 </filename>
1908               </para>
1909             </entry>
1910             <entry>
1911               <para>sha256</para>
1912             </entry>
1913           </row>
1914           <row>
1915             <entry>
1916               <para>
1917                 <command>sha256deep</command>
1918               </para>
1919             </entry>
1920             <entry>
1921               <para>
1922                 <filename class="directory">
1923                   <replaceable>/usr/bin/sha256deep</replaceable>
1924                 </filename>
1925               </para>
1926             </entry>
1927             <entry>
1928               <para>sha256</para>
1929             </entry>
1930           </row>
1931           <row>
1932             <entry>
1933               <para>
1934                 <command>sha384sum</command>
1935               </para>
1936             </entry>
1937             <entry>
1938               <para>
1939                 <filename class="directory">
1940                   <replaceable>/usr/bin/sha384sum</replaceable>
1941                 </filename>
1942               </para>
1943             </entry>
1944             <entry>
1945               <para>sha384</para>
1946             </entry>
1947           </row>
1948           <row>
1949             <entry>
1950               <para>
1951                 <command>sha512sum</command>
1952               </para>
1953             </entry>
1954             <entry>
1955               <para>
1956                 <filename class="directory">
1957                   <replaceable>/usr/bin/sha512sum</replaceable>
1958                 </filename>
1959               </para>
1960             </entry>
1961             <entry>
1962               <para>sha512</para>
1963             </entry>
1964           </row>
1965           <row>
1966             <entry>
1967               <para>
1968                 <command>tigerdeep</command>
1969               </para>
1970             </entry>
1971             <entry>
1972               <para>
1973                 <filename class="directory">
1974                   <replaceable>/usr/bin/tigerdeep</replaceable>
1975                 </filename>
1976               </para>
1977             </entry>
1978             <entry>
1979               <para>tiger</para>
1980             </entry>
1981           </row>
1982           <row>
1983             <entry>
1984               <para>
1985                 <command>whirlpooldeep</command>
1986               </para>
1987             </entry>
1988             <entry>
1989               <para>
1990                 <filename class="directory">
1991                   <replaceable>/usr/bin/whirlpooldeep</replaceable>
1992                 </filename>
1993               </para>
1994             </entry>
1995             <entry>
1996               <para>whirlpool</para>
1997             </entry>
1998           </row>
1999           <row>
2000             <entry>
2001               <para>
2002                 <command>cfv</command>
2003               </para>
2004             </entry>
2005             <entry>
2006               <para>
2007                 <filename class="directory">
2008                   <replaceable>/usr/bin/cfv</replaceable>
2009                 </filename>
2010               </para>
2011             </entry>
2012             <entry>
2013               <para>md5, sha1, sfv, crc</para>
2014             </entry>
2015           </row>
2016         </tbody>
2017       </tgroup>
2018     </informaltable></para>
2019   </sect1>
2020   <sect1 id="konfig-useractions">
2021     <title>UserActions</title>
2022     <para>Here you can configure the terminal for UserActions and
2023     the font for the output-collection. The default terminal is
2024     <command>konsole --noclose -e</command>. To set up, configure
2025     and manage your UserActions use ActionMan
2026     (<link linkend="useractions">UserActions</link> &URL;).</para>
2027 
2028   </sect1>
2029   <sect1 id="konfig-protocols">
2030     <title>Protocols</title>
2031     <para>This page links the &MIME;s to protocols. &eg;
2032     protocol <quote>tar</quote> is linked to &MIME; <quote>application/x-tar</quote>.</para>
2033 
2034     <para>In the
2035     <guilabel>Links</guilabel> you will see &eg;
2036     <itemizedlist>
2037       <listitem>
2038         <para>Iso</para>
2039         <itemizedlist>
2040           <listitem>
2041             <para>application/x-iso</para>
2042           </listitem>
2043         </itemizedlist>
2044       </listitem>
2045       <listitem>
2046         <para>krarc</para>
2047         <itemizedlist>
2048           <listitem>
2049             <para>application/x-ace</para>
2050           </listitem>
2051           <listitem>
2052             <para>application/x-arj</para>
2053           </listitem>
2054           <listitem>
2055             <para>application/x-bzip2</para>
2056           </listitem>
2057           <listitem>
2058             <para>application/x-cpio</para>
2059           </listitem>
2060           <listitem>
2061             <para>application/x-deb</para>
2062           </listitem>
2063           <listitem>
2064             <para>application/x-debian-package</para>
2065           </listitem>
2066           <listitem>
2067             <para>application/x-gzip</para>
2068           </listitem>
2069           <listitem>
2070             <para>application/x-jar</para>
2071           </listitem>
2072           <listitem>
2073             <para>application/x-lha</para>
2074           </listitem>
2075           <listitem>
2076             <para>application/x-rar</para>
2077           </listitem>
2078           <listitem>
2079             <para>application/x-rpm</para>
2080           </listitem>
2081           <listitem>
2082             <para>application/x-zip</para>
2083           </listitem>
2084         </itemizedlist>
2085       </listitem>
2086       <listitem>
2087         <para>tar</para>
2088         <itemizedlist>
2089           <listitem>
2090             <para>application/x-tar</para>
2091           </listitem>
2092           <listitem>
2093             <para>application/x-tarz</para>
2094           </listitem>
2095           <listitem>
2096             <para>application/x-tbz</para>
2097           </listitem>
2098           <listitem>
2099             <para>application/x-tgz</para>
2100           </listitem>
2101         </itemizedlist>
2102       </listitem>
2103     </itemizedlist></para>
2104   </sect1>
2105 </chapter>