<chapter id="krusader-tools">
<!-- **********************************************************************
                            krusader-tools.sgml
                          +++++++++++++++++++++++
  copyright            : (C) 2000, 2001, 2002, 2003, 2004
                          Rafi Yanai, Shie Erlich, Frank Schoolmeesters
                          & the Krusader Krew
  e-mail               : krusader@users.sourceforge.net
  web site             : http://krusader.sourceforge.net
  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>&krusader; Tools</title>
<sect1 id = "remote-man">
	<title>RemoteMan: the &FTP;/SMB connection manager</title>
	<screenshot>
	 	<screeninfo>RemoteMan</screeninfo>
		<mediaobject>
		<imageobject><imagedata fileref="remoteman.png" format="PNG"/></imageobject>
		<imageobject><imagedata fileref="remoteman.eps" format="EPS"/></imageobject>
		<textobject><phrase>RemoteMan</phrase></textobject>
		<caption><para>RemoteMan.</para></caption>
		</mediaobject>
	</screenshot>
        <para><emphasis role="bold">
              Important: RemoteMan has been replaced by our new bookmark manager since Krusader 1.25-beta1.
                         The new manager handles local files and remote &URL;'s the same way.
                         RemoteMan is being left around to allow an easier transition and
                         give you a chance to move your bookmarks. IT WILL BE REMOVED SOON!</emphasis></para>

                 <para>Try the new bookmark-manager: open a new remote connection. once
                       done, press the <guibutton>"Bookmark"</guibutton> button, select
                       <guimenuitem>"Add bookmark"</guimenuitem> and that's it!
      </para>
      <para>
	RemoteMan is a central place for all your &FTP;/SMB needs. It is a tree-like list of remote locations
	each with its own username and password. You can create new "folders" (or groups) in the tree and place
	remote sessions inside these groups. Each session includes a name (something that best describes the &URL;)
	and a host. A hostname is a &URL; which can begin with 'ftp://' or 'smb://'. Additional information that
	can be filled is the username and password. Not filling these values will trigger an anonymous login. You
	can also click the 'anonymous' checkbox, which will force an anonymous login. One can also decide on a
	different port - or keep the default (port 21). If you choose a 'smb://' host, you cannot change the port.
	Optional are the description (a freetext area) and remote directory. If you enter a remote directory,
	&krusader; will try, upon connection, to cd into that directory.</para>
	<itemizedlist>
		<listitem><para><keycap>Double clicking</keycap> on a session makes &krusader; connect to that host.
		   You can also use the <guibutton>"Connect"</guibutton> button for that purpose.</para></listitem>
		<listitem><para>The <guibutton>"More"</guibutton> button does nothing for now. We keep some tricks for &krusader;
		   2.</para></listitem>
	</itemizedlist>
</sect1>

<sect1 id = "mount-man">
	<title>MountMan: handle your mounted filesystems</title>
	<screenshot>
		<screeninfo>MountMan</screeninfo>
		<mediaobject>
		<imageobject><imagedata fileref="mountman.png" format="PNG"/></imageobject>
		<imageobject><imagedata fileref="mountman.eps" format="EPS"/></imageobject>
		<textobject><phrase>MountMan</phrase></textobject>
		<caption><para>MountMan.</para></caption>
		</mediaobject>
	</screenshot>
	<para>MountMan is a tool which helps you manage your mounted filesystems. Once invoked, it displays
	a list of every mounted filesystem. For each filesystem, MountMan displays its name (which is the
	actual device name - &ie; /dev/fd0 for a floppy), its type (vfat, ext2 ...) and its mount-point
	(the directory on which the filesystem is mounted). MountMan also displays usage information using
	total size, free size and percentage free. If those numbers say "N/A", it usually means that the filesystem
	isn't mounted. Left clicking on a filesystem displays a pie chart on the left of the window, this
	graphically displays the usage information for the filesystem. Clicking on a non-mounted filesystem will
	display "not mounted" instead of the graph.</para>
	<itemizedlist>
		<listitem><para><keycap>Double clicking</keycap> on a filesystem will close MountMan and open
		that filesystem inside &krusader;'s active panel.</para></listitem>
		<listitem><para><keycap>Right clicking</keycap> on a filesystem will open a small menu which
		displays what actions can be performed on that filesystem. For now you can only mount, unmount and
		eject (if clicking on a removable filesystem - e.g. a cdrom).</para></listitem>
	</itemizedlist>
	<note><para>We plan to expand MountMan in the next evolution of &krusader;. It will be able to format floppies,
	edit <filename class="directory">/etc/fstab</filename>, create new filesystems and more...
	btw. we have started working on it, see "Quickmode for MountMan"</para></note>

<para><emphasis role="bold">Quickmode for MountMan</emphasis></para>

<note><para>This new feature will be the future MountMan, but for now it is still under development therefore unfinished. &hesbugreport_lnk;
            If you have a good idea, don&apos;t hesitate to send us
            <link linkend="faqq_wish_patch">User feedback</link>.</para></note>

<para>Quickmode for MountMan is only available on &kde; 3.2 - earlier versions will see no difference.</para>

<para>To activate Quickmode for MountMan, click AND HOLD the MountMan button on the &toolbar_lnk;</para>

<para>General idea: display a list of all possible mountpoints.
      Each time the menu is displayed, it determines if a mountpoint is mounted or not and associated the correct
      action (mount or umount). This offers a quick interface to MountMan. 
      It is working, and currently uses KMountMan::mount and unmount, we think that it can replace the "old"
      MountMan. It uses the new &kde; services for fstab-reading and this will enable us to remove A LOT of code
      from the "old" MountMan.</para>

</sect1>

