<chapter id="basic-functions">
  <!-- **********************************************************************
                            using-krusader.docbook
                          +++++++++++++++++++++++++++
  copyright            : (C) 2000 - 2009
                          Rafi Yanai, Shie Erlich, Frank Schoolmeesters
                          & the Krusader Krew
  e-mail               : krusader@users.sourceforge.net
  web site             : http://www.krusader.org
  description          : a Krusader Documentation File

***************************************************************************
* Permission is granted to copy, distribute and/or modify this            *
* document under the terms of the GNU Free Documentation License,         *
* Version 1.1 or any later version published by the Free Software         *
* Foundation; with no Invariant Sections, no Front-Cover Texts and        *
* no Back-Cover Texts.  A copy of the license is available on the         *
* GNU site http://www.gnu.org/licenses/fdl.html or by writing to:         *
* Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,    *
* MA 02111-1307, USA.                                                     *
*********************************************************************** -->
  <title>Basic Functions</title>
  <sect1 id="controls">
    <title>Controls</title>
    <sect2 id="control-general">
      <title>General</title>
      <para>This is a rather short but important section that will
      go into the details of controlling &krusader;.
      This section does not try to cover all the various key
      combinations for two reasons: 
      <orderedlist numeration="arabic">
        <listitem>
          <para>there are just too many of them</para>
        </listitem>
        <listitem>
          <para>most of &krusader; actions are
          configurable in the
          <link linkend="konfig-looknfeel">Konfigurator Look &amp; Feel page</link></para>
        </listitem>
      </orderedlist>We will only mention the most important
      keyboard shortcuts with the default configuration, but keep
      in mind that most of the <link linkend="key_bindings">Key-Bindings</link> are
      configurable. If you find that you use a certain command a
      lot and want to know the shortcut for this command, or you
      want to change this command shortcut, then check out the
      <link linkend="key_bindings">Key-Bindings</link> tab at the
      <link linkend="konfig-looknfeel">Konfigurator Look &amp; Feel page</link>.</para>
    </sect2>
    <sect2 id="moving-around">
      <title>Moving Around</title>
      <para>By Moving Around we mean the transfer of the keyboard
      and mouse focus between the different parts of the
      &krusader; 
      <link linkend="mainwindow">main window</link>. The focus can
      be in one of five places: the Left or Right Panel, the Menu
      Bar, the Command Line or the Terminal Emulator. The panel
      that has the focus is called the Active Panel. An Active
      Panel will remain active until the other panel receives the
      focus (i.e.: if the Left Panel was active and you
      clicked on the Command Line - then the Left Panel remains the
      Active Panel). You must deliberately change which panel is
      active.</para>
      <para>The most common way to transfer the focus to a specific
      panel is to use the mouse to click on that panel. But you
      should be aware of the following: 
      <itemizedlist>
        <listitem>
          <para>Clicking on the Toolbar, the FN keys bar or the
          Status Bar does *not* change the focus.</para>
        </listitem>
        <!--
   Quick View Panel: old Krusader feature , removed since krusader-1.12-beta1      
   <listitem>
     <para>The display part of the Quick View Panel does not accept clicks so you should click on the
           Location Toolbar of this panel if you want it to have focus.</para>
   </listitem>