<sect1 id = "bookman">
<title>BookMan: Organize your bookmarks</title>
	<note><para>Since &krusader; 1.25-beta1 there is a new BookMan and &krusader;'s bookmark manager to edit and
	organize your bookmarks has been replaced by &keditbookmarks;.</para></note>
	<para>BookMan is a tool which allows you to bookmark folders and &URL;'s using &krusader;, and later return to
	them in a click of a button. All you need to do is click on the <guibutton>"Bookmark"</guibutton> button.</para>
	<screenshot>
		<screeninfo>BookMan: the Bookmark menu</screeninfo>
		<mediaobject>
		<imageobject><imagedata fileref="bookmanadd.png" format="PNG"/></imageobject>
		<imageobject><imagedata fileref="bookmanadd.eps" format="EPS"/></imageobject>
		<textobject><phrase>BookMan: the Bookmark menu</phrase></textobject>
		<caption><para>BookMan: the Bookmark menu.</para></caption>
		</mediaobject>
	</screenshot>
	<para>Usually, you click on the <guibutton>"Bookmark"</guibutton> button when you're in the target folder. For example, to bookmark
	 '/usr/tmp', navigate &krusader; there and click the <guibutton>"Bookmark"</guibutton> button and select
	 <guimenuitem>"Add bookmarks"</guimenuitem>. When the <guilabel>"Add bookmarks"</guilabel> dialog box appears, the &URL; line will say '/usr/tmp'. The upper
	 line (Bookmark name) is for the name you would like to call the bookmark (for example: temporary folder). If you add the
	 bookmark without entering a name, the bookmarks name will be the same as its target. With the
	 <guimenuitem>"New Bookmark Folder..."</guimenuitem> item you can create a new bookmark folder.</para>
	<note><para>You can bookmark inside a remote filesystem (&FTP; or SAMBA) and later use the bookmark to quickly connect
	to the remote machine. You CANNOT bookmark inside an archive.</para></note>
	<para>To use your new bookmarks, click the <guibutton>"Bookmark"</guibutton> button and choose one - as shown in the picture above.
        You may also use the keyboard shortcut <keycap>Alt+right/left arrow</keycap> to <keycap>open right/left
        panel bookmarks list</keycap></para>
	<screenshot>
		<screeninfo>&keditbookmarks; edit and organize your Bookmarks</screeninfo>
		<mediaobject>
		<imageobject><imagedata fileref="bookmanedit.png" format="PNG"/></imageobject>
		<imageobject><imagedata fileref="bookmanedit.eps" format="EPS"/></imageobject>
		<textobject><phrase>&keditbookmarks; edit and organize your Bookmarks</phrase></textobject>
		<caption><para>&keditbookmarks;: edit and organize your Bookmarks.</para></caption>
		</mediaobject>
	</screenshot>
	<para>To edit and organize your bookmarks, click the <guibutton>"Bookmark"</guibutton> button and select
	<guimenuitem>"Edit bookmarks"</guimenuitem>, &keditbookmarks; will be displayed. 
	This is where you can edit/remove and re-arrange the bookmarks.
        &keditbookmarks; (part of the kdebase package) is a bookmark editor for &konqueror;, &krusader; and other
	applications, which use the &xbel_url; standard for the bookmark format. The bookmarks are stored in
	<filename class="directory">~/.kde/share/apps/krusader/krbookmarks.xml.</filename></para>
	<para>You can inport bookmarks from <application>IE</application>, <application>Opera</application>,
	<application>Galeon</application>, &kde;,
	<application>Mozilla</application>, &Netscape;.
        &keditbookmarks; is easy to use, please read the &keditbookmarks; or the &konqueror; handbook if you need more
	info.</para>
</sect1>

<sect1 id = "krusearcher">
<title>KruSearcher: find what you're looking for</title>
	<para>Welcome to &krusader;'s powerful search module - nicknamed Krusearcher. It is the most able
	tool (that we know of) for &Linux;, since it allows so many different ways to quickly find the file you're
	looking for. It is divided into two levels, the general and the advanced. Let's take a look at the general
	page ...</para>
	<screenshot>
		<screeninfo>Krusearcher General</screeninfo>
		<mediaobject>
		<imageobject><imagedata fileref="search_general.png" format="PNG"/></imageobject>
		<imageobject><imagedata fileref="search_general.eps" format="EPS"/></imageobject>
		<textobject><phrase>Krusearcher General</phrase></textobject>
		<caption><para>Krusearcher General.</para></caption>
		</mediaobject>
	</screenshot>
	<para>The page is divided into four parts: top (search for) part, bottom part - titled 'containing text',
	left part - titled 'search in' and right part which is called 'don't search in'. Obviously, each part
	handles different aspects of the search. Let's look at them closely.</para>
	<itemizedlist><title>Top Part:</title>
		<listitem><para><guilabel>"Search for"</guilabel>: here you enter the main search criteria.
		You can enter a filename, a wildcard (<literal role="extension">*.o.*</literal>,
		<literal role="extension">*.c</literal> &etc;) or both - separated by a space.
		</para></listitem>
		<listitem><para><guilabel>"Case sensitive"</guilabel>: unchecking it will allow lower and upper case
		search (&ie;: <literal role="extension">*.c</literal> interprets as <literal role="extension">*.c</literal>
		AND <literal role="extension">*.C</literal>).</para></listitem>
		<listitem><para><guilabel>"Of type"</guilabel>: this box lets you search for a file not only by its
		name, but also by its mimetype. For example, you can search for all the audio files whose name
		begins with B. Usually this option defaults to 'all files', but you can choose to search for
		archives, directories, images, text files, videos and audio files.</para></listitem>
	</itemizedlist>

	<itemizedlist><title>Left and Right Part:</title>
		<listitem><para><guilabel>"Search in"</guilabel> and <guilabel>"Don't search in"</guilabel>: Using those two parts,
		you can specify a search exactly the way you want it. For example, you might want to search for
		a file in the whole filesystem (beginning with /), but don't want to search inside /mnt. All you
		need to do is write '/' in the 'search in' box, and write '/mnt' in the 'dont search in' box.
		If you want to enter more than one directory in one of the boxes, just write the first name and
		press <keycap>Enter</keycap>. The directories name will be copied to the bigger box and you'll be
		 able to enter another name.
		<note><para>The input line has an auto completion feature, corrosponding to &kde;'s global settings.
		If you wish, you can click on the folder icon, and browse to the directory you wish to
		add.</para></note>
		</para></listitem>
	</itemizedlist>
	<itemizedlist><title>Bottom Part:</title>
		<listitem><para><guilabel>"Text"</guilabel>: entering text here makes &krusader; search for it inside the
		files (grep). That way, you can search for all header files (*.h) which include the word 'testing 123'
		inside them.</para></listitem>
		<listitem><para><guilabel>"Match whole word only"</guilabel></para></listitem>
		<listitem><para><guilabel>"Case sensitive"</guilabel>: refers to your text being searched for in upper
		and lower case or the exact phrase you entered.</para></listitem>
		<listitem><para><guilabel>"Search in subdirectories"</guilabel>: do a recursive search and dive into
		every directory on the way.</para></listitem>
		<listitem><para><guilabel>"Search in archives"</guilabel>: &krusader; will search for your files inside
		every supported archive. This, however, takes longer to perform.
		<note><para>If you check this checkbox, you'll notice you cannot 'grep' inside files anymore.
		This is done, since looking inside files which are archived, forces &krusader;
		to extract them, which will results in an extremely long search.</para></note></para></listitem>
		<listitem><para><guilabel>"Follow links"</guilabel>: if checked,  &krusader; will follow soft-links during
		the search.</para></listitem>
	</itemizedlist>

	<para>The above screenshot shows a search for all the files which end with c, cpp or h and include the
	       string 'testing 123'. &krusader; will search in /root, /opt, /bin and /usr, but not in /usr/lib and
	       /usr/share.</para>

	<para>Clicking the <guibutton>"Search"</guibutton> button starts the search and displays the results page.
	During the search, you may press the <guibutton>"Stop"</guibutton> button to stop the search. The close button
	is not operational during a search, so you must first stop the search and then <guibutton>"Close"</guibutton> the
	window. When a result is found, double clicking on it will make &krusader;'s active panel point to the found
	files - but will not close the search window, so you'll be able to click on a different result.</para>

	<para>Sometimes, you need to narrow your search even more. Krusearcher allows a much finer search, and
	for that, let's look at the advanced page...</para>

	<screenshot>
		<screeninfo>Krusearcher Advanced</screeninfo>
		<mediaobject>
		<imageobject><imagedata fileref="search_advanced.png" format="PNG"/></imageobject>
		<imageobject><imagedata fileref="search_advanced.eps" format="EPS"/></imageobject>
		<textobject><phrase>Krusearcher Advanced</phrase></textobject>
		<caption><para>Krusearcher Advanced.</para></caption>
		</mediaobject>
	</screenshot>
	<para>This screenshot shows a search for files which size is between 10KB and 150KB, which were modified
	between October 10th and November 1st. Which belong to any user in the 'ftp' group, and are readable and
	writeable by anyone in the 'ftp' group but only readable to the rest of the world.</para>
	<para>The advanced page is divided into three parts: size, date and ownership.</para>
	<para><guilabel>"Size"</guilabel></para>
	<para>Allows you to choose the size range of the file you're looking for. By checking the checkboxes, you can
	search for a file which is bigger than XXX bytes (or KB, MB), smaller than XXX bytes or, by checking both,
	search for a file which size is bigger than XXX but smaller than YYY.</para>
	<para><guilabel>"Date"</guilabel></para>
	<para>This part offers three different ways of defining a date criteria:
	<itemizedlist>
		<listitem><para><guilabel>"Modified between"</guilabel>: allows you to enter two dates. &krusader; will
		search for files with a modification date between the first date and the second one. If you only
		enter a date in the left box, you'll be searching for files older than that date. If you only enter
		a date in the right box, you'll be searching for files newer than that date.
		<note><para>You can click on the date icon (near the input boxes) to open a standard date window -
		which allows you to easily browse through the calender and search for the desired date. Clicking on a
		date will close the window and the date will appear in the input
		box.</para></note></para></listitem>
		<listitem><para><guilabel>"Not modified after"</guilabel>: choosing this option makes &krusader; search
		for files that were NOT modified after a given date, which is the same as searching for files older
		than that date.</para></listitem>
		<listitem><para><guilabel>"Modified in the last/not modified in the last"</guilabel>: in these input
		boxes, you enter not a date, but a number. This number represents days/weeks/months (as chosen in the
		near dropbox). Entering the number 5 in the upper input box, makes &krusader; search for files that were
		modified in the 5 days. Entering the number 2 in the lower input box makes &krusader; search for files
		that did NOT change in the last 2 days. The combination of both results in a search for files that were
		changed in the last 5 days, but NOT in the last 2 days.</para></listitem>
	</itemizedlist></para>
	<para><guilabel>"Ownership"</guilabel></para>
	<itemizedlist>
		<listitem><para><guilabel>"Belongs to user/group"</guilabel>: by checking each of the corresponding
		checkboxes, you can search for files which belong to a certain user and/or group. The dropbox lists
		all the user names and group names in the system, just choose one and go ahead.</para></listitem>
		<listitem><para><guilabel>"Permissions"</guilabel>: divided into owner, group and all - it allows you
		to choose certain permissions for the file. You can choose to specify permissions for the owner,
		group, all or any combination. The question mark (?) is a wildcard - which means that any permission
		is valid.</para></listitem>
	</itemizedlist>

	<note><para>To clarify, the screenshot above (the permissions part) describes a search for files
		that belong to any user in group 'ftp', are readable, writable but not executable to any user in
		the group, are readable but not writable or executable to the rest of the world and have unknown
		permissions to its owner.</para></note>

<para>Clicking on the <guibutton>"Search"</guibutton> button to start the search and opens the Results window.
       Here you can see the progress and the the results of the search action. If you want you can stop the current
       search action with the <guibutton>"Stop"</guibutton> button.
       In the result list select the file and use <keycap>F3</keycap>/<keycap>F4</keycap> to view/edit or use
       the right-click menu.
       When you click on a found item, the directory of the active panel will change if the selected item is not in
       the current panel directory. When you close the Krusearcher window, the selected item is selected in the
       active panel.</para>
</sect1>

<sect1 id = "krviewer">
<title>KrViewer: &krusader;'s internal viewer-editor</title>