-->
        <listitem>
          <para>Pushing the 
          <guibutton>"History"</guibutton> or the 
          <guibutton>"Run in Terminal"</guibutton> buttons in the
          Command Line will not transfer the focus, so you have to
          click inside the Input Line.</para>
        </listitem>
        <listitem>
          <para>When you choose a menu, the Menu Bar will become
          focused. It remains focused until you choose a command -
          the focus returns to the previous owner.</para>
        </listitem>
      </itemizedlist></para>
      <para>There are, of course, ways to use the keyboard to
      change the focus: 
      <itemizedlist>
        <listitem>
          <para>The &Tab; Key will switch panels, if one
          of the panels has the focus or rotate between all the
          commands in a menu, if the Menu Bar is active.</para>
        </listitem>
        <listitem>
          <para>The 
          <keycombo action="simul">&Ctrl;
          <keycap>Down Arrow</keycap></keycombo> will take you from
          the Active Panel to the Command Line or Terminal
          Emulator, and the 
          <keycombo action="simul">&Ctrl;
          <keycap>Up Arrow</keycap></keycombo> will take you back
          from the Command Line to the Active Panel.</para>
        </listitem>
        <listitem>
          <para>The <keycap>Esc</keycap> Key will make the Menu Bar
          return the focus, if it has it, to the previous Active
          Panel.</para>
        </listitem>
        <listitem>
          <para>If you happen to be inside the Terminal Emulator,
          you can use the &Tab; Key, or the mouse, to
          navigate to an Active Panel.</para>
        </listitem>
        <listitem>
          <para>Pressing 
          <keycombo action="simul">&Alt;
          <keycap>"Underlined Letter"</keycap></keycombo> from the
          Menu Bar will open that menu (unless this key combination
          is a "Reserved Key", used by one of
          &krusader;'s actions).</para>
        </listitem>
      </itemizedlist></para>
    </sect2>
    <sect2 id="selecting-files">
      <title>Selecting</title>
      <note>
        <para>&krusader; offers 4
        <link linkend="mouse_selection_modes">Mouse Selection Modes</link>, only
        &krusader;'s Mouse Selection Mode is explained
        here.</para>
      </note>
      <para>Selecting is a skill you need to master in order to get
      the most out of &krusader;. Since you can not select
      files in the Quick View Panel, and the Tree Panel only lets
      you select one directory at a time, this paragraph mainly
      explains how to select files in the List Panel
      filelist.</para>
      <para>Moving the cursor is easy. Left-clicking on a file or
      directory (referred to herein as "elements" meaning files AND
      directories) will select it. Here are some useful pointers
      that will make &krusader; even easier to use (assuming you are
      using &krusader;'s Mouse Selection Mode): 
      <itemizedlist>
        <listitem>
          <para>The 
          <keycap>SPACE</keycap> and 
          <keycap>Insert</keycap> key will toggle the selection of
          the file under the cursor without affecting the selection
          of other files/directories, the cursor will go one
          position down.</para>
        </listitem>
        <listitem>
          <para>Pressing the 
          <keycap>SPACE</keycap> on a Directory under the cursor
          will 
          <link linkend="calculate">calculate occupied
          space</link> without affecting the selection of other
          files/directories.</para>
        </listitem>
        <listitem>
          <para>
          <keycap>Left Clicking</keycap> on a file will select, or
          unselect, all previously selected files.</para>
        </listitem>
        <listitem>
          <para>
          <keycombo action="simul">&Ctrl;
          <keycap>Left Clicking</keycap></keycombo> will toggle the
          selection of the file under the cursor without affecting
          the selection of other files/directories.</para>
        </listitem>
        <listitem>
          <para>
          <keycombo action="simul"><keycap>Backspace</keycap>
          <keycap>Left Clicking</keycap></keycombo> will select all
          the elements between the previous cursor location and the
          new one.</para>
        </listitem>
        <listitem>
          <para>
          <keycombo action="simul"><keycap>Backspace</keycap>
          <keycap>Home</keycap></keycombo> selects everything above
          the cursor (and deselects everything below the cursor, if
          selected).</para>
        </listitem>
        <listitem>
          <para>
          <keycombo action="simul"><keycap>Backspace</keycap>
          <keycap>End</keycap></keycombo> selects everything below
          the cursor (and unselects everything above the cursor, if
          selected).</para>
        </listitem>
        <listitem>
          <para>The ".." entry is not selectable.</para>
        </listitem>
        <listitem>
          <para>The <link linkend="edit-menu">Edit menu</link> can offer more ways
          to select your files.</para>
        </listitem>
      </itemizedlist></para>
    </sect2>
    <sect2 id="executing_commands">
      <title>Executing Commands</title>
      <para>There is not a lot to say here, all you need to do is
      select some files (if you do not, &krusader; will
      operate on the file(s) or directory(s) that have the focus),
      choose a 
      <link linkend="menu-commands">Command</link> from the Menu Bar
      or use a Keyboard Shortcut (or the Right Click Menu) and the
      selected Command executes. See also 
      <link linkend="executing_files">Executing
      Files</link>.</para>
    </sect2>
    <sect2 id="quicksearch">
      <title>Quicksearch</title>
      <!-- Thanks to Heiner Eichmann -->
      <para>This feature will do a quick search for the file name
      in the Active List Panel.</para>
      <para>Type 
      <keycap>foo</keycap>(one character) to do a quick search in
      the Active List Panel for a file beginning with "foo". A
      small quick search dialog box will open below the Active List
      Panel. Type the first few characters of the desired file name
      (more than one character allowed), the cursor will jump to
      that filename (if it exists), e.g. type "ab" to
      search for a file which begins with "ab". The 
      <keycap>Up/Down Arrow</keycap>will jump to the next or
      previous match. <keycap>Esc</keycap> will close the quick search
      line. The cursor will stay on the last file
      found.</para>
      <note>
        <para>If you press 
        <keycombo action="simul">&Alt;
        <keycap>foo</keycap></keycombo>, the key binding shortcut
        will be executed. If there is no configured key binding,
        the remaining letter 
        <keycap>foo</keycap>will be used for the quick
        search.</para>
      </note>
      <para>Use <link linkend="konfig-looknfeel">Konfigurator Look &amp; Feel page</link> to change from
      the default configuration.</para>
    </sect2>
    <sect2 id="context-menu">
      <title>Context Menu</title>
      <para>&krusader; has many Context menus that allow
      you to do fast operations with the mouse, usually a
      right-click will open the Context menu (depending on your
      <link linkend="mouse_selection_modes">Mouse Selection Modes</link> settings). This list
      gives an overview of the most important context menus. Use
      them to discover the available commands. 
      <itemizedlist>
        <listitem>
          <para><link linkend="mainwindow">Main Toolbar</link> (orientation, text
          position, icon size)</para>
        </listitem>
        <listitem>
          <para><link linkend="list_panel">List Panel</link> on a file or
          directory</para>
        </listitem>
        <listitem>
          <para><link linkend="cmdline">Command Line</link> (undo, paste, text
          completion...)</para>
        </listitem>
        <listitem>
          <para><link linkend="termemu">Terminal emulator</link> (send signal, font,
          history...)</para>
        </listitem>
        <listitem>
          <para><link linkend="folder-tabs">Folder tabs</link> (new, duplicate,
          close)</para>
        </listitem>
        <listitem>
          <para>
          <link linkend="krusearcher">KruSearcher</link> Search
          results file list (F3 View, F4 Edit)</para>
        </listitem>
        <listitem>
          <para><link linkend="mount-man">MountMan</link> (unmount,
          format...)</para>
        </listitem>
        <listitem>
          <para><link linkend="synchronizer">Synchronize Directories</link> File List</para>
        </listitem>
        <listitem>
          <para><link linkend="useractions">UserActions</link></para>
        </listitem>
        <listitem>
          <para>&konqueror; Right-Click actions are
          shown in &krusader;</para>
        </listitem>
        <listitem>
          <para>Show/hide 
          <link linkend="list_panel">Column Headers</link></para>
        </listitem>
        <listitem>
          <para><link linkend="bookman">Bookmarks</link> enable/disable permanent
          bookmarks</para>
        </listitem>
        <listitem>
          <para>...</para>
        </listitem>
      </itemizedlist></para>
    </sect2>
  </sect1>
  <sect1 id="basic">
    <title>Basic File Management</title>
    <sect2 id="executing_files">
      <title>Executing Files</title>
      <para>You can only execute files in the Active List Panel. To
      <keycap>execute</keycap> a file just 
      <keycap>(double-)click on it or press Enter</keycap> when it
      is under the list cursor. &krusader; will open it
      in the default application for this file type (picture,
      text file...) or the file will be executed (script,
      binary...). If you want to use 
      <keycap>another application</keycap> to open the file, 
      <keycap>Right-Click</keycap> on the file and go to the "open
      with" sub-menu which will offer more options.
      &krusader; is compatible with &kde;
      default file manager for all file types except archives that
      are opened inside the &krusader; panel and not in
      an external application. See 
      <link linkend="konfig-archives">the archives page in
      Konfigurator</link>for details.</para>
    </sect2>
    <sect2 id="copying">
      <title>Copying and Moving</title>
      <para>To copy or move files/directories just select them and
      press 
      <keycap>F5</keycap> to 
      <keycap>copy</keycap> or 
      <keycap>F6</keycap> to 
      <keycap>move</keycap> them. If the 
      <guimenuitem> Preserve attributes (only on local
      targets)</guimenuitem> option is checked,
      &krusader; will try to preserve all attributes
      (time, owner, group) of the local files according to the
      source depending on your permissions: 
      <itemizedlist>
        <listitem>
          <para>User preserving if you are root</para>
        </listitem>
        <listitem>
          <para>Group preserving if you are root or member of the
          group</para>
        </listitem>
        <listitem>
          <para>Preserving the timestamp</para>
        </listitem>
      </itemizedlist>Using this option may slow down the copy/move
      process. A dialog will appear and allow you to choose the
      operation destination. The default destination is the
      other-panel browsed directory. If you enter a partial
      &URL;, &krusader; will use the current
      panel directory as the &URL; base.</para>
    </sect2>
    <sect2 id="queue">
      <title>Queue manager</title>
      <para>
      Use <keycap>F5</keycap> (copy) or <keycap>F6</keycap> (move) and than <keycap>F2</keycap> to use it.
      Or the direct shortcuts: copy by queue <keycombo action="simul"><keycap>Backspace</keycap><keycap>F5</keycap></keycombo> , 
      move by queue <keycombo action="simul"><keycap>Backspace</keycap><keycap>F6</keycap></keycombo> .
      Queueing is used for one-by-one copying.
      E.g. if you have a pen drive (which is slow), and you want to copy 40 files onto it, 
      it's much better copying them one-by-one instead of starting to copy 40 files parallelly.
      That's why enqueuing is important.
      If you pack/unpack 40 files parallelly, you overload your computer,
      but adding them to a queue (which is not yet implemented into Krusader), is much more useful.
      </para>
    </sect2>
    <sect2 id="deleting">
      <title>Deleting</title>
      <para>Deleting files/directories is done by selecting them
      and pressing 
      <keycap>F8</keycap> or 
      <keycap>Delete</keycap>. By 
      <link linkend="konfig-general">default</link> it will be moved
      to &kde;'s Trash. You can open the KDE Trash with <filename>trash:/</filename> ("kdebase3-runtime" needs to be installed, otherwise the KDE trash protocol will not work).
      Phisically KDE Trash is located in <filename>~/.local/share/Trash/</filename> .  
      <keycombo action="simul"><keycap>Backspace</keycap>
      <keycap>Delete</keycap></keycombo> will delete the file
      permanently. A dialog will ask for your confirmation and will
      warn you when deleting non-empty directories. Of course only
      operations that you are permitted to do by the Operating
      System will be performed - you will be notified otherwise. If
      you do not wish to see the confirmation dialogs, you can
      disable them in the 
      <link linkend="konfig-advanced">Konfigurator advanced
      tab</link>.</para>
    </sect2>
    <sect2 id="shred">
      <title>Shred Files</title>
      <para>Shred was removed from KDE4 (and as consequence Krusader-2 for KDE4).
           The main reason is probably that shredding is filesystem dependent and even if you overwrite the file 100 times, it's not sure, that it'll be deleted from the disk finally.
           Quote from the kgpg posts: "The shred feature has been removed from the KDE library. Kgpg will not support this feature anymore. Moderns file systems use journalisation. So the shred feature should be implemented in the file system. Not in kgpg."
           But you might use a proper shred <link linkend="useractions">UserAction</link> for your filesystem.
	   But keep in mind that if you want to be 100% shure that it's impossible that someone can read a deleted file, you need to destroy your harddrive hardware ...
	   </para>
    </sect2>
    <sect2 id="renaming">
      <title>Renaming Files, Creating Directories and Link
      Handling</title>
      <para>
      <keycap>Rename</keycap> the file under the cursor with the 
      <keycap>F9</keycap> key or with two single mouse clicks. If
      only the file name needs to be renamed and not the extension,
      you can configure this in the
      <link linkend="konfig-looknfeel">Konfigurator Look &amp; Feel page</link>. 
      <keycap>Create a new directory</keycap> with the 
      <keycap>F7</keycap> key. 
      <keycap>Right-clicking on a regular file</keycap> will give
      you the 
      <keycap>option "New Symlink"</keycap>. A dialog will prompt
      you to enter a symlink name. That name will point to the
      file/directory you Right-Clicked on. If the file you
      Right-Clicked on is a symlink, you will also be presented
      with the "redirect link" option that will allow you to change
      the link target.</para>
    </sect2>
    <sect2 id="viewing">
      <title>Viewing and Editing files</title>
      <para>
      <link linkend="krviewer">KrViewer</link> has a chapter of its
      own.</para>
    </sect2>
  </sect1>

<!-- call the archives sect1 section -->
&archives;

</chapter>