<para>Pressing <keycap>enter</keycap> on a selected file <emphasis>opens the file with the associated
      application</emphasis>.</para>

<sect2 id = "krview">
<title>Viewer</title>

  <para>To view a file as fast as possible according to it's type just put it under
	the cursor and press <keycap>F3</keycap>.
	&krusader;'s internal viewer is actually a &konqueror; part, which can basically view every
	file type viewable by &konqueror; (&eg; display pictures, play music, show the content of an
	archive), this is called the 'Generic viewer'.</para>

  <para>The viewer works as follows:
      <itemizedlist>
	<listitem><para>It will try to view the file with the <emphasis>'Generic viewer'.</emphasis>
	          </para></listitem>
	<listitem><para>When the file type cannot be determined or when a file (&eg; a binary)
		        doesn't have a associated action, it disables the 'generic viewer'.
		        The file will be treated as a text file, this is the <emphasis>'Text viewer'</emphasis>.
		  </para></listitem>
	<listitem><para>The user can change in the
	                <link linkend="kredit_krviewer_menu">KrViewer menu</link> between:
	                'Generic viewer' (if available), 'Text viewer' and <emphasis>'Hex viewer'</emphasis>.
	          </para></listitem>
      </itemizedlist>
  </para>

  <para><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo> views a &URL; on demand, &eg;:
      <itemizedlist>
	<listitem><para>
	<userinput><command>man:/</command></userinput> views the manpages.
        </para></listitem>
	<listitem><para>
	<userinput><command>man:/</command><replaceable>krusader</replaceable></userinput> views a manpage.
	&eg; <ulink url="http://krusader.sourceforge.net/handbook/kru_manpage.html">&krusader;'s manpage</ulink>
	"saved as" html page with the viewer.
	            </para></listitem>
	<listitem><para>
	<userinput><command>info:/</command></userinput> views the infopages.
        </para></listitem>
	<listitem><para>
	<userinput><command>http://</command><replaceable>krusader.sourceforce.net/</replaceable></userinput>
	             views a webpage.
		  </para></listitem>
	<listitem><para>
	<userinput><command>ftp://</command><replaceable>ftp.kde.org/pub/kde/</replaceable></userinput>
	             views a ftp-server.
	          </para></listitem>
	<listitem><para>
	<userinput><command>sftp://</command><replaceable>sftp.foo/</replaceable></userinput>
	             views a secure ftp-server.
	          </para></listitem>
	<listitem><para>
	<userinput><command>file:/</command><replaceable>home/frank</replaceable></userinput>
	             views the homedirectory of Frank.
	</para></listitem>
	<listitem><para>
	<userinput><replaceable>/home/frank/archive.tar.gz</replaceable></userinput>
	             views a tar.gz archive.
	</para></listitem>
      </itemizedlist>
  </para>

  <para>KrViewer can have the following menu's:
        <link linkend="kredit_file_menu">File</link>,
        <link linkend="kredit_edit_menu">Edit</link>,
        <link linkend="kredit_view_menu">View</link>,
        <link linkend="kredit_settings_menu">Settings</link> and
        <link linkend="kredit_krviewer_menu">Krviewer</link>,
        depending on which file type is viewed. They will be discussed in the
        <link linkend="kredit">Editor section</link>.
	The internal viewer can follow links on HTML pages.
	With <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> the viewer will
	start &krusader;'s internal editor (which is basically the same application).
  </para>

  <note><para>The embedded viewer is not written by us, it is supplied via &kde; (libs) and &kioslave_url;
        We cannot and don't want to change it, usings these libraries reduces the amount of written code.
	So we don't have to reinvent the weel ;-)</para></note>
</sect2>

<sect2 id="kredit">
<title>Editor</title>

  <para>&krusader;'s internal editor has almost everything what you can expect of an editor.
        Editing is similar to viewing but with the <keycap>F4</keycap> key.
        The default editor is &krusader;'s internal editor. You can change the used
	editor in the &konfiggereral_lnk;, if you prefer to use an external editor.</para>

   <tip><para>When you use &krusader;'s internal editor for the first time,
               It is recommended to look at each section of the
               <link linkend="kredit_settings_menu">Settings</link> menu, and configure it the way you want it.
	       </para></tip>

</sect2>

<sect2 id="kredit_menus">
<title>Menu overview</title>
<para>Most of the menus are pretty self-explanatory. ;-)</para>

<variablelist id="kredit_file_menu"><title><guimenu>File</guimenu> menu</title>
   <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
   <guimenu>File</guimenu>
   <guimenuitem>Save</guimenuitem></menuchoice></term>
   <listitem>
   <para>Save file.</para>
   </listitem>
  </varlistentry>

   <varlistentry>
   <term>
   <menuchoice>
   <guimenu>File</guimenu>
   <guimenuitem>Save As</guimenuitem></menuchoice></term>
   <listitem>
   <para>Save file with an other name.</para>
   </listitem>
  </varlistentry>

   <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycap>F5</keycap></shortcut>
   <guimenu>File</guimenu>
   <guimenuitem>Reload</guimenuitem></menuchoice></term>
   <listitem>
   <para>Reload file.</para>
   </listitem>
  </varlistentry>

   <varlistentry>
   <term>
   <menuchoice>
   <guimenu>File</guimenu>
   <guimenuitem>Export</guimenuitem></menuchoice></term>
   <listitem>
   <para>Export the file to html format.</para>
   </listitem>
  </varlistentry>

   <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
   <guimenu>Print</guimenu>
   <guimenuitem>Export</guimenuitem></menuchoice></term>
   <listitem>
   <para>Print the file.</para>
   </listitem>
  </varlistentry>
</variablelist>

<variablelist id="kredit_edit_menu"><title><guimenu>Edit</guimenu> menu</title>
  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Undo</guimenuitem></menuchoice></term>
   <listitem>
   <para>Undo last action.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Redo</guimenuitem></menuchoice></term>
   <listitem>
   <para>Redo last action.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Cut</guimenuitem></menuchoice></term>
   <listitem>
   <para>Cut selected text to clipboard.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Copy</guimenuitem></menuchoice></term>
   <listitem>
   <para>Copy selected text to clipboard.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Paste</guimenuitem></menuchoice></term>
   <listitem>
   <para>Paste clipboard content to the document.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Select All</guimenuitem></menuchoice></term>
   <listitem>
   <para>Select whole document.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Deselect</guimenuitem></menuchoice></term>
   <listitem>
   <para>Deselect current selection.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Toggle Block Selection</guimenuitem></menuchoice></term>
   <listitem>
   <para>Toggle Block Selection, this will activate/deactivate the block selection possibility.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Edit</guimenu>
   <guimenuitem>Toggle Insert</guimenuitem></menuchoice></term>
   <listitem>
   <para>Toggle Insert mode.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Find</guimenuitem></menuchoice></term>
   <listitem>
   <para>Find text.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul"><keycap>F3</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Find Next</guimenuitem></menuchoice></term>
   <listitem>
   <para>Find next text.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Find Previous</guimenuitem></menuchoice></term>
   <listitem>
   <para>Find previous text.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Replace</guimenuitem></menuchoice></term>
   <listitem>
   <para>Replace text.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut>
   <guimenu>Edit</guimenu>
   <guimenuitem>Go to line</guimenuitem></menuchoice></term>
   <listitem>
   <para>Go to given linenumber.</para>
   </listitem>
  </varlistentry>
</variablelist>

<variablelist id="kredit_view_menu"><title><guimenu>View</guimenu> menu</title>
  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycap>F12</keycap></shortcut>
   <guimenu>View</guimenu>
   <guimenuitem>Dynamic Word Wrap</guimenuitem></menuchoice></term>
   <listitem>
   <para>Go to the next line at the maximum number of characters per line (default 80).</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycap>F9</keycap></shortcut>
   <guimenu>View</guimenu>
   <guimenuitem>Show Folding Markers</guimenuitem></menuchoice></term>
   <listitem>
   <para>Show Folding Markers.</para>  <!-- TODO -->
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycap>F6</keycap></shortcut>
   <guimenu>View</guimenu>
   <guimenuitem>Show Icon Border</guimenuitem></menuchoice></term>
   <listitem>
   <para>Show Icon Border.</para>  <!-- TODO -->
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycap>F11</keycap></shortcut>
   <guimenu>View</guimenu>
   <guimenuitem>Show Line Numbers</guimenuitem></menuchoice></term>
   <listitem>
   <para>Shows the line numbers.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>View</guimenu>
   <guimenuitem>Set Encoding</guimenuitem></menuchoice></term>
   <listitem>
   <para>&eg; ISO8859-1, utf8, utf16, tscii, ... .</para>
   </listitem>
  </varlistentry>
</variablelist>

<variablelist id="kredit_bookmarks_menu"><title><guimenu>Bookmarks</guimenu> menu</title>
  <varlistentry>
   <term>                               <!-- TODO -->
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></shortcut>
   <guimenu>Bookmark</guimenu>
   <guimenuitem>Toggle Bookmark</guimenuitem></menuchoice></term>
   <listitem>
   <para>Toggle Bookmark.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Bookmark</guimenu>
   <guimenuitem>Clear Bookmarks</guimenuitem></menuchoice></term>
   <listitem>
   <para>Clear Bookmarks.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Alt;<keycap>PageDown</keycap></keycombo></shortcut>
   <guimenu>Bookmark</guimenu>
   <guimenuitem>Next Bookmark</guimenuitem></menuchoice></term>
   <listitem>
   <para>Go to the next Bookmark.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Alt;<keycap>PageUp</keycap></keycombo></shortcut>
   <guimenu>Bookmark</guimenu>
   <guimenuitem>Previous Bookmark</guimenuitem></menuchoice></term>
   <listitem>
   <para>Go to the previous Bookmark.</para>
   </listitem>
  </varlistentry>
</variablelist>

<variablelist id="kredit_tools_menu"><title><guimenu>Tools</guimenu> menu</title>
  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Tools</guimenu>
   <guimenuitem>Highlight mode</guimenuitem></menuchoice></term>
   <listitem>
   <para>Highlight mode for scripts, programming languages, markup file, &etc;: &eg; Bash, C++, XML, Makefile, Diff,
          ... .</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Tools</guimenu>
   <guimenuitem>End of Line</guimenuitem></menuchoice></term>
   <listitem>
   <para>Change the end of Line termination: &UNIX;, &Windows;/DOS,
         <trademark class="registered">Macintosh</trademark>.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></shortcut>
   <guimenu>Tools</guimenu>
   <guimenuitem>Indent</guimenuitem></menuchoice></term>
   <listitem>
   <para>Indent.</para> <!-- TODO-->
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>I</keycap></keycombo></shortcut>
   <guimenu>Tools</guimenu>
   <guimenuitem>Unindent</guimenuitem></menuchoice></term>
   <listitem>
   <para>Unindent.</para> <!-- TODO-->
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Tools</guimenu>
   <guimenuitem>Clean Indendation</guimenuitem></menuchoice></term>
   <listitem>
   <para>Clean Indendation.</para> <!-- TODO-->
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>#</keycap></keycombo></shortcut>
   <guimenu>Tools</guimenu>
   <guimenuitem>Comment</guimenuitem></menuchoice></term>
   <listitem>
   <para>Add appropriate comment tags, if available.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>#</keycap></keycombo></shortcut>
   <guimenu>Tools</guimenu>
   <guimenuitem>Uncomment</guimenuitem></menuchoice></term>
   <listitem>
   <para>Removes the comment tags on the left.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Tools</guimenu>
   <guimenuitem>Apply Word Wrap</guimenuitem></menuchoice></term>
   <listitem>
   <para>Apply Word Wrap.</para> <!-- TODO-->
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></shortcut>
   <guimenu>Tools</guimenu>
   <guimenuitem>Editing command</guimenuitem></menuchoice></term>
   <listitem>
   <para>Opens a dialog box for entering a editing command.</para> <!-- TODO-->
   </listitem>
  </varlistentry>
</variablelist>

<variablelist id="kredit_settings_menu"><title><guimenu>Settings -> Configure Editor</guimenu> menu</title>
  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>Colors</guimenuitem></menuchoice></term>
   <listitem>
   <para>Color configuration for the: background, selected text, current line and bracket highlighting.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>Fonts</guimenuitem></menuchoice></term>
   <listitem>
   <para>Fonts configuration for display and printer: font, font style and size, with a preview window.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>Identation</guimenuitem></menuchoice></term>
   <listitem>
   <para>Identation configuration: automaticly indent, use spaces to indent, tab keys indent,
          backspace keys indent, keep indent profile, keep extra spaces.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>Selection</guimenuitem></menuchoice></term>
   <listitem>
   <para>Selection configuration: persistent selections, overwrite selected text.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>Editing</guimenuitem></menuchoice></term>
   <listitem>
   <para>Editing configuration: word wrap config., witespace config., auto brackets, smart home,
          wrap cursor, maximum undo steps.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>Shortcuts</guimenuitem></menuchoice></term>
   <listitem>
   <para>Shortcuts configuration.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>Highlighting</guimenuitem></menuchoice></term>
   <listitem>
   <para>Highlighting configuration: default styles and highlight mode.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>View defaults</guimenuitem></menuchoice></term>
   <listitem>
   <para>View defaults: dynamic word wrap, show line numbers, show icon border, show folder markers if
          available, sort bookmarks menu method.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <guimenu>Settings</guimenu>
   <guimenuitem>Configure Editor</guimenuitem>
   <guimenuitem>Plugins</guimenuitem></menuchoice></term>
   <listitem>
   <para>Plugins configuration: &eg; kTexteditor incremental search plugin,
          kTexteditor insert file plugin, kTexteditor kdatatoolplugin...</para>
   </listitem>
  </varlistentry>
</variablelist>

<variablelist id="kredit_krviewer_menu"><title><guimenu>KrViewer</guimenu> menu</title>
  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut>
   <guimenu>KrViewer</guimenu>
   <guimenuitem>Generic viewer</guimenuitem></menuchoice></term>
   <listitem>
   <para>&krusader;'s internal viewer is actually part of Konqueror, which can basically view every file type
         viewable by &konqueror; (&eg; display pictures, play music, show the content of an archive).</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></shortcut>
   <guimenu>KrViewer</guimenu>
   <guimenuitem>Text viewer</guimenuitem></menuchoice></term>
   <listitem>
   <para>View the file in text mode.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut>
   <guimenu>KrViewer</guimenu>
   <guimenuitem>Hex viewer</guimenuitem></menuchoice></term>
   <listitem>
   <para>View the file in hex mode.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo></shortcut>
   <guimenu>KrViewer</guimenu>
   <guimenuitem>Text editor</guimenuitem></menuchoice></term>
   <listitem>
   <para>Edit the file in text mode.</para>
   </listitem>
  </varlistentry>

  <varlistentry>
   <term>
   <menuchoice>
   <shortcut><keycap>Esc</keycap></shortcut>
   <guimenu>KrViewer</guimenu>
   <guimenuitem>Close</guimenuitem></menuchoice></term>
   <listitem>
   <para>Closes &krusader;'s viewer/editor window.</para>
   </listitem>
  </varlistentry>
</variablelist>

</sect2>

</sect1>

<sect1 id="krusyncdir">
<title>KruSyncDir: Synchronize Directories</title>

<para>This function compares the left and the right panel directories and shows the difference between them.
      After selecting some options and the "compare" function you can synchronize the files and directories.
      One panel could be a &FTP; server. Don't forget the <guilabel>"compare by content"</guilabel> option
      if the file size stays equal.
      Choose <emphasis role="bold"><menuchoice><guimenu>Commands</guimenu>
      <guimenuitem>Synchronize Directories</guimenuitem></menuchoice></emphasis>
      or
      <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo> to start this feature.</para>

<!-- ONLY for parsing at HTML (at this moment)  krusyncdir.png sceenshot-->
<!--
<screenshot>
	 <screeninfo>KruSyncDir: Synchronize Directories</screeninfo>
	 <mediaobject>
         <imageobject><imagedata fileref="krusyncdir" format="PNG"/></imageobject>
         <imageobject><imagedata fileref="krusyncdir" format="EPS"/></imageobject>
         <textobject><phrase>KruSyncDir: Synchronize Directories</phrase></textobject>
         <caption><para>KruSyncDir: Synchronize Directories.</para></caption>
	 </mediaobject>
</screenshot>
-->

<para>
    <orderedlist><title>Procedure:</title>
    <listitem><para>Set the left and the right directory.</para>
              </listitem>
    <listitem><para>Configure the optional file filter.</para>
              </listitem>
    <listitem><para>Set the <link linkend="synccomp_checkb_options">checkbox options</link>:
                   <guilabel>"Recurse subdirectories"</guilabel>,
                   <guilabel>"Follow symlinks"</guilabel>, <guilabel>"Compare by content"</guilabel>,
                   <guilabel>"Ignore Date"</guilabel> and <guilabel>"Asymmetric"</guilabel>.</para>
              </listitem>
    <listitem><para>Click on the <guibutton>"Compare"</guibutton> button to compare the directories.</para>
              </listitem>
    <listitem><para>By using the <link linkend="synccomp_show_options">Show options</link>, you can
                      include/exclude particular filetypes.
                      Those files, that are not in the list, will be untouched by synchronization.</para>
              </listitem>
    <listitem><para>If needed you can change the <guilabel>"Task"</guilabel> operations
	              determined by the Comparator with the
		      <link linkend="synccomp_right_click">right click menu</link>.</para>
              </listitem>
    <listitem><para>When you agree with the <guibutton>"Compare"</guibutton> results click on the
                    <guibutton>"Synchronize"</guibutton> button to show the synchronize dialog.</para>
              </listitem>
    <listitem><para>After selection the options of the
                     <link linkend="sychronizer">Synchronizer</link>, click on the
                     <guibutton>"Start"</guibutton> button to start the synchronization process.</para>
              </listitem>
    </orderedlist>
    A detailed explanation of all the functions and buttons is described in the following text.
</para>

<para><emphasis role="bold">Comparator</emphasis></para>

<variablelist>
<varlistentry><term>Panel elements</term>
  <listitem>
   <itemizedlist>
     <listitem><para><guilabel>"Left Directory"</guilabel>: the left side base directory.</para>
    	       </listitem>
     <listitem><para><guilabel>"Right Directory"</guilabel>: the right side base directory.</para>
               </listitem>
    <listitem><para><guilabel>"File Filter"</guilabel>: filter the filenames at synchronizing. &eg;
                    <literal role="extension">*.png</literal> selects only those files which name's ends
		    with <literal role="extension">.png</literal>
                    Directories will be listed if the directory name ends with
		    <literal role="extension">.png</literal> or
                    if the directory contains files which end with <literal role="extension">.png</literal></para>
              </listitem>
   </itemizedlist>
   </listitem>
</varlistentry>

<varlistentry id="synccomp_checkb_options"><term>Checkbox options</term>
  <listitem>
   <itemizedlist>
     <listitem><para><guilabel>"Recurse subdirectories"</guilabel>:
	             the Synchronizer walks through on subdirectories when comparing.</para>
	       </listitem>
     <listitem><para><guilabel>"Follow symlinks"</guilabel>:
	             the Synchronizer follows the symbolic links to directories (not the files!).</para>
	       </listitem>
     <listitem><para><guilabel>"Compare by content"</guilabel>:
	             those files which size is equal will be compared by content as well.</para>
	       </listitem>
     <listitem><para><guilabel>"Ignore Date"</guilabel>:
	             Ignores the date information (useful for &FTP;, smb, archive, ... )
                     the date information is relevant only in the local file system.</para>
               </listitem>
     <listitem><para><guilabel>"Asymmetric"</guilabel>:
	             The <guilabel>"Left Directory"</guilabel> is the target directory,
                     the <guilabel>"Right Directory"</guilabel> is the source directory.
                     This functions synchronizes the content of the left directory to the right directory.
                     <itemizedlist>
                     <listitem><para>Those files that exists only in the left side will be deleted.</para>
                               </listitem>
                     <listitem><para>Those ones that exists only in the right side will be copied to left.</para>
                               </listitem>
                     <listitem><para>Those files that considered to be equal will be untouched.</para>
                               </listitem>
                     <listitem><para>Those files that considered to be different will be copied to left.</para>
                               </listitem>
                   </itemizedlist>
                   This function is useful if the date information is unusable, or to synchronize the
                   left directory to the content of a fileserver (like a download).
                   Or to make a backup from the right directory to left directory.
                   NOTE: do NOT use this to option to synchronize a desktop and a notebook
                   (&eg; files that exists only in the left side will be deleted!).</para>
                </listitem>
      <listitem><para><guilabel>"Automatic Scrolling"</guilabel>:
 	              It's for slow &FTP; servers, ... When the Synchronizer finished
                      comparing a file, it puts the file into the end of the list at once and
                      scrolls the window if it is necessary. It is important if you want to
                      know what the Synchronizer is doing. If the &FTP; server is slow, the
                      comparation of a directory may take a lot of time. By turning this
                      option on, one can see that the comparator is "alive", but slow.
                      For fast file systems, it can reduce the speed of comparing slightly.</para>
                </listitem>
    </itemizedlist>
    </listitem>
</varlistentry>

</variablelist>

<para>When all the above things are done, click on the <guibutton>"Compare"</guibutton> button to compare the
       directories, the results are displayed in the "File List".</para>

<variablelist><varlistentry><term>"File List"</term>
  <listitem>
    <para>The <guilabel>"File List"</guilabel> has the following columns: "Left name | Left size | Left time |
           Task | Right time | Right size | Right name".</para>
    </listitem>
  </varlistentry>

<varlistentry><term>Tasks (&lt;=>)</term>
  <listitem><para>This column will display the task that is planned for the Syncronizer.</para>
    <itemizedlist>
    	<listitem><para><guibutton>-></guibutton>:
	           copy from the left side to the right side.
                   For directories: <command>mkdir</command> in the right side.</para>
                   </listitem>
    	<listitem><para><guibutton>=</guibutton>:
	           the files are the same, don't do anything.</para>
	           </listitem>
	<listitem><para><guibutton>!=</guibutton>:
	           the file is excluded, or the Synchronizer does not know what to do.</para>
	           </listitem>
	<listitem><para><guibutton>&lt;-</guibutton>:
	           copy from the right side to the left side.
                   For directories: <command>mkdir</command> in the left side</para>
                   </listitem>
	<listitem><para><guibutton>DEL</guibutton>:
	           delete files from the right side.</para>
	           </listitem>
    </itemizedlist>
    <para>The tasks can be changed with the <link linkend="synccomp_right_click">right click menu</link>.</para>
    </listitem>
  </varlistentry>

  <varlistentry id="synccomp_show_options"><term>Show options</term>
    <listitem>
    <para>Here you can include/exclude particular filetypes.
    Those files, that are not in the list, will be untouched at synchronization.</para>
    <itemizedlist>
    	<listitem><para><guibutton>-></guibutton>:
	           Enable/Disable the copy task from left to right.</para></listitem>
    	<listitem><para><guibutton>=</guibutton>:
	           Enable/Disable listing the equal files.</para></listitem>
	<listitem><para><guibutton>!=</guibutton>:
	           Enable/Disable listing the excluded / "don't know what to do" files.</para></listitem>
	<listitem><para><guibutton>&lt;-</guibutton>:
	           Enable/Disable the copy task from right to left.</para></listitem>
	<listitem><para><guibutton>Trash</guibutton>:
	           Enable/Disable the file deleting from the left side task.</para></listitem>
	<listitem><para><guibutton>Duplicates</guibutton>:
	           Enable/Disable those files that exist on both side.</para></listitem>
	<listitem><para><guibutton>Singles</guibutton>:
	           Enable/Disable those files that exist only on one side.</para></listitem>
    </itemizedlist></listitem>
    </varlistentry>

    <varlistentry><term>Action buttons</term>
    <listitem>
    <itemizedlist>
    	<listitem><para><guibutton>"Compare"</guibutton>:
	           compares the directories, the results are displayed in the file list.</para></listitem>
    	<listitem><para><guibutton>"Stop"</guibutton>:
	           stops comparing.</para></listitem>
	<listitem><para><guibutton>"Synchronize"</guibutton>:
	           shows the synchronize dialog.</para></listitem>
	<listitem><para><guibutton>"Close"</guibutton>:
	           closes the Synchronizer window.</para></listitem>
    </itemizedlist></listitem>
    </varlistentry>

    <varlistentry><term>The Status line may contain</term>
    <listitem>
    <itemizedlist>
    	<listitem><para>The number of scanned directories at comparing.</para></listitem>
    	<listitem><para>The filename at comparing by content (for big files).</para></listitem>
	<listitem><para>The number of files in the list.</para></listitem>
    </itemizedlist></listitem>
    </varlistentry>

    <varlistentry id="synccomp_right_click"><term>Right click menu on the File List</term>
    <listitem>
    <para>The right click menu is split up in three sections:</para>

    <para>1. change the <guilabel>Task</guilabel> operations
	   determined by the Comparator. Select one or multiple files.
           The change will be applied on the selection and not only on the right clicked item.
	   If the selected item is a directory, the change will be applied on its
	   files/subdirectories as well.</para>
    <itemizedlist>
    	<listitem><para><guibutton>"Synchronise Directories"</guibutton>:
	           starts synchronization.</para></listitem>
    	<listitem><para><guibutton>"Exclude"</guibutton>:
	           excludes a file/dir from synchronization ( task change to != ).</para></listitem>
	<listitem><para><guibutton>"Restore original operation"</guibutton>:
	           task change to the original result of comparator.</para></listitem>
	<listitem><para><guibutton>"Reverse direction"</guibutton>:
	           task change ( -> to &lt;-, and &lt;- to -> ).</para></listitem>
        <listitem><para><guibutton>"Copy from right to left"</guibutton>:
	           task change to &lt;-.</para></listitem>
        <listitem><para><guibutton>"Copy from left to right"</guibutton>:
	           task change to ->.</para></listitem>
        <listitem><para><guibutton>"Delete ( left single )"</guibutton>:
	           task change to DEL.</para></listitem>
    </itemizedlist>

    <para>2. change the selections</para>
    <itemizedlist>
        <listitem><para><guibutton>"Select items"</guibutton>:
	           Opens a dialog which allows you to select items.
		   This is the <guimenuitem>Select Group</guimenuitem> dialog  from the
		   &markmenu_lnk;.</para></listitem>
        <listitem><para><guibutton>"Unselect items"</guibutton>:
	           Opens a dialog which allows you to unselect items.
		   This is the <guimenuitem>Unselect Group</guimenuitem> dialog  from the
		   &markmenu_lnk;.</para></listitem>
        <listitem><para><guibutton>"Invert selection"</guibutton>:
	           Invert the selection status of all items.</para></listitem>
    </itemizedlist>

    <para>3. others  Note: the following operations work on the right-clicked file and not on the selection.</para>
    <itemizedlist>
        <listitem><para><guibutton>"View left file"</guibutton>:
	           starts viewer on the left file.</para></listitem>
        <listitem><para><guibutton>"View right file"</guibutton>:
	           starts viewer on the right file.</para></listitem>
        <listitem><para><guibutton>"Compare Files"</guibutton>:
	           starts the diff utility (ex. kompare) on the files.</para></listitem>
    </itemizedlist>
    </listitem>
    </varlistentry>

    </variablelist>


    <para id="sychronizer"><emphasis role="bold">Synchronizer</emphasis></para>
    <para>After pressing the <guibutton>"Synchronize"</guibutton> button the synchronization dialog appears.</para>

    <variablelist>
    <varlistentry><term>Check boxes</term>
    <listitem>
    <para>Here you confirm the copy and delete operations of the Synchronizer</para>
    <itemizedlist>
    	<listitem><para><guilabel>"Right to left"</guilabel>:
	           copy X1 files ( Y1 bytes )
                   enable / disable the copy from right to left.</para></listitem>
    	<listitem><para><guilabel>"Left to right"</guilabel>:
	           copy X2 files ( Y2 bytes )
                   enable / disable the copy from left to right.</para></listitem>
	<listitem><para><guilabel>"Left"</guilabel>:
	           delete X3 files ( Y3 bytes )
                   enable / disable the left side deleting.</para></listitem>
	<listitem><para><guilabel>"Confirm overwrites"</guilabel>:
	           By switching this option on, Krusader will show the
                   <guibutton>"rename, skip, overwrite, skip all, overwrite all"</guibutton> dialog box,
                   before overwriting the file.</para></listitem>  
    </itemizedlist></listitem>
    </varlistentry>

    <varlistentry><term>Status labels</term>
    <listitem>
    <itemizedlist>
    	<listitem><para><guilabel>"Ready"</guilabel>:
	           A1/A2 files, B1/B2.
		   This line is changed at synchronizing, showing that synchronizer finished
                   with A1 files from A2 ( B1 bytes from B2 ).</para></listitem>
    	<listitem><para><guilabel>"Progress bar"</guilabel>:
	           Shows the progress on the synchronization (based on bytes).</para></listitem>
    </itemizedlist></listitem>
    </varlistentry>

    <varlistentry><term>Action buttons</term>
    <listitem>
    <itemizedlist>
    	<listitem><para><guibutton>"Start"</guibutton>:
	           starts synchronization.</para></listitem>
    	<listitem><para><guibutton>"Pause / Resume"</guibutton>:
	           pauses/resumes the synchronization process.</para></listitem>
	<listitem><para><guibutton>"Close"</guibutton>:
	           closes the synchronization dialog (and stops synchronization).</para></listitem>
    </itemizedlist></listitem>
    </varlistentry>

    </variablelist>

</sect1>


</chapter>
