diff options
| author | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-02-22 18:58:28 +0000 |
|---|---|---|
| committer | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-02-22 18:58:28 +0000 |
| commit | 83b9bf0e3bfb1d842b10b80bbe749095b2c661a1 (patch) | |
| tree | b05b1793361693ae88106648c2a953bed988f423 /doc/en | |
| download | krusader-83b9bf0e3bfb1d842b10b80bbe749095b2c661a1.tar.gz krusader-83b9bf0e3bfb1d842b10b80bbe749095b2c661a1.zip | |
Added old KDE3 version of Krusader
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/krusader@1094427 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'doc/en')
38 files changed, 17903 insertions, 0 deletions
diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am new file mode 100644 index 0000000..dc8b999 --- /dev/null +++ b/doc/en/Makefile.am @@ -0,0 +1,11 @@ +####### kdevelop will overwrite this part!!! (begin)########## + + +EXTRA_DIST = archives.docbook editors-note.docbook java.docbook profiles.docbook user-interface.docbook bookmarks.docbook more.docbook faq.docbook keyboard.docbook release-overview.docbook using-krusader.docbook checksum.docbook features.docbook konfigurator.docbook remote-connections.docbook vfs.docbook commands.docbook glossary.docbook krusader-tools.docbook search.docbook viewer-editor.docbook compare.docbook help.docbook locate.docbook splitter.docbook configuration-files.docbook index.docbook mount.docbook synchronizer.docbook credits.docbook installation.docbook mouse.docbook useractions.docbook diskusage.docbook introduction.docbook occupied-space.docbook useraction-xml.docbook + +####### kdevelop will overwrite this part!!! (end)############ + +KDE_LANG = en +KDE_DOCS = krusader + + diff --git a/doc/en/archives.docbook b/doc/en/archives.docbook new file mode 100644 index 0000000..a94afe1 --- /dev/null +++ b/doc/en/archives.docbook @@ -0,0 +1,125 @@ +<sect1 id="archives"> + <title>Archive Handling</title> + <indexterm> + <primary>Archives</primary> + </indexterm> + <sect2 id="browsing-archives"> + <title>Browsing Archives</title> + <para>The &vfs-lnk; allows you to browse archives as + if it was a directory. Currently &krusader; supports + the following archives types: ace, arj, bzip2, deb, gzip, iso, + lha, rar, rpm, tar, zip and 7-zip and supports the following + passworded archives: arj, ace, rar and zip. Passwords can be + stored in &kwallet;. Please note that the archive + support first needs to be properly + <link linkend="konfig-archives">configured</link> in + Konfigurator. To open the archive, use &Enter;, + (double-)click or the + <keycap>Right Arrow</keycap>. &krusader; supports + also + <emphasis role="bold">hidden archives</emphasis>, these are + renamed archives with a *wrong* extension, ⪚ + &openoffice; uses zip archives with the following + extensions: odt, sxw and odw. &Enter; will open the + &openoffice; document and the + <keycap>Right Arrow</keycap> will open the archive. Another + example is J2EE, where the rar extension means a zip archive. + Since &krusader; auto-detects the supported archive + types, it will open with + <keycap>Right Arrow</keycap> even if it has another mime type. + Please note that browsing archives has a few limitations: + <itemizedlist> + <listitem> + <para>Not all functions are supported by all archive types. + (&ie;: you can not delete files in ace or rar + archives)</para> + </listitem> + <listitem> + <para>The permissions you have inside the archive are the + same as the permissions you have for the archive.</para> + </listitem> + <listitem> + <para>The command line (if visible) will not follow you + inside the archive but will point to the archive + directory.</para> + </listitem> + <listitem> + <para>Before any action is performed on files/directories + inside the archive, they must be extracted. The archive + will be repacked when you leave it or when + &krusader; detects that extracted files have + changed.</para> + </listitem> + <listitem> + <para>Packing and un-packing are "blocking operations" that + display a progress dialog. However, this might change in + the future since we are planning to create more background + operations.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="unpacking-archives"> + <title>Unpack Files</title> + <para>There are 2 ways to extract files from archives:</para> + <para>If you want to unpack a whole archive(s), browse to the + archive location, select the archive(s) and select + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Unpack</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Alt; + <keycap>U</keycap></keycombo>. &krusader; will ask + you where to put the extracted files. The default location is + the inactive panel directory. If you don't cancel the + operation, &krusader; will try to unpack all the + selected files in the inactive panel.</para> + <para>If you only want to extract a part of the archive, then + <link linkend="browsing-archives">browse</link> the archive and + copy the files you want to extract to their new location just + as you would copy "normal" files. Note that unpacking from a + browsed archive takes more time (file by file unpack) compared + to unpacking a whole archive with the first method.</para> + </sect2> + <sect2 id="pack-archive"> + <title>Packing Files</title> + <para>If you want to create a new archive, begin by selecting + the elements you want to pack in the active panel and select + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Pack</guimenuitem> + </menuchoice> + </emphasis> or + <keycombo action="simul">&Alt; + <keycap>P</keycap></keycombo>. A dialog will pop-up prompting + you to select the archive name and location. Select the packer + from one of the + <link linkend="konfig-archives">supported file name + extensions</link>.</para> + <para>To add files to an existing archive(s), open the archive + in one panel and the files to be copied in the other panel, + then simply copy the files into the archive in exactly the same + way you copy files into a "normal" directory.</para> + </sect2> + <sect2 id="test-archive"> + <title>Testing Archives</title> + <para>Krusader will not handle corrupted archives since it may + result in data loss. If you receive an error message when + opening an archive, or if you suspect that there is something + wrong with the archive, you should test it before use. To test + an archive, browse (navigate) to the archive location and + select the archive. Next select + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Test Archive</guimenuitem> + </menuchoice> + </emphasis> or + <keycombo action="simul">&Alt; + <keycap>E</keycap></keycombo>. &krusader; will test + the archive file and inform you whether the archive passed or + failed the file integrity test.</para> + </sect2> +</sect1> diff --git a/doc/en/bookmarks.docbook b/doc/en/bookmarks.docbook new file mode 100644 index 0000000..9817d77 --- /dev/null +++ b/doc/en/bookmarks.docbook @@ -0,0 +1,289 @@ +<sect1 id="bookman"> + <title>BookMan: Organize your Bookmarks</title> + <indexterm> + <primary>Bookmarks</primary> + </indexterm> + <para>BookMan is &krusader;'s Bookmark tool for + bookmarking folders, local- and + <link linkend="remote-connections">remote URL's</link>, and later + returning to them in a click of a button. The Bookman menu is + divided into four sections: + <itemizedlist> + <listitem> + <para>Your personal bookmarks</para> + </listitem> + <listitem> + <para>Popular &URL;'s</para> + </listitem> + <listitem> + <para>Permanent bookmarks</para> + </listitem> + <listitem> + <para>Manage bookmarks</para> + </listitem> + </itemizedlist></para> + <note> + <para>You can bookmark inside a remote file system + (&FTP; or SAMBA) and later use the bookmark to + quickly connect to the remote machine, but you cannot bookmark + inside an archive.</para> + </note> + <!-- OLD +<screenshot> + <screeninfo>Bookmark menu</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="bookmanadd.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="bookmanadd.png" format="EPS"/></imageobject> + <textobject><phrase>BookMan: the Bookmark menu</phrase></textobject> + <caption><para>Bookmark menu</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-bookmanadd" float="1"> + <title>Bookmark menu</title> + <mediaobject> + <imageobject> + <imagedata fileref="bookmanadd.png"></imagedata> + </imageobject> + <textobject> + <phrase>Bookmark menu</phrase> + </textobject> + </mediaobject> + </figure> + <sect2 id="using_bookmarks"> + <title>Using Bookmarks</title> + <para>Usually, you click on the + <guibutton>Bookmark</guibutton> button when you are in the target + folder. For example, to bookmark + <filename class="directory">/usr/tmp</filename>, navigate + &krusader; there and click the + <guibutton>Bookmark</guibutton> button and select + <guimenuitem>Bookmark Current</guimenuitem>. When the + <guilabel>Bookmark Current</guilabel> dialog box appears, the + &URL; line will say + <filename class="directory">/usr/tmp</filename>. + <guilabel>Name</guilabel> is for the name you would like to give + to the bookmark (e.g.: temporary folder). Hotkeys are supported + by adding + <literal>&</literal> to the bookmark name + ⪚ + <literal>&sourceforge, &home, + down&loads</literal> &etc;, so you can + quickly call the bookmark name with + <keycombo action="simul">&Alt; + <keycap>foo</keycap></keycombo>. If you add the bookmark + without entering a name, the bookmarks name will be the same as + its target. + <guilabel>URL</guilabel> + <!-- Openjade does not like an acronym element for "URL" here --> + is where the bookmark points to. + <guilabel>Create in</guilabel> creates bookmark folders for + organizing your bookmarks.</para> + <para>To use your bookmarks, click the + <guibutton>Bookmark</guibutton> button and choose a bookmark. + You may also use the &keybindigs-lnk; : + <keycombo action="simul">&Ctrl;&Shift; + <keycap>d</keycap></keycombo> to bookmark the current item, + <keycombo action="simul">&Alt; + <keycap>right/left arrow</keycap></keycombo> to + <keycap>open right/left panel bookmarks list</keycap> and + <keycombo action="simul">&Ctrl; + <keycap>d</keycap></keycombo> to open the bookmarks of the + active panel. A &MMB; click on bookmarks opens them + in a new + <link linkend="folder-tabs">Folder tab</link>.</para> + <para>Navigation in bookmarks: + <orderedlist> + <listitem> + <para>Start typing letters</para> + </listitem> + <listitem> + <para>⪚ when you type + <literal>'h'</literal> and only one bookmark starts with + <literal>'h'</literal>, it is executed immediately - no + enter needed</para> + </listitem> + <listitem> + <para>If more than one bookmarks begins with + <literal>'h'</literal>, you will have to continue adding + letters, until you have specified enough and again, the + bookmark is executed.</para> + </listitem> + </orderedlist></para> + </sect2> + <sect2 id="password_handling"> + <title>Password handling</title> + <para>One of the benefits of the + <link linkend="bookman">bookmark manager</link> is that the + passwords are saved using &kde;'s services - where + ⪚ your &konqueror;/&kmail; + password are saved. If you have a wallet, &kde; will + save the passwords there. By clicking the bookmarks, a dialog + will open and ask for your username and password. Supply them + and click 'save password'. The passwords and usernames will be + saved securely by &kde;'s wallet (make sure it is + enabled by your distro). The downside here is that if you + reinstall and do not backup your passwords from the wallet as + well as &krusader;'s bookmark file, something will + be lost.</para> + </sect2> + <sect2 id="popular-urls"> + <title>Popular URL's</title> + <indexterm> + <primary>Popular URL's</primary> + </indexterm> + <para>The submenu + <guilabel>Popular URL's</guilabel> + <!-- Openjade does not like an acronym element for "URL" here --> + holds persistent the most popular visited &URL;'s + (local or remote). This submenu displays the top 15 popular + URLs, sorted by ranking, so that the top &URL; is + the most popular. This is easy for when you need to visit + &URL;s often, but do not want to create + &bookmarks-lnk;, it serves as a temporary bookmark + list for the most visited links. + <guilabel>Quicksearch Popular URL's</guilabel> is a fast way to + browse/select the popular &URL;s: + <itemizedlist> + <listitem> + <para>Open the + <guilabel>Popular URL's</guilabel> + <!-- Openjade does not like an acronym element for "URL" here --> + or use + <keycombo action="simul">&Ctrl; + <keycap>z</keycap></keycombo></para> + </listitem> + <listitem> + <para>Type a few letters to narrow the search</para> + </listitem> + <listitem> + <para>Press enter (you will go to the &URL; + list)</para> + </listitem> + <listitem> + <para>Press enter again and the panel is refreshed</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="permanent_bookmarks"> + <title>Permanent bookmarks</title> + <para>These are hardcoded bookmarks to the top bookmark menu; + there is no need for them to be saved to the file. With the + &context-menu-lnk; you can enable/disable these + permanent bookmarks. The following permanent bookmarks are + available: + <itemizedlist> + <listitem> + <para> + <guilabel>Media</guilabel> uses &kde;'s + <link linkend="konfig-advanced">Media protocol</link> + <filename>media:/</filename></para> + </listitem> + <listitem> + <para> + <guilabel>Local Network</guilabel> uses &kde;'s + <filename>lan:/</filename> protocol.</para> + </listitem> + <listitem> + <para> + <guilabel>Virtual Filesystem</guilabel> &vfs-lnk; + + <filename>virt:/</filename> is not a virtual folder, but a + container for &URL;'s from different file + systems. It is used for ⪚ the + <guilabel>Feed to Listbox</guilabel> feature of the search + module and the synchronizer. The location toolbar will + display ⪚ + <filename>virt:/Search results 1</filename> or + <filename>virt:/Synchronise results 1</filename>.</para> + </listitem> + <listitem id="jump_back"> + <para> + <guilabel>Jump back</guilabel> or + <keycombo action="simul">&Ctrl; + <keycap>J</keycap></keycombo> brings you back to your + starting position when you did create a new tab in the + panel window. This feature is very handy if you go deep + into a directory tree, than you can return with one action + to the starting point. With + <guilabel>Set jump back point here</guilabel> or + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>J</keycap></keycombo> sets the current directory as + a jump back point.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="manage_bookmarks"> + <title>Manage bookmarks</title> + <para>To edit and organize your bookmarks, by clicking the + <guibutton>Bookmark</guibutton> button and selecting the + <guimenuitem>Manage Bookmarks</guimenuitem>, + &keditbookmarks; will be displayed. This is where + you can edit/remove and rearrange 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> + ~/.kde/share/apps/krusader/krbookmarks.xml.</filename></para> + <para>You can import bookmarks from + <application>IE</application>, + <application>Opera</application>, + <application>Galeon</application>, &kde;, + <application>Mozilla</application>, &Netscape;. + &keditbookmarks; is easy to use, however, if you + need more information, please read the + &keditbookmarks; or the &konqueror; + handbook.</para> + <!-- OLD +<screenshot> + <screeninfo>&keditbookmarks; Bookmark Manager</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="bookmanedit.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="bookmanedit.png" format="EPS"/></imageobject> + <textobject><phrase>&keditbookmarks; edit and organize your Bookmarks</phrase></textobject> + <caption><para>&keditbookmarks;: Bookmark Manager.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-bookmanedit" float="1"> + <title>&keditbookmarks; Bookmark Manager</title> + <mediaobject> + <imageobject> + <imagedata fileref="bookmanedit.png"></imagedata> + </imageobject> + <textobject> + <phrase>&keditbookmarks; Bookmark + Manager</phrase> + </textobject> + </mediaobject> + </figure> + </sect2> + <sect2 id="bookmark_buttons"> + <title>Bookmarks as action buttons on the Toolbar</title> + <para>Bookmarks can be placed as buttons on the + &main-toolbar-lnk; or the + &actions-toolbar-lnk;. You can even make a + key-binding for them: + <itemizedlist> + <listitem> + <para>Create your &bookmarks-lnk;.</para> + </listitem> + <listitem> + <para>If you want, create keybindings for the bookmarks in + the + <guilabel>Key-bindings</guilabel> section of the + &konfiglookandfeel-lnk;.</para> + </listitem> + <listitem> + <para>Add your bookmarks as action buttons on the + &main-toolbar-lnk; or the + &actions-toolbar-lnk; with the + <guilabel>Toolbar</guilabel> section of the + &konfiglookandfeel-lnk;.</para> + </listitem> + </itemizedlist></para> + </sect2> +</sect1> diff --git a/doc/en/checksum.docbook b/doc/en/checksum.docbook new file mode 100644 index 0000000..e6a3c0b --- /dev/null +++ b/doc/en/checksum.docbook @@ -0,0 +1,34 @@ +<sect1 id="checksum"> + <title>Checksum creation-verification</title> + <indexterm> + <primary>Checksum</primary> + </indexterm> + <para> + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Create Checksum</guimenuitem> + </menuchoice> + </emphasis>: &krusader; checks which tools you have + and if those tools allow recursive operation (in case you + selected folders), you can generate a checksum by choosing a + checksum type from the list (md5, sha...). You can then save the + checksum to a file, usually called checksum.md5 or + checksum.sha1.</para> + <para> + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Verify Checksum</guimenuitem> + </menuchoice> + </emphasis>: &krusader; checks if you have a tool that + supports the type of checksum you need (from your specified + checksum file) and displays the files that failed the checksum + (if any).</para> + <para>The system abstracts over different checksum mechanisms and + Checksum Utilities. At the moment, the following checksums are + supported: md5, sha1, sha256, sha224, sha256, sha384, sha512, + tiger, whirlpool, cfv and crc. Please check your + <link linkend="konfig-dependencies">Checksum Utilities + settings</link> before using this function.</para> +</sect1> diff --git a/doc/en/commands.docbook b/doc/en/commands.docbook new file mode 100644 index 0000000..54b6336 --- /dev/null +++ b/doc/en/commands.docbook @@ -0,0 +1,2129 @@ +<chapter id="menu-commands"> + <!-- ********************************************************************** + commands.docbook + ++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Menu Commands</title> + <indexterm> + <primary>Commands</primary> + <secondary>Menu</secondary> + </indexterm> + <sect1 id="file-menu"> + <title>File Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F4</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>New Text File</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a new text file in the current directory, + unless another directory is specified. The new file is + opened for editing after it is created.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F7</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>New Directory</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a new directory in the current + directory.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>S</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>New Symlink</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a symbolic link to the currently selected + file.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F3</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>View File</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the currently selected file for + <link linkend="kredit">viewing</link>.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F4</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Edit File</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the currently selected file for + <link linkend="kredit">editing</link>.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F5</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Copy</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a dialog to + <link linkend="copying">copy</link> the currently selected + files or directories to a specified location.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F6</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Move</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a dialog to + <link linkend="copying">move</link> the currently selected + files or directories to a specified location.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>P</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Pack</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a + <link linkend="pack-archive">new archive</link> of all the + selected files and directories in the active + panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Unpack</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="unpacking-archives">Unpacks</link> all the + selected files in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>E</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Test Archive</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="test-archive">Tests archive</link> for + corruption.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Compare by content</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Compares two current files by content - one from + each panel via an external graphical diff utility. By + default &kompare; (part of the kdebase + package) is used, but you can also use ⪚ + &xxdiff-url; or &kdiff3-url; , + change it in the + &konfigdependencie-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry id="multi_rename"> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F9</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Multi Rename</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>This menu option starts &krename-url; a + very powerful external batch renamer for &kde; + 3.x.</para> + <itemizedlist> + <title>Krename Features</title> + <listitem> + <para>Renaming a list of files based on a set of + expressions</para> + </listitem> + <listitem> + <para>Copying/moving a list of files to another + directory</para> + </listitem> + <listitem> + <para>Convert filenames to upper/lower case</para> + </listitem> + <listitem> + <para>Adding numbers to filenames</para> + </listitem> + <listitem> + <para>Finding and replacing parts of the + filename</para> + </listitem> + <listitem> + <para>Renaming MP3/OGG Vorbis files based on their + ID3 tags</para> + </listitem> + <listitem> + <para>Setting access and modification dates</para> + </listitem> + <listitem> + <para>Changing permissions and file ownership</para> + </listitem> + <listitem> + <para>A plug-in API which allows you to extend + Krename's features</para> + </listitem> + <listitem> + <para>Renaming directories recursively</para> + </listitem> + <listitem> + <para>Support for KFilePlugins</para> + </listitem> + <listitem> + <para>Create undo file</para> + </listitem> + <listitem> + <para>And many more....</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Create Checksum</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="checksum">Checksum creation</link> on + file(s) and/or folder(s).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Verify Checksum</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="checksum">Verify Checksum</link> + </para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>P</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Split file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The &splitfile-lnk; function splits a + file up into multiple smaller files so that it can be + stored on several smaller media (like + <hardware>diskettes, zip-drives, ...</hardware>) or sent by + e-mail.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>B</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Combine files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The &combinefiles-lnk; function combines + multiple files into one file after the + &splitfile-lnk; function was used.</para> + </listitem> + </varlistentry> + <!--vertical bar --> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Q</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Quit</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Closes &krusader; and cleans up the + temporary directory, the same as pressing + <keycap>F10</keycap> key.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="edit-menu"> + <title>Edit Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>X</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Cut to Clipboard</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="copying">Cuts</link> the selected file(s) + to the clipboard to be moved to another location.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>C</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Copy to Clipboard</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="copying">Copies</link> the selected file(s) + to the clipboard to be moved to another location.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>V</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Paste from Clipboard</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="copying">Pastes</link> previously cut or + copied items from the clipboard to the current + directory.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F9</keycap> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Rename</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="renaming">Renames</link> the currently + selected file.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F8</keycap> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Delete</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="deleting">Deletes</link> the currently + selected file(s).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>+</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Select Group</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a dialog which allows you to select files in + the active panel. In the + <guilabel>Search for</guilabel> dialog place the main + search criteria. Enter a filename, a wildcard ( + <literal role="extension">*.o.*</literal>, + <literal role="extension">*.c</literal> &etc;) + or both - separated by a space. When using + <literal>'text'</literal>, the results are the same as + <literal>'*text*'</literal>. You can exclude files from + the search with '|' (⪚ + <literal role="extension">'*.cpp *.h | + *.moc.cpp'</literal>). With the + <link linkend="profiles">profile handler</link> you can + manage your selections for future usage. A double-click + on a profile is the same as entering the selection and + pressing the + <guibutton>OK</guibutton> button. More options for + <guilabel>Select Group</guilabel> dialog are explained in + the + <link linkend="krusearcher">Search dialog</link>, which + are basically almost the same dialogs.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>-</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Unselect Group</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The opposite of + <guimenuitem>Select Group</guimenuitem>. The files that + match the pattern in the active panel will be + deselected.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>+</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Select All</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Selects all files in the active panel. You can also + select all directories by activating the + <guilabel>Automark directories</guilabel> option in the + &konfiglookandfeel-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>-</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Unselect All</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unselects all the files in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>*</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Invert Selection</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Inverts the selection status of all the files in + the active panel (&ie; selected files will + become unselected and deselected files will become + selected).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>C</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Compare Directories</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggles &krusader; + &comparedir-lnk; function.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Edit</guimenu> + <guimenuitem>Compare setup</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Configures the + <guimenuitem>Compare Directories</guimenuitem> function.</para> + <itemizedlist> + <listitem> + <para> + <guimenuitem>Select Newer and Single</guimenuitem> (default)</para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Newer</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Different and Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Different</guimenuitem> + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Edit</guimenu> + <guimenuitem>Calculate Occupied Space</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="calculate">Calculates occupied + space</link> of files and folders, archives and remote + filesystems.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>KP_Enter</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Properties</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the properties dialog for the currently + selected file. (KP refers to Key Pad.)</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="view-menu"> + <title>View Menu</title> + <para>The action in this submenu usually affects the current + &krusader; session. If you want to make permanent + changes use &konfigstartpg-lnk;.</para> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Shift; + <keycap>D</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Detailed View</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the file names, file size, creation date and time and their attributes.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Shift; + <keycap>B</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Brief View</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows only the file names.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>.</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Show Hidden Files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggles the option to display the hidden files in + the &krusader; panels.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F10</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>All Files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Turns off all filters and display all files.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F12</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Custom</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Allows you to install a custom filter on the + &krusader; panel. Only files that match the + filter pattern(s) and directories will be displayed. Do + not forget to deactivate the custom filter after use, or + some files may not be visible.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Select Remote Charset</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Selects the remote charset for + &remote-connections-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>R</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Reload</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Refreshes the contents of the active panel.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="go-menu"> + <title>Go Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>Go</guimenu> + <guimenuitem>Back</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the previously viewed directory in the + active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>PageUp</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Up</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the parent directory of the active + panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Backspace</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Root</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the root directory of the + system.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Home</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Home</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the home directory of the current + user.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Z</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Popular URLs</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Displays a listing of frequently viewed directories + from which you may navigate to one by double-clicking on + it.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>J</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Set Jump Back Point</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Sets the current directory as a "jump back" point. + To navigate to this directory quickly, select the "Jump + Back" command from the Go Menu.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>J</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Jump Back</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Returns to a previous "jump back" point.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="useractions-menu"> + <title>Useractions Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Manage useractions</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the &useractions-lnk; + manager.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Your own Useractions</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the default user actions and those + created by the user.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Equal panel-size</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Sets the ratio between the two panels to + 50/50.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>1</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Sort By Name</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>When this action is turned on, the main sorting key + in the &krusader; panel becomes the file + name.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>2</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Sort By Extension</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>When this action is turned on, the main sorting key + in the &krusader; panel becomes the file + extension (the part of the filename after the last '.'). + This is useful for grouping files of the same type closer + together.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>3</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Sort By Size</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>When this action is turned on, the main sorting key + in the &krusader; panel becomes the file size. + This is useful for determining the largest files in a + particular directory.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>4</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Sort By Modified</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>When this action is turned on, the main sorting key + in the &krusader; panel becomes the last + modified date for each file. This is useful for finding + files you recently worked on.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Edit as root</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Allows you to edit a file with kwrite using root + permissions.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Mount</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Mounts a new filesystem.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Enqueue in Amarok</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Appends selected item(s) to Amarok playlist.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Copy current item to + clipboard</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Copies selected item(s) to the clipboard.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Shift;<keycap>F5</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Backup current</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Backups current file in current directory and asks the user for a new filename. + By default <filename>.old</filename> is appended to the original filename.</para> + </listitem> + </varlistentry> + </variablelist> + + +<para></para> <!-- empty line--> +<para><emphasis role="bold">&krusader;-1.90.0 "Power Stone" additional Useractions</emphasis></para> + <variablelist> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Copy as root</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Copy selected files & directories with root privileges, also inside archives! + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Copy+as+root?content=36902">Andrew Svet and MaxiPunkt</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Search and Replace in file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>This Useraction uses the &UNIX; standard-tool <command>sed</command> (the stream-editor) so perform + search and replace operations in all selected files + It is possible to give a regular expression for both strings. + Please note: The sed-command is "s/search/repleace/", so you have to escape the slash when you need it! + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Search+and+Replace?content=36310">Jonas Bähr</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unmount</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Umount selected directory. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/unmount+filesystem?content=68056">Stefan Endrullis</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Eject cd/dvd</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unmounts and ejects current cdrom/dvd.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>gzip current</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Gzip current file with maximum (9) compression, preserving original file. In case of directory, it is first tarred. + Useraction contributed by + <ulink url="http://qa.debian.org/developer.php?login=fboudra@free.fr">Fathi Boudra</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>7zip current file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Make a 7zip archive containing current file to other panel. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/7zip+current+file?content=32523">Václav Jůza</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Lzma current file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Lzma current file and keep input files to other panel.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>tar.gz current</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>tar.gz current file/directory. + <ulink url="http://www.kde-files.org/content/show.php/Gzip%2Btar.gz+current+file?content=32522">Václav Jůza</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>tar.lzma selected files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>tar.lzma selected files to other panel.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Pack/Unpack ar archive (.a, .deb, ...)</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Make an archive or extract from it using the <command>ar</command> utility, which is + used for static libraries <filename>*.a</filename> or &debian; packages + You can extract &debian; packages this way without having <command>dpkg</command> installed. + Like <command>tar</command>, <command>ar</command> does not use any compression. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/ar++archive+pack%2Bunpack+with+dialog?content=33333">Václav Jůza</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>tar.7z selected files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>tar.7z selected files to other panel.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack archive to dir</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a directory with the current archive name in the other panel before unpacking + the files into it. It uses <command>ark</command> and tries to guess the directory name (archive name + without file extension). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Archive+to+Dir?content=29760">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack current tar.7z</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack current tar.7z to other panel.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack current tar.lzma</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack current tar.lzma to other panel and keep original input file.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack current lzma</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack current lzma to other panel and keep original input file.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack current lzma</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack current lzma to other panel and keep original input file.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack multiple zip archives</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack all selected zip archives into seperate directories. + Useraction contributed by + <ulink url="http://krusader.org/phpBB/viewtopic.php?t=2059">Ernest Beinrohr (OERNii), + and Jonas Bähr</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Split large mp3</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Splits large mp3's using <command>mp3splt</command>. + Useraction contributed by + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1010">Andrew Svet</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Encrypt with kgpg</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Encrypts the current file with kpgp (which has to be in your $PATH). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Encrypt+with+kgpg?content=32505">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Decrypt with kgpg</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Decrypts the current file with kpgp (which has to be in your $PATH). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Decrypt+with+kgpg?content=32506">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Sign with kgpg</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Signs the current file with kpgp (which has to be in your $PATH). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Sign+with+kgpg?content=32508">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Verify signature with kgpg</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Tries to verify the signature of the current file with kpgp (which has to be in your $PATH). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Verify+signature+with+kgpg?content=32509">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Decode current file created with uuencode.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Decode a file created with uuencode. Requirements: Sharutils. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Uuencode?content=75488">Andrew Svet</ulink>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Uuencode current file.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Uuencode creates an encoded ASCII copy of a file. Requirements: Sharutils. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Uuencode?content=75488">Andrew Svet</ulink>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Select from file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>A javascript useraction, TC-like "load selection from file". + Use this action on a text file which contains a list of filenames and these files will be selected. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Select+from+file?content=54518">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Recode files using GNU recode or iconv</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>A javascript useraction, which converts either file names or their content or both from one + to another character encoding. It processes all selected files and directories in the active panel + (for the directories, recurse their content). You can select, whether a recoded copy is created or + if the file is moved (there is no warranty, so don't test move on any important data) + Requirements: You need krusader compiled with javascript support and GNU recode installed. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/recode+files+with+dialog?content=48289">Václav Jůza</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Mount as root</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>A javascript useraction, Mounts a device with root-privileges. + Requirements: You need krusader compiled with javascript support. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Root+Mount?content=29744">Jonas Bähr</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Calculator</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>A javascript useraction, a simple calculator. + Requirements: You need krusader compiled with javascript support. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Demo+Calc?content=29743">Jonas Bähr</ulink>.</para> + </listitem> + </varlistentry> + + </variablelist> + + + </sect1> + <sect1 id="tools-menu"> + <title>Tools Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>S</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Search</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens + <link linkend="krusearcher">KruSearcher</link> - the + Krusader search module.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>L</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Locate</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the &locate-lnk; for fast file + searching.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Y</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Synchronize Directories</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The &syncdirs-lnk; function compares the + left and right panels and shows the differences between + them. After the compare function, you can move + files/directories so that they can be + synchronized.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>/</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>MountMan</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens + <link linkend="mount-man">MountMan</link> - the + Mount-Manager.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>D</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Disk Usage</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens &diskusage-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>N</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>New Net Connection</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the + <link linkend="remote-connections">New Network + Connection</link>dialog to start a &FTP;, SMB, + FISH or SFTP connection to a remote host. If you leave + the user name and password fields empty, you will login as + anonymous. You can + <link linkend="bookman">Bookmark</link> these remote + sessions.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Shift;&Ctrl; + <keycap>F</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Disconnect From Net</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Ends the + <link linkend="remote-connections">remote + connection</link> in the active panel and returns to the + start-up path.</para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Start Terminal</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a terminal window in the default directory + (usually your home directory). You can choose your + favorite terminal application in the + &konfiggereral-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>F2</keycap> + </keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Start Terminal Here</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a terminal window in the currently browsed + directory of the active panel. You can choose your + favorite terminal application in the + &konfiggereral-lnk;.</para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry id="root-mode"> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>K</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Start Root Mode Krusader</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Starts &krusader; in + &rootmode-lnk; at the same location.</para> + <caution> + <para>Be careful when using &krusader; with + ROOT PRIVILEGES.</para> + </caution> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>J</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Javascript Console</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the + <link linkend="javascript_console">Javascript + Console</link>.</para> + </listitem> + </varlistentry> + <!--<varlistentry>--> + <!--<term>--> + <!--<menuchoice>--> + <!--<shortcut>--> + <!--<keycombo action="simul">&Ctrl;<keycap>`</keycap></keycombo>--> + <!--</shortcut>--> + <!--<guimenu>Tools</guimenu>--> + <!--<guimenuitem>User Menu</guimenuitem>--> + <!--</menuchoice>--> + <!--</term>--> + <!--<listitem>--> + <!--<para>--> + <!--Please use at this moment the <link linkend="useractions-menu">Useractions menu</link> instead.--> + <!--Our plans for the Usermenu are to make user-configurable KActionMenus.--> + <!--With this one could make a UserMenu containing ⪚ all music-related actions and place--> + <!--this in the button-bar.... (or anywhere else).--> + <!--</para>--> + <!--</listitem>--> + <!--</varlistentry>--> + </variablelist> + </sect1> + <sect1 id="settings-menu"> + <title>Settings Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Toolbar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the &main-toolbar-lnk; if + checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Actions Toolbar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the &actions-toolbar-lnk; if + checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Statusbar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the + <link linkend="mainwindow">Statusbar</link> if + chosen.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Hide Statusbar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Hides the + <link linkend="mainwindow">Statusbar</link> if + chosen.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show FN Keys bar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the &fnkeybar-lnk; if + checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Command Line</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the + <link linkend="cmdline">Command Line</link> if + checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>T</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Show Terminal Emulator</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Show the + <link linkend="cmdline">Terminal Emulator</link> if + checked.</para> + </listitem> + </varlistentry> + <varlistentry id="configure-shortcuts"> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Shortcuts</guimenuitem> + </menuchoice> + </term> + <listitem> + <indexterm> + <primary>Configure</primary> + <secondary>Shortcuts</secondary> + </indexterm> + <para>Opens a dialog which allows you to configure the + &krusader; key bindings.</para> + <para>With the + <guibutton>Import shortcuts</guibutton> and + <guibutton>Export shortcuts</guibutton> buttons you can + load and save a Key-binding profile. This allows + &krusader; to have the &tcmd;, + &mc;, foo-commander, or your custom + Key-bindings. The only limitation is that global + &kde; key-bindings and some + &krusader; key-bindings can not be changed yet, + as well as some features in foo-commander that we either + do not have or need. The Key-bindings are stored in + <filename>$KDEDIR/share/apps/krusader</filename>, + <filename>foo.keymap.info</filename> contains a + description, + <filename>foo.keymap</filename> is an ini file that holds + the Key-bindings. Until &krusader;-1.70.1 this + was a binary file, &krusader; is backwards + compatible for importing this legacy binary format. If a + <filename>*.keymap.info</filename> text file exists, + &krusader; will display it, showing additional + information regarding the loaded Key-bindings file. Here + you have a chance to exit without importing the proposed + Key-bindings file.</para> + <tip> + <para>A &tcmd; Key-bindings file is + provided. Please + <link linkend="help_krusader"> upload your favorite + Key-bindings schemes</link> so that they become + available for the &krusader; community. + Thanks!</para> + </tip> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Toolbars</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a dialog which allows you to configure the + &main-toolbar-lnk; or the + &actions-toolbar-lnk;. You can add action + buttons of your favourite &useractions-lnk; to + the desired toolbar.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure + &krusader;</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens + <link linkend="konfigurator">Konfigurator</link> - the + &krusader; configuration center.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="window-menu"> + <title>Window Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>N</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>New Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a new tab in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl;&Shift; + <keycap>N</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Duplicate Current Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a new tab that is a duplicate of the active + tab in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>W</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Close Current Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Closes the current tab in the active panel. This + command is only available if there is more than one tab + in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>Right</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Next Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the next tab in the active panel. This + command is only available if there is more than one tab + in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>Left</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Previous Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the previous tab in the active panel. + This command is only available if there is more than one + tab in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry id="c_panel_profiles"> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>L</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Profiles</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a menu where + <link linkend="panel_profiles">Panel profiles</link> can + be saved and restored.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Swap Panels</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The left panel will become the right panel and vice + versa, only the current tabs will be swapped.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Swap Sides</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The complete left panel will become the right panel + and vice versa, and all tabs will be swapped.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>r</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Vertical Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggles the &list-panel-lnk; between + horizontal and vertical mode.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>F</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Toggle Fullwidget Terminal + Emulator</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggles full screen mode of the terminal editor. + This option is only available when "Show Terminal + Emulator" is activated.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Window</guimenu> + <guimenuitem>Save Position</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Saves the current size and position of the + &krusader; main window. This action can be + automated with + <guilabel>"Save settings on exit"</guilabel> in + &konfigstartpg-lnk;</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="help-menu"> + <title>Help Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>Krusader Handbook</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the &kde; Help system starting at + the &krusader; help pages (this + document).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F1</keycap></keycombo> + </shortcut> + <guimenu>Help</guimenu> + <guimenuitem>What's This?</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The &whatsthis-url; help function + changes the mouse cursor to a combination arrow and + question mark. Clicking on items within + &krusader; will open a help window (if one + exists for that particular item) explaining the item + function. Use this feature if you want to know more about + a specific item. A right-click on an item will also open + the &whatsthis-url; help.</para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>Report Bug</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the bug report dialog for sending bug reports + via mail.</para> + <note> + <para> + <remark>If you have bugs to report please do not + use &kde;'s bugzilla http://bugs.kde.org/, + &kde;'s Bug Tracking System. We use + Sourceforge.net for reporting and managing our + &faqbugreports-lnk;.</remark> + </para> + </note> + <para>Wishes, patches, and comments are always + <link linkend="faqg_wish">welcome</link>.</para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>About Krusader</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Displays version, author, and license + information.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>About KDE</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Displays the &kde; version and basic + information.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> +</chapter> diff --git a/doc/en/compare.docbook b/doc/en/compare.docbook new file mode 100644 index 0000000..7b9774c --- /dev/null +++ b/doc/en/compare.docbook @@ -0,0 +1,89 @@ +<sect1 id="compare"> + <title>Compare</title> + <para>&krusader; contains several compare functions: + <guimenuitem>Compare by content</guimenuitem>, + <guimenuitem>Compare Directories</guimenuitem> and the + <link linkend="synchronizer">Synchronizer</link> compare + function.</para> + <sect2 id="compare-content"> + <title>Compare by Content</title> + <indexterm> + <primary>Compare</primary> + <secondary>Content</secondary> + </indexterm> + <para>Select one file in each panel and use + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Compare by content</guimenuitem> + </menuchoice> + </emphasis>. &krusader; will open an external + graphical difference tool that is + <link linkend="konfig-dependencies">configured</link>. + &kompare;, &kdiff3-url; and + &xxdiff-url; are supported.</para> + </sect2> + <sect2 id="compare-dir"> + <title>Compare Directories</title> + <indexterm> + <primary>Compare</primary> + <secondary>Directories</secondary> + </indexterm> + <para>Compare the files of each panel by using + <emphasis role="bold"> + <menuchoice> + <guimenu>Edit</guimenu> + <guimenuitem>Compare Directories</guimenuitem> + </menuchoice> + </emphasis>. By default newer and single files will be selected + in each panel, this behaviour can be changed in the + <guimenuitem>Compare Setup</guimenuitem> menu. + <note> + <para>The files are not compared by content but by their + names and dates only.</para> + </note></para> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>Edit</guimenu> + <guimenuitem>Compare Setup</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Configures the + <guimenuitem>Compare + Directories</guimenuitem> function.</para> + <itemizedlist> + <listitem> + <para> + <guimenuitem>Select Newer and + Single</guimenuitem> (default)</para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Newer</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Different and + Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Different</guimenuitem> + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + </sect2> +</sect1> diff --git a/doc/en/configuration-files.docbook b/doc/en/configuration-files.docbook new file mode 100644 index 0000000..9b94149 --- /dev/null +++ b/doc/en/configuration-files.docbook @@ -0,0 +1,165 @@ +<appendix id="config_files"> + <!-- ********************************************************************** + configuration-files.docbook + +++++++++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Configuration files</title> + <indexterm> + <primary>Configuration files</primary> + </indexterm> + <para>This appendix gives an overview of the configuration files + used by &krusader;.</para> + <para> + <emphasis role="bold">krusaderui.rc</emphasis> + </para> + <para>This file stores the users toolbar settings and the menu + structure. Tip: read also the + <link linkend="faqi_krusaderui_rc">krusaderui.rc + &FAQ;</link>.</para> + <para>Location: + <filename>$KDEDIR/share/apps/krusader/krusaderui.rc</filename> or + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename></para> + <para> + <emphasis role="bold">krusaderrc</emphasis> + </para> + <para>This file stores the &krusader; + configuration.</para> + <para>Location: + <filename>~/.kde/share/config/krusaderrc</filename></para> + <para>The following settings are ⪚ stored:</para> + <itemizedlist> + <listitem> + <para>Actions Toolbar</para> + </listitem> + <listitem> + <para>Archives</para> + </listitem> + <listitem> + <para>Colors</para> + </listitem> + <listitem> + <para>Dependencies</para> + </listitem> + <listitem> + <para>DiskUsage</para> + </listitem> + <listitem> + <para>DiskUsageViewer</para> + </listitem> + <listitem> + <para>General</para> + </listitem> + <listitem> + <para>HTML Settings</para> + </listitem> + <listitem> + <para>KFileDialog</para> + </listitem> + <listitem> + <para>KFileDialog Speedbar</para> + </listitem> + <listitem> + <para>KrDetailedViewLeft</para> + </listitem> + <listitem> + <para>KrDetailedViewRight</para> + </listitem> + <listitem> + <para>KrViewerWindow</para> + </listitem> + <listitem> + <para>KrViewerWindow Toolbar extraToolBar</para> + </listitem> + <listitem> + <para>Look&Feel</para> + </listitem> + <listitem> + <para>Notification Messages</para> + </listitem> + <listitem> + <para>Panel Profiles</para> + </listitem> + <listitem> + <para>Private</para> + </listitem> + <listitem> + <para>Protocols</para> + </listitem> + <listitem> + <para>Search</para> + </listitem> + <listitem> + <para>Startup</para> + </listitem> + <listitem> + <para>Synchronize</para> + </listitem> + <listitem> + <para>Locate</para> + </listitem> + <listitem> + <para>SynchronizerProfile - 1</para> + </listitem> + </itemizedlist> + <para> + <emphasis role="bold">krbookmarks.xml</emphasis> + </para> + <para>This file stores the &krusader; bookmarks and + uses the &xbel-url; standard.</para> + <para>Location: + <filename> + ~/.kde/share/apps/krusader/krbookmarks.xml</filename></para> + <para> + <emphasis role="bold">useractions.xml</emphasis> + </para> + <para>This file stores the &useractions-lnk; + configuration. The file structure is documented in + doxygen-headers of UserActionXML.</para> + <para>Location: + <filename> + ~/.kde/share/apps/krusader/useractions.xml</filename></para> + <para> + <emphasis role="bold">useraction-examples.xml</emphasis> + </para> + <para>This is the default User-Actions provided by us. The + file-structure is documented in doxygen-headers of + UserActionXML.</para> + <para>Location: + <filename> + $KDEDIR/share/apps/krusader/useraction-examples.xml</filename></para> + <para> + <emphasis role="bold">foo.keymap</emphasis> + </para> + <para>Is an ini file that holds a + <link linkend="configure-shortcuts">Key-binding profile</link>. + Until &krusader;-1.70.0 this was a binary file. + &krusader; is backwards compatible for importing this + legacy binary format.</para> + <para>Location: + <filename> + $KDEDIR/share/apps/krusader/foo.keymap</filename></para> + <para> + <emphasis role="bold">foo.color</emphasis> + </para> + <para>This is a binary file that holds the + <link linkend="konfig-color">Color Scheme</link>.</para> + <para>Location: + <filename>$KDEDIR/share/apps/krusader/foo.color</filename></para> +</appendix> diff --git a/doc/en/credits.docbook b/doc/en/credits.docbook new file mode 100644 index 0000000..6cd627a --- /dev/null +++ b/doc/en/credits.docbook @@ -0,0 +1,310 @@ +<chapter id="credits"> + <!-- ********************************************************************** + credits.docbook + +++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Credits and License</title> + <indexterm> + <primary>Credits</primary> + </indexterm> + <indexterm> + <primary>License</primary> + </indexterm> + <para> + <emphasis role="bold">&krusader;</emphasis> + </para> + <para>Program copyright 2000-2003 Shie Erlich and Rafi Yanai, + 2004-2008 &krusader; Krew + <email>krusader@users.sourceforge.net</email></para> + <para>&krusader; is developed by a dedicated team of + individuals, known as the &krusader; Krew. + <itemizedlist> + <listitem> + <para>Shie Erlich, author + <email>erlich@users.sourceforge.net</email></para> + </listitem> + <listitem> + <para>Rafi Yanai, author + <email>yanai@users.sourceforge.net</email></para> + </listitem> + <listitem> + <para>Dirk Eschler, webmaster & i18n + coordinator + <email>deschler@users.sourceforge.net</email></para> + </listitem> + <listitem> + <para>Csaba Karai, developer + <email>ckarai@users.sourceforge.net</email></para> + </listitem> + <listitem> + <para>Heiner Eichmann, developer + <email>h.eichmann@gmx.de</email></para> + </listitem> + <listitem> + <para>Jonas Bähr, developer + <email>jonas.baehr@web.de</email></para> + </listitem> + <listitem> + <para>Frank Schoolmeesters, Documentation & + Marketing coordinator + <email>frank_schoolmeesters@yahoo.com</email></para> + </listitem> + <listitem> + <para>Richard Holt, Documentation & Proofing + <email>richard.holt@gmail.com</email></para> + </listitem> + <listitem> + <para>Matej Urbančič, + Marketing & Product Research + <email>matej.urban@gmail.com</email></para> + </listitem> + </itemizedlist>The project is written using + <application>KDevelop</application>and + <application>&Qt; Designer</application>.</para> + <para>We would especially like to thank Dirk Eschler the + &krusader; web master. If you visit the + &kruwebsite-url; you'll appreciate the hard work and + effort that Dirk has put into the site as much as we do.</para> + <para>Contributors: We would like to thank all the + &krusader; users who submitted bugs, wishes and + patches. Sorry we can't mention all of you.</para> + <para>Donations: We would like to thank the following + organisations and individuals for their recent financial + <ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488"> + support</ulink>. In addition we would to thank those who have + contributed + <ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488"> + anonymously</ulink>. Your support is very much appreciated. + <itemizedlist> + <listitem> + <para> + <ulink url="http://Distrowatch.com"> + distroWatch.com</ulink> (donation)</para> + </listitem> + <listitem> + <para>Sven Opitz (the first donation ever !)</para> + </listitem> + <listitem> + <para>Christian Bock (webspace)</para> + </listitem> + </itemizedlist></para> + <para>Special thanks to: + <itemizedlist> + <listitem> + <para>&sourceforge-net-url;, webhosting + services</para> + </listitem> + <listitem> + <para>Jiri Klement, &kde;4 porting help</para> + </listitem> + <listitem> + <para>&kde-files-url; & + &kde-apps-url; creator Frank Karlitschek</para> + </listitem> + <listitem> + <para>&openusability-url;</para> + </listitem> + <listitem> + <para>Google.com</para> + </listitem> + <listitem> + <para>&krusader; &MacOS;-X port with the &fink-url;-project: Jonas Bähr, &bodo-tasche-url;, + <ulink url="http://pdb.finkproject.org/pdb/maintainer.php?maintainer=Alexander%20K.%20Hansen">Alexander K. Hansen</ulink> + <ulink url="http://hritcu.wordpress.com/2006/08/10/krusader-on-intel-mac/">Catalin Hritcu</ulink></para> + </listitem> + <listitem> + <para>Technical Communication team of 2007, University of Oulu, Finland; + Documentation for &krusader; 1.80.0</para> + </listitem> + <listitem> + <para>Václav Jůza, QA, + bug-hunting, patches and general help</para> + </listitem> + <listitem> + <para>Jiří + Paleček, QA, bug-hunting, patches and + general help</para> + </listitem> + <listitem> + <para>Andrew Neupokoev (nwmod) &krusader; Logo and + Icons, art contest winner.</para> + </listitem> + <listitem> + <para>Angel Ramos, &debian; package + maintainer</para> + </listitem> + <listitem> + <para>Terry "Fudoki" Wilkinson, handbook proofreader</para> + </listitem> + <listitem> + <para>Gábor Lehel (illissius), Viewer + module for the 3rd Hand Panel</para> + </listitem> + <listitem> + <para>Szombathelyi György, ISO KIO + slave</para> + </listitem> + <listitem> + <para>David Harel, panel toolbar buttons</para> + </listitem> + <listitem> + <para>Jan Willem van de Meent (Adios), &krusader; + icons</para> + </listitem> + <listitem> + <para> + <ulink url="http://usefularts.org/">usefularts.org</ulink>, + &krusader; icons</para> + </listitem> + <listitem> + <para>Hans Loffler, directory history list</para> + </listitem> + <listitem> + <para>Jan Halasa, new bookmark module</para> + </listitem> + <listitem> + <para>Mikolaj Machowski, Usability and QA</para> + </listitem> + <listitem> + <para>Cristi Dumitrescu, QA, bug-hunting, patches and general + help</para> + </listitem> + <listitem> + <para>Aurelien Gateau, patch for KViewer</para> + </listitem> + <listitem> + <para>Milan Brabec, the first patch ever !</para> + </listitem> + </itemizedlist></para> + <para>Thanks to the Documentation translators: + <itemizedlist> + <listitem> + <para>Russian: Roman Batejkin</para> + </listitem> + </itemizedlist></para> + <para>Thanks to the GUI translators: + <itemizedlist> + <listitem> + <para>Bosnian: Asim Husanovic</para> + </listitem> + <listitem> + <para>Brazilian Portuguese: Doutor Zero</para> + </listitem> + <listitem> + <para>Bulgarian: Milen Ivanov</para> + </listitem> + <listitem> + <para>Catalan: Rafael Munoz Rodriguez, Quim Perez + Noguer</para> + </listitem> + <listitem> + <para>Chinese: Jinghua Luo</para> + </listitem> + <listitem> + <para>Czech: Martin Sixta, Václav + Jůza</para> + </listitem> + <listitem> + <para>Danish: Anders Bruun Olsen, Christian Sonne, Peter + H.S.</para> + </listitem> + <listitem> + <para>Dutch: Frank Schoolmeesters</para> + </listitem> + <listitem> + <para>French: René-Pierre Lehmann, David + Guillerm</para> + </listitem> + <listitem> + <para>German: Christoph Thielecke, Dirk Eschler</para> + </listitem> + <listitem> + <para>Greek: Spiros Georgaras</para> + </listitem> + <listitem> + <para>Hungarian: Kukk Zoltan, Arpad Biro, Karai Csaba</para> + </listitem> + <listitem> + <para>Italian: Giuseppe Bordoni</para> + </listitem> + <listitem> + <para>Japanese: UTUMI Hirosi, Hideki Kimura</para> + </listitem> + <listitem> + <para>Lithuanian: Dovydas Sankauskas</para> + </listitem> + <listitem> + <para>Polish: Marcin Szafran, Lukasz Janyst, Marcin Garski, + Pawel Salawa, Tomek Grzejszczyk</para> + </listitem> + <listitem> + <para>Portuguese: Bruno Queirós</para> + </listitem> + <listitem> + <para>Russian: Dmitry V. Chernyak, Denis Koryavov, Nick + Shaforostoff, Dmitry A. Bugay</para> + </listitem> + <listitem> + <para>Serbian: Sasa Tomic</para> + </listitem> + <listitem> + <para>Slovak: Zdenko Podobný</para> + </listitem> + <listitem> + <para>Slovenian: Matej + Urbančič</para> + </listitem> + <listitem> + <para>Spanish: Rafael Munoz Rodriguez, Alejandro Araiza + Alvarado, Alex Araiza</para> + </listitem> + <listitem> + <para>Swedish: Erik Johansson, Anders + Lindén, Peter Landgren</para> + </listitem> + <listitem> + <para>Turkish: Bekir Sonat</para> + </listitem> + <listitem> + <para>Ukrainian: Ivan Petrouchtchak</para> + </listitem> + </itemizedlist>And to all the other translators, we're sorry we + can't list all of your names here. Please take a look in the + headers of the + <filename>foo.po</filename> files to see + &i18n-credits-url;.</para> + <para>If your native language is not listed above and you would + like to translate &krusader; into your language, + please read the &i18n-page-url;.</para> + <para>For more credits, read the &changelog-url; file + online or in the Krusader sources.</para> + <para>Documentation Copyright 2000-2003 Shie Erlich and Rafi + Yanai. Copyright 2004-2008 &krusader; Krew + <email>krusader@users.sourceforge.net</email>.</para> + <!-- &underGPL; --> + <!-- GPL License, do not remove --> + <para>This program is licensed under the terms of the + <ulink url="http://www.gnu.org/copyleft/gpl.html">GNU General + Public License</ulink> Version 2, June 1991.</para> + <!-- &underFDL; --> + <!-- FDL License, do not remove --> + <para>This documentation is licensed under the terms of the + <ulink url="http://www.gnu.org/copyleft/fdl.html">GNU Free + Documentation License</ulink>.</para> +</chapter> diff --git a/doc/en/diskusage.docbook b/doc/en/diskusage.docbook new file mode 100644 index 0000000..a8868c4 --- /dev/null +++ b/doc/en/diskusage.docbook @@ -0,0 +1,120 @@ +<sect1 id="diskusage"> + <title>Disk Usage</title> + <indexterm> + <primary>Disk Usage</primary> + </indexterm> + <para>The Disk Usage is based on the code of + &filelight;. The Disk Usage shows you how your disk + space is being used by a graphical representation of your + file system. The following presentations are possible: + <itemizedlist> + <listitem> + <para>Line view</para> + </listitem> + <listitem> + <para>Detailed view</para> + </listitem> + <listitem> + <para>&filelight; view: as a set of concentric + segmented-rings</para> + </listitem> + </itemizedlist>Choose + <emphasis role="bold"> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Disk Usage</guimenuitem> + </menuchoice> + </emphasis> or + <keycombo action="simul">&Alt; + <keycap>d</keycap></keycombo> to start this feature in a separate + window, or open it inside the + &popup-panel-lnk;.</para> + <para>Disk Usage Keybindings, right click menu. + <itemizedlist> + <listitem> + <para> + <keycap>Del</keycap>: Delete</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>e</keycap></keycombo>: Exclude</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Arrow Up</keycap></keycombo>: parent dir</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>n</keycap></keycombo>: new search</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>r</keycap></keycombo>: refresh</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>i</keycap></keycombo>: include all</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Arrow Down</keycap></keycombo>: step into</para> + </listitem> + <listitem> + <para>View menu: + <itemizedlist> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>l</keycap></keycombo>: Line view</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>d</keycap></keycombo>: Detailed view</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo>: Filelight view</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Arrow Right</keycap></keycombo>: Next view</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Arrow Left</keycap></keycombo>: Previous + view</para> + </listitem> + </itemizedlist></para> + </listitem> + </itemizedlist></para> + <!-- OLD +<screenshot> + <screeninfo>Disk Usage</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="diskusage.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="diskusage.png" format="EPS"/></imageobject> + <textobject><phrase>Konfigurator Look & Feel page</phrase></textobject> + <caption><para>Disk Usage</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-diskusage" float="1"> +<title>Disk Usage</title> +<mediaobject> +<imageobject><imagedata fileref="diskusage.png"/></imageobject> +<textobject><phrase>Disk Usage</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> +</sect1> diff --git a/doc/en/editors-note.docbook b/doc/en/editors-note.docbook new file mode 100644 index 0000000..cf550b9 --- /dev/null +++ b/doc/en/editors-note.docbook @@ -0,0 +1,73 @@ +<!-- ********************************************************************** + editors-note.docbook + ++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> +<preface id="editors_note"> + <title>Note from the Editors</title> + + <para>As you may notice, this handbook is written by various authors. + The draft explanation of new features is done by the developers on the + krusader-devel mailinglist, the editors add this information in this handbook. + We have taken much care in ensuring technical and vocabulary consistency. + The authors write in English even though it is not their native language; + therefore, you may notice strange sentence constructions. + Do not hesitate to let us know, if something is not clear to you.</para> + + <para>An open source project's greatest strength is derived from getting user + feedback. That's why we would love to hear what you have to say. + <emphasis>Documentation contributors are always welcome!</emphasis>, + since this is a time consuming task. + If you have ideas on how to improve the content, + if you would like to write about an undocumented &krusader; feature, or + if you have comments or suggestions about the &krusader; Handbook, please let us know. + You can contact us even if you find typos!</para> + + <para>The Handbook "revision" matches the &krusader; version number. + ⪚ "&krusader; Handbook revision 1.80.x" describes "&krusader; 1.80.x"</para> + + <para>Please read the &docchangelog-url; file online or in the &krusader; sources to find + out the latest changes in the &krusader; Handbook.</para> + + <para>For information about the &krusader; documentation project, + please contact the &krusader; documentation coordinator, Frank Schoolmeesters + <email>frank_schoolmeesters@yahoo.com</email>.</para> + + +<para>This handbook is available in several formats. +<itemizedlist> + <listitem> + <para>via the <ulink url="help-menu.html">Help Menu</ulink> when using &krusader;</para> + </listitem> + <listitem> + <para>the &onlinehandbook-url;</para> + </listitem> + <listitem> + <para>As documentation tarballs (HTML, TXT, RTF, PDF, XML-SOURCE), + download them from the &sfmirrors-url;</para> + </listitem> +</itemizedlist> +The most recent version of this handbook is available when using &krusader; from cvs +or the &onlinehandbook-url;. +</para> + +&dev-cvs-note; + +<para>All mentioned Trademarks and Copyrights in this handbook belong to their respective owners.</para> + +</preface> diff --git a/doc/en/faq.docbook b/doc/en/faq.docbook new file mode 100644 index 0000000..4051f9c --- /dev/null +++ b/doc/en/faq.docbook @@ -0,0 +1,1848 @@ +<chapter id="faq"> + <!-- ********************************************************************** + faq.docbook + ++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Frequently Asked Questions (&FAQ;)</title> + <indexterm> + <primary>FAQ</primary> + </indexterm> + <!-- &reporting.bugs; + &updating.documentation; --> + <para>If you have problems with &krusader; please + check the &install-proc-lnk;, as your problem may be + caused by a bad installation.</para> + <para>The &FAQ; is divided into three sections: + <itemizedlist> + <listitem> + <para> + <link linkend="faq_installation">Installation + &FAQ;</link> (this page)</para> + </listitem> + <listitem> + <para> + <link linkend="faq_usage">Usage + &FAQ;</link> (issues with running/using + &krusader;)</para> + </listitem> + <listitem> + <para> + <link linkend="faq_general">General + &FAQ;</link> (bug reports, forum, mailing list, + ...)</para> + </listitem> + </itemizedlist>If you feel that a &FAQ; is missing or + if something is not clear to you, please + <link linkend="editors_note">let us know</link>.</para> + <sect1 id="faq_installation"> + <title>Installation &FAQ;</title> + <qandaset> + <qandaentry> + <question id="faqi_kdelibs"> + <para>Does &krusader; need &kde; to + run?</para> + </question> + <answer> + <para> + <emphasis>No, &krusader; does not need the + &kde; window manager</emphasis> to run on your + computer but &krusader;'s natural environment + is &kde;, because it relies on services + provided by the &kde; base libraries. Only + some shared libraries are needed ⪚ + &kde; libraries, &Qt; libraries, + &etc; This means that &krusader; + runs on &gnome-url;, + &afterstep-url;, &xfce-url; and + other window managers provided the approriate libraries + are installed on your computer. All this is not a problem + since the apt-get world can resolve these dependencies + instantly.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para>You do not need to switch to the &kde; + window manager to use &krusader;; you can + still use &gnome-url;, + &afterstep-url;, &xfce-url; or + another window manager. However, the configuration of the + &krusader; fonts and some behavior is done by + running + <command>kcontrol</command>.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para>A lot depends on what you want to do with + &krusader;. You should know that + &krusader; uses the &kde; + &kioslaves1-url; to access remote file + systems, and support for only a limited number of file + system types are shipped with &kdelibs-url;, + most of the &kioslaves2-url; are bundled with + &kdebase-url; (including fish, sftp and tar). + However, if you want the property-dialog to show + EXIF-data for .jpeg's, you need &kde;graphics. + If you want ID3-infos, you need + &kde;multimedia, and so on.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para>To summarize, if you want a working + &krusader; - install &kde;libs. If + you want a functional &krusader; then you need + &kde;libs + &kde;base. For maximum + functionality, &krusader; needs all of the + &kde; package libraries, but the + &kde; window manager is optional.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_libs"> + <para>Which libraries does &krusader; need to + run?</para> + </question> + <answer> + <para>For running &krusader; (⪚ + when you have installed &krusader; with a + binary RPM) you need less libraries than if you compile + &krusader; from source. ⪚ you + only need the C-compliler &gcc; when you + compile &krusader; from source (see the next + question).</para> + <para>Here is a list of the required shared libraries + when you run &krusader;:</para> + <para> + <itemizedlist> + <listitem> + <para>kdelibs (for the required &kde; + version see the &install-proc-lnk;)</para> + </listitem> + <listitem> + <para>libacl1 libart-2.0 libattr1 libaudio2 libc6 + libfam0 libfontconfig1</para> + </listitem> + <listitem> + <para>libfreetype6 libgcc1 libgcc2 libice6 libidn11 + libjpeg62 libkjsembed1</para> + </listitem> + <listitem> + <para>libkonq4 libpcre3 libpng12 libqt3-mt libsm6 + libstdc++6 libunwind7 libx11-6</para> + </listitem> + <listitem> + <para>libxcursor1 libxext6 libxft2 libxi6 + libxinerama1 libxrandr2 libxrender1 libxt6 + zlib1g</para> + </listitem> + </itemizedlist>If you need more info please take a look + at the &deb-requirements-url; .</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_missing_libs"> + <para>I have followed all the steps but + <command>configure</command>complains about missing libs + or headers. What do I need to do?</para> + </question> + <answer> + <para>Install the missing packages.</para> + <para>Here is a list of the required packages to compile + &krusader; from source:</para> + <para> + <itemizedlist> + <listitem> + <para>gcc-cpp gcc-c++ glibc libgcc1 (other + compilers may work but haven't been tested)</para> + </listitem> + <listitem> + <para>autoconf automake XFree</para> + </listitem> + <listitem> + <para>libqt3 libqt-devel</para> + </listitem> + <listitem> + <para>kdelibs kdelibs-devel</para> + </listitem> + <listitem> + <para>libjpeg62 libjpeg-devel libpng3 + libmng1</para> + </listitem> + <listitem> + <para>fam libfam-devel</para> + </listitem> + <listitem> + <para>zlib1 arts libart_lgpl2 libstdc++5 + libpcre0</para> + </listitem> + <listitem> + <para>libkjsembed, if you use the + &javascript-console-lnk;, often found in + a package called KDEbindings(-devel) and + libkonq-dev for the &konqueror; + right-click menu entries.</para> + </listitem> + </itemizedlist> + </para> + <para>Most RPM-based distributions separate the headers + from the libs. The headers are needed to compile + &krusader;. Look for packages in the form + foo-devel-*.rpm (⪚ + <filename>kdelibs-devel-foo.i586.rpm</filename>) or + foo-dev-*.deb for &debian; based + distributions. These are usually included with your + distribution. + <tip> + <para>If you ca not find the needed package, use + &rpmfind-url; and click 'missing lib or + header' in the search line. Or use + <command>apt-cache search + <replaceable>foo</replaceable></command> to find the + corresponding package for &debian; based + distributions.</para> + </tip></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_64bit"> + <para>How do I compile &krusader; when I'm + using a 64 bit processor ?</para> + </question> + <answer> + <para>As far as we know, there are no issues. + &krusader; is also available on + <ulink url="http://packages.debian.org/unstable/utils/krusader"> + many other architectures</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_rpm-source"> + <para>I have downloaded the Source RPM + <filename>krusader-x.xx.dist.src.rpm</filename>, what to + do now?</para> + </question> + <answer> + <para> + <orderedlist> + <listitem> + <para>Check the ownership and the permissions on + <filename class="directory"> + /usr/src/RPM/</filename> and all recursive + directories that your normal user can + read-write-execute in these directories.</para> + </listitem> + <listitem> + <para>To produce the binary RPM for your computer, + do this: + <screen><prompt>$</prompt> <userinput><command>rpm</command> <option>--rebuild</option> <replaceable></path/to/rpmfile/> krusader-x.xx.dist.src.rpm</replaceable></userinput></screen> + </para> + </listitem> + <listitem> + <para>If all + <link linkend="faqi_missing_libs"> + dependencies</link> are OK, a binary RPM + <filename>krusader-x.xx.dist.rpm</filename> will be + created at + <filename class="directory"> + /usr/src/RPM/RPMS/i586</filename> (replace i586 with + your architecture).</para> + </listitem> + <listitem> + <para>Test the binary RPM for errors before + installing: + <screen><prompt>$</prompt> <userinput><command>rpm</command> <option>-i --test</option> <replaceable></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable></userinput></screen> + If the prompt returns without any message, + then everything is OK.</para> + </listitem> + <listitem> + <para>Install the binary RPM as usual, for example: + <screen><prompt>$</prompt> <userinput><command>su -c 'rpm</command> <option>-Uvh</option> <replaceable></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable>'</userinput></screen> + You will be asked to enter your root + password.</para> + </listitem> + <listitem> + <para>Now you can + <link linkend="starting-krusader"> + start</link> &krusader;.</para> + </listitem> + </orderedlist> + </para> + <para></para> + <!-- Empty line to make it more readable --> + <tip> + <para>For more information about RPM, visit + &rpm-org-url; and read the + &rpm-guide-url; by Eric + Foster-Johnson.</para> + </tip> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_rpm-fails"> + <para>I'm trying to install binary foo (RPM or DEB + package), but it fails. What's wrong?</para> + </question> + <answer> + <para>Since we only prepare (and use) the source, we have + no way of knowing this. Did you test the binary RPM + before installing? + <screen><prompt>$</prompt> <userinput><command>rpm</command> <option>-i --test</option> <replaceable></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable></userinput></screen> + If the prompt returns without any message, then + everything is OK. RPM's downloaded from our website are + usually provided by &krusader; users. Visit + your distro website and search for an updated RPM.</para> + <para>If the RPM is not OK, try to find another package + at &Linux; software archives such as + &freshmeat-url; or &kde-apps-url;. + If you still can't find the appropriate package for your + &Linux; distribution, we recommend searching + for it with &rpmfind-url; or + &rpmpbone-url;.</para> + <para>In general, a package for an older version of your + distrubution or even for another distribution might work + on your computer (⪚ FC RPM's often work on + Mdk and RH, and vice versa), but it is always the best + that you install only RPM's that exactly match your + distribution. If you can't find a package that matches + your distribution version, architecture or distribution, + then use a source RPM. When you use a source RPM, the + Krusader sources will be built, on your computer, + guaranteeing a suitable binary RPM for your specific + distribution and architecture. In addition, this method + results in maximum system speed, since the resulting + binary is customized for your computer. Please read the + previous question, it explains how to install a source + RPM. The best solution is explained in the next + question.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_rpm-notfound"> + <para>I can't find an RPM or DEB package for + &krusader;, what to do?</para> + </question> + <answer> + <para>Check if your distribution provides + &krusader;, if it doesn't then contact your + distribution creator and ask them to include + &krusader;!</para> + <para>Did you take a look at the &URL;'s on + the &install-proc-lnk; page? If you have and + found nothing, you can always compile + &krusader; from source. Even if you feel you + haven't got the necessary skills, you will probably + succeed in compiling &krusader;: we provide a + very detailed installation procedure. This HowTo enables + newcomers to compile &krusader; from source, + even if they have never done a compilation from source + before, just follow the instructions carefully. Feel free + to post a &help-request-lnk; if you encounter + problems.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_krusaderui_rc"> + <para>I've installed &krusader;, but when I + start, only the + <guimenu>"Help"</guimenu> menu appears. Why?</para> + </question> + <answer> + <para>In this case only the + <guimenu>Help</guimenu> menu is visible and all other menu + items like ⪚ + <guimenu>File</guimenu> and + <guimenu>Select</guimenu> are missing. This is because + some distributions put the + <filename>krusaderui.rc</filename> file in the wrong + directory. To solve the problem, just copy the + <filename>krusaderui.rc</filename> file from the package + <filename> + krusader_kde3/krusader/krusaderui.rc</filename> to + <filename> + $KDEDIR/share/apps/krusader/krusaderui.rc</filename> and + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename> and + re-run &krusader;. If you have compiled + &krusader; from sources this is often caused + if the &kdeqtdir-lnk; environment variables + are not correctly set. The result is that the + <filename>krusaderui.rc</filename> file is installed in + the wrong directory. Please read the following question, + as well.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_missing_menus"> + <para>Some new menu items are missing after updating + &krusader;, what's wrong?</para> + </question> + <answer> + <para>The + <filename>krusaderui.rc</filename> file is stored in + <filename> + $KDEDIR/share/apps/krusader/krusaderui.rc</filename>. + When you change the + <guilabel>"Toolbar"</guilabel>, &kde; makes a + copy of that file in the home directory at + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename>. If + Krusader was previously installed on your computer, and + you install a newer &krusader; version the + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename> file + must be replaced with the newer version. Note: this will + also reset all your changes on toolbars and + shortcuts!</para> + <para>The first line of + <filename>krusaderui.rc</filename> contains the version + number. After installing a newer &krusader; + version, &kde; will automatically replace the + old + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename> with + the newer version when starting the new + &krusader; for the first time + (&kde; will detect the newer version number in + the first line).</para> + <para>If you install a CVS or beta version and + &krusader; was already installed on your + computer then you should delete the + <filename>krusaderui.rc</filename> file from your home + directory to activate the new menu entries + <prompt>$</prompt> + <userinput> + <command>rm</command> + <option> + ~/.kde/share/apps/krusader/krusaderui.rc</option> + </userinput></para> + <para>If the + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename> file + is older, then the new menu elements will not be shown. + Read the previous question for information on how to + update the + <filename>krusaderui.rc</filename> file. If + <filename>krusaderui.rc</filename> is missing or in a + wrong directory, only the + <guimenu>"Help"</guimenu> menu appears, please read the + previous question.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_libfam_la"> + <para>When I run + <command>make</command>, it complains about + <filename>libfam.la</filename>, what's wrong?</para> + </question> + <answer> + <para>The + <command>./configure</command> script does not check for + the presence of + <filename>libfam.la</filename>, and + <command>make</command> needs + <filename>libfam.la</filename> to compile + &krusader;. If you know how this can be + solved, please let us know. Install + <filename>libfam0-devel-foo.rpm</filename>. Note: when + you install &Mandrake;-&Linux; 9.2 + with the default settings, this package is not installed. + If you need more information take a look at + &missing-libs-lnk;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_deb-qt"> + <para>&debian; complains about &Qt; + when running + <command>./configure</command>, what's wrong?</para> + </question> + <answer> + <para>This problem occurs when you use &gcc; + 2.95, you need to install &gcc; 3.2 (or + higher). You also need to set the enviroment variables + "CC, CPP and CXX" before running the + <command>./configure</command> script. + <screen><prompt>$</prompt> <userinput><command>export</command> CC=<replaceable>/usr/bin/gcc-3.2</replaceable></userinput> + <prompt>$</prompt> <userinput><command>export</command> CXX=<replaceable>/usr/bin/g++-3.2</replaceable></userinput> + <prompt>$</prompt> <userinput><command>export</command> CPP=<replaceable>/usr/bin/cpp-3.2</replaceable></userinput> + </screen> + For more information please take a look + &debian-qt-a-url; and at the + &debian-qt-b-url; on how to build a + &Qt;/&kde;3 application on + &debian;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_nvidia"> + <para>I have a + <filename>libGLcore.so.1</filename> compile error after + using the &nvidia; installer, what to + do?</para> + </question> + <answer> + <para>This problem occurs when you use the + &nvidia; installer and not the official + &nvidia; packages of your distribution. + &krusader; is based on &Qt; which + can be linked against the X OpenGL libraries. As a result + &krusader; may look for OpenGL as well. The + problem is that the &nvidia; installer (prior + to version 7xxx) doesn't perform it's task properly: it + replaces the OpenGL header files (which get included into + &krusader;) but doesn't set the libGL links + correctly. The best solution is to use the + &nvidia; packages provided by your distributor + or a new &nvidia; installer, the current + version at the moment of writing is 7114. If, for some + reason, you must use an old &nvidia; driver, + one solution is the following hack, the exact commands + depend on the distribution used and the version of the + &nvidia; driver (6111 in this example), but it + should read something like this: + <screen><prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.1.0.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.0.0.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.0.0.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.1</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.1.0.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>/usr/lib/libGLU.la /usr/X11R6/lib/libGLU.la</replaceable></userinput> + </screen></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_gcc4"> + <para>Why &krusader;-1.60.x does not compile + with gcc4?</para> + </question> + <answer> + <para>Because &krusader;-1.60.x was not gcc4 + compatible, it first needs some patches: + <itemizedlist> + <listitem> + <para>add 'class ListPanelFunc;' in + krusader/Panel/listpanel.h</para> + </listitem> + <listitem> + <para>add 'class KMountManGUI;' in + krusader/MountMan/kmountman.h</para> + </listitem> + <listitem> + <para>add 'class KrDetailedViewItem;' in + krusader/Panel/krdetailedview.h</para> + </listitem> + </itemizedlist>More information can be found in our + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1328"> + forum</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_help_request"> + <para>I am having trouble compiling and installing + &krusader;, how do I send a help + request?</para> + </question> + <answer> + <para>Please read our detailed + <link linkend="compilation">installation + procedure</link> and the &faq-lnk;. If you + can't find a solution to your problem then feel free to + post a + <emphasis role="bold">help request</emphasis> at our + &krusader; forum or use the + &kruusers-url; mailing list. But before + posting a help request, please try the following: + <orderedlist> + <listitem> + <para>Use the &kruforumsearch-url; + function on the &forum-lnk;, your problem + might be solved or discussed already.</para> + </listitem> + <listitem> + <para>If you can't find a solution, please make a + note of the following issues: + <itemizedlist> + <listitem> + <para>the &krusader; version + used</para> + </listitem> + <listitem> + <para>the &Linux; distribution + + version used</para> + </listitem> + <listitem> + <para>a good description of the problem</para> + </listitem> + </itemizedlist>Without this information, it is very + difficult for us to help you. + <note> + <para>If you give us the error messages + (⪚ + <command>make</command> error messages) please start + with the FIRST error message, all the error + messages which follow the first error message are + consequences and not the cause of your + problem.</para> + </note></para> + </listitem> + <listitem> + <para>Send out your help request.</para> + </listitem> + </orderedlist></para> + <para>Thank you for your co-operation!</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_rpm-build"> + <para>How can I build an RPM package for + &krusader;?</para> + </question> + <answer> + <para>If you have experience with compiling from source, + you will probably be able to build a + &krusader; RPM too. Information about RPM can + be found at &rpm-org-url; and in the + &rpm-guide-url; by Eric Foster-Johnson. The + following is the short procedure howto on building an + RPM.</para> + <warning> + <para>NEVER build RPMs when logged in as root. Mistakes + in building packages (⪚ a bad + <filename>krusader.spec</filename> file) can do serious + damage to your system when logged in as root.</para> + </warning> + <para> + <orderedlist> + <listitem> + <para>Compile &krusader; from source to + check that the compilation works fine.</para> + </listitem> + <listitem> + <para>Check the ownership and the permissions on + <filename class="directory"> + /usr/src/RPM/</filename> and all recursive + directories that your normal user can + read-write-execute in these directories.</para> + </listitem> + <listitem> + <para>Copy + <filename>kusader-1.xx.tar.gz</filename> to + <filename class="directory"> + /usr/scr/RPM/SOURCE</filename></para> + </listitem> + <listitem> + <para>Copy + <filename>kusader.spec</filename> to + <filename class="directory"> + /usr/scr/RPM/SPECS</filename> Tip: the latest + <filename>kusader.spec</filename> can be found in + CVS.</para> + </listitem> + <listitem> + <para>Edit + <filename>kusader.spec</filename> and add your name, + your e-mail address, the rpm name, ... Other + changes may be needed if + <command>rpmbuild</command> fails.</para> + </listitem> + <listitem> + <para>Build the binary and the source RPM with: + <screen><prompt>$</prompt> <userinput><command>rpmbuild</command> <option>-ba</option> <replaceable>/usr/scr/RPM/SPECS/krusader.spec</replaceable></userinput></screen> + If everything went OK you will have a + binary RPM in + <filename class="directory"> + /usr/src/RPM/RPMS/i586</filename> (depending on your + architecture) and a source RPM in + <filename class="directory"> + /usr/src/RPM/SRPMS/</filename> ⪚ + <filename> + krusader-1.70-beta1.suse10.i586.rpm</filename> and + <filename> + krusader-1.70-beta1.suse10.src.rpm</filename></para> + </listitem> + <listitem> + <para>If the build is not OK you will receive an + error message during the rpmbuild process, try to + fix it and run + <command>rpmbuild</command> again.</para> + </listitem> + <listitem> + <para>And finally: + <link linkend="faqi_rpm-source">test</link> the RPM + before sending it in.</para> + </listitem> + </orderedlist> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_cvs_verion"> + <para>Why does &krusader;-cvs show an old + version number in the about box?</para> + </question> + <answer> + <para>Because we only change the version number just + before we do a new release. &krusader;-cvs + will show an older version number, so ignore the version + number and check the download date. We simply haven't yet + decided what the next version number will be.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + </qandaset> + </sect1> + <sect1 id="faq_usage"> + <title>Usage &FAQ;</title> + <qandaset> + <qandaentry> + <question id="faqu_qt355"> + <para>&krusader; keeps crashing, why?</para> + </question> + <answer> + <para>We've been receiving a lot of emails and bug + reports (December 2005) regarding random crashes, + especially during file operations such as copy, move, + etc. + <emphasis role="bold">These crashes are related to + &Qt; 3.3.5 and NOT + &krusader;.</emphasis> It seems that + &Qt; 3.3.5 introduced a serious bug which is + currently (December 2005) causing random crashes in many + &kde; applications including + &konqueror;. You can use Google to find out + more. As far as we know, &debian;-Sid and + &SuSE; already posted new &Qt; + binaries that fix the problem, and &gentoo; + has masked &Qt; 3.3.5 completely. As for now, + you either need &Qt; 3.3.4 or a fixed + &Qt; 3.3.5 or a higer version, depending on + your distribution. More information is available on our + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1407"> + website</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_supermount"> + <para>When I try to mount/unmount my cdrom/floppy, + &krusader; reports something about a + supermount, what's this about?</para> + </question> + <answer> + <para>Supermount is a daemon which handles the + mounting/unmounting of removable filesystems for you. + Just insert a floppy, and do + <userinput> + <command>cd</command> + <option> + <replaceable>/mnt/floppy</replaceable> + </option> + </userinput>supermount will do the mount for you + automatically and transparently. Usually this works fine. + However, supermount misleads the system into thinking + that the + <hardware>floppy/cdrom</hardware> is mounted at all times! + This creates some problems for &krusader;, as + it cannot really know when the floppy or CD has been + removed because the system information is not correctly + updated by supermount - is there really a + <hardware>floppy</hardware> in the + <hardware>drive</hardware>? Of course, this can be + solved, but as for now, we don't consider it a + priority.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_dead_mountpoint"> + <para>Why does &krusader; freeze or hang on a + dead mountpoint?</para> + </question> + <answer> + <para>When &krusader; is ⪚ + browsing an NFS share and the NFS server goes down, + &krusader; will freeze. This + &krusader; (and all other open internal + viewers/editors) freeze is fatal, and can only be + corrected with the + <command>kill -9</command>. We have no solution for this. + This is an issue not confined to file managers, or even + the &Linux; OS! The problem is that you "hang" + on the first access to the dead share - so there is no + way around it, no check to avoid it, even + <command>ls</command> will freeze. Just trying to read + something - anything - is enough to get you stuck. The + one and only way around this architectural problem is + using a multi-threaded design - this way if we get stuck, + we don't hang the entire application event loop, but we + don't think that the time is right for adding threads, we + are not sure that *all* the &kde; systems out + there are using &Qt;-mt (the multi threaded + version of the &Qt; library), and the Krusader + Krew may not be the right people to address this major + issue in any case; so currently this is just a bug we + have to learn to live with.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_resize"> + <para>When I try to resize &krusader; to make + it smaller, I discover that I can't resize it below a + certain size. Why?</para> + </question> + <answer> + <para>See the + <guibutton>F1, F2</guibutton> (&etc;) buttons? + They are not allowing &krusader; to downsize + as they have a minimum size. Just disable them + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show FN Keys Bar</guimenuitem> + </menuchoice> + and you'll be able to resize + &krusader; to your liking. Since version 1.51 + we have improved this greatly: when downsizing the + buttons will look like 'F5 ..py'. When the button faces + are too small to read a tooltip will give the complete + text. The minimum width is 45 pixels for each + button.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_refresh"> + <para>When I perform some file operations, + &krusader;'s panel doesn't refresh / I'm using + &krusader; with fam installed, but updates to + the panel are not shown. Why?</para> + </question> + <answer> + <para>The bad news is that we're not sure why, but it + seems that + <command>fam</command> (file alteration monitor) sometimes + refuses to work. We are looking into this problem to make + sure it is not + <emphasis>our</emphasis> problem. We've tried the same + source code on two different Gentoo installations: one + worked, the other did not. The good news is that if you + disable + <application>fam</application>, &krusader; + will automatically revert to its internal update + mechanism (which is less efficient, but works) without + needing to recompile. You can disable + <application>fam</application> with: + <screen><prompt>$</prompt> <userinput><command>su -c 'fam -l'</command></userinput></screen> + Look at the manpages for more information about + <application>fam</application>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_samba_codepage"> + <para> + <application>Samba</application> ISO 8859-x codepage / + What to do if &krusader; does not read shared + directories containing special international + characters?</para> + </question> + <answer> + <para>&krusader; does not handle (yet) + <application>Samba</application> ISO 8859-x codepages, if + you use a codepage different than 8859-1 you will have to + do a manual configuration. Create or modify the file: + <filename>~/.smb/smb.conf</filename> + <programlisting>[global] + workgroup = MyWorkGroup (ex. WORKGROUP) + client code page = MyCodePage (ex. 852) + character set = MyCharSet (ex. ISO8859-2) + </programlisting> + Unfortunately + <application>kcontrol</application> (&kde; + 3.1.1) fails to configure smb.conf properly, so this must + be done manually with a text editor.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_krarc_protocol"> + <para>&krusader; reports "krarc:... protocol + not supported" error at opening an archive file, what to + do?</para> + </question> + <answer> + <para>Install the krarc slave properly:</para> + <para>Copy the + <filename>kio_krarc.so</filename>, + <filename>kio_krarc.la</filename> files into + <filename class="directory"> + $KDEDIR/lib/kde3</filename></para> + <para>Copy the + <filename>krarc.protocol</filename> file into + <filename class="directory"> + $KDEDIR/share/services</filename></para> + <para>or the directory where the KIO slaves are placed in + your &Linux; distribution.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_krarc_support"> + <para>I get the error message "Protocol not supported by + Krusader: "krarc:/path/to/foo-archive", when I try to + open foo-Archive, what to do?</para> + </question> + <answer> + <para>The icons, kio_slaves and documentation must be + installed in the correct places in the &kde; + directory tree. The + <filename>kio_krarc.*</filename> files must be in the same + directory with the other KIO slaves. Try this: locate + <filename>kio_tar.*</filename> and copy/link the + <filename>kio_krarc.*</filename> files to the same + location. Don't forget to run + <command># ldconfig</command> on this directory when + you're done. For more information click + <ulink url="www.krusader.org/phpBB/viewtopic.php?t=991"> + here</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + +<qandaentry> + <question id="faqu_external_tool"> + <para>What todo if an extenal tool doesn't seem to work?</para> + </question> + <answer> + <para>Krusader uses several programs as <link linkend="konfig-dependencies">external tools</link>, + and sometimes they appear not to work. + + Open a terminal and check if tool foo is installed. + <screen><prompt>$</prompt> <userinput><command>foo</command></userinput></screen> + + Check if tool foo is properly configured in the &konfigdependencie-lnk;. + + For Archiving tools: autodetect the archives again with the <guibutton>Auto Configure</guibutton> button + in the <link linkend="konfig-archives">Konfigurator archive page</link>. + + Check the &konfigprotocol-lnk; + + If it doesn't work, backup your <filename>~/.kde/share/config/krusaderrc</filename> configuration file and remove it from this location, + Restart Krusader, Krusader will now start the first start configuration wizard, follow these guidelines. + + </para> + <para> </para> <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqu_jar"> + <para>Howto executing jar files (and not enter the jar archive)?</para> + </question> + <answer> + <para>Go to the &konfigprotocol-lnk; and remove <guilabel>application/x-jar</guilabel> + from the krarc node, &krusader; should no longer enter the archive. + Global file associations are handled by &kde; and not by &krusader;. + To assosiate the jar extension: + <itemizedlist> + <listitem> + <para>Open &kde;s control center: <application>kcontrol</application> + </para> + </listitem> + <listitem> + <para> + <menuchoice> + <guimenu>KDE Components</guimenu> + <guimenuitem>File Associations</guimenuitem> + </menuchoice> + </para> + </listitem> + <listitem> + <para>Enter <filename>jar</filename> as filename pattern + </para> + </listitem> + <listitem> + <para>Add <filename>java</filename> as application + </para> + </listitem> + </itemizedlist> + </para> + <para> </para> <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + <!-- Thanks to Dirk Eschler --> + <qandaentry> + <question id="faqu_ftp_firewall"> + <para>Why do I have trouble with my &FTP; + connection?</para> + </question> + <answer> + <para>This problem often occurs when you are behind a + firewall or proxy. Open + <menuchoice> + <guimenu>KDE Control Center</guimenu> + <guimenuitem>Network</guimenuitem> + <guimenuitem>Preferences</guimenuitem> + </menuchoice>, + <guilabel>"Enable Passive Mode (PASV)"</guilabel> has to + be turned on or off, depending on it's current setting. + Now try your &FTP; session again to see if it + works. Also, make sure you have no other &FTP; + sessions open (using web browsers, etc.), they can cause + complications. More information can be found in + &active-passive-ftp-url;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_ftp_http_proxy"> + <para>I get + <errorcode>"FTP protocol not supported by + &krusader;"</errorcode> error when trying to + open a remote &FTP; directory, what to + do?</para> + </question> + <answer> + <para>The reason for this error is that '&FTP; + via &HTTP; proxy' feature is not yet supported + by &krusader;. This error may be caused by a + misconfiguration of the proxy settings in + &kcontrolcenter;. Modify the proxy settings to + not use &HTTP; proxy and &FTP; will + work.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_no_part"> + <para>How don't add ".part" suffix when copying files via ftp?</para> + </question> + <answer> + <para>When uploading files a <filename>.part</filename> suffix is added to the filename, + once the upload is complete the filename is renamed automagically + to remove the <filename>.part</filename> suffix. + This works great but sometimes some ftp-servers don't allow a rename operation. + You can solve this by unchecking the checkbox + <guilabel>Mark partially uploaded files</guilabel> in &kde;'s control center. + The checkbox is located at + <menuchoice> + <guimenu>Internet and Network</guimenu> + <guimenuitem>Connection Preferences</guimenuitem> + </menuchoice>.</para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_close_connection"> + <para>How can I close a remote connection + (⪚ a FTP connection)?</para> + </question> + <answer> + <para>It's explained in the + <link linkend="remote-connections">remote connections + chapter</link>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_media_protocol"> + <para>I am experiencing problems with the media:// + protocol, why?</para> + </question> + <answer> + <para>At the moment of writing the media:// protocol is + instable, we need to wait until the &kde; team + corrects it, every other protocol works properly with + &krusader;, only media fails. More information + regarding this issue is available in + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1357"> + our forum</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <!-- Thanks to thepieman at the Krusader Forum --> + <qandaentry> + <question id="faqu_sound"> + <para>How can I disable the default sounds, + ⪚ when I do a delete action ?</para> + </question> + <answer> + <para>Those are the default &kde; System + sounds, and not related to &krusader;. If you + want to disable them globally open your &kde; + &kcontrolcenter; ( + <application>kcontrol</application>): + <menuchoice> + <guimenu>KDE Control Center</guimenu> + <guimenuitem>Sound & + Multimedia</guimenuitem> + <guimenuitem>System Notifications</guimenuitem> + </menuchoice>, + <guilabel>Event Source: "KDE System + Notifications"</guilabel> and uncheck sound items you + don't like.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_remoteMan"> + <para>Where is RemoteMan, the remote connection manager + ?</para> + </question> + <answer> + <para>RemoteMan has been replaced by our Bookmark Manager + since Krusader 1.25-beta1. The Bookmark Manager handles + local files and + <link linkend="remote-connections">remote + &URL;'s</link> the same way. RemoteMan was left + as a selection until &krusader;-1.51 to allow + an easier transition and give you a chance to move your + &bookmarks-lnk;. RemoteMan was disabled, as + announced, in &krusader;-1.60.</para> + <para>&URL; transition procedure: + <orderedlist numeration="arabic"> + <listitem> + <para>install &krusader;-1.51</para> + </listitem> + <listitem> + <para>open the RemoteMan and connect to an + &FTP;</para> + </listitem> + <listitem> + <para>once inside, bookmark the current location, + select a name and save.</para> + </listitem> + <listitem> + <para>do this for all your connections, all the + &bookmarks-lnk; are now stored in + <filename>krbookmarks.xml</filename></para> + </listitem> + <listitem> + <para>install &krusader;-1.60, it will use + <filename>krbookmarks.xml</filename> or import it if + needed.</para> + </listitem> + </orderedlist></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_mimetypemagic_archives"> + <para>Why doesn't mimetype magic sometimes work inside + archives?</para> + </question> + <answer> + <para>When you enter an archive and press + <keycap>F3</keycap> to view a file that has no known + extension, ⪚ + <filename>README, INSTALL</filename> &etc;. And + if the viewer opens in hex-mode instead of the usual + mode, than you need to configure: + <menuchoice> + <guimenu>KDE Control Center</guimenu> + <guimenuitem>KDE components</guimenuitem> + <guimenuitem>File Associations</guimenuitem> + <guimenuitem>Application</guimenuitem> + <guimenuitem>octet-stream</guimenuitem> + </menuchoice>, + <guilabel>binary viewer</guilabel> needs to be + removed.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_konfigurator"> + <para>Where is Konfigurator, do i need to install the &kde; Desktop Enviroment to use it?</para> + </question> + <answer> + <para><link linkend="konfigurator">Konfigurator</link> is &krusader;s configuration module, + when you have installed &krusader; than you have also Konfigurator. + For some reason some people think it's an other &kde; application, but it is not, so + you don't need to install the &kde; Desktop Enviroment to use Konfigurator. + When runnig &krusader;, use + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure &krusader;</guimenuitem> + </menuchoice>, and it will start + <link linkend="konfigurator">Konfigurator</link>. + Please read the manual, &krusader; has many many configuration options, + a lot of things can be customized to your needs with <link linkend="konfigurator">Konfigurator</link>. + </para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_equal_lookandfeel"> + <para>How can I set the look & feel of 2 + different users to be the same?</para> + </question> + <answer> + <para>Presuming that the current setup is the good + configuration, you can copy the configuration to the + other user. + <screen><prompt>#</prompt> <userinput><command>cp ~/.kde/share/config/krusaderrc /home/foo_user/.kde/share/config</command></userinput></screen> + And when the other user is Root use: + <screen><prompt>#</prompt> <userinput><command>cp ~/.kde/share/config/krusaderrc /root/.kde/share/config</command></userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_save_last_location"> + <para>Why doesn't "save last location" work?</para> + </question> + <answer> + <para>Unfortunately the 1.70.x version contains a bug. + The tabs are not saved if a "Panels Save Settings=Tabs" + item is present in the configuration files. The fix is + easy: + <itemizedlist> + <listitem> + <para>open and edit + <filename> + ~/.kde/share/config/krusaderrc</filename></para> + </listitem> + <listitem> + <para>remove the "Panels Save Settings" item</para> + </listitem> + </itemizedlist>and it'll work with the + <Last Session> feature in + Konfigurator. More info can be found in + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1357"> + our forum</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_handbook"> + <para>Why doesn't the handbook work?</para> + </question> + <answer> + <para>This error will happen on &debian; (or + &debian; based) distro with the + krusader_1.51-1_i386.deb package. You will see the next + error message if you try to open the handbook: "The + requested help file could not be found. Check that you + have installed the documentation." To fix it go to + <filename> + /usr/share/doc/kde/HTML/en/krusader/</filename>, you will + see the + <filename>foo.docbook.gz</filename> files. Now, you need + to extract all these files with root privileges + ("File->Unpack" with &krusader;) + to create + <filename>foo.docbook</filename> files. Now the handbook + will work. This error is fixed in the + krusader_1.60.0-1_i386.deb package and higher + versions.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + </qandaset> + </sect1> + <sect1 id="faq_general"> + <title>General &FAQ;</title> + <qandaset> + <qandaentry> + <question id="faqg_wish"> + <para>How can I report a wish, a suggestion, or a + comment?</para> + </question> + <answer> + <para>An open source project's greatest strength is + derived from getting user feedback. That is why we love + to hear what you have to say. Your "gripes" are our + instructions. After about 6 months, programmers can no + longer see their own mistakes. It's natural. We want the + ideas, qritiques, and feedback because we all want to + make &krusader; the best and most useful file + manager available anywhere.</para> + <para>The most convenient way to contact us is to use the + &forum-lnk;, or the krusader-users + &mailing-lists-url;. For information on what + remains to be done look at the + &todoforum-url;. Adding ToDo items into the + &todoforum-url; is for developers only, but + feel free to post to the &featureforum-url; + for things that aren't on the &todoforum-url;, + but should be. If you have a nice feature request, the + &krusader; Krew will add your request to the + &todoforum-url;. We review and discuss every + submission. For more information how the forum works + click + <link linkend="faqg_kru-forum">here</link>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_patch"> + <para>How can I send a patch?</para> + </question> + <answer> + <para>It's not easy to write patch guidelines, but here + are some. + <orderedlist numeration="arabic"> + <listitem> + <para>Patches, new code or new features are always + welcome!</para> + </listitem> + <listitem> + <para>Focus only on one problem at a time, so the + developers can easily understand you, and commit your patch + it works.</para> + </listitem> + <listitem> + <para>Preferrably, you can start a discussion + with the developers on the krusader-devel + &mailing-lists-url; or on the + &forum-lnk;. Unfortunatly, we can't apply + a patch if the patch is in conflict with the "general + design" of the &krusader; code (read for more + instructions in this FAQ). + Please send only one change request per mail, so + that the discussion is easier to follow. The + modifications should be committed step by step, + checking each line. + </para> + </listitem> + <listitem> + <para>Submit your patch files into our &patch-tracker-url;, + so that all patch proposals stay organised and don't get lost, + tar.gz archives or diffs are usually ok. + Do not copy changes into a mail. Most mailers will change the + white spaces, so that the diff will not apply or the + code snipped does not diff. In the past, patch mails went lost or disorganized in many many mails, + so please use the &patch-tracker-url;, thanks! + </para> + </listitem> + <listitem> + <para>Use portable solutions, &krusader; + should run on: + <itemizedlist> + <listitem> + <para>All POSIX + (&Linux;/BSD/&UNIX;-like + OSes), &Solaris;.</para> + </listitem> + <listitem> + <para>All BSD Platforms + (&freebsd;/&netbsd;/&openbsd;/&MacOS;).</para> + </listitem> + <listitem> + <para>&kde; 3.3- &kde; + 3.5 and even on GNOME with + &kde;libs (for krusader-2.x &kde; 4) .</para> + </listitem> + <listitem> + <para>GCC 2.95 - GCC 4.1</para> + </listitem> + </itemizedlist>Architecture changes are made by the + team only.</para> + </listitem> + <listitem> + <para>A final note: always keep in mind a patch might + be rejected. Either it has side effects, which we + could not fix or it contradicts with the idea behind + the patched module. In this sense, a software project + differs from, let's say a wiki: a software project + has to have someone to make all the final decisions. + Otherwise the software will not work. Furthermore: + keep in mind that the examination of patches might + take time, as we all have private lives.</para> + </listitem> + </orderedlist></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_bug_report"> + <para>How can I report a bug?</para> + </question> + <answer> + <para>Bugs?!?!? Well, ok.... We have an online Bug + Tracking System.</para> + <para>Using the online bug-tracker helps us have a clear + and orderly way to know how many bugs are open, bug + priority and follow-ups. It saves us from browsing + through the entire &krusader; forum, searching + for yesterdays bug. Please use this system.</para> + <para>Before reporting a bug, please read the following: + <orderedlist> + <listitem> + <para>Use the &forum-lnk;'s + &kruforumsearch-url; function , your bug + might be already solved . Please DO NOT post new bugs + to the &bugforum-url; (except if you are + not sure that you have found a bug). We use it for + bug discussions.</para> + </listitem> + <listitem> + <para> + <emphasis role="bold">Check</emphasis> if the bug is + already posted in the &online-buglist-url; + of the Bug Tracking System.</para> + </listitem> + <listitem> + <para>If you can't find this bug mentioned, please + <emphasis role="bold">submit</emphasis> it into the + bug tracker by clicking the + <guibutton>Submit New</guibutton> button in the + bug-tracker window. Please submit the following + issues: the &krusader; version used, the + &Linux; distribution + version used, + processor type, and as good a description of the + problem as you can manage.</para> + </listitem> + </orderedlist></para> + <para>Thank you for your co-operation!</para> + <note> + <para>If possible, try to do the same operation with + &konqueror; or another &kde; + application. If you encounter the same problem then it + is possibly a &kioslaves1-url; or + &kde; (kdelibs) bug, and not a + &krusader; bug. &krusader; uses + the &kde; libraries and the + &kioslaves2-url; for many operations. In + some cases you can encounter problems if your + distribution is incorrectly configured, please test it + first as explained above.</para> + </note> + <para></para> + <!-- Empty line to make it more readable --> + <note> + <para> + <remark>If you've got bugs to report please do not + use &kde;'s bugzilla http://bugs.kde.org/, + &kde;'s Bug Tracking System. Report + &krusader; bugs directly to us.</remark> + </para> + </note> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + +<qandaentry> + <question id="faqg_valgrint"> + <para>How can i send good debug or crash reports?</para> + </question> + <answer> + <para>Usually binary packages that are been used by your distribution do not contain debug information. + Since we usually only develop and fix &krusader;-cvs, compile &krusader;-cvs in debugmode and install it, than check if the bug still exist. + <screen><prompt>$</prompt> <userinput><command>./configure</command> <option>--enable-debug=full</option></userinput></screen> + + Install <ulink url="http://valgrind.org">valgrind</ulink>, a suite of tools for debugging and profiling &Linux; programs. + + Run Valgrind/&krusader; + <screen><prompt>$</prompt> <userinput><command>valgrind</command> <option>--tool=memcheck</option> <replaceable>{foo_path}/krusader</replaceable></userinput></screen> + + The valgrind tool will write to stdout, what really happens. + If you could send these informations before the crash, it's almost sure, that we may fix or tell you what to do. + </para> + <para> </para> <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqg_crashhandler"> + <para>What todo if the KDEcrashhandler sends no usefull backtrace information?</para> + </question> + <answer> + <para>Usually binary packages that are been used by your distribution do not contain debug information. + Since we usually only develop and fix &krusader;-cvs, compile &krusader;-cvs in debugmode and install it, than check if the bug still exist. + <screen><prompt>$</prompt> <userinput><command>./configure</command> <option>--enable-debug=full</option></userinput></screen> + + If the KDEKrashhandler still doesn't provide usefull backtrace information, than sometimes a coredump will give better information. + Run Krusader, with disabled crashhandler. + <screen><prompt>$</prompt> <userinput><command>krusader</command> <option>--nocrashhandler</option></userinput></screen> + + On a crash you will get a <filename>.core</filename> file, usually in your home directory. + + Run <ulink url="http://sourceware.org/gdb/">gdb</ulink>, the GNU Project Debugger + + <screen><prompt>$</prompt> <userinput><command>gdb</command> <option>-c</option> <replaceable>corefile krusader</replaceable></userinput></screen> + + Now type <command>bt</command> to get the backtrace and type <command>q</command> to quit gdb. + + Often the best debug results will be given when using the valgrint tool. + </para> + <para> </para> <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqg_mail_list"> + <para>Does &krusader; have a mailing + list?</para> + </question> + <answer> + <para>Yes, currently we have 6 + &mailing-lists-url;. No spam, no bother, just + &krusader;. Feel free to subscribe and + unsubscribe.</para> + <para>Tip. our mailing lists can be browsed online or + read with a newsreader, so that you don't even need to + subscribe to follow the action on the mailing lists. + <itemizedlist> + <listitem> + <para>&krunews-url; is a very low volume + list, used for newsletters and announcements of new + versions or critical bugfixes. The news can also be + read online at &krulatestnews-url; and in + the &newsforum-url; which are basically + the same but displayed in another format.</para> + </listitem> + <listitem> + <para>&krudevel-url; is the developer + mailing list (read-only). If you want to follow the + development of &krusader; on the cutting + edge, this is the list to follow.</para> + </listitem> + <listitem> + <para>&kruusers-url; is the + &krusader; users mailing list. Here you + can ask for help and talk with the + &krusader; users and developers.</para> + </listitem> + <listitem> + <para>&krui18n-url; is the translations + mailing list.</para> + </listitem> + <listitem> + <para>&krudoc-url; is the documentation + mailing list.</para> + </listitem> + <listitem> + <para>&krucommits-url; (read-only): when + the &krusader; Krew commits code into CVS, + it will be reported in this mailing list. Want to + keep track? Waiting for a certain feature/bugfix? + Follow &krusader;'s development + here.</para> + </listitem> + </itemizedlist></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_newsfeeds"> + <para>Does &krusader; provide + newsfeeds?</para> + </question> + <answer> + <para>Yes, we do. Several newsfeeds in various formats + are available. &filereleasefeed-url;, + &forumfeed-url;, &krunewsfeed-url;, + &krudevelfeed-url; and even + <ulink url="http://dir.gmane.org/gmane.comp.kde.krusader.devel"> + additional feeds</ulink> by gmane.org. + &kruusersfeed-url;, + &krui18nfeed-url;, + &krudocfeed-url;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_irc"> + <para>Does &krusader; have an IRC + channel?</para> + </question> + <answer> + <para>Yes, we do. Feel free to talk to the + &krusader; Krew and fellow-users via + &freenode-url; servers. The server is + <emphasis>irc.freenode.org</emphasis>, the channel is + <emphasis>#krusader</emphasis>. Everyone is + welcome.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_kru-forum"> + <para>How does the &krusader; forum + work?</para> + </question> + <answer> + <para>In the spirit of freedom of speech, everything that + is &krusader; related can be discussed in our + forum. It does not matter if you are a newcomer or an + advanced user, everyone is welcome. An open source + project's greatest strength is derived from getting user + feedback. That is why we love to hear what you have to + say. With your feedback we can make &krusader; + better and better; otherwise, we are not aware of issues + and ideas you may have. But please remember the + following, so that we can maintain some order in the + chaos.</para> + <para>If the + <link linkend="index">Documentation</link>, + &faq-lnk;, &kruforum-url; and + &krudevel-url; (please use the search function + ) can't help you, do not hesitate to post on our forum. + The &krusader; Krew or the + &krusader; community is always available to + help you.</para> + <para>Please use the &kruforumsearch-url; + function of the &kruforum-url;, your issue may + have been previously discussed (this allows us to + minimize the double/triple/... postings). If your issue + has already been discussed in the past there is a great + chance that you will have an instant solution to your + problem. If the issue is currently being discussed, you + can join in the discussion. Some questions are asked over + and over again, that's why we have created this + &faq-lnk;. This allows us to spend more time + developing &krusader;.</para> + <para>The &kruforum-url; is split into seven + sections: + <itemizedlist> + <listitem> + <para>&newsforum-url;: all the latest + news.</para> + </listitem> + <listitem> + <para>&newsletterforum-url;: all newsletters.</para> + </listitem> + <listitem> + <para>&bugforum-url;: discussions about + bugs, please DO NOT use the forum for + &faqbugreports-lnk; (except if you are + unsure if you have found a bug).</para> + </listitem> + <listitem> + <para>&featureforum-url;: discussions + about new features for future &krusader; + versions.</para> + </listitem> + <listitem> + <para>&todoforum-url; here you will find + the list of the planned features. Registered users + will be able to VOTE and COMMENT on the TODO items. + Here you get the chance to push your favourite + features (+3) and still prefer certain features over + others (+1), if you don't care about a feature just + simply don't vote on that feature. Unregistered users + may only browse the &todoforum-url;. The + &todoranking-url; contains the results + based on the votes. + <link linkend="faqg_patch">Adding ToDo items</link> or + removing ToDo items which have been implemented will + be done by the &krusader; Krew.</para> + </listitem> + <listitem> + <para>&useractionsforum-url;: discussions + about &useractions-lnk;. Posting your own + User Actions is greatly appreciated. We plan to + include the best ones in the next + &krusader; releases.</para> + </listitem> + <listitem> + <para>&krugenforum-url;: everything that + is &krusader; related and doesn't belong + in the other forums.</para> + </listitem> + </itemizedlist></para> + <para>Thank you for your co-operation!</para> + <para>We provide RSS feeds for our forums. You don't have + to check for new posts all the time, instead the news + will come to you! To make use of them, simply point your + RSS aggregator to &rss-url;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_i18n"> + <para>How can I translate &krusader; into my + native language?</para> + </question> + <answer> + <para>Please read the &i18n-page-url;. It's + not difficult to translate! Most anyone can do it, it + just takes some time.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_support"> + <para>How can I support &krusader;?</para> + </question> + <answer> + <para>You can + <link linkend="help_krusader"> + support</link> &krusader; in many different + ways. Please send us + <link linkend="faqg_wish">feedback</link>, + &faqbugreports-lnk;, patches, + <link linkend="help_krusader">donations</link>, + translations, ...</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_mac"> + <para>Is there a &MacOS; X port?</para> + </question> + <answer> + <para>Yes, there is &MacOS; X port, but you + will not have the all the power you would have on + &Linux;. Please read the + <link linkend="mac-port">&MacOS; X port + section</link> for more information. A recommended native + file manager for &MacOS; is + &disk-order-url; (shareware).</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_win"> + <para>Is there a &Windows; port?</para> + </question> + <answer> + <para>No, but this might change in the future. Please + <link linkend="help_krusader">help us</link> with this + project, contributions are greatly appreciated. A + recommended native file manager for &Windows; + is &tcmd-url; (shareware).</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_mcstyle"> + <para>Why is &konqueror; in "midnight + commander style" not an + <link linkend="gloss-ofm">OFM</link>?</para> + </question> + <answer> + <para>The two panels and a commandline are available, all + the other stuff like + <link linkend="features">OFM features</link> and the + <link linkend="gloss-ofm">OFM</link> interaction with the + user is missing from this profile.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_why_ofm"> + <para>Why should I use an + <link linkend="gloss-ofm">OFM</link>?</para> + </question> + <answer> + <para>An &ofm-url; is much faster than a one + panel filemanager and faster than the command line. If + you would like to know + <ulink url="http://www.softpedia.com/reviews/linux/Krusader-Review-18193.shtml"> + how &krusader; feels</ulink>, there is only + one way to discover: install it on your computer and use + it for a while. If you prefer to waste time and lose + productivity, continue to use one panel filemanagers + which are based on &Windows; Explorer. Matej + Urbančič has written + a + <ulink url="http://murban.blogspot.com/2006/01/krusader-and-konqueror-twin-versus-one.html"> + blog</ulink>on why + <link linkend="gloss-ofm">OFM</link> is better than a one + panel filemanager.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + </qandaset> + </sect1> + <!-- + <qandaentry> + <question><para> </para></question> + <answer> + <para> </para> + <para> </para> // Empty line to make it more readable + </answer> + </qandaentry> +--> +</chapter> diff --git a/doc/en/features.docbook b/doc/en/features.docbook new file mode 100644 index 0000000..6170c87 --- /dev/null +++ b/doc/en/features.docbook @@ -0,0 +1,515 @@ +<chapter id="features"> +<title>Features</title> +<indexterm> + <primary>Features</primary> +</indexterm> +<note> + <para>The most important features and improvements are + highlighted here, it would make this list too long if we were to + include + <emphasis>all</emphasis> the features and improvements. You will + discover even more features in this documentation and in the + &changelog-url; file.</para> +</note> +<para> + <itemizedlist> + <listitem> + <para> + <itemizedlist> + <title>&ofm-url; features</title> + <listitem> + <para>Two powerful and easy to use + <link linkend="panels">OFM panels</link>.</para> + </listitem> + <listitem> + <para>&cmdline-lnk; and optional + &termemu-lnk; below.</para> + </listitem> + <listitem> + <para>Strong + <link linkend="keyboard-commands"> + keyboard</link>orientation and the ability to perform + all functions without the mouse.</para> + </listitem> + <listitem> + <para>Context-dependent invocation of scripts and + programs ⪚ mouseclick/enter (execute or + open with the associated application), F3 (view) and F4 + (edit).</para> + </listitem> + <listitem> + <para>&usermenu-lnk;, create your own + customized menu.</para> + </listitem> + <listitem> + <para>History ⪚ + <link linkend="folderhistory">Folder History</link>, + <link linkend="popular-urls">Popular + &URL;s</link>, ...</para> + </listitem> + <listitem> + <para>&vfs-lnk; for ⪚ + &remote-connections-lnk;, + &archives-lnk;, search results, + synchronizer.</para> + </listitem> + <listitem> + <para>Powerful internal + <link linkend="krviewer">viewer and editor</link> via + kparts supporting almost every file format.</para> + </listitem> + <listitem> + <para>&advanced-search-module-lnk; : + searching in archives and search content on remote + file systems.</para> + </listitem> + <listitem> + <para>Several Panel view modes via the + &popup-panel-lnk;.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + <itemizedlist> + <title>&krusader; tools</title> + <listitem> + <para>&remote-connections-lnk; : + &FTP;/SAMBA with SFTP/SCP support via + &kioslaves1-url;</para> + </listitem> + <listitem> + <para>&locate-lnk;</para> + </listitem> + <listitem> + <para>&syncdirs-lnk;</para> + </listitem> + <listitem> + <para> + <link linkend="mount-man">Mount-Manager</link> + </para> + </listitem> + <listitem> + <para>&diskusage-lnk;</para> + </listitem> + <listitem> + <para>&rootmode-lnk;</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + <itemizedlist> + <title>&krusader; features</title> + <listitem> + <para>Archive Handling: browsing, unpack, pack, + testing. Supported &archives-lnk; : ace, + arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and + 7-zip.</para> + </listitem> + <listitem> + <para> + <link linkend="checksum">Checksum + creation-verification</link> mechanism that supports + md5, sha1, sha256, sha224, sha256, sha384, sha512, + tiger, whirlpool, cfv and crc.</para> + </listitem> + <listitem> + <para> + <link linkend="calculate">Calculate occupied + space</link> of files and folders, archives and remote + filesystems.</para> + </listitem> + <listitem> + <para> + <link linkend="compare-dir">Directory + comparison</link> and + <link linkend="view-menu">filtering</link>.</para> + </listitem> + <listitem> + <para> + <link linkend="compare-content">Compare files by + content</link> via external diff programs like + &kompare;, &kdiff3-url; or + &xxdiff-url;.</para> + </listitem> + <listitem> + <para> + <link linkend="multi_rename">Rename</link> files and + folders via &krename-url;</para> + </listitem> + <listitem> + <para>Completely supports drag'n'drop: drag from + &konqueror; straight into a .tar.gz file, + from &krusader;'s panel into the trash-bin, + the desktop or into &konqueror;</para> + </listitem> + <listitem> + <para> + <link linkend="konfig-advanced">Preserve date</link> for + local targets at copy/move operations.</para> + </listitem> + <listitem> + <para>F2 opens a + <link linkend="tools-menu">Terminal Window</link> in the + default directory.</para> + </listitem> + <listitem> + <para>Easy editing of + <link linkend="file-menu">file permissions</link> and + ownership and + <link linkend="konfig-looknfeel-operation">Numeric + permissions</link>.</para> + </listitem> + <listitem> + <para> + <link linkend="krusearcher">Selection + filters</link> used in ⪚ Synchronizer and + KruSearcher.</para> + </listitem> + <listitem> + <para> + <link linkend="jump_back">Jump-Back</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="konfig-general"> + mimetype-aware</link>.</para> + </listitem> + <listitem> + <para> + <link linkend="folder-tabs">Tabbed panels</link> and + <link linkend="krviewer">Tabbed + Editor/Viewer</link>.</para> + </listitem> + <listitem> + <para>&quick-search-lnk;</para> + </listitem> + <listitem> + <para> + <link linkend="splitter">File splitter</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="mouse_gestures">Mouse Gestures</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="list_panel">Quick Navigation</link> in + the Location Toolbar.</para> + </listitem> + <listitem> + <para>&whatsthis-url; Help function in favour + of tooltips where reasonable.</para> + </listitem> + <listitem> + <para>&sync-browsing-lnk;</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + <itemizedlist> + <title>Customize &krusader; to your own + needs</title> + <listitem> + <para> + <link linkend="konfig-startup"> + Konfigurator</link> &krusader;'s + configuration center.</para> + </listitem> + <listitem> + <para>&main-toolbar-lnk;, + <link linkend="actions_toolbar">Actions + Toolbar</link> for user actions and bookmarks.</para> + </listitem> + <listitem> + <para> + <link linkend="key_bindings">Key-bindings</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="konfig-color">Colors</link> + </para> + </listitem> + <listitem> + <para>&panel-profiles-lnk;</para> + </listitem> + <listitem> + <para>&bookmark-manager-lnk;</para> + </listitem> + <listitem> + <para>&mouse-selection-modes-lnk;</para> + </listitem> + <listitem> + <para>Many more features can be + <link linkend="konfig-startup">configured</link> the way you + like.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + <itemizedlist> + <title>&krusader; Extensions</title> + <listitem> + <para>&useractions-lnk;</para> + </listitem> + <listitem> + <para>&javascript-console-lnk;</para> + </listitem> + <listitem> + <para>&color-profiles-lnk;</para> + </listitem> + <listitem> + <para>&keybindigs-profiles-lnk;</para> + </listitem> + </itemizedlist>Download and upload your favourite + &krusader; extensions at + &kde-files-url;.</para> + </listitem> + </itemizedlist> +</para> +<para> + <itemizedlist> + <title>New features in the &krusader;-1.80.0 "Final 3rd Stone" + release</title> + <listitem> + <para>Archive improvements + <itemizedlist> + <listitem> + <para> + <link linkend="archives">Password support</link> for: arj, + ace, rar and zip. Passwords can be stored in + &kwallet;</para> + </listitem> + <listitem> + <para> + <link linkend="archives">7-zip support</link>, by + external applications 7z and 7za.</para> + </listitem> + <listitem> + <para> + <link linkend="archives">Auto-detection support</link>, + allowing you to open "hidden archives" (⪚ + &openoffice; documents).</para> + </listitem> + <listitem> + <para>Packing/unpacking is now in the background.</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para><link linkend="list_panel">Brief View</link></para> + </listitem> + <listitem> + <para>Many improvements of the UserAction &useractions-lnk; system.</para> + </listitem> + <listitem> + <para>Countless usability enhancements, especially in Konfigurator and the heavily reordered menubar.</para> + </listitem> + <listitem> + <para> + <link linkend="konfig-advanced">Media button</link> + </para> + </listitem> + <listitem> + <para>Copy/Move: + <link linkend="copying">preserve all attributes</link> (time, + owner, group).</para> + </listitem> + <listitem> + <para> + <link linkend="konfig-color">Dim the colors of the inactive + panel</link>.</para> + </listitem> + <listitem> + <para>Renaming a filename without extension, single instance + mode, start to system tray, check this out in + <link linkend="konfigurator">Konfigurator</link></para> + </listitem> + <listitem> + <para>Configurable + <link linkend="list_panel">Atomic extensions</link>, + so that extensions like <filename>tar.gz</filename> are shown as one part in the <guilabel>Ext Column</guilabel>. + </para> + </listitem> + <listitem> + <para>Context menu for bookmarks and enable/disable special + bookmarks.</para> + </listitem> + <listitem> + <para>Restyled + <link linkend="menu-commands">MenuBar</link></para> + </listitem> + <listitem> + <para>&termemu-lnk; enhancements bringing new functions, new usages and new look.</para> + </listitem> + <listitem> + <para>&synchronizer-lnk; enhancements and parallel threads for slow + FTP servers.</para> + </listitem> + <listitem> + <para> + <link linkend="konfig-startup">Single instance mode</link>, + <link linkend="konfig-startup">start to system + tray</link></para> + </listitem> + <listitem> + <para> + <link linkend="context-menu">Context menu for permanent + bookmarks.</link> + </para> + </listitem> + <listitem> + <para>Full support for + <link linkend="acl">ACL permissions</link> permissions, like properties, preserve attributes, synchronizer and other.</para> + </listitem> + <listitem> + <para>Searcher-results, Locate-results, Synchronizer-results: support for dragging items and copy to clipboard (CTRL+C).</para> + </listitem> + <listitem> + <para>Many bug fixes.</para> + </listitem> + </itemizedlist> +</para> + +<para> + <itemizedlist> + <title>New features in the &krusader;-1.90.0 "Power Stone" + (The final version for KDE3.x)</title> +<para>Basically &krusader;-1.90.0 = &krusader;-1.80.0 + bugfixes + + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1989">Krusader Extensions</ulink> sended in by our users.</para> + + <listitem> + <para> + <itemizedlist> + <para>Improvements:</para> + <listitem> + <para>GCC 4.3 compatibility.</para> + </listitem> + <listitem> + <para>&kde; 3.2 - &kde; 3.5 compatibility.</para> + </listitem> + <listitem> + <para>bugfixes.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para> + <itemizedlist> + <para>Many &krusader; Extensions:</para> + <listitem> + <para>Keymaps, use keybindings of other commanders or customized keybindings!</para> + </listitem> + <listitem> + <para>Colormaps, use colors of other commanders or customized colors !</para> + </listitem> + <listitem> + <para>Useractions, create actions for your own needs ! <link linkend="useractions-menu">Click here</link> for and overview.</para> + </listitem> + <listitem> + <para>Javascript useractions, create actions with additional javascript power for your own needs !</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para>Krusader Extensions highlights: + <itemizedlist> + <para>Color schemes:</para> + <listitem> + <para>&tcmd;</para> + </listitem> + <listitem> + <para><trademark class="copyright">Dos Navigator</trademark></para> + </listitem> + <listitem> + <para>Midnight Commander</para> + </listitem> + <listitem> + <para>bash</para> + </listitem> + </itemizedlist> + + <itemizedlist> + <para>Keymap:</para> + <listitem> + <para>Midnight Commander</para> + </listitem> + </itemizedlist> + + <itemizedlist> + <para>Useractions:</para> + <listitem> + <para>Search and Replace in file</para> + </listitem> + <listitem> + <para>Split large mp3 files</para> + </listitem> + <listitem> + <para>Archive foo to dir</para> + </listitem> + <listitem> + <para>lzma and tar.lzma archive support</para> + </listitem> + <listitem> + <para>tar.7z archive support</para> + </listitem> + <listitem> + <para>ar (.a, .deb,...) archive support</para> + </listitem> + <listitem> + <para>Unpack multiple zip archives</para> + </listitem> + <listitem> + <para>kgpg: encrypt, decrypt, sign, verify signature</para> + </listitem> + <listitem> + <para>.uue file support (uuencode and uudecode)</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para> + <itemizedlist> + <para>Javascript useractions:</para> + <listitem> + <para>Recode files using iconv or GNU recode.</para> + </listitem> + <listitem> + <para>Mount as root.</para> + </listitem> + <listitem> + <para>Select from file.</para> + </listitem> + <listitem> + <para>Calculator.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para>Check the &changelog-url; for a complete overview of changes.</para> + </listitem> + </itemizedlist> +</para> + + + +&dev-cvs-note;</chapter> diff --git a/doc/en/glossary.docbook b/doc/en/glossary.docbook new file mode 100644 index 0000000..70b889f --- /dev/null +++ b/doc/en/glossary.docbook @@ -0,0 +1,355 @@ +<glossary id="glossary"> + <!-- ********************************************************************** + glossary.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <indexterm> + <primary>Glossary</primary> + </indexterm> + <para>This chapter is intended to explain the various words which + have been used throughout the &krusader; + documentation. If you believe some acronyms or terms are missing, + please do not hesitate to contact the &krusader; + documentation team.</para> + <para>Thanks to + <ulink url="http://en.wikipedia.org/">wikipedia.org</ulink> the + free encyclopedia that anyone can edit.</para> + <glossentry id="gloss-acl"> + <glossterm> + <acronym>ACL</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Access_control_list"> + Access Control List</ulink>; a concept in computer security + used to enforce privilege separation. It is a means of + determining the appropriate access rights to a given object + depending on certain aspects of the process that is making + the request.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-bsd"> + <glossterm> + <acronym>BSD</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Bsd">Berkeley + Software Distribution</ulink>; refers to any of several free + &UNIX;-compatible operating systems, derived from + <acronym>BSD</acronym>&UNIX;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-cvs"> + <glossterm> + <acronym>CVS</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Concurrent_Versions_System"> + Concurrent Versions System</ulink>; an important component of + Source Configuration Management (SCM). By using it, + developers can record the history of source files and + documents.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-deb"> + <glossterm> + <acronym>DEB</acronym> + </glossterm> + <glossdef> + <para>This is a binary file format that is used by + <ulink url="http://en.wikipedia.org/wiki/Debian"> + &debian;</ulink> and &debian;-based + distributions. It is a suffix of a installation file + specifically built for these distributions; e.g. + <filename>krusader_1.70.1-1_amd64.deb</filename>. Simply + described it is a special archive containing all the + program files and their proposed location on the + system.</para> + </glossdef> + </glossentry> + <glossentry id="glos-dcop"> + <glossterm> + <acronym>DCOP</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Dcop">Desktop + Communication Protocol</ulink>; the interprocess + communication protocol used by &kde; desktop + environment. It enables various &kde; applications + to communicate with each other.</para> + </glossdef> + </glossentry> + <glossentry id="glos-faq"> + <glossterm> + <acronym>FAQ</acronym> + </glossterm> + <glossdef> + <para> + <link linkend="faq">Frequently Asked Questions</link>; a + document where questions that arise many times are answered. + If you have a question to the developers of + &krusader;, you should always have a look at the + &faq-lnk; first.</para> + </glossdef> + </glossentry> + <glossentry id="glos-ftp"> + <glossterm>&FTP;</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/File_Transfer_Protocol"> + File Transfer Protocol</ulink>; it is an Internet protocol + that allows you to retrieve files from so-called + &FTP; servers.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-gpl"> + <glossterm> + <acronym>GPL</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Gpl">GNU General + Public License</ulink>; a software license created by the + <ulink url="http://www.fsf.org/">Free Software + Foundation</ulink> defining the terms for releasing free + software.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-gui"> + <glossterm>&GUI;</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Graphical_user_interface"> + Graphical User Interface</ulink>.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-iso"> + <glossterm> + <acronym>ISO</acronym> + </glossterm> + <glossdef> + <para>An + <ulink url="http://en.wikipedia.org/wiki/ISO_image">ISO + image</ulink> (.iso) is an informal term for a disk image of + an ISO 9660 file system. More loosely, it refers to any + optical disk image, even a UDF image.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-kde"> + <glossterm>&kde;</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Kde">K Desktop + Environment</ulink>; a project to develop a free graphical + desktop environment for &UNIX; compatible + systems.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-keybinding"> + <glossterm>Key Binding</glossterm> + <glossdef> + <para>All features of &krusader; are available + through the menubar, but you can also bind (link) a certain + key combination to that function. You will find, however, + that using the + <link linkend="keyboard-commands">keyboard</link> is remakably + faster than using the menubar or + <link linkend="gloss-gui">GUI</link>. + <link linkend="keyboard-commands">Keyboard usage</link> is an + important tool for + <link linkend="gloss-ofm">Orthodox File Managers</link>. + &krusader; comes with several predefined + &keybindigs-lnk;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-kpart"> + <glossterm>Kpart</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/KPart"> + Kpart</ulink>; KParts is the name of the component framework + for the &kde; desktop environment. KParts are + analogous to Bonobo components in &gnome-url;, + both of which are based on the same concepts as + &Microsoft;'s Object Linking and Embedding. e.g. + if you use &krusader;'s viewer to view a PDF file, + KPDF wil be launched inside &krusader;'s + viewer.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-kio"> + <glossterm> + <acronym>KIO</acronym> or kioslave</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Kioslave">KDE + Input/Output</ulink>; also known as + &kioslaves1-url; is part of the &kde; + architecture. It provides access to files, web sites and + other resources through a single consistent API.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-mount"> + <glossterm>mount</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Mount_%28computing%29"> + Mouting</ulink>; in computer science, is the process of + making a file system ready for use by the operating system, + typically by reading certain index data structures from + storage into memory ahead of time. The term recalls a period + in the history of computing when an operator had to mount a + magnetic tape or hard disk on a spindle before using + it.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-ofm"> + <glossterm> + <acronym>OFM</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://www.softpanorama.org/OFM/index.shtml"> + Orthodox File Manager</ulink>; also known as "Commanders". + Members of this family of file managers use simple yet very + powerful interface that is a direct derivative of the + <ulink url="http://en.wikipedia.org/wiki/Norton_Commander"> + Norton Commander</ulink> (NC) interface.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-rpm"> + <glossterm>RPM</glossterm> + <glossdef> + <para>This is the binary file format for distributions based + on the + <ulink url="http://www.rpm.org/">RPM Package Manager</ulink>, + a widely used packaging tool for the &Linux; + operating system. If you still have to get + &krusader; and your system supports RPM packages, + you should get &krusader; packages ending in + .rpm.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-ssh"> + <glossterm> + <acronym>SSH</acronym>, Secure Shell</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/SSH">SSH</ulink>; + is a set of standards and an associated network protocol that allows + establishing a secure channel between a local and a remote computer.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-svn"> + <glossterm> + <acronym>SVN</acronym>, Subversion</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Subversion"> + Subversion</ulink>; a version control system that is a + compelling replacement for + <link linkend="gloss-cvs">CVS</link>. It is used by many + software projects including &kde; and + &krusader;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-termemu"> + <glossterm>Terminal emulator</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Terminal_emulator"> + Terminal emulator</ulink>; simply a windowed shell; this is + known as command line window in some other environments. If + you want to use the shell and type the commands, you should + know at least a few of the system-level commands for your + operating system.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-posix"> + <glossterm> + <acronym>POSIX</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Posix">"Portable + Operating System Interface for uniX"</ulink>; a collective + name of a family of related standards specified by the IEEE + to define the application programming interface (API) for + software compatible with variants of the &UNIX; + operating system.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-url"> + <glossterm> + <acronym>&URL;</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/URL">Universal + Resource Locater</ulink>; a universal resource locater is the + technical term for what is commonly referred to as a websites + address. Examples of URLs include + <ulink url="http://krusader.sourceforge.net"> + http://krusader.sourceforge.net</ulink> and + &remote-connections-lnk;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-vfs"> + <glossterm> + <acronym>VFS</acronym> + </glossterm> + <glossdef> + <para>&vfs-lnk; is a basic + <link linkend="features">OFM feature</link>, this an + abstracted layer over all kinds of archived information (ZIP + files, FTP servers, TAR archives, NFS filesystems, SAMBA + shares, ISO cd/dvd images, RPM catalogs, etc.), which allows + the user to access all the information in these divergent + types of file systems transparently - just like entering an + ordinary sub-directory! &krusader; supports + several &vfs-lnk;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-xml"> + <glossterm>XML</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Xml">Extensible + Markup Language</ulink>; a very flexible text format derived + from SGML (ISO 8879). Originally designed to meet the + challenges of large-scale electronic publishing, XML is also + playing an increasingly important role in the exchange of a + wide variety of data on the Web and elsewhere.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-zeroconf"> + <glossterm>Zeroconf</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Zeroconf">Zeroconf</ulink>; + or Zero Configuration Networking is a set of techniques that automatically + create a usable IP network without configuration or special servers. + This allows inexpert users to connect computers, networked printers, + and other items together and expect them to work automatically.</para> + </glossdef> + </glossentry> +</glossary> diff --git a/doc/en/help.docbook b/doc/en/help.docbook new file mode 100644 index 0000000..a3b6ee4 --- /dev/null +++ b/doc/en/help.docbook @@ -0,0 +1,158 @@ +<!-- ********************************************************************** + help.docbook + +++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> +<preface id="help_krusader"> + <title>Help &krusader;</title> + <indexterm> + <primary>Help</primary> + </indexterm> + <para>Here is your opportunity to &contribute-url; to + the &krusader; project. There are things that need to + be done, but can't be done by us. If you feel you can help, do not + hesitate to contact us; every OpenSource can use some help. + Please also check the &contribute-url; page on our + website for more recent information. Thanks!</para> + <para> + <emphasis role="bold">Documentation</emphasis> + </para> + <para>Help is needed (we are looking for documentation writers) + for keeping the &krusader; documentation up to date. + The draft explanation of new features is done by the developers + on the krusader-devel mailing list, but we need editors to add + this information in the handbook. By playing with the new + features these editors can give valuable information to the + developers for making the new features even better!</para> + <para> + <emphasis role="bold">&krusader; + Extensions</emphasis> + </para> + <para>Please upload your favourite extensions at + &kde-files-url;, so that they become available for the + &krusader; community. Maybe they will be shipped by + default with &krusader; at the next release :-)) It + features + <ulink url="http://www.kde-files.org/index.php?xcontentmode=660"> + Keymaps</ulink>, + <ulink url="http://www.kde-files.org/index.php?xcontentmode=661"> + Colormaps</ulink>, + <ulink url="http://www.kde-files.org/index.php?xcontentmode=662"> + User Actions</ulink>, + <ulink url="http://www.kde-files.org/index.php?xcontentmode=663"> + JavaScript Extensions</ulink>.</para> + <para>User Actions can be discussed in our + &useractionsforum-url;, please join!</para> + <para> + <emphasis role="bold">Spread the Word + &krusader;</emphasis> + </para> + <para>If you like &krusader;, + <ulink url="http://krusader.sourceforge.net/spread.php">let + people know!</ulink> Write articles and reviews for internet or + print publications. Encourage your friends to give + &krusader; a try. Participate in forums to help others + in the community.</para> + <para> + <emphasis role="bold">GUI Translations</emphasis> + </para> + <para>&krusader; is available in many languages, but + usually several translations do need an update and translations + to new languages are always welcome, please read the + &i18n-page-url; . Even when there is already a + translator for your native language, it is always helpful to have + a second or third translator ⪚ for proofreading. + Sometimes the regular translator is not available when a + translation update is needed (studies, holiday...). Please + contact the translator/s for your native language; your help will + be appreciated. Any translation (even partial translations) are + accepted by the &krusader;-Krew at any time (feature + freeze or not).</para> + <para> + <emphasis role="bold">Documentation Translations</emphasis> + </para> + <para>This documentation is translatable, if you are interested + in translating this documentation please contact Frank.</para> + <para> + <emphasis role="bold">OpenUsability</emphasis> + </para> + <para>Using a program, understanding its interface and getting + information out of it, is something that should always be clear + in every application - no matter how advanced your understanding + of operating systems is or how deep your computer literacy is. + For that reason &krusader; asked to be included in the + &openusability-url; project.</para> + <para>This project joins the software developers and usability + experts in an attempt to check all parts of a user interface for + the inappropriate entries. Its main goal is making user + interfaces and dialogs understandable and friendly to every user. + We need our users comments, your comments, to make things better. + In case you find a part of the program's interface to be too + complicated, please do help us correct it and make it + better.</para> + <para> + <emphasis role="bold">Donations</emphasis> + </para> + <para>Actually, we hadn't considered donations, until users asked + us for a way to &donate-url; to the project. + &krusader; is, and always will be free, in all the + terms of the GNU Public License.</para> + <para> + <emphasis role="bold">Packagers</emphasis> + </para> + <para>We are always in need of packagers for different distro + rpm's, deb's, etc. All help is welcome.</para> + <para> + <emphasis role="bold">Users' feedback for the + &krusader; &MacOS; X port</emphasis> + </para> + <para>There is a &macosx-port-url; + with the help of &fink-url; , the port is + maintained by + <ulink url="http://hritcu.wordpress.com/about/">Catalin Hritcu</ulink>, + all feedback is welcome.</para> + <para> + <emphasis role="bold">Porting &krusader; to + &Windows;</emphasis> + </para> + <para>&krusader; is written using &Qt; as + well as &kde;libs. As long as &kde;libs + does not run on &Windows;, porting + &krusader; is not an option. However, we do believe + that once &Qt;4-GPL is released, efforts will be made + to port &kde;libs to &Windows;, and if that + happens, we're in business and then we need a maintainer for + porting &krusader; to &Windows;.</para> + <para> + <emphasis role="bold">FAQ</emphasis> + </para> + <para>If you have a question that is missing in the + &faq-lnk;, we would like to hear it.</para> + <para> + <emphasis role="bold">Others</emphasis> + </para> + <para> + <link linkend="faqg_wish">Feedback</link>, + <link linkend="faqg_bug_report">Bug reports</link>, patches, + &etc; are always welcome! An open source project's + greatest strength is derived from getting user feedback.</para> + <para>On some websites like &freshmeat-url; or + &kde-apps-url; you can give a rate, if you like + &krusader; go to one of these sites and rate + &krusader;, thanks.</para> +</preface> diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..146f1ba --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,594 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- <?xml version="1.0" ?> --> +<!DOCTYPE +book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" +"dtd/kdex.dtd" +[ + +<!-- +Previous used Docbook +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ +--> + +<!-- ********************************************************************** + index.docbook + +++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<!ENTITY krusader 'Krusader'> +<!ENTITY kapp "&krusader;"> +<!ENTITY kappname "&krusader;"> +<!-- <!ENTITY % addindex "IGNORE"> --> +<!ENTITY % addindex "INCLUDE"> + +<!-- ONLY If you are writing non-English original documentation, change the language here --> +<!ENTITY % English "INCLUDE"> +<!ENTITY Backspace "<keycap>Backspace</keycap>"> +<!-- +Added <!ENTITY Backspace "<keycap>Backspace</keycap>"> in index.docbook +since the Entity Backspace is not defined in +/usr/share/apps/ksgmltools2/customization/ru/user.entities on KDE: 3.5.4 +This is a workaround, until Backspace is translated in all +/usr/share/apps/ksgmltools2/customization/ru/user.entities +files +http://groups.google.com/group/krusader-devel/browse_thread/thread/d102adec2edcfb47/e3ca0489310cc12e#e3ca0489310cc12e +--> + +<!-- kdebase, kdeadmin, etc. Leave this unchanged if your application is not maintained in KDE CVS --> +<!ENTITY package "kde-module"> + +<!-- internet links, Krusader --> +<!ENTITY onlinehandbook-url '<ulink url="http://www.krusader.org/handbook/">Online Handbook</ulink>'> +<!ENTITY kru-screenshots-url '<ulink url="http://www.krusader.org/scr.php">&krusader; Screenshots</ulink>'> +<!ENTITY mail-url '<ulink url="mailto:krusader * users.sourceforge net">mail</ulink>'> + +<!ENTITY kruwebsite-url '<ulink url="http://www.krusader.org">Krusader website</ulink>'> +<!ENTITY kruproject-url '<ulink url="http://sourceforge.net/projects/krusader">here</ulink>'> +<!ENTITY contribute-url '<ulink url="http://www.krusader.org/help.php">contribute</ulink>'> +<!ENTITY donate-url '<ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488">Donate</ulink>'> + +<!ENTITY kruforum-url '<ulink url="http://www.krusader.org/phpBB/index.php">&krusader; Forum</ulink>'> +<!ENTITY kruforumsearch-url '<ulink url="http://www.krusader.org/phpBB/search.php">Search</ulink>'> +<!ENTITY krugenforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=1">General Discussion Forum</ulink>'> +<!ENTITY newsforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=7">News and Announcements Forum</ulink>'> +<!ENTITY newsletterforum-url '<ulink url="http://krusader.sourceforge.net/phpBB/viewforum.php?f=12">NewsLetter Forum</ulink>'> +<!ENTITY bugforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=3">Bug Discussion Forum</ulink>'> +<!ENTITY featureforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=6">New Features Discussion/Requests Forum</ulink>'> +<!ENTITY todoforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=10">ToDo Forum</ulink>'> +<!ENTITY todoranking-url '<ulink url="http://www.krusader.org/todo.php">ToDo ranking system</ulink>'> +<!ENTITY useractionsforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=11">UserActions Forum</ulink>'> +<!ENTITY rss-url '<ulink url="http://krusader.sf.net/phpBB/rss.php">here</ulink>'> +<!ENTITY krucutedge-url '<ulink url="http://www.krusader.org/cvs.php">&krusader;'s Cutting Edge page</ulink>'> +<!ENTITY active-passive-ftp-url '<ulink url="http://slacksite.com/other/ftp.html">Active &FTP; vs. Passive &FTP;, a Definitive Explanation</ulink>'> + +<!ENTITY viewcvs-url '<ulink url="http://krusader.cvs.sourceforge.net/krusader/">ViewCVS</ulink>'> +<!ENTITY sfmirrors-url '<ulink url="http://sourceforge.net/project/showfiles.php?group_id=6488">Sourceforge mirrors</ulink>'> +<!ENTITY changelog-url +'<ulink url="http://www.krusader.org/text.php?t=cvs.changelog"><filename>ChangeLog</filename></ulink>'> +<!ENTITY cvsnews-url +'<ulink url="http://www.krusader.org/text.php?t=cvs.news"><filename>CVSNEWS</filename></ulink>'> +<!ENTITY docchangelog-url '<ulink url="http://cvs.sourceforge.net/viewcvs.py/krusader/krusader_kde3/doc/ChangeLog?view=markup">Documentation ChangeLog</ulink>'> +<!ENTITY i18n-page-url '<ulink url="http://www.krusader.org/i18n.php">i18n page</ulink>'> + +<!ENTITY deb-requirements-url '<ulink url="http://packages.debian.org/unstable/utils/krusader">requirements on &debian;</ulink>'> +<!ENTITY mailing-lists-url '<ulink url="http://www.krusader.org/lists.php">mailing lists</ulink>'> +<!ENTITY krunews-url '<ulink url="http://groups-beta.google.com/group/krusader-news">&krusader;-news</ulink>'> +<!ENTITY krulatestnews-url '<ulink url="http://www.krusader.org/news.php">latest news</ulink>'> + +<!ENTITY krucommits-url '<ulink url="http://sourceforge.net/mailarchive/forum.php?forum_id=34772">&krusader;-commits</ulink>'> +<!ENTITY krudevel-url '<ulink url="http://groups-beta.google.com/group/krusader-devel">&krusader;-devel</ulink>'> +<!ENTITY kruusers-url '<ulink url="http://groups-beta.google.com/group/krusader-users">&krusader;-users</ulink>'> +<!ENTITY krudoc-url '<ulink url="http://groups-beta.google.com/group/krusader-doc">&krusader;-doc</ulink>'> +<!ENTITY krui18n-url '<ulink url="http://groups-beta.google.com/group/krusader-i18n">&krusader;-i18n</ulink>'> + +<!ENTITY forumfeed-url '<ulink url="http://www.krusader.org/phpBB/rss.php">rss-forumfeed</ulink>'> +<!ENTITY filereleasefeed-url '<ulink url="http://sourceforge.net/export/rss2_projfiles.php?group_id=6488">rss-filerelease feed</ulink>'> +<!ENTITY krunewsfeed-url '<ulink url="http://groups.google.com/group/krusader-news/feeds">krusader-news feed</ulink>'> +<!ENTITY krudevelfeed-url '<ulink url="http://groups.google.com/group/krusader-devel/feeds">krusader-devel feed</ulink>'> +<!ENTITY kruusersfeed-url '<ulink url="http://groups.google.com/group/krusader-users/feeds">krusader-users feed</ulink>'> +<!ENTITY krui18nfeed-url '<ulink url="http://groups.google.com/group/krusader-i18n/feeds">krusader-i18n feed</ulink>'> +<!ENTITY krudocfeed-url '<ulink url="http://groups.google.com/group/krusader-doc/feeds">krusader-doc feed</ulink>'> + +<!ENTITY online-buglist-url '<ulink url="http://sourceforge.net/tracker/?atid=106488&group_id=6488&func=browse">online bug list</ulink>'> +<!ENTITY patch-tracker-url '<ulink url="http://sourceforge.net/tracker/?group_id=6488&atid=306488">Patch Tracker</ulink>'> +<!ENTITY i18n-credits-url '<ulink url="http://krusader.cvs.sourceforge.net/krusader/krusader_kde3/po/">more translator credits</ulink>'> + + +<!ENTITY subversion-url '<ulink url="http://sourceforge.net/svn/?group_id=6488">Subversion</ulink>'> +<!ENTITY browse-svn-repo-url '<ulink url="http://svn.sourceforge.net/krusader">Browse the Subversion Repository</ulink>'> + +<!ENTITY fhs-url '<ulink url="http://www.pathname.com/fhs/">Filesystem Hierarchy Standard (FHS)</ulink>'> + +<!-- internet links, Krusader binaries --> +<!ENTITY krudownload-url '<ulink url="http://www.krusader.org/down.php">&krusader; downloadpage</ulink>'> +<!ENTITY gentoo-life-ebuild-url '<ulink url="http://www.krusader.org/data/krusader-cvs-1.ebuild">&gentoo; Live Ebuild</ulink>'> + +<!ENTITY gentoo-download-url '<ulink url="http://packages.gentoo.org/search/?sstring=krusader">&gentoo;</ulink>'> +<!ENTITY suse-download-url '<ulink url="http://search.novell.com/qfsearch/SearchServlet?bbshow=true&query0=krusader&operator0=0&collection=Novell&date=&numhits=10&template=ResultListTemplate.html&submit+search=Search">&SuSE;</ulink>'> +<!ENTITY mandriva-download-url '<ulink url="http://search.belnet.be/packages/mandrake/current/i586/media/contrib/">&mandriva;</ulink>'> +<!ENTITY freebsd-download-url '<ulink url="http://www.freebsd.org/cgi/ports.cgi?query=krusader&stype=all">&freebsd;</ulink>'> +<!ENTITY debian-download-url '<ulink url="http://packages.debian.org/krusader">&debian;</ulink>'> +<!ENTITY netbsd-download-url '<ulink url="http://pkgsrc.se/sysutils/krusader">&netbsd;</ulink>'> +<!ENTITY yoper-download-url '<ulink url="http://ftp.belnet.be/linux/yoper/devel/yoper-3.0/RPMS.chris/">&yoper;</ulink>'> +<!ENTITY macosx-port-url '<ulink url="http://pdb.finkproject.org/pdb/package.php/krusader">&MacOS;-X port</ulink>'> +<!ENTITY ubuntu-kubuntu-download-url '<ulink url="http://packages.ubuntu.com/krusader">&ubuntu;/&kubuntu;</ulink>'> +<!ENTITY linspire-download-url '<ulink url="http://www.linspire.com/lindows_products_details.php?product_id=3160&pg=specs">&linspire;</ulink>'> +<!ENTITY archlinux-download-url '<ulink url="http://www.archlinux.org/packages.php?id=793">&archlinux;</ulink>'> +<!ENTITY frugalware-linux-download-url '<ulink url="http://frugalware.org/packages.php?id=280">&frugalware-linux;</ulink>'> +<!ENTITY pclinuxos-download-url '<ulink url="http://www.pclinuxonline.com/pclos/html/package_list.html">&pclinuxos;</ulink>'> +<!ENTITY altlinux-download-url '<ulink url="http://www.altlinux.com/index.php?module=sisyphus&package=krusader">&altlinux;</ulink>'> +<!ENTITY ccuxlinux-download-url '<ulink url="http://packages.ccux-linux.de/index.php?pdetail=154">&ccuxlinux;</ulink>'> +<!ENTITY lunarlinux-download-url '<ulink url="http://modules.lunar-linux.org/index.php?option=module&module=krusader">&lunarlinux;</ulink>'> +<!ENTITY qilinux-download-url '<ulink url="http://www.qilinux.org/modules.php?op=modload&name=distromatic&file=index&tag=devel&pkg=krusader.source">&qilinux;</ulink>'> +<!ENTITY rocklinux-download-url '<ulink url="http://www.rocklinux.net/packages/krusader.html">&rocklinux;</ulink>'> + +<!ENTITY klik-protocol-url '<ulink url="http://klik.atekon.de/">klik protocol</ulink>'> +<!ENTITY klik-krusader-url '<ulink url="klik://krusader">klik://krusader</ulink>'> +<!ENTITY klik-krusader-latest-url '<ulink url="klik://krusader-latest">klik://krusader-latest</ulink>'> +<!ENTITY klik-krusader-cvs-url '<ulink url="klik://krusader-cvs">klik://krusader-cvs</ulink>'> +<!ENTITY klik-available-url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader">available</ulink>'> +<!ENTITY klik-stable-krusader-url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader-latest">stable &krusader;</ulink>'> +<!ENTITY klik-cvs-krusader-url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader-cvs">cvs snapshot of &krusader;</ulink>'> + + +<!ENTITY fedora-extras-url '<ulink url="http://fedoraproject.org/wiki/Extras/UsingExtras ">&fedora; Extras</ulink>'> +<!ENTITY distrowatch-com-url '<ulink url="http://distrowatch.com/search.php?pkg=krusader&pkgver=1.70.0">Distrowatch.com</ulink>'> + +<!ENTITY dag-wiers-download-url '<ulink url="http://dag.wieers.com/packages/krusader/">dag.wieers.com</ulink>'> +<!ENTITY dries-verachtert-download-url '<ulink url="http://dries.ulyssis.org/rpm/packages/krusader/info.html">Dries Verachtert RPM Repository</ulink>'> +<!ENTITY portpkg-url '<ulink url="http://portpkg.berlios.de/">Portpkg</ulink>'> +<!ENTITY kru-slackbuild-url '<ulink url="http://cvs.berlios.de/cgi-bin/viewcvs.cgi/portpkg/ports/open/krusader/Attic/">&krusader; SlackBuild</ulink>'> + +<!ENTITY freshmeat-url '<ulink url="http://freshmeat.net/projects/krusader/">freshmeat.net</ulink>'> +<!ENTITY rpmfind-url '<ulink url="http://rpmfind.net/linux/rpm2html/search.php?query=krusader&submit=Search+...">rpmfind</ulink>'> +<!ENTITY rpmpbone-url '<ulink url="http://rpm.pbone.net/index.php3/stat/3/search/krusader">rpmpbone</ulink>'> +<!ENTITY rpmseek-url '<ulink url="http://rpmseek.com/rpm-pl/krusader.html?hl=com&cx=2155:K:0">rpmseek</ulink>'> + +<!ENTITY kde-files-url '<ulink url="http://www.kde-files.org/index.php?xcontentmode=660x661x662x663">kde-files.org</ulink>'> + +<!-- internet links, others --> +<!ENTITY xxdiff-url '<ulink url="http://furius.ca/xxdiff/"><application>xxdiff</application></ulink>'> +<!ENTITY kdiff3-url '<ulink url="http://kdiff3.sourceforge.net"><application>Kdiff3</application></ulink>'> +<!ENTITY krename-url '<ulink url="http://www.krename.net"><application>Krename</application></ulink>'> +<!ENTITY kasablanca-url '<ulink url="http://kasablanca.berlios.de/">Kasablanca</ulink>'> +<!ENTITY kftpgrabber-url '<ulink url="http://kftpgrabber.sourceforge.net/"><application>Kftpgrabber</application></ulink>'> +<!ENTITY xbel-url '<ulink url="http://grail.sourceforge.net/info/xbel.html">XBEL standard</ulink>'> +<!ENTITY kde-apps-url '<ulink url="http://www.kde-apps.org/content/show.php?content=10214">KDE-APPS.org</ulink>'> +<!ENTITY rpm-org-url '<ulink url="http://www.rpm.org/">rpm.org</ulink>'> +<!ENTITY rpm-guide-url '<ulink url="http://fedora.redhat.com/docs/drafts/rpm-guide-en/">RPM Guide</ulink>'> +<!ENTITY kioslaves1-url '<ulink url="http://docs.kde.org/development/en/kdebase/kioslave/index.html">KIOSlaves</ulink>'> +<!ENTITY kioslaves2-url '<ulink url="http://developer.kde.org/documentation/library/3.4-api/kio/html/index.html">KIOSlaves</ulink>'> +<!ENTITY kio-ipodslave-url '<ulink url="http://sourceforge.net/projects/kpod">KIOipod-slave</ulink>'> +<!ENTITY kdelibs-url '<ulink url="http://lxr.kde.org/source/kdelibs/kioslave">&kde;libs</ulink>'> +<!ENTITY kdebase-url '<ulink url="http://lxr.kde.org/source/kdebase/kioslave">&kde;base</ulink>'> +<!ENTITY gnome-url '<ulink url="http://www.gnome.org"><application>GNOME</application></ulink>'> +<!ENTITY afterstep-url '<ulink url="http://www.afterstep.org/"><application>AfterStep</application></ulink>'> +<!ENTITY xfce-url '<ulink url="http://www.xfce.org/"><application>XFce</application></ulink>'> + +<!ENTITY debian-qt-a-url '<ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=710">in our forum</ulink>'> +<!ENTITY debian-qt-b-url '<ulink url="http://opendoorsoftware.com/cgi/http.pl?p=DebianQTChecklist">instructions</ulink>'> +<!ENTITY freenode-url '<ulink url="http://freenode.net">freenode.org</ulink>'> +<!ENTITY fink-url '<ulink url="http://www.finkproject.org/">fink</ulink>'> +<!ENTITY kjsembed-url '<ulink url="http://xmelegance.org/kjsembed/">KJSEmbed</ulink>'> + +<!ENTITY ofm-url '<ulink url="http://www.softpanorama.org/OFM/index.shtml">Orthodox File Manager (OFM)</ulink>'> +<!ENTITY disk-order-url '<ulink url="http://www.likemac.ru/english/"><trademark class="copyright">Disk Order</trademark></ulink>'> +<!ENTITY apple-x11-url '<ulink url="http://www.apple.com/downloads/macosx/apple/x11formacosx.html">&apple; X11</ulink>'> +<!ENTITY apple-x11-sdk-url '<ulink url="http://developer.apple.com/darwin/runningX11.html">&apple; X11 SDK</ulink>'> +<!ENTITY bodo-tasche-url '<ulink url="http://blog.wannawork.de/about.php">Bodo Tasche</ulink>'> + +<!ENTITY sourceforge-net-url '<ulink url="http://sourceforge.net/">Sourceforge.net</ulink>'> +<!ENTITY openusability-url '<ulink url="http://openusability.org/projects/krusader/">OpenUsability.org</ulink>'> + +<!ENTITY whatsthis-url '<ulink url="http://urbanlizard.com/~aseigo/whatsthis_tutorial/">WhatsThis</ulink>'> + + + +<!-- documentation links --> +<!ENTITY context-menu-lnk '<link linkend="context-menu">Context Menu</link>'> +<!ENTITY vfs-lnk '<link linkend="vfs">Virtual file systems (VFS)</link>'> +<!ENTITY mouse-selection-modes-lnk '<link linkend="mouse_selection_modes">Mouse Selection Modes</link>'> +<!ENTITY konfigstartpg-lnk '<link linkend="konfigurator">Konfigurator Startup page</link>'> +<!ENTITY konfiglookandfeel-lnk '<link linkend="konfig-looknfeel">Konfigurator Look & Feel page</link>'> +<!ENTITY konfiggereral-lnk '<link linkend="konfig-general">Konfigurator General page</link>'> +<!ENTITY konfigdependencie-lnk '<link linkend="konfig-dependencies">Konfigurator Dependencies page</link>'> +<!ENTITY konfigprotocol-lnk '<link linkend="konfig-protocols">Konfigurator Protocol page</link>'> +<!ENTITY viewmenu-lnk '<link linkend="view-menu">View menu</link>'> +<!ENTITY editmenu-lnk '<link linkend="edit-menu">Edit menu</link>'> +<!ENTITY comparedir-lnk '<link linkend="compare-dir">Compare Directories</link>'> +<!ENTITY fnkeybar-lnk '<link linkend="fnkeys">FN Keys Bar</link>'> +<!ENTITY main-toolbar-lnk '<link linkend="mainwindow">Main Toolbar</link>'> +<!ENTITY actions-toolbar-lnk '<link linkend="actions_toolbar">Actions Toolbar</link>'> +<!ENTITY statusbar-lnk '<link linkend="mainwindow">Statusbar</link>'> +<!ENTITY location-toolbar-lnk '<link linkend="list_panel">Location Toolbar</link>'> +<!ENTITY rootmode-lnk '<link linkend="root-mode">Root mode</link>'> +<!ENTITY settingsmenu-lnk '<link linkend="settings-menu">Settings menu</link>'> +<!ENTITY keybindigs-lnk '<link linkend="key_bindings">Key-Bindings</link>'> +<!ENTITY keybindigs-profiles-lnk '<link linkend="configure-shortcuts">Key-binding Profiles</link>'> +<!ENTITY color-profiles-lnk '<link linkend="konfig-color">Color Profiles</link>'> +<!ENTITY synchronizer-lnk '<link linkend="synchronizer">Synchronizer</link>'> +<!ENTITY syncdirs-lnk '<link linkend="synchronizer">Synchronize Directories</link>'> +<!ENTITY splitfile-lnk '<link linkend="splitter">Split file</link>'> +<!ENTITY combinefiles-lnk '<link linkend="splitter">Combine files</link>'> +<!ENTITY kdeqtdir-lnk '<link linkend="kde_qt_dir"><envar>KDEDIR</envar> - <envar>QTDIR</envar></link>'> +<!ENTITY useractions-lnk '<link linkend="useractions">UserActions</link>'> +<!ENTITY usermenu-lnk '<link linkend="useractions">User Menu</link>'> +<!ENTITY faq-lnk '<link linkend="faq">FAQ</link>'> +<!ENTITY forum-lnk '<link linkend="faqg_kru-forum">&krusader; Forum</link>'> +<!ENTITY help-request-lnk '<link linkend="faqi_help_request">help request</link>'> +<!ENTITY list-panel-lnk '<link linkend="list_panel">List Panel</link>'> +<!ENTITY popup-panel-lnk '<link linkend="popup_panel">PopUp Panel</link>'> +<!ENTITY quick-search-lnk '<link linkend="quicksearch">Quick search</link>'> +<!ENTITY locate-lnk '<link linkend="locate">Locate</link> &GUI; frontend'> +<!ENTITY foldertabs-lnk '<link linkend="folder-tabs">Folder tabs</link>'> +<!ENTITY mountman-lnk '<link linkend="mount-man">MountMan</link>'> +<!ENTITY cmdline-lnk '<link linkend="cmdline">Command Line</link>'> +<!ENTITY termemu-lnk '<link linkend="termemu">Terminal emulator</link>'> +<!ENTITY missing-libs-lnk '<link linkend="faqi_missing_libs">&FAQ; missing libs or headers</link>'> +<!ENTITY panel-profiles-lnk '<link linkend="panel_profiles">Panel profiles</link>'> +<!ENTITY sync-browsing-lnk '<link linkend="panel_toolbar">Sync-browsing</link>'> +<!ENTITY diskusage-lnk '<link linkend="diskusage">Disk Usage</link>'> +<!ENTITY bookmarks-lnk '<link linkend="bookman">Bookmarks</link>'> +<!ENTITY bookmark-manager-lnk '<link linkend="bookman">Bookmark-Manager</link>'> +<!ENTITY advanced-search-module-lnk '<link linkend="krusearcher">Advanced Search module</link>'> +<!ENTITY javascript-console-lnk '<link linkend="javascript_console">JavaScript console</link>'> +<!ENTITY archives-lnk '<link linkend="archives">archives</link>'> +<!ENTITY remote-connections-lnk '<link linkend="remote-connections">Remote Connections</link>'> +<!ENTITY krusaderrc-lnk '<link linkend="config_files">krusaderrc</link>'> + +<!ENTITY install-proc-lnk '<link linkend="installation">Installation procedure</link>'> +<!ENTITY disablenote '<note><para>This feature is temporarily disabled and will be rewritten, sorry.</para></note>'> +<!ENTITY faqbugreports-lnk '<link linkend="faqg_bug_report">bug reports</link>'> +<!ENTITY hesbugreport-lnk 'Don't hesitate to send <link linkend="faqg_bug_report">Bug reports</link>.'> +<!ENTITY betafeaturenote '<note><para>This is a new feature that can be considered as "beta". &hesbugreport-lnk; + <link linkend="faqg_wish">User feedback</link> is always welcome!</para></note>'> +<!ENTITY newfeaturenote '<note><para>This is a new feature under development. Some descriptions may become obsolete if functionality changes during development. &hesbugreport-lnk; + <link linkend="faqg_wish">User feedback</link> is always welcome!</para></note>'> +<!ENTITY rwfeaturenote '<note><para>This module was rewritten. Some descriptions may become obsolete if + functionality changes during development. &hesbugreport-lnk; + <link linkend="faqg_wish">User feedback</link> is always welcome!</para></note>'> +<!ENTITY krusaderui-rc-text '<para>If you install a CVS or beta version and if &krusader; was previously + installed on your computer, then you should delete the <filename>krusaderui.rc</filename> file + in your home directory to activate the new menu entries + <prompt>$</prompt> <userinput><command>rm</command> <option>~/.kde/share/apps/krusader/krusaderui.rc</option></userinput> + , click <link linkend="faqi_krusaderui_rc">here</link> for more info.</para>'> + +<!ENTITY gpl-lnk '<link linkend="credits">&GNU; General Public License (GPL)</link>'> + +<!ENTITY dev-cvs-note '<note><para> + If you are using a <link linkend="krusader_devel">development</link> or + <link linkend="krusader_cvs">CVS</link> version, it is possible that the latest + new features are not yet in the "The Krusader Handbook". + Please read the &changelog-url; file online or in the &krusader; + sources to find out more about the new features. + For a brief description, please read the &cvsnews-url; file online + or in the &krusader; sources. + <link linkend="faqg_wish">User feedback</link> and + <link linkend="faqg_bug_report">Bug reports</link> are always welcome! + </para></note>'> + + +<!-- markup ENTITIES --> +<!ENTITY folder-tabs '<guibutton>Folder Tabs</guibutton>'> +<!ENTITY right-click '<keycap>Right-click</keycap>'> + + +<!-- application ENTITIES --> +<!ENTITY mc '<application>Midnight Commander</application>'> +<!ENTITY xxdiff '<application>xxdiff</application>'> +<!ENTITY krename '<application>Krename</application>'> +<!ENTITY kget '<application>kget</application>'> +<!ENTITY filelight '<application>Filelight</application>'> +<!ENTITY kdevelop '<application>Kdevelop</application>'> +<!ENTITY keditbookmarks '<application>KeditBookmarks</application>'> +<!ENTITY kwallet "<application>Kwallet</application>"> + +<!-- (TM) Trademark ENTITIES --> +<!ENTITY fedora '<trademark>Fedora</trademark>'> +<!ENTITY yoper '<trademark>Yoper</trademark>'> +<!ENTITY openlx '<trademark>OpenLX</trademark>'> +<!ENTITY appleipod '<trademark>Apple ipod</trademark>'> + +<!-- (R) Registered ENTITIES --> +<!ENTITY freebsd '<trademark class="registered">FreeBSD</trademark>'> +<!ENTITY debian '<trademark class="registered">Debian</trademark>'> +<!ENTITY mandriva '<trademark class="registered">Mandriva</trademark>'> +<!ENTITY gentoo '<trademark class="registered">Gentoo</trademark>'> +<!ENTITY mepis '<trademark class="registered">Mepis</trademark>'> +<!ENTITY ubuntu '<trademark class="registered">Ubuntu</trademark>'> +<!ENTITY kubuntu '<trademark class="registered">Kubuntu</trademark>'> +<!ENTITY linspire '<trademark class="registered">Linspire</trademark>'> +<!ENTITY xandros '<trademark class="registered">Xandros</trademark>'> +<!ENTITY slackware '<trademark class="registered">Slackware</trademark>'> +<!ENTITY arklinux '<trademark class="registered">Ark Linux</trademark>'> +<!ENTITY archlinux '<trademark class="registered">Arch Linux</trademark>'> +<!ENTITY netbsd '<trademark class="registered">NetBSD</trademark>'> +<!ENTITY openbsd '<trademark class="registered">OpenBSD</trademark>'> +<!ENTITY knoppix '<trademark class="registered">Knoppix</trademark>'> +<!ENTITY frugalware-linux '<trademark class="registered">Frugalware Linux</trademark>'> +<!ENTITY pclinuxos '<trademark class="registered">PCLinuxOS</trademark>'> +<!ENTITY altlinux '<trademark class="registered">altlinux</trademark>'> +<!ENTITY sourcemage '<trademark class="registered">Source Mage</trademark>'> +<!ENTITY kanotix '<trademark class="registered">Kanotix</trademark>'> +<!ENTITY lunarlinux '<trademark class="registered">Lunar Linux</trademark>'> +<!ENTITY ccuxlinux '<trademark class="registered">CCux Linux</trademark>'> +<!ENTITY qilinux '<trademark class="registered">QiLinux</trademark>'> +<!ENTITY rocklinux '<trademark class="registered">ROCK Linux</trademark>'> + +<!ENTITY nvidia '<trademark class="registered">NVIDIA</trademark>'> +<!ENTITY nc '<trademark class="registered">Norton Commander</trademark>'> +<!ENTITY openoffice '<trademark class="registered">OpenOffice</trademark>'> +<!ENTITY firefox '<trademark class="registered">Firefox</trademark>'> +<!ENTITY safari '<trademark class="registered">Safari</trademark>'> +<!ENTITY apple '<trademark class="registered">Apple</trademark>'> + +<!-- (C) Copyright ENTITIES --> +<!ENTITY freebsd '<trademark class="copyright">FreeBSD</trademark>'> +<!ENTITY tcmd '<trademark class="copyright">Total Commander</trademark>'> +<!ENTITY tcmd-url '<ulink url="http://www.ghisler.com/">&tcmd;</ulink>'> + +<!-- useraction ENTITIES --> +<!ENTITY useraction-parameter 'Parameter:'> +<!ENTITY useraction-optional-parameter 'Parameter (optional):'> +<!ENTITY useraction-default 'Default:'> + +<!-- chapters in separate docbook files --> + <!ENTITY help SYSTEM "help.docbook"> + <!ENTITY editors-note SYSTEM "editors-note.docbook"> + <!ENTITY introduction SYSTEM "introduction.docbook"> + <!ENTITY features SYSTEM "features.docbook"> + <!ENTITY user-interface SYSTEM "user-interface.docbook"> + <!ENTITY using-krusader SYSTEM "using-krusader.docbook"> + <!ENTITY more SYSTEM "more.docbook"> + <!ENTITY commands SYSTEM "commands.docbook"> + <!ENTITY keyboard SYSTEM "keyboard.docbook"> + <!ENTITY mouse SYSTEM "mouse.docbook"> + <!ENTITY konfigurator SYSTEM "konfigurator.docbook"> + <!ENTITY krusader-tools SYSTEM "krusader-tools.docbook"> + <!ENTITY faq SYSTEM "faq.docbook"> + <!ENTITY credits SYSTEM "credits.docbook"> + <!ENTITY glossary SYSTEM "glossary.docbook"> + +<!-- some using-krusader content in separate docbook files --> + <!ENTITY splitter SYSTEM "splitter.docbook"> + <!ENTITY profiles SYSTEM "profiles.docbook"> + <!ENTITY vfs SYSTEM "vfs.docbook"> + <!ENTITY compare SYSTEM "compare.docbook"> + <!ENTITY occupied-space SYSTEM "occupied-space.docbook"> + <!ENTITY checksum SYSTEM "checksum.docbook"> + <!ENTITY archives SYSTEM "archives.docbook"> + +<!-- some krusader-tools content in separate docbook files --> + <!ENTITY bookmarks SYSTEM "bookmarks.docbook"> + <!ENTITY diskusage SYSTEM "diskusage.docbook"> + <!ENTITY java SYSTEM "java.docbook"> + <!ENTITY search SYSTEM "search.docbook"> + <!ENTITY viewer-editor SYSTEM "viewer-editor.docbook"> + <!ENTITY locate SYSTEM "locate.docbook"> + <!ENTITY mount SYSTEM "mount.docbook"> + <!ENTITY remote-connections SYSTEM "remote-connections.docbook"> + <!ENTITY synchronizer SYSTEM "synchronizer.docbook"> + <!ENTITY krusader-useractions SYSTEM "useractions.docbook"> + +<!-- <!ENTITY remote-connections SYSTEM "remote-connections.docbook"> + <!ENTITY mount SYSTEM "mount.docbook"> + <!ENTITY bookmarks SYSTEM "bookmarks.docbook"> + <!ENTITY search SYSTEM "search.docbook"> + <!ENTITY locate SYSTEM "locate.docbook"> + <!ENTITY viewer-editor SYSTEM "viewer-editor.docbook"> + <!ENTITY synchronizer SYSTEM "synchronizer.docbook"> + <!ENTITY java SYSTEM "java.docbook"> + <!ENTITY diskusage SYSTEM "diskusage.docbook"> +--> + +<!-- appendices in separate docbook files --> + <!ENTITY installation SYSTEM "installation.docbook"> + <!ENTITY configuration-files SYSTEM "configuration-files.docbook"> + <!ENTITY useraction-xml SYSTEM "useraction-xml.docbook"> + <!ENTITY release-overview SYSTEM "release-overview.docbook"> + +]> +<book lang="&language;"> + <bookinfo id="index"> + <title>The Krusader Handbook</title> + <authorgroup> + <!-- +Changed the <author> tag in favor for <othercredit role="developer"> for Frank since +the <author><contrib> tag is not shown for the documentation author on the index page +This is a workaround, i have no idea why the <author> tag doesn't show the <contrib> tag (= the title) +on the index page. +Frank. +--> + +<!-- NOTE: DBLATEX doesn't accept "&" to display "&" in the <contrib> tag, so i changed it to "and" --> + + <othercredit role="developer"> + <firstname>Frank</firstname> + <surname>Schoolmeesters</surname> + <contrib>Documentation and Marketing + coordinator</contrib> + <affiliation> + <address> + <email>frank_schoolmeesters@yahoo.com</email> + </address> + </affiliation> + </othercredit> + <othercredit role="reviewer"> + <firstname>Richard</firstname> + <surname>Holt</surname> + <contrib>Documentation and Proofing</contrib> + <affiliation> + <address> + <email>richard.holt@gmail.com</email> + </address> + </affiliation> + </othercredit> + <othercredit role="reviewer"> + <firstname>Matej</firstname> + <surname> + Urbančič</surname> + <contrib>Marketing and Product + Research</contrib> + <affiliation> + <address> + <email>matej.urban@gmail.com</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Shie</firstname> + <surname>Erlich</surname> + <contrib>Author and initial Handbook author</contrib> + <affiliation> + <address> + <email>erlich@users.sourceforge.net</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Rafi</firstname> + <surname>Yanai</surname> + <contrib>Author and initial Handbook author</contrib> + <affiliation> + <address> + <email>yanai@users.sourceforge.net</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Dirk</firstname> + <surname>Eschler</surname> + <contrib>Webmaster and i18n + coordinator</contrib> + <affiliation> + <address> + <email>deschler@users.sourceforge.net</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Csaba</firstname> + <surname>Karai</surname> + <contrib>Developer</contrib> + <affiliation> + <address> + <email>ckarai@users.sourceforge.net</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Heiner</firstname> + <surname>Eichmann</surname> + <contrib>Developer</contrib> + <affiliation> + <address> + <email>h.eichmann@gmx.de</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Jonas</firstname> + <surname>Bähr</surname> + <contrib>Developer</contrib> + <affiliation> + <address> + <email>jonas.baehr@web.de</email> + </address> + </affiliation> + </othercredit> + </authorgroup> + <copyright> + <year>2000</year> + <year>2001</year> + <year>2002</year> + <year>2003</year> + <holder>Rafi Yanai</holder> + <holder>Shie Erlich</holder> + </copyright> + <copyright> + <year>2004</year> + <year>2005</year> + <year>2006</year> + <year>2007</year> + <year>2008</year> + <holder>Krusader Krew</holder> + </copyright> + <legalnotice> + <para>Permission is granted to copy, distribute and/or modify + this document under the terms of the + <ulink url="http://www.gnu.org/copyleft/fdl.html">GNU Free + Documentation License</ulink>, Version 1.1 or any later + version published by the Free Software Foundation; with no + Invariant Sections, with no Front-Cover Texts, and with no + Back-Cover Texts. A copy of the license is included in the + &krusader; sources.</para> + </legalnotice> + <date>2008-03-06</date> + <releaseinfo>1.90.0 "Power Stone"</releaseinfo> + <abstract> + <para>&krusader; is an advanced, twin-panel + (commander-style) file-manager for KDE, and other desktops in + the *nix world</para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>krusader</keyword> + <keyword>commander</keyword> + <keyword>filemanager</keyword> + <keyword>twinpanel</keyword> + <keyword>linux</keyword> + <keyword>file</keyword> + <keyword>manager</keyword> + <keyword>dual pane</keyword> + <keyword>linux-commander</keyword> + <keyword>kde-commander</keyword> + </keywordset> + </bookinfo> +<!-- preface --> + &help; + &editors-note; + +<!-- chapters --> + &introduction; + &features; + &installation; + &user-interface; + <!-- &basic-functions; TODO "using-krusader" has become "basic-functions" --> &using-krusader; + <!-- &advanced-functions; TODO "more" has become "advanced-functions" --> &more; + <!-- &menu-commands; TODO "commands" has become "menu-commands" --> &commands; + <!-- &keyboard-commands; TODO "keyboard" has become "keyboard-commands" --> &keyboard; + <!-- &mouse-commands; TODO "mouse" has become "mouse-commands" --> &mouse; + &krusader-tools; + + + &konfigurator; + &faq; + <!-- &credits-and-license; TODO "credits" has become "credits-and-license" --> &credits; + +<!-- appendices --> + &configuration-files; + &useraction-xml; + &release-overview; + +<!-- glossary --> + &glossary; + +<!-- index (automagically generated) --> + &documentation.index; +</book> diff --git a/doc/en/installation.docbook b/doc/en/installation.docbook new file mode 100644 index 0000000..4bd186b --- /dev/null +++ b/doc/en/installation.docbook @@ -0,0 +1,1250 @@ +<chapter id="installation"> + <!-- ********************************************************************** + installation.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Installation on KDE3.x</title> + <indexterm> + <primary>Installation</primary> + </indexterm> + <sect1 id="requirements"> + <title>Requirements</title> + <para>In order to successfully use the most recent + &krusader;, you need &kde;libs + >= 3.4</para> + <para>Required &kde; version: + <itemizedlist> + <listitem> + <para>&krusader; v1.01: &kde; + 2</para> + </listitem> + <listitem> + <para>&krusader; v1.02 - 1.40: &kde; + 3.0 - &kde; 3.2</para> + </listitem> + <listitem> + <para>&krusader; 1.40: prefers &kde; + 3.2 (otherwise all features will not be available)</para> + </listitem> + <listitem> + <para>&krusader; v1.50 - v1.51: &kde; + 3.2 - &kde; 3.3 (Konfigurator crash on + &kde; 3.4)</para> + </listitem> + <listitem> + <para>&krusader; v1.60.0 - v1.70.0: + &kde; 3.3 - &kde; 3.5</para> + </listitem> + <listitem> + <para>&krusader; 1.70.x: prefers + &kde; >= 3.4 (otherwise all + features will not be available)</para> + </listitem> + <listitem> + <para>&krusader; 1.80.0: &kde; 3.4 - + &kde; 3.5</para> + </listitem> + <listitem> + <para>&krusader; v2.xx.x: &kde; 4 - + &Qt; 4 The big challenge, a first release in + 2008</para> + </listitem> + </itemizedlist> + NOTE: there are no installation instructions for &kde;4 yet available since at moment of writing &krusader; + was not ported yet to &kde;4.</para> + <para>Platforms: + <itemizedlist> + <listitem> + <para>All POSIX + (&Linux;/BSD/&UNIX;-like OSes), + &Solaris;</para> + </listitem> + <listitem> + <para>All BSD Platforms + (&freebsd;/&netbsd;/&openbsd;/&MacOS;)</para> + </listitem> + </itemizedlist></para> + <para>&krusader; uses about 3-4 Mbyte of memory to + run and about 15 Mbyte of shared memory, which is also used by + other processes, but this may vary depending on your platform + and configuration. In order to handle archives the archivers + must be configured + <link linkend="konfig-dependencies">here</link>.</para> + <para>A package of popular (un)packers, &krusader; + itself and add-ons can be found on the + &krudownload-url;.</para> + <para>For more requirements, see below. Have a look at the + &faq-lnk; section as well.</para> + </sect1> + <sect1 id="getting-krusader"> + <title>Obtaining &krusader;</title> + <para>The latest information about &krusader; can be + found on the &kruwebsite-url; .</para> + <sect2 id="krusader-download"> + <title>&krusader; Downloads</title> + <para>it is recommended to use the &krusader; package + that is provided by your distribution. + &distrowatch-com-url; is a great resource to check + the availability. If your distribution does not offer + &krusader;, please contact the creators of your + distribution and ask them to provide a &krusader; + package</para> + <para>The latest version, as well as the older versions, can + be found on the &krudownload-url; and on the + &sfmirrors-url;. It contains the source tarballs, + RPM and DEB packages to whatever distro the + &krusader;-Krew is using and packages build by + &krusader; users and third parties.</para> + <para>Distributions who provide &krusader;: + <itemizedlist> + <listitem> + <para>&suse-download-url; >= + 9.3, Note: please use &krusader;-1.60.0 + instead of &krusader;-1.51 (might be unstable + on &SuSE;9.3-&kde;3.4).</para> + </listitem> + <listitem> + <para>&fedora; via + &fedora-extras-url; + <command># yum install krusader</command> will do the job, + thanks to Marcin Garski. &RedHat; RPM packages + can usually found on the &krudownload-url; or + at &dag-wiers-download-url; and + &dries-verachtert-download-url; .</para> + </listitem> + <listitem> + <para>&debian-download-url;, on our + &krudownload-url; you might find more recent + DEB packages. Note: usually &debian; packages + work also on distributions that are "based on + &debian;", and some of these provide their own + (incompatible) packages. + &ubuntu-kubuntu-download-url;, + &linspire-download-url;, &knoppix; + 4.x DVD, &kanotix;, etc.</para> + </listitem> + <listitem> + <para>&mandriva-download-url; via the contrib + repository + <command># urpmi krusader</command> will do the job, + &gentoo-download-url;, + &yoper-download-url;.</para> + </listitem> + <listitem> + <para>&archlinux-download-url;, + &frugalware-linux-download-url;, + &pclinuxos-download-url;, + &altlinux-download-url;.</para> + </listitem> + <listitem> + <para>&freebsd-download-url;, the port is + maintained by + <link linkend="credits">Heiner Eichmann</link>.</para> + </listitem> + <listitem> + <para>&netbsd-download-url;, + &lunarlinux-download-url; + ,&arklinux;, &openlx;, + &sourcemage;.</para> + </listitem> + <listitem> + <para>Even more distributions can be found with + &distrowatch-com-url;.</para> + </listitem> + </itemizedlist>Use the installation tools included in your + distro to install the &krusader; package. You + might need an internet connection if &krusader; is + not included on the &CD; or DVD. There are + probably other distributions which include + &krusader;. If you know of one, please send + feedback so that we can include it on the distrolist.</para> + <para>Others + <itemizedlist> + <listitem> + <para>&slackware; tgz binaries can usually be + found on the &krudownload-url;. You can also + use &portpkg-url; that contains a + &kru-slackbuild-url;, + <command># portpkg krusader</command> will do the + job.</para> + </listitem> + <listitem> + <para>There is a &macosx-port-url; + with the help of &fink-url; , the port is + maintained by <ulink url="http://hritcu.wordpress.com/about/">Catalin Hritcu</ulink>.</para> + </listitem> + </itemizedlist></para> + <para>Installation via the &klik-protocol-url; + <itemizedlist> + <listitem> + <para>&klik-krusader-url; downloads + &krusader; provided by &debian; + stable, more information is + &klik-available-url; .</para> + </listitem> + <listitem> + <para>&klik-krusader-latest-url; downloads the + latest &klik-stable-krusader-url; provided by + the &krusader; Krew.</para> + </listitem> + <listitem> + <para>&klik-krusader-cvs-url; downloads a + &klik-cvs-krusader-url; provided by the + &krusader; Krew.</para> + </listitem> + </itemizedlist></para> + <para>Search engines + <itemizedlist> + <listitem> + <para>You can also find packages on &Linux; + software archives such as &freshmeat-url; or + &kde-apps-url; .</para> + </listitem> + <listitem> + <para>If you can notfind a package for your distribution, + we recommend searching for it with + &rpmfind-url;, &rpmpbone-url; or + &rpmseek-url;.</para> + </listitem> + </itemizedlist>If you enjoy using &krusader;, we + would appreciate it if you went to one of these sites and + rated it.</para> + <para>If you still can not find a package, follow the + installation procedure on how to compile + &krusader; from source. This very thorough HowTo + describes the process in such detail that even newcomers + should not have any problems.</para> + </sect2> + <sect2 id="version_scheme"> + <title>Version Scheme</title> + <para>A new version scheme has been used since + &krusader;-1.60.0 + <itemizedlist> + <listitem> + <para>First digit - the major version</para> + </listitem> + <listitem> + <para>Second digit(s) - percentage of features completed + for this major version</para> + </listitem> + <listitem> + <para>Third digit(s) - bugfixes.</para> + </listitem> + </itemizedlist>In essence, releasing + &krusader;-1.60.0 means that we believe that + &krusader; is about 60% done with all the features + we had scheduled for the 1.x.x series. Series 2.x.x will be + &kde; 4.x releases. Hopefully, it is easy to + understand.</para> + </sect2> + <sect2 id="krusader_stable"> + <title>Stable Version</title> + <para> + <filename>krusader-x.xx.tar.gz</filename> + </para> + <note> + <para>&krusader; is released under the + &gpl-lnk;. This means that THE PROGRAM IS + PROVIDED "AS IS" WITH NO WARRANTY OF ANY KIND, even when it + is marked as a stable release.</para> + </note> + </sect2> + <sect2 id="krusader_devel"> + <title>Development Version (beta release)</title> + <para> + <filename>krusader-x.xx-betax.tar.gz</filename> + </para> + <para>Before every stable release we release at least one + development version in order to hunt down the bugs.</para> + <warning> + <para>These releases are beta releases and will probably + contain some bugs.</para> + </warning>&dev-cvs-note; + <para>The beta release has 3 goals: + <itemizedlist> + <listitem> + <para>Apply a feature-freeze until the stable is released, + only bugs will be fixed. New features have to wait until + the stable is released.</para> + </listitem> + <listitem> + <para>Obtain feedback from &krusader; users so + that we can fix the bugs.</para> + </listitem> + <listitem> + <para>Give translators time to update the translations for + the coming stable. Please read the + &i18n-page-url;.</para> + </listitem> + </itemizedlist></para></sect2> + <sect2 id="krusader_cvs"> + <title>CVS Builds</title> + <para> + <filename>krusader-cvs-yyyymmdd.tar.gz</filename> + </para> + <warning> + <para>These builds are untested and come without any + warranty. They may contain bugfixes, new features, or even + new bugs.</para> + </warning> + <para>We provide daily snapshots of &krusader;'s + CVS version. For those who are interested, the + <emphasis role="bold">nightly tarball</emphasis> can be found + on the &krucutedge-url;. Depending on the stage of + development, this version will either be stable or unstable. + Just before a stable release, the CVS version is almost + stable. After a stable release new features will be committed + into CVS, which might lead to the appearance of bugs. In some + rare cases, the build will not even compile if we make a + mistake. In that case we try to fix the error as soon as + possible.</para> + <para>&krusader; provides 2 nightly snapshots: + <orderedlist numeration="arabic"> + <listitem> + <para> + <filename>krusader-cvs-yyyymmdd.tar.gz</filename>: + <command>make -f Makefile.cvs</command> must be run before + the + <command>./configure</command> script is available.</para> + </listitem> + <listitem> + <para> + <filename>krusader-cvs2-yyyymmdd.tar.gz</filename>: for + users who have problems with the + <command>make -f Makefile.cvs</command> command, we have + already done this for you and the + <command>./configure</command> script is included in the + tarball. This tarball is a bit bigger than the first + one.</para> + </listitem> + </orderedlist></para> + <para> + <emphasis role="bold">check out from CVS</emphasis>. + &krusader; can be checked out through anonymous + (pserver) CVS with the following instruction set. The module + you wish to check out must be specified as the module name. + When prompted for a password for anonymous, press the + &Enter; key.</para> + <para>Currently, there are two module options: + <itemizedlist> + <listitem> + <para>krusader_kde2: the &kde;2 branch, stable + but it is basically v1.01 and there are no planned + changes</para> + </listitem> + <listitem> + <para>krusader_kde3: the &kde;3 branch that we + currently use</para> + </listitem> + </itemizedlist></para> + <para>To check out &krusader; from CVS: + <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader login</option></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader co krusader_kde3</option></userinput></screen> + (note: updates from within the modules directory do + not need the -d parameter)</para> + <para>If you want to check out a specific version of + &krusader; from CVS (⪚ + &krusader;-1.60.0) : + <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader co -rversion_1_60_0 krusader_kde3</option></userinput></screen> + </para> + <para>If you want to check out a specific date of + &krusader; from CVS (⪚ + &krusader;-2006-10-29) : + <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader co -D2006-10-29 krusader_kde3</option></userinput></screen> + </para> + <para>Mostly being &gentoo; users, we provide a + &gentoo-life-ebuild-url; for all those who want to + stay on the bleeding edge of file management and do not want + to miss the advantages of portage. Please take a look at our + &krucutedge-url; for more installation + details.</para> + <para>We also provide &viewcvs-url; to browse the + CVS repository.</para> + </sect2> + <sect2 id="krusader_svn"> + <title>Subversion</title> + <para>&subversion-url; is used for + the &krusader; 2.x series for &kde;4. + it is also possible to + &browse-svn-repo-url;.</para> + <para>To check out the latest &krusader; 1.x for + &kde; 3 from SVN: (NOTE: at moment of writing use CVS for krusader_kde3, since krusader_kde3 + is developed in CVS and NOT in SVN, currently you will get an old version in SVN) + <screen><prompt>$</prompt> <userinput><command>svn</command> <option>co https://krusader.svn.sourceforge.net/svnroot/krusader/trunk/krusader_kde3</option></userinput></screen> + To check out the latest &krusader; 2.x + for &kde; 4 from SVN: + <screen><prompt>$</prompt> <userinput><command>svn</command> <option>co https://krusader.svn.sourceforge.net/svnroot/krusader/trunk/krusader_kde4</option></userinput></screen> + </para> + </sect2> + <sect2 id="krusader_old"> + <title>Older Releases</title> + <para>If you are looking for older releases we recommend the + &sfmirrors-url;, available from our project + page.</para> + </sect2> + </sect1> + <sect1 id="compilation"> + <title>Compiling and Installing</title> + <sect2 id="sourcedownload"> + <title>Compiling &krusader;. What now?</title> + <para>Check the environment variables + &kdeqtdir-lnk;.</para> + <para>To compile and install &krusader; on your + system, type the following in the base directory of the + &krusader; package:</para> + <screen> + <prompt>$</prompt> <userinput><command>./configure</command></userinput> + <prompt>$</prompt> <userinput><command>make</command></userinput> + <prompt>$</prompt> <userinput><command>su -c 'make</command> <option>install'</option></userinput></screen> + &krusaderui-rc-text; + <para>Since &krusader; uses + <command>autoconf</command> and + <command>automake</command> you should have no trouble compiling + it. If you run into problems, read the detailed installation + instructions below.</para></sect2> + + +<sect2 id="install_quickstart"> +<title>Quickstart Installation Tutorial</title> + +<sect3 id="install_quickstart_debian"> +<title>Debian</title> +<para>These instructions should work as well on &debian; based distributions like: +&ubuntu;, &kubuntu;, &linspire;, &kanotix;, ...</para> + +<para>Add the next lines in the <filename>~/.bashrc</filename> configuration file +<screen> +<userinput><command>export</command> <option>QTDIR=/usr</option></userinput> +<userinput><command>export</command> <option>KDEDIR=/usr</option></userinput> +<userinput><command>export</command> <option>export KDEDIRS=/opt/krusader:/usr</option></userinput> +</screen> +</para> + +<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader; +<screen> +<prompt>#</prompt> <userinput><command>apt-get</command> <option>build-dep krusader</option></userinput> +</screen> +</para> + +<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and +enter the <filename>krusader_kde3</filename> directory.</para> + +<para> +The next command will create <command>./configure</command> +<screen> +<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput> +</screen> +NOTE: you might need to upgrade <filename>automake</filename> and/or <filename>autoconf</filename>, if an error message appears. +</para> + +<para>Install &krusader; in the <filename>/opt</filename> directory to not overwrite the official &debian; binary <filename>/usr/bin/krusader</filename>, +so that <command>krusader</command> will run the official &debian; package and <command>/opt/bin/krusader</command> runs the compiled version. +It's recommended to use enable the full debug, so that you can possible problems at us. Run configure. +<screen> +<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/opt/krusader --enable-debug=full</option></userinput> +</screen> +</para> + +<para>Compile &krusader; +<screen> +<prompt>$</prompt> <userinput><command>make</command></userinput> +</screen> +</para> + +<para>Install Krusader +<screen> +<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput> +</screen> +</para> + +<para><command>/opt/bin/krusader</command> runs the compiled &krusader; version.</para> +</sect3> + +<sect3 id="install_quickstart_suse"> +<title>SuSE</title> +<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader;</para> +<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and +enter the <filename>krusader_kde3</filename> directory. Now you can compile and install &krusader; +<screen> +<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput> +<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/opt/krusader --enable-debug=full</option></userinput> +<prompt>$</prompt> <userinput><command>make</command></userinput> +<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput> +</screen> +</para> +</sect3> + +<sect3 id="install_quickstart_others"> +<title>For other Linuxes</title> +<para>Ofcource it's impossible to cover all Linuxes, but here are the general installation instructions.</para> + +<para>Usually <command>./configure --prefix=/usr</command> should be used, though options like +<filename>/opt/krusader</filename> are usually better so that you don't overwrite files that +are installed by your package managment system. +Please don't use the <filename>/usr/local</filename> directory as it simply won't work.</para> +<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader;</para> +<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and enter the <filename>krusader_kde3</filename> directory. Now you can compile and install &krusader; +<screen> +<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput> +<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/usr</option></userinput> +<prompt>$</prompt> <userinput><command>make</command></userinput> +<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput> +</screen> +</para> +</sect3> + +</sect2> + + <sect2 id="install_tutorial"> + <title>Detailed Installation Tutorial</title> + <para>The next section will explain how to install + &krusader; step by step. Questions about the + installation process have been asked many times and + especially users new to &Linux; often have + problems compiling software from source. Therefore, we are + trying to keep the explanations as detailed as possible even + if they are mostly not &krusader; specific. + Experienced users may easily skip most of the steps.</para> + <para>Unfortunately, because not all &Linux; + distributions follow the &fhs-url; it is impossible + to write a tutorial that would cover all circumstances. + However, these guidelines will help you in the right + direction.</para> + <note> + <para>If you encountered problems, please read first this + installation procedure and the &faq-lnk;. If the + problem persists, use the &help-request-lnk; to + ask for help.</para> + </note> + <orderedlist> + <listitem> + <para>Install all packages and libraries that are needed + for the compilation, please read the + &faq-lnk;. + <tip> + <para>If you install &kdevelop;, (almost) + everything that you need to compile + &krusader; will be installed on your + computer. However, if you are not a developer, please + follow the instructions and do not use + &kdevelop; to compile + &krusader;.</para> + </tip></para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Open your favourite terminal emulator + (⪚ &konsole;).</para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>We recommend you create a separate directory to + keep all the sources you compile in. This way you will + have a better overview of the installed programs and it + will be easier to uninstall them later. + <screen><prompt>$</prompt> <userinput><command>mkdir</command> ~/source</userinput></screen> + The chosen directory is just an example, any + other will work.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem> + <para>Copy the sources to the + <filename>~/source</filename> directory and unpack them. + <screen><prompt>$</prompt> <userinput><command>cp</command> /<replaceable>"your_dir"</replaceable> /krusader-x.xx.tar.gz ~/source</userinput></screen> + <screen><prompt>$</prompt> <userinput><command>cd</command> ~/source</userinput></screen> + <screen><prompt>$</prompt> <userinput><command>tar</command> <option>-xzvf</option> krusader-x.xx.tar.gz</userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Optional step: if you wish you can delete the + tarball at this point as it is no longer needed. + <screen><prompt>$</prompt> <userinput><command>rm</command> krusader-x.xx.tar.gz</userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Change to the directory containing the sources. + <screen><prompt>$</prompt> <userinput><command>cd</command> krusader-x.xx</userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem id="kde_qt_dir"> + <para>Check the environment variables + <envar>QTDIR</envar>and + <envar>KDEDIR</envar>. &krusader;'s + <command>./configure</command> script needs to know where + the &Qt; and &kde; directories + are.</para> + <para> + <envar>QTDIR</envar>: + <replaceable><path to your Qt + installation></replaceable> ⪚ + <filename>/usr/lib/qt3</filename> or + <filename>/usr/qt3</filename></para> + <para> + <envar>KDEDIR</envar>: + <replaceable><path to your KDE + installation></replaceable> ⪚ + <filename>/usr</filename> or + <filename>/opt/kde3</filename></para> + <para>Normally your distribution will set them for you, + but experience has shown that some do not. You can easily + check the values with the + <command>echo</command> command. + <screen><prompt>$</prompt> <userinput><command>echo</command> $QTDIR</userinput>/usr/lib/qt3 + <prompt>$</prompt> <userinput><command>echo</command> $KDEDIR</userinput>/usr</screen> + + If both commands give an output, the enviroment variables + are set (the above example are the settings of + &mandriva;-&Linux;). In case you + receive empty lines, the variables are not set and you + have to set them manually. If you do not know what to set + the variables to, or if you want to check if the + variables are correctly set, ask your distributor or use + the + <command>find</command> command. +<screen><prompt>$</prompt> <userinput><command>find</command> <option>/usr /opt -name</option> qtconfig <option>-type f 2>/dev/null</option></userinput> +/usr/lib/qt3/bin/qtconfig +<prompt>$</prompt> <userinput><command>find</command> <option>/usr /opt -name</option> kdeinit <option>-type f 2>/dev/null</option></userinput> +/usr/bin/kdeinit</screen> + In this case + <filename>/usr/lib/qt3</filename> is your + <envar>QTDIR</envar> and + <filename>/usr</filename> is your + <envar>KDEDIR</envar>. The installed binaries will go to + <filename>/usr/bin</filename>. Now we will set the + enviroment variables with the + <command>export</command> command. + <screen><prompt>$</prompt> <userinput><command>export</command> QTDIR=<replaceable><replace with your QTDIR></replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>export</command> KDEDIR=<replaceable><replace with your KDEDIR></replaceable></userinput></screen> + </para> + <note> + <para>These enviroment variables are only set for the + lifetime of your current shell. When you close your + terminal and open a new one they will be gone. Assuming + &krusader; is not the only + &Qt;/&kde; program you want to + compile, we recommend to make these settings permanent + (⪚ append both export commands to your + <filename class="directory">/etc/profile</filename>) + file.</para> + </note> + <para>If you can notdetermine your KDEDIR, + <command>kde-config --prefix</command> might help + you.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem> + <para>If you have downloaded a stable version + <filename>"krusader-x.xx.tar.gz"</filename> or a beta + version + <filename>"krusader-x.xx-betax.tar.gz"</filename>, you + can skip this step. In this case the + <filename>./configure</filename> script is + provided.</para> + <para>If you have downloaded a CVS build or nightly + tarball + <filename>"krusader-cvs-yyyy-mm-dd.tar.gz"</filename>", + you will have to run the following command to create the + <filename>./configure</filename> script: + <screen><prompt>$</prompt> <userinput><command>make</command> <option>-f</option>Makefile.cvs</userinput></screen> + </para> + <para>If everything is OK you will see the following + output on your screen: +<screen><prompt>$</prompt> <userinput><command>make</command> <option>-f</option> Makefile.cvs</userinput> +This Makefile is only for the CVS repository +This will be deleted before making the distribution +*** Creating acinclude.m4 +*** Creating list of subdirectories +*** Creating configure.in +*** Creating aclocal.m4 +*** Creating configure +*** Creating config.h template +*** Creating Makefile templates +*** Postprocessing Makefile templates +*** Creating date/time stamp +*** Finished +Don't forget to run ./configure +If you haven't done so in a while, run ./configure --help +<prompt>$</prompt></screen> + </para> + <note> + <para>You will need to have + <application>autoconf 2.52, 2.53 or + 2.54</application> and + <application>automake 1.6</application> (or higher) to + run the + <command>make -f Makefile.cvs</command> command</para> + </note> + <tip> + <para>If you encounter problems with this command click + <link linkend="krusader_cvs">here</link>. + &krusader; provides two nightly builds + (snapshots) one with a + <filename>./configure</filename> script and one + without.</para> + </tip> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem> + <para>Your &Linux; distro + &krusader; RPM or DEB package will normally + install &krusader; in the + <filename>KDEDIR/bin</filename> directory. According to + the &fhs-url;, any user installed files go to + the + <filename>/usr/local</filename> directory. If you wish + &krusader; to be installed in another + directory, it can be determed with the prefix option. If + you do not have root access, + <filename>/home/YOUR_USERNAME/.kde</filename> is probably + a good choice. +<screen> +foo + +Krusader Project: +----------------- +Source code location: . +C Compiler: gcc +C Compiler flags: -ansi -W -Wall -pedantic -Wchar-subscripts -Wshadow -Wpointer-arith +-Wmissing-prototypes -Wwrite-strings -D_XOPEN_SOURCE=500 -D_BSD_SOURCE -O2 +-Wformat-security -Wmissing-format-attribute +C++ Compiler: g++ +prefix: /usr/local +kde_libraries: /usr/include +kde_includes: /usr/lib +kde_locale: /usr/share/locale +qt_libraries: /usr/lib/qt3/lib +qt_includes: /usr/lib/qt3/include +KDEDIR: /usr +QTDIR: /usr/lib/qt3 +Install path: /usr/local/bin +krusader version: 1.80.0 +krusader binary: /usr/local/bin/krusader (after 'make install') +Thank you for using Krusader + +Good - your configure finished. Start make now +<prompt>bash$</prompt> +</screen> + </para> + <para>This is the output for + &Mandrake;-&Linux; 10, other + distributions may give a different output.</para> + <tip> + <para>At the end of the + <command>./configure</command> script you will find a + summary of the most important settings, ⪚ + where the &krusader; binary will be + installed (after the 'make install' command). This part + will also display a warning if the environment + variables &kdeqtdir-lnk; are empty.</para> + </tip> + <para></para> + <!-- Empty line to make it more readable --> + <para>Since &krusader;-1.70.0 + <command>./configure</command> has two specific + &krusader; options: + <itemizedlist> + <listitem> + <para> + <userinput> + <command>./configure</command> + <option>--without-konqueror</option> + </userinput>: build &krusader; without support + &konqueror;'s servicemenus, default=with. + This means that &konqueror;'s right-click + menu entries will not be available.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>./configure</command> + <option>--without-javascript</option> + </userinput>: build &krusader; without JavaScript + support, default=with. This means that the + &javascript-console-lnk; will not be + available.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>./configure</command> + <option>--without-acl</option> + </userinput>: build &krusader; without ACL support default=with. + Sometimes this option is needed if you get a ACL compile error when running <command>make</command>.</para> + </listitem> + </itemizedlist>In the past the support was always + compiled in when the headers where found, now you have + the choice.</para> + <para>Use + <userinput> + <command>./configure</command> + <option>--help</option> + </userinput>to see more options or read the + <filename>INSTALL</filename> file in the + &krusader; sources.</para> + <para>If you used another --prefix= than + <filename>$KDEDIR or /usr/local</filename>, it is + recommended to do an extra check: +<screen><prompt>$</prompt> <userinput><command>kde-config</command> <option>--path exe</option></userinput> +/home/frank/.kde/bin/:/usr/bin/:/usr/local/bin/ +<prompt>$</prompt></screen> + If the + <prefix_dir/bin> directory is + not shown, you need to use e.g. + <command>export KDEDIRS=/usr/local:/usr</command>. To + make these settings permanent you can ⪚ + append this export command to your + <filename>/etc/profile</filename> file. After that you + need to restart &kde;.</para> + <note> + <para>If + <command>./configure</command> fails, take a look at + &missing-libs-lnk;.</para> + </note> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Start the compilation process with the + <command>make</command> command. + <screen><prompt>$</prompt> <userinput><command>make</command></userinput></screen> + This will take about 3 - 40 minutes depending on how fast your computer runs. If + everything goes well, it will ⪚ end with + the following messages: +<screen> +foo +make[2]: Leaving directory `/home/source/krusader_kde3/tar' +make[2]: Entering directory `/home/source/krusader_kde3' +make[2]: Leaving directory `/home/source/krusader_kde3' +make[1]: Leaving directory `/home/source/krusader_kde3' +<prompt>bash$</prompt> +</screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + <para>If + <command>./configure</command> was successful and + <command>make</command> failed for some reason, continue + to read this page. If you can not find a solution to your + problem, feel free to post a help request at our + &forum-lnk;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>If everything is correct, you can now install + &krusader;. + <screen><prompt>$</prompt> <userinput><command>su -c 'make</command> <option>install'</option></userinput></screen> + You will be asked to enter your root + password.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem>&krusaderui-rc-text; + <para></para> + <!-- Empty line to make it more readable --></listitem> + <listitem> + <para>Now you can + <link linkend="starting-krusader"> + start</link> &krusader;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Optional step: Cleaning up to save disk space. + Note: All compiled files created with the + <command>make</command>command will be deleted. + <screen><prompt>$</prompt> <userinput><command>make</command> <option>clean</option></userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem> + <para>If you ever want to uninstall + &krusader;, use + <screen><prompt>$</prompt> <userinput><command>su -c 'make</command> <option>uninstall'</option></userinput></screen> + You will be asked to enter your root + password.</para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + </orderedlist> + <para>If you followed the installation procedure and still + encountered problems installing &krusader;, refer + to &faq-lnk;. If the problem persists, use the + &help-request-lnk; to ask for help.</para> + </sect2> + </sect1> + <sect1 id="mac-port"> + <title>Installing on &MacOS;-X</title> + <indexterm> + <primary>&MacOS;-X port</primary> + </indexterm> + +<note><para>Since June 2006 &krusader; is added into the + <ulink url="http://pdb.finkproject.org/pdb/package.php/krusader">&krusader; finkproject.org repository</ulink> + Please check this url for the latest information about the &MacOS;-X port, + please read the &fink-url; documentation for more information, + all information below could be outdated, though they should still work :) + From now on the port is maintained by + <ulink url="http://hritcu.wordpress.com/about/">Catalin Hritcu</ulink>. +</para></note> + <para>Krusader is ported to &MacOS; thanks the &fink-url;-project and Jonas + Bähr and &bodo-tasche-url; . + Unfortunately the only *stable* kdelib-binaries which + &fink-url; has to offer is currenly 3.1.4 which + means you need to use &krusader;-1.40 . + Unfortunately the &MacOS; X &krusader; + port does not have the same power as in a native + &Linux;-&kde; environment. To run + &krusader; you need also X11, which doesn't interact + with the rest of the &MacOS; desktop. We hope that + &Qt;4/&kde;4 will solve most of these + problems. If you want a more recent Krusader version you need + to compile &kde;. With &fink-url; it is + rather easy but it takes some CPU cycles.</para> + <para>Installation Instructions for &krusader;-1.40 + <orderedlist> + <listitem> + <para>Download and install &fink-url; with the + &kde;3.1 binaries provided by fink and read the + documentation.</para> + </listitem> + <listitem> + <para>Extract the + <filename> + krusader-1.40.fink.darwin-ppc.tar.bz2</filename> package to + <filename>/sw/fink/dist/local/main/</filename> Only root can + write here. You may have to create 'local' and + 'main'.</para> + </listitem> + <listitem> + <para>Run as root: + <command>fink install krusader</command></para> + </listitem> + </orderedlist></para> + <para>Follow these instructions if you wish to compile more + source code or use a more recent version of + &krusader;: + <orderedlist> + <listitem> + <para>Install &apple-x11-url;</para> + </listitem> + <listitem> + <para>Install the &apple-x11-sdk-url; + developer-tools with X11 headers (gcc is included)</para> + </listitem> + <listitem> + <para>Install the fink-base</para> + </listitem> + <listitem> + <para>Compile kdelibs 3.4.1 or higher (fink provides the + necessary + <filename>.info</filename> files)</para> + </listitem> + <listitem> + <para>Compile the &krusader;-tarball or follow + steps 2 and 3 of the previous section if a recent + &krusader;-package ⪚ + <filename> + krusader-1.70.0.fink.darwin-ppc.tar.bz2</filename> is + available</para> + </listitem> + </orderedlist></para> + +<para>Follow these instructions if you wish to compile &krusader;-1.80.0 : + <orderedlist> + <listitem> + <para>Install &apple-x11-url;</para> + </listitem> + <listitem> + <para>nstall fink and + <ulink url="http://fink.sourceforge.net/faq/usage-fink.php#unstable">enable fink unstable</ulink>.</para> + </listitem> + <listitem> + <para>Compile and install the &kde; bundle in fink: fink install bundle-kde-ssl + (if you get “no package found” the previous step did not succeed).</para> + </listitem> + <listitem> + <para>Use <filename>krusader.info</filename> (provided in the &krusader;-sourcecode) and then copy to + <filename>/sw/fink/dists/local/main/finkinfo</filename> .</para> + </listitem> + <listitem> + <para>Compile and install &krusader; in fink: <command>fink install krusader</command> + </para> + </listitem> + <listitem> + <para>Start X11 (startx) and in xterm run &krusader; + </para> + </listitem> + </orderedlist> + Thanks to <ulink url="http://hritcu.wordpress.com/2006/08/10/krusader-on-intel-mac/">Catalin Hritcu </ulink> for these install instructions. +</para> + + + </sect1> + <sect1 id="starting-krusader"> + <title>Starting &krusader;</title> + <para>Type + <userinput> + <command>krusader</command> + </userinput> (lower case) at a command prompt. You can create + shortcut on your desktop or create an entry in the + (&kde;) menu. Read the previous page and the + &faq-lnk; if &krusader; doesn't + start.</para> + <para>When &krusader; is started from the + command line, various options can be specified to modify its + behavior.</para> + <screen> + <prompt>$</prompt> <userinput><command>krusader</command></userinput> + WARNING: Mt.Man: Born, looking around to get familiar. foo</screen> + <note> + <para>Do not worry about the messages you get in the + &konsole;. These messages are log messages that + can be used for debugging &krusader;.</para> + </note> + <para>You can also use + <keycombo action="simul">&Alt; + <keycap>F2</keycap></keycombo> to open the Run Command dialog + box, type + <userinput> + <command>krusader</command> + </userinput> (lower case) and press &Enter; or click + on the + <guibutton>Run</guibutton> button.</para> + <para>If &krusader; is installed by an RPM or DEB + package then usually &krusader; can be started from + the &kmenu;. ⪚ on + &Mandrake;-&Linux; 10.0 click on the + &kicon; button and choose + <emphasis role="bold"> + <menuchoice> + <guimenuitem>Applications</guimenuitem> + <guimenuitem>File tools</guimenuitem> + <guimenuitem>&krusader;</guimenuitem> + </menuchoice> + </emphasis>.</para> + <variablelist> + <title>Command-line options:</title> + <varlistentry> + <term> + <option>--left</option> + <replaceable> + <path></replaceable> + </term> + <listitem> + <para> + <action>start left panel at + <path></action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--right</option> + <replaceable> + <path></replaceable> + </term> + <listitem> + <para> + <action>start right panel at + <path></action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--left</option> + <replaceable> + <path1>,<path2>,<path3></replaceable> + </term> + <listitem> + <para> + <action>start left panel at + <path1>,<path2>,<path3>, + with tabs.</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--profile</option> + <replaceable> + <panel-profile></replaceable> + </term> + <listitem> + <para> + <action>load a + <link linkend="panel_profiles">panel-profile</link> on + startup (this overrides the + <link linkend="konfig-startup">default startup + profile</link>).</action> + </para> + </listitem> + </varlistentry> + </variablelist> + <para>Examples: + <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=<path> --right=<path></replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=/mnt/cdrom --right=ftp://downloads@myserver.net</replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=<path1>,<path2> --right=<path1>,<path2>,<path3></replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>krusader</command><replaceable>--profile <panel-profile></replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--profile ftp-managment</replaceable></userinput></screen> + </para> + <para>The standard &Qt; and &kde; + command-line options are available, and can be listed by + entering + <userinput> + <command>krusader</command> + <option>--help</option> + </userinput>.</para> + <variablelist> + <title>Other command-line options:</title> + <varlistentry> + <term> + <option>--help-qt</option> + </term> + <listitem> + <para> + <action>List Qt-specific options</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--help-kde</option> + </term> + <listitem> + <para> + <action>List KDE-specific options</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--help-all</option> + </term> + <listitem> + <para> + <action>List all options</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--author</option> + </term> + <listitem> + <para> + <action>Show the authors names</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>-v,--version</option> + </term> + <listitem> + <para> + <action>Show the version number</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--license</option> + </term> + <listitem> + <para> + <action>Show license information</action> + </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="configuration"> + <title>Configuring &krusader;</title> + <para>When you run &krusader; for the first time, + the &krusader; configuration module + <link linkend="konfigurator">Konfigurator</link> will show up + and allow you to configure &krusader; as well as + detect installed packers and tools. You can always run + Konfigurator again from the + &settingsmenu-lnk;.</para> + </sect1> + <sect1 id="default-file-manager"> + <title>Making &krusader; the default file + manager</title> + <para>To make &krusader; the default file manager in + Gnome, <ulink url="http://psychocats.net/ubuntu/nonautilusplease">click here</ulink> for more information. + </para> + <para>To make &krusader; the default file manager in + &kde;, <ulink url="http://groups.google.com/group/krusader-devel/browse_thread/thread/8209d785d3ba0ac6">click here</ulink> for more information. + </para> + </sect1> +</chapter> + +<chapter id="krusader_kde4_install"> +<title>Installation on KDE4.x</title> +<sect1 id="kde4_install"> + <title>Krusader installation instructions on KDE4.0</title> + <note> + <para>From version &krusader;-2.0.0 and higher is &kde;-4 only.</para> + </note> + <note> + <para>At moment of writing &krusader;-2.0.0 is still under development, though it works :)</para> + </note> + +<para>"krusader_kde4.tar.gz" is the supposed name of the krusader tarball (it will be probably a different one ;)</para> + +<para>You can download the latest available krusader-2.x <link linkend="krusader_svn">from SVN</link>.</para> + +<para><command>DCMAKE_INSTALL_PREFIX</command> is the location of the KDE DQT_INCLUDES</para> +<para> + <screen> + <prompt>$</prompt> <userinput><command>tar -xzvf</command> <option>krusader_kde4.tar.gz</option></userinput> + <prompt>$</prompt> <userinput><command>cd </command> <option>krusader_kde4</option></userinput> + <prompt>$</prompt> <userinput><command>cmake </command> <option>-DCMAKE_INSTALL_PREFIX=/usr/ -DQT_INCLUDES=/usr/share/qt4/include</option></userinput> + <prompt>$</prompt> <userinput><command>make</command></userinput> + <prompt>$</prompt> <userinput><command>su -c </command> <option>"make install"</option></userinput> + </screen> +</para> + + </sect1> +</chapter>
\ No newline at end of file diff --git a/doc/en/introduction.docbook b/doc/en/introduction.docbook new file mode 100644 index 0000000..9ff6078 --- /dev/null +++ b/doc/en/introduction.docbook @@ -0,0 +1,145 @@ +<chapter id="introduction"> + +<title>Introduction</title> +<indexterm><primary>Introduction</primary></indexterm> + <sect1 id="package-description"> + <title>Package description</title> + <para>&krusader; is a simple, easy, powerful, + twin-panel file manager (commander-style) for &kde; + and other *nix desktops, similar to &mc; or + &tcmd;. It provides all the file management features + you could possibly want.</para> + <para>Krusader also includes extensive archive handling, + mounted file system support, &FTP;, advanced search + module, viewer/editor, directory synchronization, file content + comparisons, powerful batch renaming and much, much more. + &krusader; supports archive formats: ace, arj, bzip2, deb, gzip, iso, lha, + rar, rpm, tar, zip and 7-zip and handles other + &kioslaves1-url; such as smb:// or fish://.</para> + <para>&krusader; is almost completely customizable and therefore + very user-friendly.</para> + <para>Try &krusader;.</para> + <!-- OLD +<screenshot> + <screeninfo>&krusader; screenshot</screeninfo> + <mediaobject id="krusader_screenshot"> + <imageobject><imagedata fileref="krusader1.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="krusader1.png" format="EPS"/></imageobject> + <textobject><phrase>&krusader; screenshot</phrase></textobject> + <caption><para>&krusader; screenshot</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-krusader" float="1"> + <title>&krusader; screenshot</title> + <mediaobject> + <imageobject> + <imagedata fileref="krusader1.png"></imagedata> + </imageobject> + <textobject> + <phrase>&krusader; screen shot</phrase> + </textobject> + </mediaobject> + </figure> + <para>More &kru-screenshots-url; can be viewed on + our website.</para> + </sect1> + + <sect1 id="welcome"> + <title>Welcome to &krusader;!</title> + <para>Our aim is to give you a simple, intuitive tool that + easily handles the most important tasks you perform on your + computer each and every day: manage and process your files the + way you want.</para> + <para>Whether you are a &Linux; expert or a novice, + &krusader; makes routine file management tasks quick + and accurate, allowing you to focus on the big picture, not + command line syntax. This is especially helpful if you are new + to xxNIX operating systems. To do just that, + &krusader; uses a good-looking &GUI; and + supports drag and drop as well as mime types, making it easy to + use.</para> + <para>&krusader; has many useful features. It is fast, and + handles &archives-lnk; transparently. In addition, + &krusader; streamlines many complex file management + tasks, reducing fatigue, errors, and distraction. Basically, + &krusader; provides all the helpful features you have + come to expect from other quality file management tools like + &mc; and &tcmd;. &krusader; is + designed to integrate seamlessly with the &kde; + Desktop, the desktop of choice for many programmers, network + engineers, and other power users of &Linux;. With + &krusader; even novice users can quickly access the + power, convenience, and feature rich capabilities of the + &kde; Desktop. &krusader; is a free + open-source project, and it is released under the + &gpl-lnk;, although the developers still retain the + copyright for the project and its name, and manage the + project's continuing evolution.</para> + <para>The &krusader; Project mission is to create + an "all-in-one" file manager, which will do all the ordinary + things you would expect of it, and more. Since the principle + behind &krusader; is based on the + &ofm-url;, dual-pane filemanagers (&mc;, + &nc;, &etc;), it is certain that + &krusader; is able to handle all the standard Copy, + Move, Delete, &etc; file operations.</para> + <para>From the start, virtual file systems became the main + focus. &vfs-lnk; are an abstracted layer over all + kinds of archived information (ZIP files, &FTP; + servers, TAR archives, NFS filesystems, SAMBA shares, ISO + cd/dvd images, RPM catalogs, &etc;), which allow the + user to access all the information in these divergent types of + file systems transparently - just like entering an ordinary + sub-directory. Files can then be copied or moved around (except + ISO,rpm,tar.gz) between these data sources/containers + effortlessly. &krusader; currently supports VFSs for + all popular and some specialized types of archives (ace, arj, + bzip2, gzip, iso, lha, rar, tar, zip and 7-zip), configuration + packages (rpm, deb), and traditional remote file system types + (&FTP;, NFS, Samba, FISH, SFTP).</para> + <para>&krusader; also includes a built-in + Mount-Manager &mountman-lnk;, which enables you to + mount or unmount file systems of all types with a click of a + mouse. The user is able to obtain usage and other property + information easily, in a consistent and understandable format + in seconds. Ease and consistency is the goal.</para> + <para>A &bookmark-manager-lnk; for local + files/remote &URL;s and an + &advanced-search-module-lnk; is also included to + speed the locating of needed files. &krusader; also + allows the user to configure Toolbars in order to provide a + wide variety of additional functionality, such as File + Comparison (several user selectable methods available), + Multiple File Rename, and standard Terminal windows.</para> + <para>Advanced users benefit greatly from being able to carry + out clerical tasks effortlessly, without distraction from the + real task at hand. Convenient shortcut keys enable the user to + navigate directory trees with ease, create multiple tabbed + directory views simultaneously, and access fully functional + history lists. Due to efficient programming and low system + overhead, &krusader; is perhaps the most responsive + all around system management tool used to access the full + potential of a computer using &kde;, or any other + standards compliant X Windows window manager. Although designed + specifically for, and tightly integrated with, + &kde;; &krusader; works equally well with + Gnome, Enlightenment, WindowMaker, IceWM, BlackBox, Wiamea, + XFCE, etc.as soon as the KDE libraries are installed.</para> + <para>New extensibility is provided by the flexible + &useractions-lnk;, a &krusader; + innovation that allows unlimited additional custom + functionality to be added to suit the specific needs of users. We + are planning to develop more modules in the near future, + thereby enhancing &krusader;. Information on what is + proposed, approved, or remains to be completed can be found in + the &todoforum-url;.</para> + <para>No other program we know of, offers so many useful, + easily accessible features in such an intuitive and simple + format. Best of all, we listen, and implement good suggestions + that are consonant with the &krusader; Project's + goal: making &krusader; the very best File Manager + available.</para> + <para>We hope you'll enjoy it - we do!</para> + </sect1> +</chapter> diff --git a/doc/en/java.docbook b/doc/en/java.docbook new file mode 100644 index 0000000..dcaa287 --- /dev/null +++ b/doc/en/java.docbook @@ -0,0 +1,88 @@ +<sect1 id="javascript_console"> + <title>JavaScript Console</title> + <indexterm> + <primary>JavaScript Console</primary> + </indexterm> + <para> + <keycombo action="simul">&Alt;&Ctrl; + <keycap>j</keycap></keycombo> opens the JavaScript console. + (only available if libkjsembed is present at compile- and + runtime)</para> + <para>The JavaScript console is an interface to the embedded + JS-Interpreter which can be used for amusement or + testing.</para> + </sect1> + + <sect1 id="javascript_interface"> + <title>JavaScript interface</title> + <indexterm> + <primary>JavaScript interface</primary> + </indexterm> + <para> + <emphasis role="bold">Warning:</emphasis> The JS-Support is + quite stable, and you can not lose any data by using it. However, + your scripts may not work with future versions of + &krusader;, as the JS-Support is changing.</para> + <tip> + <para>Please + <link linkend="help_krusader">upload your favorite JavaScript + Extensions</link> so that they become available for the + &krusader; community. Thanks!</para> + </tip> + <para>JavaScript applications usually have 2 files + <filename>foo.js</filename>and + <filename>foo.ui</filename>. They will be installed in + <filename>~/.kde/share/apps/krusader/js/</filename>, a + user action with a "%_Script" action will start the + Javascripting. Currently we have 2 JS demos + <filename>root-mount-extension.tar.bz2</filename> and + <filename>js-demo-calc.tar.bz2</filename> that will be more + explanatory.</para> + <para>When a script is executed, the script doesn't know its + origin (or maybe there is a way to do so that we do not know of) + and all relative paths are relative to the current working-dir. + But this dir is (normally) not the one where the script is + located but the current dir of the active Panel of Krusader. + This needs to stay like this. However, for referencing + additional files like .ui (Userinterface, exported by + &Qt;'s Designer) one needs the path of the script. + The alternative where absolute paths are used is more than + unhandy. For this reason the Variable "scriptDir" was + introduced. If a Script wants to load a &GUI; from a + .ui-file this can be done this way: + <emphasis>var ui = Factory.loadui( scriptDir + 'filename.ui' + );</emphasis> I recommend using Dialog as a base when designing + &GUI;s to be used with JS. Execute the dialog with: + <emphasis>ui.exec();</emphasis> The elements of the + &GUI; may be accessed in the following way: + <emphasis>ui.child('widgetName')</emphasis></para> + <para>Currently only the objects 'Krusader' and + 'PanelManager' are exposed C++ objects without a logic + behind them. They can be inspected using the JS-Console and the + functions 'properties()', 'children()' and 'slots()'. The + children can be accessed with the function + 'child("nameOfChild")' with returns an object itself. Currently, the Variable scriptDir is more useful. Following the root-mount + extension it is already possible to create advanced + &GUI;s for command line tools</para> + <para>You can play around with 'Krusader.setCaption("Hey Ho, + Let's go!");', 'Krusader.children();', + 'Krusader.child("help").slots();', + 'alert(Krusader.properties())' or + 'Krusader.child("help").show();'.... In addition, a new + placeholder for the &useractions-lnk;, %_Script()%, + will execute an external file.</para> + <para>NOTE: The object 'Krusader' will change. We have not made + decisions about the JS-interface yet (at the time of the + 1.70.0-release). Any ideas are welcome. Plase use our + &kruforum-url; for feedback.</para> + <para>The JavaScript-support is based on + &kjsembed-url;. Some examples which show the power + of this library can be found + <ulink url="http://xmelegance.org/kjsembed/examples/index.html"> + here</ulink>. Support for all of KDE's ground-laying technologies + such as DCOP or KParts is provided. You can even load whole + GUIs from .ui-files, created with &Qt;'s Designer. + An example extension making use of this can be found + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?p=4832#4832"> + here</ulink>.</para> +</sect1> diff --git a/doc/en/keyboard.docbook b/doc/en/keyboard.docbook new file mode 100644 index 0000000..5e16c3d --- /dev/null +++ b/doc/en/keyboard.docbook @@ -0,0 +1,1864 @@ +<chapter id="keyboard-commands"> + <!-- ********************************************************************** + keyboard.docbook + +++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Keyboard Commands</title> + <indexterm> + <primary>Commands</primary> + <secondary>Keyboard</secondary> + </indexterm> + <sect1 id="keyboard-usage"> + <title>Keyboard Usage</title> + <para>In this chapter you will learn how to use the keyboard + effectively, because most operations can be done more quickly + by keyboard than with the mouse. It will take some time to learn + the &keybindigs-lnk;, but mastering them saves you a + lot of time. Please note that &krusader; can use + &keybindigs-profiles-lnk; to swap easily to other + Key-binding setups, e.g. of other commanders, or you can create + your own key-bindings.</para> + <para>After + <link linkend="starting-krusader"> + starting</link> &krusader;, the keyboard action can + begin. Use <keycombo action="simul">&Ctrl;<keycap>l</keycap></keycombo> to jump to the + &location-toolbar-lnk; where you can type the + desired directory. After <keycombo action="simul">&Ctrl;<keycap>Down arrow</keycap></keycombo> + you are in the + &termemu-lnk; and you can type any command you + desire. Use <keycombo action="simul">&Ctrl;<keycap>Up arrow</keycap></keycombo> + to jump back to the active panel. If + you want to jump to a file or directory that starts with "f", + then simply press "f" on the keyboard to use the + &quick-search-lnk; . Use the Enter key to execute + the file or to open a directory that has the focus. Be sure to + remember the Function Keys - <keycap>F3</keycap> to View, <keycap>F4</keycap> to Edit, + <keycap>F5</keycap> to Copy, <keycombo action="simul">&Alt;<keycap>u</keycap></keycombo> to Unpack, etc.</para> + <para>You can also perform several operations with the + &foldertabs-lnk;, including several + <link linkend="edit-menu">selection</link> operations. And at + the end you can close &krusader; with <keycap>F10</keycap>.</para> + </sect1> + <sect1 id="key_bindings"> + <title>Key-Bindings</title> + <indexterm> + <primary>Key-Bindings</primary> + </indexterm> + <indexterm> + <primary>Commands</primary> + <secondary>Keyboard</secondary> + </indexterm> + <para>Most of the key-bindings (shortcuts) are configurable in + the <emphasis role="bold"> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Shortcuts</guimenuitem> + </menuchoice> + </emphasis> menu, if you like to use other key-bindings then the + default ones. You can even configure + more actions to a Key-Binding (for the actions that don't have a key-binding set by default). + Please note that some key-bindings are not &krusader; key-bindings ⪚ + &kde; key-bindings). The key-bindings that + &krusader; uses by default are listed below.</para> + + <!-- FN keys --> + <para> + <emphasis role="bold">Function (FN) Keys</emphasis> + </para> + <para>These are the Key-Bindings of the + &fnkeybar-lnk;. These Key-Bindings are configurable + since version 1.51.</para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycap>F1</keycap> + </para> + </entry> + <entry> + <para>Help</para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F2</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="tools-menu">Terminal.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F3</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="krviewer">View files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F4</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="krviewer">Edit files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F5</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Copy files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F6</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Move files</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F7</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Create a new + directory.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F8</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Delete (or move to Trash) + files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F9</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Rename files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F10</keycap> + </para> + </entry> + <entry> + <para>Quit &krusader;</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- SHIFT keys --> + <para> + <emphasis role="bold">SHIFT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F1</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="help-menu">What's this?</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F3</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="krviewer">Enter an &URL; + to view.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F4</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="file-menu">Edit new file.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F5</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="useractions-menu">Backup current file (Default Useraction).</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F9</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="multi_rename">Multi-rename + (&krename;).</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F10</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">View all files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F12</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">Custom view files.</link> + </para> + </entry> + </row> + <!-- This keybinding is disabled in the "krusader.cpp" source file +<row> +<entry><para><keycombo action="simul">&Shift;<keycap>F11</keycap></keycombo></para></entry> +<entry><para><link linkend="view-menu">Executables</link></para></entry></row> +--> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>Left Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">Change to left folder + tab.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>Right Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">Change to right folder + tab.</link> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- ALT keys --> + <para> + <emphasis role="bold">ALT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>c</keycap></keycombo> + </para> + </entry> + <entry> + <para>&comparedir-lnk;</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>d</keycap></keycombo> + </para> + </entry> + <entry> + <para>&diskusage-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>e</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="test-archive">Test Archive.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>k</keycap></keycombo> + </para> + </entry> + <entry> + <para>Start &rootmode-lnk; + &krusader;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>l</keycap></keycombo> + </para> + </entry> + <entry> + <para>&panel-profiles-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>o</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="panel_toolbar">Sync panels aka "Equals Button (=)".</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>p</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="pack-archive">Pack files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>u</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="unpacking-archives">Unpack + files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>y</keycap></keycombo> + </para> + </entry> + <entry> + <para><link linkend="synchronizer">Synchronize Directory changes</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>+</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Select All.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>-</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Unselect All.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>*</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Invert Selection.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>/</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="mount-man">MountMan.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>`</keycap></keycombo> + </para> + </entry> + <entry> + <para>&usermenu-lnk;</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>KP_Enter</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="file-menu">Properties.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>Left Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Left bookmarks.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>Right Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Right bookmarks.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>Down Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>&popup-panel-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>F1..F12</keycap></keycombo> + </para> + </entry> + <entry> + <para>Standard (&kde;) + key-bindings.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <!-- ALT+SHIFT --> + <para> + <emphasis role="bold">ALT+SHIFT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul"> + &Alt;&Shift; + <keycap>b</keycap></keycombo> + </para> + </entry> + <entry> + <para><link linkend="view-menu">Brief View</link></para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Alt;&Shift; + <keycap>d</keycap></keycombo> + </para> + </entry> + <entry> + <para><link linkend="view-menu">Detailed View</link></para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + + + <!-- CTRL --> + <para> + <emphasis role="bold">CTRL keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>b</keycap></keycombo> + </para> + </entry> + <entry> + <para>&combinefiles-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>d</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Open Bookmarks</link>in the + active panel.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>e</keycap></keycombo> + </para> + </entry> + <entry> + <para>Edit file as root (Default Useraction).</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo> + </para> + </entry> + <entry> + <para>Toggle between normal and full screen + &termemu-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>h</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folderhistory">Open History + list.</link>in the active panel.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>j</keycap></keycombo> + </para> + </entry> + <entry> + <para>A &safari;-like + <link linkend="jump_back">Jump-Back</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>l</keycap></keycombo> + </para> + </entry> + <entry> + <para>Go to the &location-toolbar-lnk; + (origin) as in &firefox; and + &konqueror;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>m</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="list_panel">Open media + list.</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>n</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="tools-menu">New Network + Connection.</link>dialog.</para> + </entry> + </row> + <!-- TODO: Is this entry gone ???? +<row> +<entry><para><keycombo action="simul">&Ctrl;<keycap>o</keycap></keycombo></para></entry> +<entry><para>the inactive panel gets the same path as the active panel</para></entry></row> +--> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>o</keycap></keycombo> + </para> + </entry> + <entry> + <para>Select directory dialog to open this directory + in the panel.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>p</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="splitter">Split file.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>u</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">Swap panels (don't swap all folder tabs)</link>. + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>r</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="panels">Reload (Refresh) + panel.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo> + <keycap>Ctrl</keycap> + <keycap>s</keycap> + </keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="krusearcher">Search.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>q</keycap></keycombo> + </para> + </entry> + <entry> + <para>Quit &krusader;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>w</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">Close Current tab.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>y</keycap></keycombo> + </para> + </entry> + <entry> + <para>&syncdirs-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>z</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Popular URL's.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>+</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Select group.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>-</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Unselect group.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>=</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">Compare + directories.</link>(Compare Mode)</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>.</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">Show/Hide hidden (dot) + files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>/</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="cmdline">Open command line history + list.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="cmdline">Go from the active panel to + the command line/terminal emulator</link>. + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="cmdline">Go from the command + line/terminal emulator to the active panel.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Go from the active panel to the + &location-toolbar-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Home</keycap></keycombo> + </para> + </entry> + <entry> + <para>Jump to the Home directory.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Left</keycap></keycombo>or + <keycombo> + <keycap>Right arrow</keycap> + </keycombo></para> + </entry> + <entry> + <para>Focus a file or directory on the left panel, + press + <keycombo action="simul">&Ctrl; + <keycap>Left arrow</keycap></keycombo> and the right + <link linkend="panels">panel</link> changes: + <itemizedlist> + <listitem> + <para>on a file: the right panel gets the same + path as the left + <link linkend="panels">panel</link>.</para> + </listitem> + <listitem> + <para>on a directory: refreshes the right panel + with the contents of the directory.</para> + </listitem> + </itemizedlist>For the right panel: press + <keycombo action="simul">&Ctrl; + <keycap>Right arrow</keycap></keycombo> and the left + panel will change.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Backspace;</keycombo> + </para> + </entry> + <entry> + <para>Jump to the Root directory.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>PageUp</keycap></keycombo> + </para> + </entry> + <entry> + <para>Up one directory.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- CTRL+SHIFT --> + <para> + <emphasis role="bold">CTRL+SHIFT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>d</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Bookmark current + item.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>f</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="remote-connections">Disconnect + remote connection.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>j</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="jump_back">Set jump back + point.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>l</keycap></keycombo> + </para> + </entry> + <entry> + <para>&locate-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>u</keycap></keycombo> + </para> + </entry> + <entry> + <para><link linkend="view-menu">Swap Sides (also swap all folder tabs)</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Left arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="list_panel">Open left media + list</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Right arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="list_panel">Open right media + list.</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Open + <link linkend="cmdline">terminal emulator</link>, + independently, whether the command line is shown or + not.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Close + <link linkend="cmdline">terminal emulator</link>, + independently, whether the command line is shown or + not.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- CTRL+ALT --> + <para> + <emphasis role="bold">CTRL+ALT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>j</keycap></keycombo> + </para> + </entry> + <entry> + <para>&javascript-console-lnk;</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>m</keycap></keycombo> + </para> + </entry> + <entry> + <para>Mount (Default Useraction).</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>n</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">New tab.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>r</keycap></keycombo> + </para> + </entry> + <entry> + <para>Toggle the &list-panel-lnk; between + horizontal and vertical mode.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>s</keycap></keycombo> + </para> + </entry> + <entry> + <para>Create a new symlink.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>t</keycap></keycombo> + </para> + </entry> + <entry> + <para>Show/hide the + <link linkend="cmdline">terminal + emulator</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>Left Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folderhistory">Left History + list.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>Right Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folderhistory">Right History + list.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>=</keycap></keycombo> + </para> + </entry> + <entry> + <para>Equal Panel Size (Default Useraction).</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt;&Shift; + <keycap>n</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">Duplicate a tab.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt;&Enter;</keycombo> + </para> + </entry> + <entry> + <para>Open current folder in a + <link linkend="folder-tabs">new tab.</link></para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- GENERAL CTRL --> + <para> + <emphasis role="bold">General CTRL keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>a</keycap></keycombo> + </para> + </entry> + <entry> + <para>Select all.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>PageDown</keycap></keycombo> + </para> + </entry> + <entry> + <para>Move to the lower part in the current + directory.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>F1..F12</keycap></keycombo> + </para> + </entry> + <entry> + <para>Standard (&kde;) + key-bindings.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>F1..F12</keycap></keycombo> + </para> + </entry> + <entry> + <para>Standard (&kde;) + key-bindings.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- OTHER KEYS --> + <para> + <emphasis role="bold">Other keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycap>foo</keycap> + </para> + </entry> + <entry> + <para>&quick-search-lnk;</para> + </entry> + </row> + <row> + <entry> + <para>	</para> + </entry> + <entry> + <para> + <link linkend="panels">Switch between the + panels</link> + </para> + </entry> + </row> + <row> + <entry> + <para>&Enter;</para> + </entry> + <entry> + <para> + <link linkend="executing_files">On a + file:</link> open/execute that file</para> + <para> + <link linkend="browsing-archives">On an archive + file:</link> browse the archive as if it was a + directory.</para> + </entry> + </row> + <row> + <entry> + <para>&Esc;</para> + </entry> + <entry> + <para> + <link linkend="moving-around">Will make the menu + bar lose the focus if it has it.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>Delete</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Delete (or move to + Trash).</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>Delete</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Delete permanently.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>SPACE</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="selecting-files">On a + file:</link> toggle the selection of the file down one + position without affecting the selection of other + files/directories.</para> + <para> + <link linkend="calculate">On a + directory:</link> calculate the size, without + affecting the selection of other + files/directories.</para> + </entry> + </row> + <row> + <entry> + <para>&Backspace;</para> + </entry> + <entry> + <para>One directory up.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>INSERT</keycap> + </para> + </entry> + <entry> + <para>Does the same as the SPACE key + <link linkend="selecting-files">and goes down one + position to toggle the next file.</link></para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>MENU</keycap> + </para> + </entry> + <entry> + <para>Right-click menu.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>Home</keycap> + </para> + </entry> + <entry> + <para>Cursor jumps to the top of the list.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>End</keycap> + </para> + </entry> + <entry> + <para>Cursor jumps to the last file in the + list.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <!-- COMMANDLINE --> + <para id="cmdline_keybindings"> + <emphasis role="bold">Command Line</emphasis> + </para> + <para>&cmdline-lnk; keybindings.</para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycap>Up arrow</keycap> and + <keycap>Down arrow</keycap></para> + </entry> + <entry> + <para>scroll through previously typed + commands.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>/</keycap></keycombo> + </para> + </entry> + <entry> + <para>open the command line history list.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>jump from the command line to the active + panel.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>jump from the active panel to the command + line.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Enter;</keycombo> + </para> + </entry> + <entry> + <para>insert current file / directory name without + path to current command line position.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift;&Enter;</keycombo> + </para> + </entry> + <entry> + <para>insert current file / directory with full path + name to current command line position.</para> + </entry> + </row> + <!-- "Backspace" key in terminal, /* Shortcut disabled because of the Terminal Emulator bug. */ krusader.cpp --> + </tbody> + </tgroup> + </informaltable> + + <!-- TERMINAL EMULATOR --> + <para id="termemu_keybindings"> + <emphasis role="bold">Terminal emulator</emphasis> + </para> + <para>&termemu-lnk; keybindings.</para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo> + </para> + </entry> + <entry> + <para>Toggle between normal and full screen + &termemu-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>v</keycap></keycombo> + </para> + </entry> + <entry> + <para>Insert from clipboard.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Jump from the Terminal Emulator to the active + panel if the Command line is hidden.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Jump from the active panel to the Terminal Emulator + if the Command line is hidden.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl;&Shift; + <keycap>Up/Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Always focus/unfocus the Terminal Emulator independently + whether the Command Line is shown or not. </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>Insert</keycap></keycombo> + </para> + </entry> + <entry> + <para>Insert from clipboard.</para> + </entry> + </row> + + <!-- "Backspace" key in terminal, /* Shortcut disabled because of the Terminal Emulator bug. */ krusader.cpp --> + </tbody> + </tgroup> + </informaltable> + + + <!-- DEFAULT USERACTIONS --> + <para> + <emphasis role="bold">Default Useractions</emphasis> + </para> + <para>Default &useractions-lnk; keybindings provided + by &krusader;.</para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>e</keycap></keycombo> + </para> + </entry> + <entry> + <para>Edit a file as root.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>c</keycap></keycombo> + </para> + </entry> + <entry> + <para>Copy current item to clipboard.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>m</keycap></keycombo> + </para> + </entry> + <entry> + <para>Mount a new file system.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>=</keycap></keycombo> + </para> + </entry> + <entry> + <para>Equal panel-size.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>a</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Enqueue in Amarok.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>1</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Sort by Name.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>2</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Sort by extension.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>3</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Sort the active panel by size.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>4</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Sort by modified.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- OTHER KEYS URL'S --> + <itemizedlist> + <title>Other Key-bindings</title> + <listitem> + <para> + <link linkend="selecting-files">Selecting files</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="krviewer">KrViewer</link> + </para> + </listitem> + <listitem> + <para>&diskusage-lnk;</para> + </listitem> + <listitem> + <para>&locate-lnk;</para> + </listitem> + <listitem> + <para>&kcontrolcenter; -> + Accessibility -> Keyboard Shortcuts</para> + </listitem> + <listitem> + <para>&useractions-lnk; configurable + key-bindings</para> + </listitem> + </itemizedlist> + </sect1> +</chapter> diff --git a/doc/en/konfigurator.docbook b/doc/en/konfigurator.docbook new file mode 100644 index 0000000..e3658e5 --- /dev/null +++ b/doc/en/konfigurator.docbook @@ -0,0 +1,1907 @@ +<chapter id="konfigurator"> + <!-- ********************************************************************** + konfigurator.docbook + ++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Konfigurator: &krusader;'s Configuration + Center</title> + <indexterm> + <primary>Configure</primary> + <secondary>Krusader</secondary> + </indexterm> + <para>Konfigurator is &krusader;s configuration + center. When runnig &krusader;, use + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure &krusader;</guimenuitem> + </menuchoice>, and it will start Konfigurator. + There you can modify the way &krusader; works + and customize it to your own needs. At any time, pressing the + <guibutton>Apply</guibutton> button applies the changes, pressing + <guibutton>Close</guibutton> closes Konfigurator, and pressing + <guibutton>Defaults</guibutton> re-applies &krusader;'s + "factory" settings. Konfigurator is divided into pages, each + containing items related to that page. For some changes to the + &GUI;, you have to close and restart + &krusader;.</para> + +<note> + <para>Since &krusader;-1.80.0 the &keybindigs-lnk; and &main-toolbar-lnk;-&actions-toolbar-lnk; + have reiceived their own configuration windows and so they are not a part anymore of Konfigurator, + you can configure them now via the &settingsmenu-lnk;.</para> +</note> + + <sect1 id="konfig-startup"> + <title>Startup</title> + <!-- OLD +<screenshot> + <screeninfo>Startup configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgstartup.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgstartup.png" format="EPS"/></imageobject> + <textobject><phrase>Startup configuration</phrase></textobject> + <caption><para>Configure Startup</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-kgstartup" float="1"> + <title>Startup configuration</title> + <mediaobject> + <imageobject> + <imagedata fileref="kgstartup.png"></imagedata> + </imageobject> + <textobject> + <phrase>Startup configuration</phrase> + </textobject> + </mediaobject> + </figure> + <para>The startup page determines the way that + &krusader; looks (and works) when it is launched. It + is divided into two main parts:</para> + <variablelist> + <varlistentry> + <term> + <guilabel>General</guilabel> + </term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Startup Profile</guilabel>: Starts the + selected + <link linkend="panel_profiles">Panel profile</link> at + startup. + <guilabel><Last + session></guilabel> is a special Panel + Profile, it is saved automatically when closing + &krusader;.</para> + </listitem> + <listitem> + <para> + <guilabel>Show splashscreen</guilabel>: Displays a + splash screen when starting + &krusader;.</para> + </listitem> + <listitem> + <para> + <guilabel>Single Instance Mode</guilabel>: Allows + only one &krusader; instance to run.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>User Interface</guilabel> + </term> + <listitem> + <para>Determines which parts of the user interface are + visible after start-up. + <itemizedlist> + <listitem> + <para> + <guilabel>Save settings on exit</guilabel>: If + checked, restores the user interface components to + their condition when last shut-down.</para> + </listitem> + <listitem> + <para> + <guilabel>Show toolbar</guilabel>: If checked, + &main-toolbar-lnk; is visible after + startup.</para> + </listitem> + <listitem> + <para> + <guilabel>Show statusbar</guilabel>: If checked, the + &statusbar-lnk; is visible after + start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Show function keys</guilabel>: If checked, + the &fnkeybar-lnk; is visible after + start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Show command line</guilabel>: If checked, + the &cmdline-lnk; is visible after + start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Show terminal emulator</guilabel>: If + checked, the &termemu-lnk; is visible + after start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Save last position, size and panel + settings</guilabel>: When launched, + &krusader; resizes itself to the size it + was when last shut-down. &krusader; also + appears in the same location on the screen, having + panels sorted and aligned as they were. If this + option is unchecked, you can use the menu + <emphasis role="bold"> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Save Position</guimenuitem> + </menuchoice> + </emphasis> option to manually set + &krusader; size and position at + start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Start to tray</guilabel>: if checked, + &krusader; starts to tray (if minimize to + tray is set), without showing the main window.</para> + </listitem> + </itemizedlist></para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="konfig-looknfeel"> + <title>Look and Feel</title> + <para>Here you can determine the look and feel of things - + which means finetuning the application to your needs. The page + is divided into four tabs: + <guilabel>Operation</guilabel>, + <guilabel>Panel</guilabel>, + <guilabel>Panel Toolbar</guilabel> and + <guilabel>Selection Mode</guilabel>:</para> + <!-- OLD +<screenshot> + <screeninfo>Look & Feel configurtarion</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kglookfeel.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kglookfeel.png" format="EPS"/></imageobject> + <textobject><phrase>Look & Feel configurtarion</phrase></textobject> + <caption><para>Configure Look & Feel</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kglookfeel" float="1"> +<title>Look & Feel configurtarion</title> +<mediaobject> +<imageobject><imagedata fileref="kglookfeel.png"/></imageobject> +<textobject><phrase>Look & Feel configurtarion</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <sect2 id="konfig-looknfeel-operation"> + <title>Operation</title> + <itemizedlist> + <title> + <guilabel>Look & Feel</guilabel> + </title> + <listitem> + <para> + <guilabel>Warn on exit</guilabel>: If checked, + &krusader; displays an "Are you sure?" warning + when you try to shut it down; otherwise, it exits without + protest.</para> + </listitem> + <listitem> + <para> + <guilabel>Minimize to tray</guilabel>: If checked, when + you minimize &krusader;, its icon will appear + in the system tray instead of the taskbar.</para> + </listitem> + <listitem> + <para> + <guilabel>Autoselect Directories</guilabel>: When + <link linkend="edit-menu">you select a group of + files</link> (either by using Select Group or by using + Select All), &krusader; checks this option. If + checked, the directories matching the select criteria are + also selected. Otherwise, only files are selected.</para> + </listitem> + <listitem> + <para> + <guilabel>Rename selects extension</guilabel>: When + <link linkend="renaming">you rename a file</link>, the + whole text is selected. If you want total commanderlike + renaming of just the name, without extension, deselect + this item.</para> + </listitem> + <listitem> + <para> + <guilabel>Use fullpath tab names</guilabel>: If checked, + display the full path in the &foldertabs-lnk;; + otherwise only the last part of the path is + displayed.</para> + </listitem> + <listitem> + <para> + <guilabel>Fullscreen terminal (mc-style)</guilabel>: + Terminal appears instead of the &krusader; + window (full screen).</para> + </listitem> + <!-- + <listitem><para><guilabel>HTML viewers minimal font size</guilabel>: when viewing an HTML file + (usually using <keycap>F3</keycap>), &krusader; invokes &kde;'s built-in HTML parser. This option + sets the minimal font size for the viewer, and aligns other font sizes accordingly. + </para></listitem> --> + </itemizedlist> + <itemizedlist> + <title> + <guilabel>Quicksearch</guilabel> + </title> + <listitem> + <para> + <guilabel>New style Quicksearch</guilabel>: The new + <link linkend="quicksearch">Quicksearch</link>feature is + used.</para> + </listitem> + <listitem> + <para> + <guilabel>Case Sensitive Quicksearch</guilabel>: When you + use the + <link linkend="quicksearch">Quicksearch</link>feature: If + checked (the &UNIX; default), all files + beginning with capital letters appear before files + beginning with lower case letters; otherwise, all files + beginning with a specified letter (capital or otherwise) + will be displayed together.</para> + </listitem> + </itemizedlist> + </sect2> + <sect2 id="konfig-looknfeel-panel"> + <title>Panel</title> + <itemizedlist> + <listitem> + <para> + <guilabel>Panel font</guilabel>: Allows you to change the + font used inside the file lists.</para> + </listitem> + <listitem> + <para> + <guilabel>Filelist icon size</guilabel>: Allows you to + change the size of the icons in the file lists. The + available sizes are 16x16, 22x22, 32x32 and 48x48 + pixels.</para> + </listitem> + <listitem> + <para> + <guilabel>Use icons in filenames</guilabel>: If checked, + show the icons in file names and folders.</para> + </listitem> + <listitem> + <para> + <guilabel>Human readable file size</guilabel>: If + checked, the file size appears in kB, Mb + &etc;, and not in bytes (default).</para> + </listitem> + <listitem> + <para>Since &krusader;-1.70.0 you need to + configure the columns with the right click menu in the + panel, not in Konfigurator. The left and right panel use + their own columns independently. The following columns + are available: + <itemizedlist> + <listitem> + <para> + <guilabel>Name</guilabel>: Shows the filename without the part after the last dot, + this latter part is displayed in the Ext column. When the Ext column is made hidden, + the complete filename is shown in the Name column like e.g. &konqueror; does. + </para> + </listitem> + <listitem> + <para> + <guilabel>Ext</guilabel>: Shows the last part of the + filename (the part after the last dot) in the ext + column, and not as a complete filename in the name column + like e.g. &konqueror; does. + </para> + </listitem> + <listitem> + <para> + <guilabel>Type</guilabel>: Shows the mime type + field.</para> + </listitem> + <listitem> + <para> + <guilabel>Size</guilabel>: Shows the size + field.</para> + </listitem> + <listitem> + <para> + <guilabel>Modified</guilabel>: Shows the modified + date and time field.</para> + </listitem> + <listitem> + <para> + <guilabel>Perms</guilabel>: Shows the full permissions + ⪚ "rwxr-xr-x" or as octal numbers + '0755' instead with enable/disable + <guilabel>Numeric Permissions</guilabel> in Look + & Feel + <guilabel>Operation</guilabel> Tab.</para> + </listitem> + <listitem> + <para> + <guilabel>rwx</guilabel>: Shows only the rights of + the current user ⪚ "-rw".</para> + </listitem> + <listitem> + <para> + <guilabel>Owner</guilabel>: Shows the owner + field.</para> + </listitem> + <listitem> + <para> + <guilabel>Group</guilabel>: Shows the group + field.</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para> + <guilabel>Show Hidden files</guilabel>: If checked, + &krusader; displays the "dot-files" which are + otherwise hidden.</para> + </listitem> + <listitem> + <para> + <guilabel>Case Sensitive Sorting</guilabel>: If checked + (the &UNIX; default), all files beginning with + capital letters appear before files beginning with + non-capital letters; otherwise, all files beginning with + a specified letter (capital or otherwise) appear + together.</para> + </listitem> + <listitem> + <para> + <guilabel>Always sort dirs by name</guilabel>: Sorts + directories by name, regardless of the sort + column.</para> + </listitem> + <listitem> + <para> + <guilabel>Numeric permissions</guilabel>: Permission + column (Look & Feel + <guilabel>Panel</guilabel>Tab) shows octal numbers '0755' + instead of 'rwxr-xr-x'.</para> + </listitem> + </itemizedlist> + <tip> + <para>Uncheck the columns not in use. This allows more + space for columns in use.</para> + </tip> + </sect2> + <sect2 id="konfig-looknfeel-ptoolbar"> + <title>Panel Toolbar</title> + <para> + <guilabel>Panel Toolbar visible</guilabel>: If checked, + &krusader; displays the Panel Toolbar.</para> + <para>You can make the buttons on the + <guilabel>Panel Toolbar</guilabel> visible or hidden: + <itemizedlist> + <listitem> + <para> + <guilabel>Clear Location Toolbar</guilabel> button: Clears + the &location-toolbar-lnk;</para> + </listitem> + <listitem> + <para> + <guilabel>Open</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Equal (=)</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Up (..)</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Home (~)</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Root (/)</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Toggle-button for sync-browsing</guilabel>: If + checked, shows the &sync-browsing-lnk; + button.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="konfig-selection_modes"> + <title>Selection Mode</title> + <para>Here you can configure the selection modes. + <itemizedlist id="mouse_selection_modes"> + <title> + <guilabel>General</guilabel> + </title> + <listitem> + <para> + <guilabel>&krusader; Mode</guilabel>: The way + &krusader; has worked from day one. Both mouse + keys allow selecting files. To select more than one file, + hold the &Ctrl; key and click the + &LMB;. Right-click menu appears with a short + click on the &RMB;.</para> + </listitem> + <listitem> + <para> + <guilabel>Konqueror Mode</guilabel>: pressing the + &LMB; selects files -- + <!-- Openjade does not like an application element for "Konqueror" here --> + you can click and select multiple files. Right-click menu + appears with a short click on the + &RMB;.</para> + </listitem> + <listitem> + <para> + <guilabel>Total commander Mode</guilabel>: Pressing the + &RMB; selects multiple files + <!-- Openjade does not like an trademark element for "Total commander" here --> + and the right-click menu appears with + <guilabel>pressing and holding</guilabel> the + &RMB; The &LMB; does not select, + but sets the current file without affecting the current + selection.</para> + </listitem> + <listitem> + <para> + <guilabel>Custom Selection Mode</guilabel>: Create your + own selection style!</para> + </listitem> + </itemizedlist> + <itemizedlist> + <title> + <guilabel>Details</guilabel> + </title> + <listitem> + <para> + <guilabel>Double-click selects (classic)</guilabel>: A + single click on a file will select and focus, a double + click opens the file or steps into the directory.</para> + </listitem> + <listitem> + <para> + <guilabel>Obey KDE global selection policy</guilabel>: + Pressing the &LMB; selects files -- Use + &kde;'s global setting: &kde; + Control Center -> Peripherals + -> Mouse.</para> + </listitem> + <listitem> + <para>Custom Selection Mode items: + <itemizedlist> + <listitem> + <para> + <guilabel>Based on KDE's selection mode</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Left mouse button selects</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Left mouse button preserves + selection</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Shift/Ctrl-Left mouse button + selects</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Right mouse button selects</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Right mouse button preserves + selection</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Shift/Ctrl-Right mouse button + selects</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Space bar moves down</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Space bar calculates diskspace</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Insert moves down</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Right-clicking shows the context menu + immediately</guilabel> + </para> + </listitem> + </itemizedlist></para> + </listitem> + </itemizedlist></para> + </sect2> + </sect1> + <sect1 id="konfig-color"> + <title>Colors</title> + <para>This page configures the colors of the + &list-panel-lnk; and the + &synchronizer-lnk;. The + <guilabel>KDE default colors</guilabel> is the default color + configuration.</para> + <!-- OLD +<screenshot> + <screeninfo>Colors configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgcolor.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgcolor.png" format="EPS"/></imageobject> + <textobject><phrase>Colors configuration</phrase></textobject> + <caption><para>Colors configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kgcolor" float="1"> +<title>Colors configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kgcolor.png"/></imageobject> +<textobject><phrase>Colors configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <variablelist> + <varlistentry> + <term> + <guilabel>General</guilabel> + </term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Use the default KDE colors</guilabel>: this + is the default, it uses &kde; color + settings of + <command>kcontrol</command>.</para> + </listitem> + <listitem> + <para> + <guilabel>Use Alternate Background color</guilabel>: + If checked, the + <guilabel>Background</guilabel> color and the + <guilabel>Alternate background</guilabel> color + alternates line by line. When you do not use the + &kde; default colors, you can configure + the alternate colors in the + <guilabel>Colors</guilabel> box.</para> + </listitem> + <listitem> + <para> + <guilabel>Show current item even if not + focused</guilabel>: If checked, shows the last cursor + position in the non active list panel. This option is + only available when you do not use the + &kde; default colors.</para> + </listitem> + <listitem> + <para> + <guilabel>Dim the colors of the inactive + panel</guilabel>: If checked, the colors of the + inactive panel are dimmed. These settings can be + configured in the + <guilabel>Inactive</guilabel> tab of the + <guilabel>Colors</guilabel> box. This option is only + available when you do not use the &kde; + default colors.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Colors</guilabel> + </term> + <listitem> + <para>Configure the colors the way you like, you can see + the result in the + <guilabel>Preview</guilabel> section. The following items + of the active and inactive panel can be + configured:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Directory foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Executable foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Symbolic link foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Invalid symlink foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Alternate background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Selected foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Selected background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Alternate selected background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Current foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Selected current foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Current background</guilabel> + </para> + </listitem> + </itemizedlist> + <para>The following items of the + &synchronizer-lnk; can be configured:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Equals foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Equals background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Differing foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Differing background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Copy to left foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Copy to left background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Copy to right foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Copy to left background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Delete foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Delete background</guilabel> + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Preview</guilabel> + </term> + <listitem> + <para>Here you see a preview of the configured + colors.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Color schemes</guilabel> + </term> + <listitem> + <para>With the + <guibutton>Import Color Scheme</guibutton> and + <guibutton>Export Color Scheme</guibutton> buttons you can + load and save a Color Scheme profile. This allows + &krusader; to use &tcmd;, + &mc;, foo-commander or your own custom color + profile. The Color Schemes are stored in + <filename>$KDEDIR/share/apps/krusader</filename>, the + <filename>foo.color</filename> is a binary file that holds + the color scheme.</para> + <tip> + <para>&mc; and &tcmd; Color + scheme files are provided. Please + <link linkend="help_krusader">upload your favorite + Color schemes</link> so that they become available for + the &krusader; community. Thanks!</para> + </tip> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="konfig-general"> + <title>General</title> + <para>Here you configure the basic operations.</para> + <!-- OLD +<screenshot> + <screeninfo>General configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kggeneral.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kggeneral.png" format="EPS"/></imageobject> + <textobject><phrase>General configuration</phrase></textobject> + <caption><para>General configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kggeneral" float="1"> +<title>General configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kggeneral.png"/></imageobject> +<textobject><phrase>General configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <para>The following options determine basic aspects of + operation: + <itemizedlist> + <listitem> + <para> + <guilabel>Delete files/Move to trash</guilabel>: when + &krusader; deletes files it can either 'really' + delete them or move them to the trash folder, thereby + making them available via &kde;'s trash.</para> + </listitem> + <listitem> + <para> + <guilabel>Use mimetype magic</guilabel>: mime type magic is + a mechanism which allows &krusader; to inspect + the files in the panels and determine their type even if + the file has no identifying extension. For example, if you + take an image file - 'image1.jpg' - and rename it to + 'image1', &krusader; will still know it's an + image file and work with it accordingly. However, this mode + of operation is slower (while refreshing the panel, or + changing directories), so try &krusader; with + and without mime type magic and decide what is best for + you.</para> + </listitem> + <listitem> + <para> + <guilabel>Editor</guilabel>: choose what editor will be + used when editing a file (via F4).</para> + </listitem> + <listitem> + <para> + <guilabel>Default viewer mode</guilabel>: either generic, + text or hex mode.</para> + </listitem> + <listitem> + <para> + <guilabel>Viewer opens each file in a separate + window</guilabel>: you can use the browsing tabs for + navigation.</para> + </listitem> + <listitem> + <para> + <guilabel>Atomic extensions</guilabel>: predefined atomic extensions like <filename>tar.gz</filename> + are shown as one part in the <guilabel>Ext Column</guilabel> of the &list-panel-lnk;.</para> + </listitem> + <listitem> + <para> + <guilabel>Terminal</guilabel>: choose which terminal + emulator will be used when &krusader; opens a + console window (via F2, or Commands->Terminal + menu option).</para> + </listitem> + <listitem> + <para> + <guilabel>Terminal Emulator sends Chdir on a panel + change</guilabel>: if unchecked, there will be no + <command>cd</command> command sent to the Terminal Emulator + if the panel folder changes.</para> + </listitem> + <listitem> + <para> + <guilabel>Temp Directory</guilabel>: this option selects + the base directory for &krusader;'s temporary + files. The actual files will be created in separate + directories under the 'Temp directory', so that each user + running &krusader; will have their own temporary + subdirectories under the chosen directory. + <note> + <para>You must choose a temporary directory to which all + users running &krusader; have full + permissions!</para> + </note></para> + </listitem> + </itemizedlist></para> + </sect1> + <sect1 id="konfig-advanced"> + <title>Advanced</title> + <para>This page handles more advanced issues, so you should + double-check your actions here: modifying settings here + <remark>makes &krusader; a more powerful AND + dangerous tool.</remark></para> + <!-- OLD +<screenshot> + <screeninfo>Advanced configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgadvanced.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgadvanced.png" format="EPS"/></imageobject> + <textobject><phrase>Advanced configuration</phrase></textobject> + <caption><para>Advanced configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kgadvanced" float="1"> +<title>Advanced configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kgadvanced.png"/></imageobject> +<textobject><phrase>Advanced configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <para>The page is divided into three parts:</para> + <variablelist> + <varlistentry> + <term> + <guilabel>General</guilabel> + </term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Preserve attributes for local copy/move + (slower)</guilabel>: If checked, + &krusader; will try to preserve all + attributes (time, owner, group) of the local files + according to the source file depending on your + <link linkend="copying">permissions</link>.</para> + </listitem> + <listitem> + <para> + <guilabel>Automount filesystems</guilabel>: this + makes &krusader; try to mount a file system + before entering it. For example, if you click on + <filename class="directory">/mnt/cdrom</filename> (and + <filename class="directory"> + /mnt/cdrom</filename> appears in + <filename class="directory">/etc/fstab</filename> as a + mount point), &krusader; will check if it + is mounted. If not, it will try and mount it for you + and then enter, so that you would see the contents of + your cdrom. Note, however, that &krusader; + will NOT unmount when exiting + <filename class="directory"> + /mnt/cdrom</filename>.</para> + </listitem> + <listitem> + <para> + <guilabel>Do not use KDE media protocol for the + Media button (if it is buggy or missing)</guilabel>: + If checked, &krusader; will not use + &kde; media protocol for the + <link linkend="list_panel">Media button</link>. + Choose this when the media protocol is buggy (in some + older &kde; versions) or if you have no + kdebase package installed on your system.</para> + </listitem> + <listitem> + <para> + <guilabel>MountMan will not (un)mount the following + mount points</guilabel>: If you have file systems that + you do not want to accidentally unmount (or mount) + then enter a list of mount points separated by commas + (⪚ + <literal>/, /boot, /tmp</literal>) and + &mountman-lnk; will not try to (un)mount + them.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Confirmations</guilabel> + </term> + <listitem> + <para>By checking the options in this section, + &krusader; will ask for confirmation before + doing a specific action; otherwise, the following actions + will be done without warning:</para> + <itemizedlist> + <listitem> + <para>deleting non empty directorie(s)</para> + </listitem> + <listitem> + <para>deleting file(s)</para> + </listitem> + <listitem> + <para>copying file(s)</para> + </listitem> + <listitem> + <para>moving file(s)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Fine-Tuning</guilabel> + </term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Icon Cache Size</guilabel>: + &krusader; uses an icon cache, so it will not + have to reload icons that have been used before. Of + course, as the cache grows bigger, it can store more + icons and further speed operations, but the memory + footprint of &krusader; will become + bigger.</para> + </listitem> + <listitem> + <para> + <guilabel>Arguments of updatedb</guilabel>: sets + additional arguments for + <command>updatedb</command>, please read the manpages + for more information.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="konfig-archives"> + <title>Archives</title> + <para>This page handles the way &krusader; works + with archives. In the + <guilabel>General</guilabel> section you will see a list of + archive formats. Some are checked and some are grayed-out. The + ones that are available (not grayed-out) are supported by + &krusader;. If you check them, &krusader; + will handle the archives transparently and let you open them as + folders; otherwise, &krusader; will attempt to + invoke an application which opens archives of that type. If a + certain archive is grayed-out, it means that + &krusader; could not find the appropriate executables + in the configured path. The next archives are supported: ace, + arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and + 7-zip.</para> + <!-- OLD +<screenshot> + <screeninfo>Archives configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgarchives.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgarchives.png" format="EPS"/></imageobject> + <textobject><phrase>Archives configuration</phrase></textobject> + <caption><para>Archives configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kgarchives" float="1"> +<title>Archives configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kgarchives.png"/></imageobject> +<textobject><phrase>Archives configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <para>If you have installed a certain archive application (let's + say + <command>arj</command>) and want &krusader; to know + about it, just click the + <guibutton>Auto Configure</guibutton> button. + &krusader; will search for all supported executables + and print a report listing the archive formats that can be + handled. If the operation was successful the new archive should + be available and checked.</para> + <note> + <para>Please install new packagers to your + <envar>PATH</envar> (&ie;: + <filename>/usr/bin</filename> or + <filename>/usr/local/bin</filename> &etc;)</para> + </note> + <para>The full path of the packagers is stored in the + &konfigdependencie-lnk; (⪚ to handle + ZIP archives, &krusader; needs the + <command>unzip</command> and + <command>zip</command> executables). It is possible that you need + to manually configure the mimes to the protocols in the + &konfigprotocol-lnk;.</para> + <para> + <guilabel>Fine-Tuning</guilabel> + <itemizedlist> + <listitem> + <para> + <guilabel>Allow moving into archives</guilabel>: this + option allows you to move files into an archive (as + opposed to just copying into the archive). The down side + is that if a power failure occurs during the process, the + files that were moved might already be deleted, but not + yet packed into the archive. + <note> + <para>If such a thing happens, the file(s) are NOT + LOST. They were actually moved into a subfolder in + &krusader;'s + <link linkend="konfig-general">temp directory</link>. + You can search the directory and recover your + files.</para> + </note></para> + </listitem> + <listitem> + <para> + <guilabel>Test archives when finished packing</guilabel>: + this option automatically runs a test on a newly packed + archive. It is safer, but takes longer.</para> + </listitem> + </itemizedlist> + </para> + </sect1> + <sect1 id="konfig-dependencies"> + <title>Dependencies page</title> + <para>This page configures the full path of the external + applications. It is even possible to configure the full path of + &krusader;!</para> + <para> + <emphasis role="bold">General tab</emphasis> + </para> + <para>Here you can configure the full path of the following + external applications: + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>application</entry> + <entry>configurable full path</entry> + </row> + <row> + <entry> + <para> + <command>df</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/df</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>eject</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/eject</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>kdesu</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/kdesu</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>kget</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/kget</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>kmail</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/kmail</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para>diff utility</para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/kompare</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <command>krename</command> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/krename</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>krusader</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/krusader</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>locate</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/locate</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>mount</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/mount</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>umount</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/umount</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>updatedb</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/updatedb</replaceable> + </filename> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable></para> + <tip> + <para>By default &kompare; (part of the kdebase + package) is used as external diff utility but you can also + use your favorite diff utility ⪚ + &xxdiff-url; or &kdiff3-url;, just fill + in the full path and enjoy.</para> + </tip> + <para> + <emphasis role="bold">Packers tab</emphasis> + </para> + <para>Here you can configure the full path of the following + external packers. &krusader; also offers an + <link linkend="konfig-archives">auto configure tool</link> for + packagers. + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>packer</entry> + <entry>configurable full path</entry> + </row> + <row> + <entry> + <para> + <command>7z</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>usr/bin/7z</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>arj</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>usr/bin/arj</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>bzip2</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>usr/bin/bzip2</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>cpio</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/cpio</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>dpkg</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/dpkg</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>gzip</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/gzip</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>lha</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/lha</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>rar</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/rar</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>tar</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/tar</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>unace</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/unace</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>unarj</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/unarj</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>unrar</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/unrar</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>unzip</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/unzip</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>zip</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/zip</replaceable> + </filename> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable></para> + <note> + <para>&krusader; may not be compatible with ACE despite our + best efforts. Unace uses closed source and contains + additional lines that make Unace get into infinite loop if + the stdin is redirected to somewhere else. It works in the + same manner as 'su', where you cannot enter the password only + from the stdin. &krusader; >= 1-51 + emulates the command line environment to enable co-operation + with Unace, but we have noticed that Unace always changes its + output format from release to release, making co-operation + almost impossible.</para> + </note> + <para> + <emphasis role="bold">Checksum Utilities tab</emphasis> + </para> + <para>Here you can configure the full path of the following + external + <link linkend="checksum">Checksum Utilities</link>: + <informaltable> + <tgroup cols="3"> + <tbody> + <row> + <entry>Checksum Utilities</entry> + <entry>configurable full path</entry> + <entry>supported checksums</entry> + </row> + <row> + <entry> + <para> + <command>md5sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/md5sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>md5</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha1sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha1sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha1</para> + </entry> + </row> + <row> + <entry> + <para> + <command>md5deep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/md5deep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>md5</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha1deep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha1deep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha1</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha224sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha224sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha224</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha256sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha256sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha256</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha256deep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha256deep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha256</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha384sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha384sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha384</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha512sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha512sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha512</para> + </entry> + </row> + <row> + <entry> + <para> + <command>tigerdeep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/tigerdeep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>tiger</para> + </entry> + </row> + <row> + <entry> + <para> + <command>whirlpooldeep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/whirlpooldeep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>whirlpool</para> + </entry> + </row> + <row> + <entry> + <para> + <command>cfv</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/cfv</replaceable> + </filename> + </para> + </entry> + <entry> + <para>md5, sha1, sfv, crc</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable></para> + </sect1> + <sect1 id="konfig-useractions"> + <title>UserActions</title> + <para>Here you can configure the terminal for UserActions and + the font for the output-collection. The default terminal is + <filename>konsole --noclose -e</filename>. To set up, configure + and manage your UserActions use ActionMan + (&useractions-lnk; url).</para> + <!-- OLD +<screenshot> + <screeninfo>Useractions configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kguseractions.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kguseractions.png" format="EPS"/></imageobject> + <textobject><phrase>Useractions configuration</phrase></textobject> + <caption><para>Useractions configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kguseractions" float="1"> +<title>Useractions configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kguseractions.png"/></imageobject> +<textobject><phrase>Useractions configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + </sect1> + <sect1 id="konfig-protocols"> + <title>Protocols</title> + <para>This page links the mimes to protocols. ⪚ + protocol "tar" is linked to mime "application/x-tar".</para> + <!-- OLD +<screenshot> + <screeninfo>Protocols configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgprotocols.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgprotocols.png" format="EPS"/></imageobject> + <textobject><phrase>Protocols configuration</phrase></textobject> + <caption><para>Protocols configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kgprotocols" float="1"> +<title>Protocols configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kgprotocols.png"/></imageobject> +<textobject><phrase>Protocols configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <para>In the + <guilabel>Defined Links</guilabel>you will see ⪚ + <itemizedlist> + <listitem> + <para>Iso</para> + <itemizedlist> + <listitem> + <para>application/x-iso</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>krarc</para> + <itemizedlist> + <listitem> + <para>application/x-ace</para> + </listitem> + <listitem> + <para>application/x-arj</para> + </listitem> + <listitem> + <para>application/x-bzip2</para> + </listitem> + <listitem> + <para>application/x-cpio</para> + </listitem> + <listitem> + <para>application/x-deb</para> + </listitem> + <listitem> + <para>application/x-debian-package</para> + </listitem> + <listitem> + <para>application/x-gzip</para> + </listitem> + <listitem> + <para>application/x-jar</para> + </listitem> + <listitem> + <para>application/x-lha</para> + </listitem> + <listitem> + <para>application/x-rar</para> + </listitem> + <listitem> + <para>application/x-rpm</para> + </listitem> + <listitem> + <para>application/x-zip</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>tar</para> + <itemizedlist> + <listitem> + <para>application/x-tar</para> + </listitem> + <listitem> + <para>application/x-tarz</para> + </listitem> + <listitem> + <para>application/x-tbz</para> + </listitem> + <listitem> + <para>application/x-tgz</para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist></para> + </sect1> +</chapter> diff --git a/doc/en/krusader-tools.docbook b/doc/en/krusader-tools.docbook new file mode 100644 index 0000000..70103b0 --- /dev/null +++ b/doc/en/krusader-tools.docbook @@ -0,0 +1,35 @@ +<chapter id="krusader-tools"> +<!-- ********************************************************************** + krusader-tools.docbook + ++++++++++++++++++++++++++ + (C)opyright : (C) 2000 - 2008 + All Rights Reserved 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> +<title>&krusader; Tools</title> + +<!-- call the bookmarks sect1 section --> &bookmarks; +<!-- call the diskusage sect1 section --> &diskusage; +<!-- call the java sect1 section --> &java; +<!-- call the search sect1 section --> &search; +<!-- call the viewer-editor sect1 section --> &viewer-editor; +<!-- call the locate sect1 section --> &locate; +<!-- call the mountman sect1 section --> &mount; +<!-- call the remote-connections sect1 section --> &remote-connections; +<!-- call the synchronizer sect1 section --> &synchronizer; +<!-- call the useractions sect1 section --> &krusader-useractions; + +</chapter> diff --git a/doc/en/locate.docbook b/doc/en/locate.docbook new file mode 100644 index 0000000..f920707 --- /dev/null +++ b/doc/en/locate.docbook @@ -0,0 +1,114 @@ +<sect1 id="locate"> + <title>Locate &GUI; Frontend</title> + <indexterm> + <primary>Locate</primary> + </indexterm> + <para>&krusader; has a &GUI; front end for + the + <command>locate</command> command (findutils). Locate is used for + fast file searching not from a directory but a database. The + package contains two files, + <command>locate</command> and + <command>updatedb</command>. Updatedb goes through the local + file system and stores the file entries in the database. + <command>cron</command> often calls + <command>updatedb</command> every night (set with Kcron). Choose + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>Locate</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Ctrl; + <keycap>L</keycap></keycombo> to start this feature. + <link linkend="konfig-advanced">Konfigurator</link> can set + additional arguments for + <command>updatedb</command>.</para> + <para>Checkbox Options + <itemizedlist> + <listitem> + <para> + <guilabel>Show only the existing files</guilabel>: if the + database contains entries which no longer exist any more + (deleted, moved since the last + <command>updatedb</command>), + <command>locate</command> does not list them. It checks the + existence of each file before the listing in the results + window (slow).</para> + </listitem> + <listitem> + <para> + <guilabel>Case Sensitive</guilabel>: unchecking it allows + lower and upper case search.</para> + </listitem> + </itemizedlist></para> + <para>Action buttons + <itemizedlist> + <listitem> + <para> + <guibutton>Locate</guibutton>: executes + <command>locate + <replaceable>foo foo</replaceable></command> and places its + output into the results window.</para> + </listitem> + <listitem> + <para> + <guibutton>Stop</guibutton>: stops the locating + process.</para> + </listitem> + <listitem> + <para> + <guibutton>UpdateDB</guibutton>: starts + <command>updatedb</command> for updating the locate database + after entering the root password.</para> + </listitem> + <listitem> + <para> + <guibutton>Close</guibutton>: closes the locate + window.</para> + </listitem> + </itemizedlist></para> + <para>Results window + <itemizedlist> + <listitem> + <para>Double-click on an item: steps to its directory, makes + the item visible and closes the locate dialog.</para> + </listitem> + <listitem> + <para>Right click: edits/views/finds the menu. + <itemizedlist> + <listitem> + <para> + <keycap>F3</keycap>: views the current item.</para> + </listitem> + <listitem> + <para> + <keycap>F4</keycap>: edits the current item.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo>: finds files in the results + window.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>n</keycap></keycombo>: shows the next search + result.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>p</keycap></keycombo>: shows the previous search + result.</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para> + The results window supports dragging items to other windows + and copy to clipboard (<keycombo action="simul">&Ctrl;<keycap>c</keycap></keycombo>).</para> + </listitem> + </itemizedlist></para> +</sect1> diff --git a/doc/en/more.docbook b/doc/en/more.docbook new file mode 100644 index 0000000..a5d097c --- /dev/null +++ b/doc/en/more.docbook @@ -0,0 +1,65 @@ +<chapter id="more-features"> +<!-- ********************************************************************** + 4 more.docbook + 5 +++++++++++++++++++++++++++ + 6 copyright : (C) 2000 - 2008 + 7 Rafi Yanai, Shie Erlich, Frank Schoolmeesters + 8 & the Krusader Krew + 9 e-mail : krusader@users.sourceforge.net + 10 web site : http://www.krusader.org + 11 description : a Krusader Documentation File + 12 + 13 *************************************************************************** + 14 * Permission is granted to copy, distribute and/or modify this * + 15 * document under the terms of the GNU Free Documentation License, * + 16 * Version 1.1 or any later version published by the Free Software * + 17 * Foundation; with no Invariant Sections, no Front-Cover Texts and * + 18 * no Back-Cover Texts. A copy of the license is available on the * + 19 * GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * + 20 * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * + 21 * MA 02110-1301, USA. * + 22 *********************************************************************** --> +<title>Advanced functions</title> +<!-- call the vfs sect1 section --> +&vfs; +<!-- call the compare sect1 section --> +&compare; +<!-- call the occupied space sect1 section --> +&occupied-space; +<!-- call the splitter sect1 section --> +&splitter; +<!-- call the checksum sect1 section --> +&checksum; +<sect1 id="send-email"> + <title>Send Files by e-mail</title> + <para>Select a file and use + <emphasis role="bold"> + <menuchoice> + <guimenu>Right-Click menu</guimenu> + <guimenuitem>Send by Email</guimenuitem> + </menuchoice> + </emphasis>. Selecting this option will open a new + &kmail; window with the file already attached. Just + fill in the subject and recipient(s) and send it. Of course, + &kmail; must be properly configured.</para> +</sect1> +<!-- call the profiles sect1 section --> +&profiles; +<sect1 id="acl"> + <title>ACL permissions</title> + <para> + <link linkend="gloss-acl">ACL permissions</link> are fully + supported when using properties, preserve attributes and the + synchronizer. To view/modify the ACL permissions, select a file + and use the &context-menu-lnk;: + <emphasis role="bold"> + <menuchoice> + <guimenu>Properties</guimenu> + <guimenuitem>Permissions</guimenuitem> + <guimenuitem>Advanced permissions</guimenuitem> + </menuchoice> + </emphasis>. At Copy/Move if + <guilabel>preserve attributes</guilabel> are selected, the ACL + permissions are also copied. The synchronizer keeps the ACL + permissions as well.</para> +</sect1></chapter> diff --git a/doc/en/mount.docbook b/doc/en/mount.docbook new file mode 100644 index 0000000..72b505d --- /dev/null +++ b/doc/en/mount.docbook @@ -0,0 +1,80 @@ +<sect1 id="mount-man"> + <title>MountMan: work with your mounted file systems</title> + <indexterm> + <primary>Mount</primary> + </indexterm> + <para>MountMan is a tool which helps you manage your mounted + file systems. Once invoked, it displays a list of every mounted + file system. For each file system, MountMan displays its name + (which is the actual device name - &ie; + <filename class="directory">/dev/fd0</filename> for a + <hardware>floppy</hardware>), its type (vfat, ext3, ReiserFS ...) + and its mount point on your system (the directory on which the + file system is mounted).</para> + <!-- OLD +<screenshot> + <screeninfo>MountMan</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="mountman.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="mountman.png" format="EPS"/></imageobject> + <textobject><phrase>MountMan</phrase></textobject> + <caption><para>MountMan</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-mountman" float="1"> + <title>MountMan</title> + <mediaobject> + <imageobject> + <imagedata fileref="mountman.png"></imagedata> + </imageobject> + <textobject> + <phrase>MountMan</phrase> + </textobject> + </mediaobject> + </figure> + <para>MountMan also displays usage information using total size, + free size, and percentage of available space free. If those + numbers say + <guilabel>N/A</guilabel>, that usually means that the file system + is not mounted. Left clicking on a file system displays a pie chart + on the left of the window, graphically displaying the usage + information for the file system. Clicking on a non-mounted + file system will display + <guilabel>not mounted</guilabel> instead of the graph.</para> + <itemizedlist> + <listitem> + <para> + <keycap>Double-clicking</keycap> on a file system will close + MountMan and open that file system inside + &krusader;'s active panel.</para> + </listitem> + <listitem> + <para> + <keycap>Right-clicking</keycap> on a file system will open a + small menu which displays what actions can be performed on + that file system. At the moment, you can only mount, unmount + and eject (if clicking on a removable file system, e.g., a + <hardware>cdrom</hardware>).</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 + file systems and more.... By the way, we have started working on + it, see "Quickmode for MountMan"</para> + </note> + <para> + <emphasis role="bold">Quickmode for MountMan</emphasis> + </para> + <para>To activate Quickmode for MountMan, click and hold the + MountMan button on the &main-toolbar-lnk;</para> + <para>General idea: display a list of all possible mount points. + Each time the menu is displayed, it determines if a mount point is + mounted or not and associates the correct action (mount or + umount). This offers a quick interface to MountMan. It is + working, and currently uses KMountMan::mount and unmount. 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> diff --git a/doc/en/mouse.docbook b/doc/en/mouse.docbook new file mode 100644 index 0000000..9cfb6fb --- /dev/null +++ b/doc/en/mouse.docbook @@ -0,0 +1,45 @@ +<chapter id="mouse-commands"> + <!-- ********************************************************************** + mouse.docbook + ++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Mouse Commands</title> + <indexterm> + <primary>Commands</primary> + <secondary>Mouse</secondary> + </indexterm> + <sect1 id="mouse-usage"> + <title>Mouse Usage</title> + <para>In this chapter you will be guided in using + &krusader; effectively with a mouse and to configure + mouse gestures through KHotKeys. By simply clicking the mouse + you can select different sections of &krusader;. + Another chapter describes the selection modes, and how you can + configure them: + <link linkend="konfig-selection_modes">Selection Mode</link> +</para> + </sect1> + <sect1 id="mouse_gestures"> + <title>Mouse Gestures</title> + <para>We provide online a + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1392"> + Mouse Gestures howto</ulink> that explains how to use KHotKeys + mouse gestures with &krusader;.</para> + </sect1> +</chapter> diff --git a/doc/en/occupied-space.docbook b/doc/en/occupied-space.docbook new file mode 100644 index 0000000..6d80921 --- /dev/null +++ b/doc/en/occupied-space.docbook @@ -0,0 +1,45 @@ +<sect1 id="calculate"> + <title>Calculate Occupied Space</title> + <indexterm> + <primary>Occupied Space</primary> + </indexterm> + <!-- Thanks to Heiner Eichmann --> + <para>There are two ways to calculate the occupied space of + files/directories. + <itemizedlist> + <listitem> + <para>Pressing the + <keycap>SPACE</keycap> on a directory under the cursor + instantly calculates the occupied size. Pressing + <keycap>SPACE</keycap> a second time will toggle the selection + of the directory without affecting the selection status of + other files/directories.</para> + </listitem> + <listitem> + <para>To calculate how much disk space is occupied by the + selected files and directories in the active panel select + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Calculate Occupied Space</guimenuitem> + </menuchoice> + </emphasis>. After a small delay, a dialog box will be + displayed with total occupied space and the number of files + and directories you selected. The space occupied by every + selected directory will be shown as if the user just pressed + <keycap>SPACE</keycap> on those directories. If the active + panel is browsing an archive, the numbers will apply to the + unpacked size of the selected files and directories, not + their compressed size. After the calculation the selection + state will be toggled and the cursor will move one step + downwards.</para> + </listitem> + </itemizedlist>Calculating the occupied space on remote + file systems is supported. + <note> + <para>Performing this operation on a very large file system + (thousands of files) may be time-consuming. You can cancel the + calculation process at any time by clicking the + <guibutton>Cancel</guibutton> button.</para> + </note></para> +</sect1> diff --git a/doc/en/profiles.docbook b/doc/en/profiles.docbook new file mode 100644 index 0000000..253502b --- /dev/null +++ b/doc/en/profiles.docbook @@ -0,0 +1,57 @@ +<sect1 id="profiles"> + <title>Profiles</title> + <indexterm> + <primary>Profiles</primary> + </indexterm> + <para>With profiles you can save and restore your favorite + settings. Several features support profiles, you can have + ⪚ different panel profiles (work, home, remote + connections, &etc;), search profiles, synchroniser + profiles, &etc;</para> + <sect2 id="panel_profiles"> + <title>Panel Profiles</title> + <para>A panel profile contains the following: all the tab + paths (left or right), the current tab (left of right) and the + active panel (left or right). All this information is stored in + the &krusaderrc-lnk; file. You can have several + panel profiles, ⪚ file management, FTP + management, home, work, &etc; The panel profile can + be + <link linkend="c_panel_profiles">saved and restored</link> in + the + <guimenu>Commands menu</guimenu>. The + <link linkend="konfig-startup">default startup + profile</link> will be used when starting &krusader;, but you can + override it with a + <link linkend="starting-krusader">command-line + option</link>.</para> + </sect2> + <sect2 id="color_profiles"> + <title>Color Profiles</title> + <para>Colormaps can be saved and restored with + <link linkend="konfig-color">Color Profiles</link>. + &krusader; Color maps are available at + &kde-files-url;.</para> + </sect2> + <sect2 id="key_profiles"> + <title>Key-binding Profiles</title> + <para>Keymaps can be saved and restored with + <link linkend="configure-shortcuts">Key-binding + Profiles</link>. &krusader; Keymaps are available at + &kde-files-url;.</para> + </sect2> + <sect2 id="search_profiles"> + <title>Search Profiles</title> + <para>If you regularly perform the same search operation, + you can save the search settings (⪚ include + files, exclude files, &etc;) in a + <link linkend="krusearcher">Search Profile</link>.</para> + </sect2> + <sect2 id="synchronizer_profiles"> + <title>Synchronizer Profiles</title> + <para>If you regularly perform the same synchronize + operation, you can save the synchronize settings in a + <link linkend="synchronizer">Synchronizer + Profile</link>.</para> + </sect2> +</sect1> diff --git a/doc/en/release-overview.docbook b/doc/en/release-overview.docbook new file mode 100644 index 0000000..2ffd4de --- /dev/null +++ b/doc/en/release-overview.docbook @@ -0,0 +1,647 @@ +<appendix id="release_overview"> + <!-- ********************************************************************** + release-overview.docbook + ++++++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Release overview</title> + <indexterm> + <primary>Release overview</primary> + </indexterm> + <para>This appendix gives an overview of the + &krusader; releases.</para> + <table id="release_overview_table" pgwide="1" frame="all"> + <title>Release overview</title> + <tgroup cols="3" colsep="1" rowsep="1"> + <thead> + <row> + <entry> + <para>&krusader; version</para> + </entry> + <entry> + <para>release date</para> + </entry> + <entry> + <para>&kde; version</para> + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para>2.00.0-beta1 "Phoenix"</para> + </entry> + <entry> + <para>2008-??-?? under construction</para> + </entry> + <entry> + <para>&kde; 4</para> + </entry> + </row> + <row> + <entry> + <para>1.90.0 "Power Stone"</para> + </entry> + <entry> + <para>2008-03-?? under construction</para> + </entry> + <entry> + <para>&kde; 3.2 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1968"> + 1.80.0 "Final 3rd Stone"</ulink></para> + </entry> + <entry> + <para>2007-07-21</para> + </entry> + <entry> + <para>&kde; 3.4 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1928"> + 1.80.0-beta2 "Last Unstable Stone"</ulink> + </para> + </entry> + <entry> + <para>2007-03-31</para> + </entry> + <entry> + <para>&kde; 3.4 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1862"> + 1.80.0-beta1 "The Last Krusade"</ulink> + </para> + </entry> + <entry> + <para>2007-01-07</para> + </entry> + <entry> + <para>&kde; 3.4 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1665"> + 1.70.1 "Round Robin"</ulink> + </para> + </entry> + <entry> + <para>2006-07-17</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1465"> + 1.70.0 "Round Robin"</ulink> + </para> + </entry> + <entry> + <para>2006-02-12</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1378"> + 1.70.0-beta2 "Afterburner"</ulink> + </para> + </entry> + <entry> + <para>2005-11-05</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1323"> + 1.70.0-beta1 "Hellfire"</ulink> + </para> + </entry> + <entry> + <para>2005-10-02</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1368"> + 1.60.1</ulink> + </para> + </entry> + <entry> + <para>2005-10-30</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.4</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1158"> + 1.60.0</ulink> + </para> + </entry> + <entry> + <para>2005-04-10</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.4</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1142"> + 1.60.0-beta2</ulink> + </para> + </entry> + <entry> + <para>2005-03-21</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.4</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1123"> + 1.60.0-beta1</ulink> + </para> + </entry> + <entry> + <para>2005-03-03</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.4</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=989"> + 1.51</ulink> + </para> + </entry> + <entry> + <para>2004-12-14</para> + </entry> + <entry> + <para>&kde; 3.2 - 3.3</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20050104203627/krusader.sourceforge.net/news.php"> + 1.50</ulink></para> + </entry> + <entry> + <para>2004-10-31</para> + </entry> + <entry> + <para>&kde; 3.2 - 3.3</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20050104203627/krusader.sourceforge.net/news.php"> + 1.50-beta1</ulink></para> + </entry> + <entry> + <para>2004-10-17</para> + </entry> + <entry> + <para>&kde; 3.2 - 3.3</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20050104203627/krusader.sourceforge.net/news.php"> + 1.40</ulink></para> + </entry> + <entry> + <para>2004-07-20</para> + </entry> + <entry> + <para>&kde; 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20050104203627/krusader.sourceforge.net/news.php"> + 1.40-beta2</ulink></para> + </entry> + <entry> + <para>2004-06-22</para> + </entry> + <entry> + <para>&kde; 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.40-beta1</ulink></para> + </entry> + <entry> + <para>2004-04-11</para> + </entry> + <entry> + <para>&kde; 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.30</ulink></para> + </entry> + <entry> + <para>2003-11-14</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.29-beta1</ulink></para> + </entry> + <entry> + <para>2003-10-02</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.25-beta1</ulink></para> + </entry> + <entry> + <para>2003-08-15</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.21-beta1</ulink></para> + </entry> + <entry> + <para>2003-07-18</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.20</ulink></para> + </entry> + <entry> + <para>2003-05-31</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.12-beta2</ulink></para> + </entry> + <entry> + <para>2003-05-09</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry><para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.12-beta1</ulink></para> + </entry> + <entry> + <para>2002-12-23</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.11</ulink></para> + </entry> + <entry> + <para>2002-10-17</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 1.10</ulink></para> + </entry> + <entry> + <para>2002-08-15</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 1.02 (first KDE3 version)</ulink></para> + </entry> + <entry> + <para>2002-04-16</para> + </entry> + <entry> + <para>&kde; 3</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 1.01</ulink></para> + </entry> + <entry> + <para>2002-04-01</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 1.00</ulink></para> + </entry> + <entry> + <para>2002-01-01</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.99</ulink></para> + </entry> + <entry> + <para>2001-12-01</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.98</ulink></para> + </entry> + <entry> + <para>2001-10-27</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.97</ulink></para> + </entry> + <entry> + <para>2001-10-08</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.95</ulink></para> + </entry> + <entry> + <para>2001-07-22</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.93</ulink></para> + </entry> + <entry> + <para>2001-05-31</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.92</ulink></para> + </entry> + <entry> + <para>2001-05-17</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.91</ulink></para> + </entry> + <entry> + <para>2001-05-10</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.90</ulink></para> + </entry> + <entry> + <para>2001-04-30</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.79</ulink></para> + </entry> + <entry> + <para>2001-02-25</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.75</ulink></para> + </entry> + <entry> + <para>2000-01-12</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.70 (milestone 3)</ulink> + </para> + </entry> + <entry> + <para>2000-11-07</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.69</ulink> + </para> + </entry> + <entry> + <para>2000-10-28</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.65</ulink> + </para> + </entry> + <entry> + <para>2000-08-19</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20000822030717/krusader.sourceforge.net/news.htm"> + 0.60</ulink></para> + </entry> + <entry> + <para>2000-07-19</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20000822030717/krusader.sourceforge.net/news.htm"> + M2 (milestone 2)</ulink> + </para> + </entry> + <entry> + <para>2000-07-11</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para>M1 (milestone 1)</para> + </entry> + <entry> + <para>2000-05-??</para> + </entry> + <entry> + <para>&kde; 2 (Kleopatra 1.91)</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20000822030717/krusader.sourceforge.net/news.htm"> + Project began</ulink></para> + </entry> + <entry> + <para>2000-04-30</para> + </entry> + <entry> + <para>Kleopatra 1.91</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + <para>Note: older 0.x beta releases are not included in this + table.</para> +</appendix> diff --git a/doc/en/remote-connections.docbook b/doc/en/remote-connections.docbook new file mode 100644 index 0000000..5feb168 --- /dev/null +++ b/doc/en/remote-connections.docbook @@ -0,0 +1,267 @@ +<sect1 id="remote-connections"> + <title>Remote Connections</title> + <indexterm> + <primary>Remote Connections</primary> + </indexterm> + <para>Remote connections are easily made by typing the + &URL; in the + <link linkend="list_panel">Location Toolbar</link>; these are + actually &kioslaves1-url;. Please note that the + &krusader; panel does not support all + &kioslaves2-url; ⪚ + <command>http://</command> will not work in the panel, but will + work in the + <link linkend="krviewer">viewer</link>. Some examples:</para> + <itemizedlist> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>public.ftpserver.org/directory/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>fish://</command><replaceable>username@hostname/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>sftp://</command><replaceable>username:password@sftp.foo.org/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>username@my.server.org:21/directory/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>smb://</command><replaceable>username:password@server/share</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>username@proxyusername:password@proxipassword@hostname/directory</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>nfs://</command><replaceable><host>:<port><url-path></replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>webdav://</command><replaceable>www.server.com/path/</replaceable> + </userinput> + </para> + </listitem> + </itemizedlist> + <para>You can bookmark these &URL;'s, however, please + read the + <link linkend="bookman">Bookman</link> section regarding + <emphasis>securely save passwords</emphasis>. For connecting to + multiple locations, bookmark these &URL;'s and open + them one by one, or open them all together by using + &panel-profiles-lnk;. To switch from one to another + location, just open a &foldertabs-lnk; for + each.</para> + <para>There are three ways to start a remote connection: + <itemizedlist> + <listitem> + <para>Type the &URL; in the + <link linkend="list_panel">Location Toolbar</link></para> + </listitem> + <listitem> + <para>Select + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>New Net Connection</guimenuitem> + </menuchoice> + </emphasis>which will pop-up a dialog that will ask for the + remote site details. This dialog is handy if you are not used + to type remote &URL;'s in the Location Toolbar. + Leaving the password and user name fields empty will log you + in as anonymous. NOTE: we are planning to rewrite this dialog + window.</para> + </listitem> + <listitem> + <para>You can bookmark a directory on a remote host and + return to this directory from the bookmark button on the top + corner of your panel just like in a web browser.</para> + </listitem> + </itemizedlist></para> + <para>After you log on to a remote server you can browse it just + like your local hard drive with the following exceptions: + <itemizedlist> + <listitem> + <para>You cannot execute files on remote servers.</para> + </listitem> + <listitem> + <para>Permissions cannot always be calculated on remote + servers (depends on server and access method) so you might + get a "?" on the permissions columns for some files.</para> + </listitem> + <listitem> + <para>Disk usage information is not available for most remote + filesystems.</para> + </listitem> + </itemizedlist></para> + <para>To change the charset of the remote host use + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>Select Remote Charset</guimenuitem> + </menuchoice> + </emphasis>.</para> + <para>You can + <emphasis role="bold">close the current Active Remote + Connection</emphasis> by two separate methods: + <itemizedlist> + <!-- + <listitem> + <para>Manually: <emphasis role="bold"><menuchoice><guimenu>Commands</guimenu> + <guimenuitem>Disconnect From Net</guimenuitem></menuchoice></emphasis></para> + </listitem> + --> + <listitem> + <para>Manually: Add the disconnect button to the + &main-toolbar-lnk; and click on it.</para> + </listitem> + <listitem> + <para>Automatically: Change the &URL; in the + &location-toolbar-lnk; .</para> + </listitem> + </itemizedlist></para> + <note> + <para>&krusader; is a file manager that supports + remote connections via &kioslaves1-url;, but if you + are looking for even more advanced remote connections features, + ⪚ an advanced &FTP;-client we + recommend you to use ⪚ + &kasablanca-url; or + &kftpgrabber-url;.</para> + </note> + +<sect2 id="remote-connections-lan-fish"> + <title>LAN connections via fish:/ protocol (zeroconf)</title> + <indexterm> + <primary>Remote LAN Connections (zeroconf)</primary> + </indexterm> + +<para>This section is contributed by + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1912">Andrew Svet (z-vet)</ulink>, + feedback about this chapter is appriciated. Thanks!</para> + + <note> + <para>This works on a &debian; system, so it will work on &debian; and derivatives (&kubuntu; &etc;), though + it should work on other Linuxes as well. + We assume that you have <link linkend="gloss-ssh">SSH</link> installed, configured and working on + every machine on LAN you want to connect to/from. + There are plenty of very good tutorials about <link linkend="gloss-ssh">SSH</link> on the net, ⪚ + at <ulink url="http://www.linuxhomenetworking.com/wiki/index.php/Quick_HOWTO_:_Ch17_:_Secure_Remote_Logins_and_File_Copying">linuxhomenetworking.com</ulink> + or just google for it. We use the default <link linkend="gloss-ssh">SSH</link> port (22) for this chapter. + Remember to change it if you use different one. All modifications, editing &etc; must be done as root. + </para> + </note> + +<para> +Let's start with installing all the packages we need: +<screen> +<prompt>#</prompt> <userinput><command>apt-get install</command> <option>avahi-daemon libnss-mdns kdnssd</option></userinput> +</screen> + +Everything is installed, now let's do some configuration. First, we need our services to be announced on LAN. +That's why we installed avahi-daemon: it represents your machine on local network and allows other applications +to publish services they provide. Avahi-daemon comes with example <filename>ssh.service</filename> configuration +file found in <filename>/usr/share/doc/avahi-daemon/examples</filename> . In order to get the service to be +announced on LAN we need to copy this file to <filename>/etc/avahi/services</filename> directory: +<screen> +<prompt>#</prompt> <userinput><command>cp</command> <option>/usr/share/doc/avahi-daemon/examples/ssh.service /etc/avahi/services</option></userinput> +</screen> + +Now we need fish:/ protocol to be announced too, so we use an ssh.service file as a template for fish.service: +<screen> +<prompt>#</prompt> <userinput><command>cp</command> <option>/etc/avahi/services/ssh.service /etc/avahi/services/fish.service</option></userinput> +</screen> + +This file is just a copy of ssh.service, Edit the <filename>fish.service</filename> file and replace +"Remote Terminal on %h" with "Fish to %h" and "_ssh._tcp" with "_fish._tcp". + +Here's how it looks after edit: +<programlisting> +<?xml version="1.0" standalone='no'?><!--*-nxml-*--> +<!DOCTYPE service-group SYSTEM "avahi-service.dtd"> + +<!-- $Id: remote-connections.docbook,v 1.6 2007/05/02 18:07:28 codeknight Exp $ --> + +<!-- + This file is part of avahi. + + avahi is free software; you can redistribute it and/or modify it + under the terms of the GNU Lesser General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + avahi is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR + +<!-- See avahi.service(5) for more information about this configuration file --> + +<service-group> + + <name replace-wildcards="yes">FISH to %h</name> + + <service> + <type>_fish._tcp</type> + <port>22</port> + </service> + +</service-group> +</programlisting> +Save the modified file. + +Now we need to create a new file <filename>_fish._tcp</filename>, open a text editor and add the next lines: +<programlisting> +Name=FISH Protocol (ssh) +Type=_fish._tcp +UserEntry=u +PathEntry=path +PasswordEntry=p +</programlisting> +And save the file <filename>/usr/share/apps/zeroconf/_fish._tcp</filename> + +Do the same on each machine on your LAN, then restart avahi-daemon: +<screen> +<prompt># /etc/init.d/</prompt> <userinput><command>avahi-daemon</command> <option>restart</option></userinput> +</screen> + +Than open &krusader; and type in location-toolbar-lnk: <filename>zeroconf:/</filename> to open the +<link linkend="gloss-zeroconf">zeroconf</link> connection. +Enter the <guilabel>Fish Protocol</guilabel> directory. Inside you'll find the links to each machine that +announced <filename>fish:/</filename> on your LAN, the location-toolbar-lnk: will point to +<filename>zeroconf:/_fish._tcp</filename> Double clicking on any of these machines, +them will bring up the password prompt, asking you for yor ssh key passphrase (if password was set). +Enter your passphrase. Congratulations: you connected to remote machine using &krusader;! +</para> + +</sect2> + +</sect1> + + diff --git a/doc/en/search.docbook b/doc/en/search.docbook new file mode 100644 index 0000000..8a9d087 --- /dev/null +++ b/doc/en/search.docbook @@ -0,0 +1,328 @@ +<sect1 id="krusearcher"> + <title>KruSearcher: find what you are looking for</title> + <indexterm> + <primary>Search</primary> + </indexterm> + <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 are looking for. The search function is + also available on remote file systems. It is divided into two + levels, the general and the advanced. Let's take a look at the + general page.</para> + <!-- OLD +<screenshot> + <screeninfo>Krusearcher General</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="search_general.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="search_general.png" format="EPS"/></imageobject> + <textobject><phrase>Krusearcher General</phrase></textobject> + <caption><para>Krusearcher General.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-search-general" float="1"> + <title>General Search</title> + <mediaobject> + <imageobject> + <imagedata fileref="search_general.png"></imagedata> + </imageobject> + <textobject> + <phrase>General Search</phrase> + </textobject> + </mediaobject> + </figure> + <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 file name, a wildcard ( + <literal role="extension">*.o.*</literal>, + <literal role="extension">*.c</literal> &etc;) or + both - separated by a space. If you type + <literal>'text'</literal> the results is the same as + <literal>'*text*'</literal>. You can exclude files from the + search with '|' (⪚ + <literal role="extension">'*.cpp *.h | + *.moc.cpp'</literal>) . You can use quotation marks for names + that contain spaces. Filter "Program Files" searches + out those files/directories the name of which is <filename>Program + Files</filename>.</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 mime type. 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 + file system (beginning with + <filename>/</filename>), but do not want to search inside + <filename>/mnt</filename>. All you need to do is write + <filename>/</filename> in the + <guilabel>search in</guilabel> box, and write + <filename>/mnt</filename> in the + <guilabel>dont search in</guilabel> box. If you want to enter + more than one directory in one of the boxes, just type the + first name and press &Enter;. The directory name + will be copied to the bigger box and youwill be able to enter + another name. + <note> + <para>The input line has an auto-completion feature, + corresponding to &kde; global settings. If you + wish, you can click on the + <guiicon>folder icon</guiicon>, 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 ( + <command>grep</command>). This way you can search for all + header files ( + <literal role="extension">*.h</literal>) which include the + word + <literal>'testing 123'</literal>.</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>: perform 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, youwill notice you cannot + <command>grep</command> inside files anymore. This is done, + since looking inside archived files forces + &krusader; to extract them, which results in an + extremely time-consuming search.</para> + </note></para> + </listitem> + <listitem> + <para> + <guilabel>Follow links</guilabel>: if checked, + &krusader; will follow soft-links during the + search.</para> + </listitem> + <listitem> + <para> + <guilabel>Profiles</guilabel>: if you have to regularly + perform the same search operation, you can save the search + settings ⪚ include files, exclude files, + etc.... Press the 'profile' button, and you can + add/load/save/remove search profiles.</para> + </listitem> + </itemizedlist> + <para>The above screen shot shows a search for all the files which + end with + <literal role="extension">c, cpp</literal> or + <literal role="extension">h</literal> and include the string + <literal>'testing 123'</literal>. &krusader; will + search in + <filename class="directory">/root, /opt, /bin</filename> and + <filename class="directory">/usr</filename>, but not in + <filename class="directory">/usr/lib</filename> and + <filename class="directory">/usr/share</filename>.</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 + <guibutton>Close</guibutton> 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 take &krusader;'s active + panel point to the found files - but will not close the search + window, so you will 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 + <guilabel>Advanced Page</guilabel>...</para> + <!-- OLD +<screenshot> + <screeninfo>Krusearcher Advanced</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="search_advanced.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="search_advanced.png" format="EPS"/></imageobject> + <textobject><phrase>Krusearcher Advanced</phrase></textobject> + <caption><para>Krusearcher Advanced.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-search-advanced" float="1"> + <title>Advanced Search</title> + <mediaobject> + <imageobject> + <imagedata fileref="search_advanced.png"></imagedata> + </imageobject> + <textobject> + <phrase>Advanced Search</phrase> + </textobject> + </mediaobject> + </figure> + <para>This screen shot shows a search for files whose size is + between 10KB and 150KB, which were modified between October 10th + and November 1st, which belong to any user in the 'users' group, + and are readable and writable by anyone in the 'users' 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> + <emphasis role="bold">Size</emphasis> + </para> + <para>Allows you to choose the size range of the file you are + looking for. By checking the check boxes, 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> + <emphasis role="bold">Date</emphasis> + </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, + inclusive. If you only enter a date in the left box, you will + be searching for files older than that date. If you only + enter a date in the right box, you will 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 calendar 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 do not enter a date + but a number. This number represents days/weeks/months (as + chosen in the near drop box). Entering the number 5 in the + upper input box, makes &krusader; search for files + that were modified in the last 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> + <emphasis role="bold">Ownership</emphasis> + </para> + <itemizedlist> + <listitem> + <para> + <guilabel>Belongs to user/group</guilabel>: by checking each + of the corresponding check boxes, you can search for files + which belong to a certain user and/or group. The drop box + 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 screen shot above (the permissions part) + describes a search for files that belong to any user in group + 'users', 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> + <emphasis role="bold">Results</emphasis> + </para> + <para>Clicking on the + <guibutton>Search</guibutton> button to start the search and open + 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. The results window supports dragging items to other windows + and copy to clipboard (<keycombo action="simul">&Ctrl;<keycap>c</keycap></keycombo>). + When you close the Krusearcher window, the selected + item is selected in the active panel.</para> + <para> + <emphasis role="bold">Feed to listbox</emphasis> + </para> + <para>When you click the + <guibutton>Feed to listbox</guibutton> button after the results + are displayed, then &krusader; ask for a Query Name, + this name will be used in the Results-Tab in the List Panel that + holds the search results. You can do whatever you want on the + files in the new tab. The location toolbar will display + ⪚ + <filename>virt:/Search results 1</filename>.</para> + <warning> + <para>The files in the Results-Tab are actually the original + files. if you delete a file - it is removed!</para> + </warning> +</sect1> diff --git a/doc/en/splitter.docbook b/doc/en/splitter.docbook new file mode 100644 index 0000000..d554230 --- /dev/null +++ b/doc/en/splitter.docbook @@ -0,0 +1,61 @@ +<sect1 id="splitter"> + <title>File Splitter</title> + <indexterm> + <primary>File Splitter</primary> + </indexterm> + <para>This function splits one (large) file up into multiple + smaller files so that they can be placed on smaller media + (⪚ zip-drives, ...) or sent by e-mail. The multiple + files can be combined again to recreate the original file. + &krusader; and &tcmd; split/combine + functions are compatible. To split a file choose + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Split</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Ctrl; + <keycap>P</keycap></keycombo> A Split dialog will open to confirm + the operation.</para> + <para>If the name of the original file is + <filename>foo</filename>, then the name of the smaller files will + be + <filename>foo.000 foo.001 foo.002</filename> &etc; + There is no theoretical limit in the number of smaller files, but + it is recommended to limit the number to a maximum of 1023 files. + &krusader; creates a + <filename>foo.crc</filename> file. This file contains the name, + size and the crc checksum of the original file. It is possible to + combine the file without the + <filename>foo.crc</filename> file but in this case + &krusader; cannot check if the the original file was + recreated correctly.</para> + <para>An example of a + <filename>foo.crc</filename> file: + <programlisting>filename=foo size=432998467868 crc32=21EB719A</programlisting></para> + <para>To combine the multiple files choose, select a partial file + + <filename>foo.xxx</filename> and choose + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Combine files</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Ctrl; + <keycap>B</keycap></keycombo>. The target directory is the + unactive panel and can be changed. The file names must be + numbered in ascending order: + <filename>foo.001, foo.002, foo.003</filename> &etc; or + have letters in ascending order: (" + <userinput> + <command>split</command> + <option>-b</option> + </userinput>letter method") + <filename>fileaa, fileab, fileac</filename> &etc; If + the file + <filename>foo.crc</filename> is found in the same directory as the + partial files, &krusader; will use this file to check + the combined file for errors.</para> +</sect1> diff --git a/doc/en/synchronizer.docbook b/doc/en/synchronizer.docbook new file mode 100644 index 0000000..c0f58f2 --- /dev/null +++ b/doc/en/synchronizer.docbook @@ -0,0 +1,730 @@ +<sect1 id="synchronizer"> + <title>Synchronizer</title> + <indexterm> + <primary>Synchronizer</primary> + </indexterm> + +<sect2 id="synchronizer_introduction"> + <title>Introduction</title> + <para>This function compares two directories with all subdirectories and shows the differences between them. + After selecting some options and the + <guilabel>Compare</guilabel> function you can synchronize the + files and directories. One panel could be an &FTP; + server. Do not 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>Y</keycap></keycombo> to start this feature. The + <link linkend="konfig-color">colors</link> are + configurable.</para> + <note> + <para>For local files: The synchronizer changes the date + information to the original dates.</para> + </note> + <!-- OLD +<screenshot> + <screeninfo>Synchronizer</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="syncdir.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="syncdir.png" format="EPS"/></imageobject> + <textobject><phrase>Synchronizer: Synchronize files and directories.</phrase></textobject> + <caption><para>Synchronizer: Synchronize files and directories.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-syncdir" float="1"> + <title>Synchronizer</title> + <mediaobject> + <imageobject> + <imagedata fileref="syncdir.png"></imagedata> + </imageobject> + <textobject> + <phrase>Synchronizer</phrase> + </textobject> + </mediaobject> + </figure> + <para> + <orderedlist> + <title>Procedure:</title> + <listitem> + <para>Set the + <guilabel>Left directory</guilabel> and the + <guilabel>Right directory</guilabel> that you want to compare.</para> + </listitem> + <listitem> + <para>Configure the optional + <guilabel>File Filter</guilabel>, + <guilabel>General Filters</guilabel> and + <guilabel>Advanced filters</guilabel>. The + <guilabel>General Filters</guilabel> includes a + <guilabel>don't search in</guilabel> option which lets you + exclude directories from comparision.</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>, + <guilabel>Asymmetric</guilabel>, + <guilabel>Ignore Case</guilabel> and + <guilabel>Hidden hidden files</guilabel>. + </para> + </listitem> + <listitem> + <para>Click on the + <guibutton>Compare</guibutton> button to compare the + directories.</para> + </listitem> + <listitem> + <para>By using + <link linkend="synccomp_show_options">Show options</link>, + you can include/exclude particular file types. The files that + are not on 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 selecting the options of the + <link linkend="synchronizer">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> + +</sect2> + +<sect2 id="synchronizer_comparator"> + <title>Comparator</title> + + <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>: Filters the filenames + at synchronizing. ⪚ + <literal role="extension">*.png</literal> selects only + files the names of which end with + <literal role="extension">.png</literal> Directories are + 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> Multiple + include/exclude example: + <literal role="extension">'*.cpp *.h | + *.moc.cpp'</literal>includes + <literal role="extension">*.cpp *.h</literal> and + exclude + <literal role="extension">*.moc.cpp</literal></para> + </listitem> + <listitem> + <para> + <guilabel>General filters</guilabel>: Search for, + containing text</para> + </listitem> + <listitem> + <para> + <guilabel>Advanced filters</guilabel>: Size, date, + ownership</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term>Filename filtering criteria</term> + <listitem> + <itemizedlist> + <listitem> + <para>You can make use of wild cards. Multiple patterns + are separated by space (means logical OR) and patterns + are excluded from the search using the pipe symbol. If + the pattern is ended with a slash (*pattern*/), it + means that pattern relates to recursive search of + directories.</para> + </listitem> + <listitem> + <para>pattern - means to search those files/directories + whose name is a pattern, recursive search goes through + all subdirectories independently of the value of the + pattern.</para> + </listitem> + <listitem> + <para>pattern/ - means to search all files/directories, + but recursive search goes through/excludes the + directories whose name is a pattern.</para> + </listitem> + <listitem> + <para>You can use quotation marks for names + that contain spaces. Filter "Program Files" searches + out those files/directories the name of which is <filename>Program + Files</filename>.</para> + </listitem> + <listitem> + <para>Examples:</para> + </listitem> + <listitem> + <para> + <literal role="extension">*.o</literal> + </para> + </listitem> + <listitem> + <para> + <literal role="extension">*.h *.c??</literal> + </para> + </listitem> + <listitem> + <para> + <literal role="extension">*.cpp *.h | + *.moc.cpp</literal> + </para> + </listitem> + <listitem> + <para> + <literal role="extension">* | CVS/ .svn/</literal> + </para> + </listitem> + <listitem> + <para>Note: the search term 'text' is equivalent to + '*text*'.</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 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>: The files + the sizes of which are 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>The files that exist only on the left side + will be deleted.</para> + </listitem> + <listitem> + <para>The files that exist only on the right side + will be copied to left.</para> + </listitem> + <listitem> + <para>The files considered to be equal will be + untouched.</para> + </listitem> + <listitem> + <para>Those files considered to be different will + be copied to left. Use this feature with + care!</para> + </listitem> + </itemizedlist>This function is useful if the date + information is unusable, or to synchronize the left + directory to the content of a file server (like a + download). Alternatively, it is useful to make a backup + from the right directory to the left directory. NOTE: + Do NOT use this option to synchronize a desktop and a + notebook (⪚ files that exist only on the + left side will be deleted!).</para> + </listitem> + <listitem> + <para> + <guilabel>Automatic Scrolling</guilabel>: This is for + slow &FTP; servers, ... When the + Synchronizer has finished comparing a file, it puts the + file into the end of the list at once and scrolls the + window, if necessary. It is important, if you want to + know what the Synchronizer is doing. If the + &FTP; server is slow, the comparison of a + directory may take a lot of time. By turning this + option on, you can see that the comparator is "alive", + but slow. For fast file systems, it can reduce the + speed of comparing slightly.</para> + </listitem> + <listitem> + <para> + <guilabel>Ignore Case</guilabel>: Case insensitive filename compare, + this is useful when synchronizing &Windows; filesystems.</para> + </listitem> + <listitem> + <para> + <guilabel>Ignore hidden files</guilabel>: Ignores files that start with a dot.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + <para>When everything mentioned above is done, click on the + <guibutton>Compare</guibutton> button to compare the directories, + the results are displayed in the <guilabel>File List</guilabel>.</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". + Here you can check the compare results and modify the synchronisation actions if desired. + The text color defines the default copy direction determined by the comparator. + <itemizedlist> + <listitem> + <para>Green: Copy from left to right.</para> + </listitem> + <listitem> + <para>Blue: Copy from right to left or delete on the right side in asymmetric mode.</para> + </listitem> + <listitem> + <para>Red: Files which are different by the given criteria (no copy direction).</para> + </listitem> + <listitem> + <para>Black: Files which are identical (no copy direction).</para> + </listitem> + </itemizedlist> + A double click on a file calls the &krusader;s <guilabel>Compare by content</guilabel> function. + The Tasks (<=>) column defines the default copy direction, which can be modified by the user if needed. + The results window supports dragging items to other windows ( drag [left], SHIFT+drag [right] ) + and copy left/right selected items to clipboard (<keycombo action="simul">&Ctrl;<keycap>c</keycap></keycombo>). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>File List</guilabel>: Tasks (<=>) column</term> + <listitem> + <para>This column displays the task that is planned for the + Synchronizer, this task can be modified with the + <link linkend="synccomp_right-click">right click menu</link>.</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, do not + 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><-</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> + </listitem> + </varlistentry> + <varlistentry id="synccomp_show_options"> + <term>Show options</term> + <listitem> + <para>Here you can include/exclude particular file types. + 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><-</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 sides.</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 on the + <guilabel>File List</guilabel>.</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 while + comparing.</para> + </listitem> + <listitem> + <para>The filename when comparing by content (for big + files).</para> + </listitem> + <listitem> + <para>The number of files on the list.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry id="synccomp_right-click"> + <term>Right click menu on the + <guilabel>File List</guilabel></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>Synchronize 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 comparison.</para> + </listitem> + <listitem> + <para> + <guibutton>Reverse direction</guibutton>: Task change ( + -> to <-, and + <- to -> ).</para> + </listitem> + <listitem> + <para> + <guibutton>Copy from right to left</guibutton>: Task + change to <-.</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 + &editmenu-lnk;.</para> + </listitem> + <listitem> + <para> + <guibutton>Unselect items</guibutton>: Opens a dialog + which allows you to deselect items. This is the + <guimenuitem>Unselect Group</guimenuitem> dialog from + the &editmenu-lnk;.</para> + </listitem> + <listitem> + <para> + <guibutton>Invert selection</guibutton>: Invert the + selection status of all items.</para> + </listitem> + </itemizedlist> + <para>3. others (note that 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 (⪚ &kompare;) on the + files.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>Other buttons</term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guibutton>Profiles</guibutton>: If you have to + synchronize the same directories often, you can save the + settings ⪚ include files, exclude files, + ... Press the + <guibutton>Profile</guibutton> button, and you will be + able to add / load / save / remove synchronizer + profiles.</para> + </listitem> + <listitem> + <para> + <guibutton>Swap sides</guibutton>: Swaps the + <guilabel>File List</guilabel>.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>Synchronize with &kget;</term> + <listitem> + <para>If you want to synchronize a local directory with an + unstable ftp server, &kget; is a much better + solution than simple file copying. After comparing you may + right click on the result list and select + <guimenuitem>Synchronize with kget</guimenuitem> to execute + the synchronization, after that the listed files will be + downloaded with kget instead of krusader. Of course + <application>kget</application> needs to be installed on + your computer; otherwise, it will not be available.</para> + </listitem> + </varlistentry> + </variablelist> + +</sect2> +<sect2 id="synchronizer_sychronisation"> + <title>Sychronisation</title> + + <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> + <varlistentry> + <term>Parallel synchronization</term> + <listitem> + <itemizedlist> + <listitem> + <para>One can give the number of the 'quasy' + threads.</para> + </listitem> + <listitem> + <para>Can drastically increase the speed when + synchronized with slow FTP servers.</para> + </listitem> + <listitem> + <para>Does not affect the speed of local + synchronization.</para> + </listitem> + <listitem> + <para>Remote "compare by content" and "directory + compare" is done in parallel.</para> + </listitem> + <listitem> + <para>Remote synchronization is also done in parallel, + except the mkdir tasks (mkdir must be before + copy).</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + +</sect2> +</sect1> diff --git a/doc/en/user-interface.docbook b/doc/en/user-interface.docbook new file mode 100644 index 0000000..c2eccab --- /dev/null +++ b/doc/en/user-interface.docbook @@ -0,0 +1,863 @@ +<chapter id="user-interface"> + <title>User Interface</title> + <indexterm> + <primary>User Interface</primary> + </indexterm> + <sect1 id="ofm-userinterface"> + <title>OFM User Interface</title> + <para>The OFM file manager concept contains + <link linkend="features">many features</link> that make them + powerful enough to belong among the best file managers today. + The interface is simple: left panel, right panel and a command + line below. Because of interaction between these three items + the file managing will become more efficient.</para> + <para>If you would like to know + <ulink url="http://www.softpedia.com/reviews/linux/Krusader-Review-18193.shtml"> + how &krusader; works</ulink> you can try it yourself, + just install it on your computer. To accept an + &ofm-url; like &krusader;, the user needs + to get used to + <emphasis>new ideas</emphasis> that are actually already 20 + years old. If you prefer to waste time and lose a lot of + productivity, you can always continue to use one panel file + managers that are based on &Windows; + Explorer.</para> + </sect1> + <sect1 id="mainwindow"> + <title>&krusader; Main Window</title> + <!-- OLD +<screenshot> + <screeninfo>&krusader; Main Window</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="mainwindow.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="mainwindow.png" format="EPS"/></imageobject> + <textobject><phrase>&krusader; Main Window</phrase></textobject> + <caption><para>&krusader; is main window with all the different parts named on the screen.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-mainwindow" float="1"> + <title>&krusader; Main Window</title> + <mediaobject> + <imageobject> + <imagedata fileref="mainwindow.png"></imagedata> + </imageobject> + <textobject> + <phrase>&krusader; Main Window</phrase> + </textobject> + </mediaobject> + </figure> + <para>The User Interface is based on &ofm-url; + paradigm, a 20- year old principle that has proven its bones. + It is known as simple, easy and powerful. In the following + sections we will cover the basic functions of each part with the + exception of:</para> + <itemizedlist> + <listitem> + <para>The + <link linkend="menu-commands">Menu Bar</link> which has a + chapter of its own.</para> + </listitem> + <listitem> + <para>The + <link linkend="bookman">Bookmarks</link> which has a chapter + of its own.</para> + </listitem> + <listitem> + <para>The + <emphasis role="bold">Status Bar</emphasis> shows the + properties of the current file (that is being) in focus. + You can use "drag and drop" to drop a &URL; + "into" the Status Bar.</para> + </listitem> + </itemizedlist> + </sect1> + <sect1 id="toolbars"> + <title>Toolbars</title> + <para>&krusader; comes with several Toolbars.</para> + <sect2 id="main_toolbar"> + <title>Main Toolbar</title> + <indexterm> + <primary>Toolbar</primary> + <secondary>Main Toolbar</secondary> + </indexterm> + <!-- OLD +<screenshot> + <screeninfo>Main Toolbar</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="toolbar.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="toolbar.png" format="EPS"/></imageobject> + <textobject><phrase>Main Toolbar</phrase></textobject> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-maintoolbar" float="1"> + <title>Main Toolbar</title> + <mediaobject> + <imageobject> + <imagedata fileref="toolbar.png"></imagedata> + </imageobject> + <textobject> + <phrase>Main Toolbar</phrase> + </textobject> + </mediaobject> + </figure> + <para>The &krusader; Main Toolbar, is a standard + &kde; toolbar that can be dragged around the + application or configured via a + <keycap>Right-Click</keycap> menu. You can decide whether or + not you want to display it each time you start + &krusader; in the &konfigstartpg-lnk;, + and you can toggle its use in the current session in the + &viewmenu-lnk;. The Main Toolbar contents can be + configured from the + <guimenuitem>Configure Toolbars</guimenuitem> in the + &settingsmenu-lnk; or the + <guilabel>Toolbar</guilabel> tab in the + &konfiglookandfeel-lnk;. Since various commands + and options in &krusader; are context-dependent, + some commands are not always available. The icon of an + inappropriate or inactive action will be deactivated + (grayed-out) disabling its use. &bookmarks-lnk; + can be placed into the Main Toolbar and the Actions Toolbar + with the mouse using "drag and drop".</para> + </sect2> + <sect2 id="actions_toolbar"> + <title>Actions Toolbar</title> + <indexterm> + <primary>Toolbar</primary> + <secondary>Actions Toolbar</secondary> + </indexterm> + <para>&useractions-lnk; and + &bookmarks-lnk; can be "plugged" into the + <guilabel>Actions Toolbar</guilabel>. To show it, use + <emphasis role="bold"> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Actions Toolbar</guimenuitem> + </menuchoice> + </emphasis>. To add user actions, use + <emphasis role="bold"> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Toolbars</guimenuitem> + </menuchoice> + </emphasis> and select Actions Toolbar. You can, for example, + drag the Actions Toolbar to the right side using the + mouse.</para> + </sect2> + <sect2 id="location_toolbar"> + <title>Location Toolbar</title> + <indexterm> + <primary>Toolbar</primary> + <secondary>Location Toolbar</secondary> + </indexterm> + <para>Below the + <guibutton>Main Toolbar</guibutton> there is a + <guibutton>Location Toolbar</guibutton> for each panel. It + shows the path the panel is currently pointing to. If the + selected path is too long, it will be automatically shortened + and an ellipsis "..." will replace the omitted part of the + path name. When entering archives the path will be displayed + in the following format: "archive + name:/directory/archive_filename/the directory inside the + archive". This format makes the paths uniform and easy to + read. The + <guibutton>Location Toolbar</guibutton> supports also + &kioslaves1-url; but not all of them, some can + only be used with the + <link linkend="krviewer">viewer</link> and some can not be + used. The user can enter a desired path by clicking on it. + <itemizedlist> + <listitem> + <para> + <userinput> + <replaceable>/mnt/cdrom/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>settings:/</command> + </userinput>will browse and open entries of the + <application>KDE control center.</application></para> + </listitem> + <listitem> + <para> + <userinput> + <command>devices:/</command> + </userinput>gives an overview of the devices + ⪚ + <hardware>floppy</hardware> or + <hardware>CD-ROM</hardware> drives.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>trash:/</command> + </userinput>opens &kde; is trash.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>ipod:/</command> + </userinput>uses the &kio-ipodslave-url; to + access, upload and organize the music stored on + &appleipod;.</para> + </listitem> + <listitem> + <para>And last but not least + &remote-connections-lnk; .</para> + </listitem> + </itemizedlist>You can copy-paste a &URL; in the + <guibutton>Location Toolbar</guibutton> or use a middle click. + With the Right-Click menu you can configure the auto-complete + function. An optional + <guilabel>Clear Location Toolbar</guilabel> button is also + available.</para> + <para>Quick Navigation: + <keycap>&Ctrl;</keycap>point with mouse in the + middle of &URL; of the + <guibutton>Location Toolbar</guibutton>. A pop-up window shows + the next &URL; location. Pressing + <keycap>&Ctrl;</keycap>+ &LMB; shows + the location where the mouse was pointing to. This feature + allows faster navigation in a big directory tree.</para> + </sect2> + <sect2 id="panel_toolbar"> + <title>Panel Toolbar</title> + <indexterm> + <primary>Toolbar</primary> + <secondary>Panel Toolbar</secondary> + </indexterm> + <para>Each panel has a + <link linkend="konfig-looknfeel-ptoolbar">configurable Panel + Toolbar</link>. The complete Panel Toolbar or specific + buttons can be made visible or be hidden. + <itemizedlist> + <listitem> + <para> + <guibutton>OpenDir Button</guibutton>: opens the + directory browser.</para> + </listitem> + <listitem> + <para> + <guibutton>Equals Button (=)</guibutton>: changes the + panel directory to the other panel directory.</para> + </listitem> + <listitem> + <para> + <guibutton>Up Button (..)</guibutton>: changes the panel + directory to the parent directory.</para> + </listitem> + <listitem> + <para> + <guibutton>Home Button (~)</guibutton>: changes the panel + directory to the home directory.</para> + </listitem> + <listitem> + <para> + <guibutton>Root Button (/)</guibutton>: changes the panel + directory to the root directory.</para> + </listitem> + <listitem> + <para> + <guibutton>Sync-browsing Button</guibutton>: when active, + each directory change in the specific panel is performed + in the other panel as well.</para> + </listitem> + </itemizedlist></para> + </sect2> + </sect1> + <sect1 id="panels"> + <title>Panels</title> + <para>The &krusader; panels are where most of the + action takes place. Currently, there are two types of panels: + <itemizedlist> + <listitem> + <para>&list-panel-lnk;: shows the files and + directories.</para> + </listitem> + <listitem> + <para>&popup-panel-lnk;: has several display + modes: Preview, Tree, Quickselect, View and Disk Usage for + the file or directory that has the focus. The PopUp Panel + may be left open or closed, as desired.</para> + </listitem> + </itemizedlist>&krusader; is a "twin-panel" file + manager so there are two panels: the "Left" panel and the + "Right" panel, or a more important logical distinction, the + *Active* panel and the *Inactive* panel. The active panel is + the one that will accept your mouse and keyboard input. If you + choose a command from the + <guilabel>Menu-Bar</guilabel> or + <guilabel>Toolbar</guilabel> the command will act upon the + selected files/directories in the active panel. You can switch + between panels using the 	 key or by clicking on + the + <guilabel>Information or Totals labels</guilabel>, or by + selecting any file in a panel with the mouse. As always, + default startup settings can be modified with the + &konfigstartpg-lnk;, and you control the current + session with the &viewmenu-lnk;.</para> + <!-- OLD +<screenshot> + <screeninfo>List Panel</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="listpanel.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="listpanel.png" format="EPS"/></imageobject> + <textobject><phrase>List Panel</phrase></textobject> + <caption><para>The List Panel with all the different parts indicated.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-listpanel" float="1"> + <title>List Panel</title> + <mediaobject> + <imageobject> + <imagedata fileref="listpanel.png"></imagedata> + </imageobject> + <textobject> + <phrase>List Panel</phrase> + </textobject> + </mediaobject> + </figure> + <sect2 id="list_panel"> + <title>List Panel</title> + <indexterm> + <primary>Panel</primary> + <secondary>List Panel</secondary> + </indexterm> + <para>This is the default panel and the one you will probably + use most of the time. This panel shows the contents of one + directory which can be local (part of your mounted file + systems, either a native file or the files inside an archive) + or remote files (accessed via &FTP; or Samba). + There are two modes: <link linkend="view-menu">Detailed View</link> that shows the file names, + file size, creation date and time and their attributes. + And <link linkend="view-menu">Brief View</link> that shows only the file names, + the number of brief columns can be changed, by right clicking on the <guilabel>Name</guilabel> header. + File copy/paste/cut via clipboard between + &konqueror; and &krusader; + <keycombo action="simul">&Ctrl; + <keycap>c</keycap></keycombo>, + <keycombo action="simul">&Ctrl; + <keycap>v</keycap></keycombo>, + <keycombo action="simul">&Ctrl; + <keycap>x</keycap></keycombo> is supported. + <keycombo action="simul">&Alt;&Ctrl; + <keycap>r</keycap></keycombo> toggles the + <guilabel>List Panel</guilabel> between horizontal and + vertical mode.</para> + <para>The following items are available: + <itemizedlist> + <listitem> + <para> + <emphasis> + <guilabel>Information Label</guilabel> + </emphasis>: shows how much free space is physically + available on the file system, the file system capacity + and where the path is mounted. If the information is not + available (most often in the case of remote file system) + a message will be displayed with the reason for + unavailablity instead of the information.</para> + <para>The + <guibutton>Media button</guibutton> on the left of the + <guilabel>Information Label</guilabel> displays a list of + all available media, where you can select the desired + media (hdd partition, dvd, usb-stick, &etc;). + The context menu gives several options like + <guilabel>Mount</guilabel>, + <guilabel>Open in a new tab</guilabel>, &etc; + The + <guibutton>Media button</guibutton> is + <link linkend="konfig-advanced"> + configurable</link>.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Column Headers</guilabel> + </emphasis>: here you can change the sort order of the + files and directories as desired. The default sort order + is by + <guilabel>Name</guilabel>. The sort order can be + instantly changed by clicking on one of the + <guilabel>Column Headers</guilabel>. To reverse the sort + order, click a second time on the Column Header. An arrow + will appear on the right of the Column Header text, + showing the sort direction (Up arrow = A to Z sorting, + Down arrow = Z to A sorting). Default + &useractions-lnk; set a keybinding for the + Column Headers. The default + <guilabel>Column Headers</guilabel> are: + <guilabel>Name, Ext, Size, Modified, rwx</guilabel>. + Predefined <link linkend="konfig-general">Atomic extensions</link> like + <filename>tar.gz</filename> are shown as one part in the + <guilabel>Ext</guilabel> Column. More + <link linkend="konfig-looknfeel-panel">optional Column + Headers</link> are available with the &RMB;. + The width + <guilabel>Column Headers</guilabel> can be changed with + the mouse by single clicking and moving the divider line + to the desired width (keep the mouse button pressed). + Both + <guilabel>List Panels</guilabel> remember the sort order + and column width. The + <guilabel>Column Headers</guilabel> can be changed and + saved individually to each panel.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>File List</guilabel> + </emphasis>: displays the files and directories in the + browsed directory. The &quick-search-lnk; + allows you to search for files by typing their names, or + the first few characters of a file name. Pressing + &Enter; or double clicking on a file will + open/execute that file. You can select/unselect files + using the mouse with the + <keycap>Insert</keycap> key or the + &editmenu-lnk;.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Totals Label</guilabel> + </emphasis>: selecting or deselecting files will change + the + <emphasis> + <guilabel>Totals Label</guilabel> + </emphasis>at the bottom of the panel, which displays how + many files you have selected (and how much total disk space + they use) as well as the total file and disk usage of the + current directory (as opposed to the information label + that displays information for the whole file system). If + a directory contains a lot of subdirectories, it may not + be possible to drop the &URL; onto the panel (on + which only directories are visible), but the + &URL; can be dropped onto the "Status Bar" or + "Totals Label" instead. When a + <link linkend="view-menu">custom filter</link> is set, it + will show the setting, example: [*.cpp].</para> + </listitem> + </itemizedlist>When using the "&kde; default + <link linkend="konfig-color">colors</link>", then the + selected files are shown in blue and the current file is + surrounded by a fine-lined rectangle. By default an icon is + shown according to the file type. Use + &konfiglookandfeel-lnk; to change the default + configuration to meet your individual needs.</para> + <para>Some useful + <guilabel>List panel</guilabel>&keybindigs-lnk;: + <itemizedlist> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>r</keycap></keycombo> will refresh the + panel.</para> + </listitem> + <listitem> + <para>Focus a file or directory on the left panel, press + <keycombo action="simul">&Ctrl; + <keycap>Left arrow</keycap></keycombo> and the right panel + changes: + <itemizedlist> + <listitem> + <para>On a file: the right panel gets the same path + as the left panel.</para> + </listitem> + <listitem> + <para>On a directory: refreshes the right panel with + the contents of the directory.</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para>For the right panel: press + <keycombo action="simul">&Ctrl; + <keycap>Right arrow</keycap></keycombo> and the left panel + will change.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="popup_panel"> + <title>PopUp Panel</title> + <indexterm> + <primary>Panel</primary> + <secondary>PopUp Panel (3rd Panel)</secondary> + </indexterm> + <para>This is "&krusader; is 3rd Hand" or the 3rd + Panel, click on the arrow-up button on the left of the + <guilabel>Totals Label</guilabel> or + <keycombo action="simul">&Alt; + <keycap>Down-Arrow</keycap></keycombo> to open the + <guilabel>PopUp Panel</guilabel>. This panel has several + display modes which can be activated by clicking on the + appropriate button. + <itemizedlist> + <listitem> + <para> + <emphasis> + <guilabel>Preview Panel</guilabel> + </emphasis>: gives a preview of the file that has the + focus (currently selected file).</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Tree Panel</guilabel> + </emphasis>: is used to quickly browse the local + directory tree. This panel behaves like the list panel + but only one directory may be selected at a time and + double clicking or pressing &Enter; on a + directory will open that directory in the active panel. + The panels fully support drag and drop (copy, move, link) + mouse actions.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Quickselect Panel</guilabel> + </emphasis>: is used to quickly select files, + ⪚ + <literal role="extension">*.png</literal>and click on the + + <guibutton>"Go"</guibutton> button. The "floppy" button + stores the current selection. The "select group dialog" + is also available.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Viewer Panel</guilabel> + </emphasis>: views a text file, views an image, + &etc; A thumbnail view is generated whenever + you open the + <guilabel>Viewer Panel</guilabel> and click on a name of a + folder that contains pictures.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Disk Usage Panel</guilabel> + </emphasis>: views the &diskusage-lnk; of a + directory.</para> + </listitem> + </itemizedlist>If needed you can resize the window + ⪚ to better display a picture or view a file is + contents. Click on the arrow down button to close the + <guilabel>3rd Hand Panel</guilabel>.</para> + </sect2> + <sect2 id="folderhistory"> + <title>Folder History</title> + <para>Both panels remember recently visited folders. Click on + the + <guibutton>"Folder history"</guibutton> button ("watch" + symbol) to open the folder history list. Here you can quickly + change to previously visited folders. The currently focused + folder is checked. On every new start of &krusader;, the + history list is empty.</para> + </sect2> + </sect1> + <sect1 id="cmdline_termemu"> + <title>Command Line / Terminal Emulator</title> + <para>This part of the <link linkend="gloss-gui">GUI</link> + can have four modes: Command Line, Terminal Emulator, show both and show none. + You can choose your mode of operation either on start-up with the + &konfigstartpg-lnk;, or for the current session with the &viewmenu-lnk; . + </para> + + <sect2 id="cmdline"> + <title>Command Line</title> + + <!-- OLD +<screenshot> + <screeninfo>Command line</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="cmdline.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="cmdline.png" format="EPS"/></imageobject> + <textobject><phrase>Command Line</phrase></textobject> + <caption><para>Command Line</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-commandline" float="1"> + <title>Command Line</title> + <mediaobject> + <imageobject> + <imagedata fileref="cmdline.png"></imagedata> + </imageobject> + <textobject> + <phrase>Command line</phrase> + </textobject> + </mediaobject> + </figure> + <para>The traditional command line mode offers a single line of + input to enter commands, it also features three buttons: + <itemizedlist> + <listitem> + <para><guibutton>"command history"</guibutton> (down arrow) to quick open previous used commands + </para> + </listitem> + + <listitem> + <para><guibutton>"Useraction expander"</guibutton> (green plus button) to add easy + <link linkend="useractions">Useraction placeholders</link> + </para> + </listitem> + + <listitem> + <para><guibutton>"run in terminal mode"</guibutton> (console icon) button with the next options: + <itemizedlist> + <listitem><para>Start and Forget</para> + </listitem> + + <listitem><para>Display Separated Standard and Error Output</para> + </listitem> + + <listitem><para>Display Mixed Standard and Error Output</para> + </listitem> + + <listitem><para>Start in New Terminal</para> + </listitem> + + <listitem><para>Send to Embedded Terminal Emulator</para> + </listitem> + + </itemizedlist> + </para> + + </listitem> + + + </itemizedlist> + When you start typing your commands, + the command line auto-completion feature will make its offers + according to what you choose in the + &kcontrolcenter;. If you want to change the way + auto-complete behaves in the current &krusader; + session, + <keycap>right click</keycap> on the command line and change it. + To the left of the input line you can find the local path that + the active panel is currently pointing to. This path is where + your command will be executed. Typing + <userinput> + <command>cd</command> + <replaceable> + <directory></replaceable> + </userinput> in the command line will also cause the active + panel to point to this directory. + + Click + <link linkend="cmdline_keybindings">here</link> to view the + command line keybindings.</para> +</sect2> + + <sect2 id="termemu"> + <title>Terminal Emulator</title> + + <!-- +<screenshot> + <screeninfo>Terminal emulator</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="terminalEmu.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="terminalEmu.png" format="EPS"/></imageobject> + <textobject><phrase>Terminal emulator</phrase></textobject> + <caption><para>Terminal emulator</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-terminalemulator" float="1"> + <title>Terminal Emulator</title> + <mediaobject> + <imageobject> + <imagedata fileref="terminalEmu.png"></imagedata> + </imageobject> + <textobject> + <phrase>Terminal emulator</phrase> + </textobject> + </mediaobject> + </figure> + <para>The terminal emulator mode is in fact a small console and + acts like one. You can change the active directory in the + terminal by using the + <userinput> + <command>cd</command> + </userinput> command. The terminal emulator will follow the + active panel directory. When you drag a file from the + <interface>"List Panel"</interface>, you will get to choose + between: "Paste", + <command>cd</command>, + <command>mv</command> and + <command>ln</command>. If you drag multiple files, then + <command>cd</command> will not be available. A full-screen + terminal emulator can be used when + <link linkend="konfig-looknfeel-operation">configured</link> or + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo> toggles between normal and full + screen mode. If the command line is hidden, press + <keycombo action="simul">&Ctrl; + <keycap>up</keycap></keycombo> to focus the terminal emulator. + <keycombo action="simul">&Ctrl; + <keycap>down</keycap></keycombo> brings you back down. + <keycombo action="simul">&Ctrl; + <keycap>Enter</keycap></keycombo> and + <keycombo action="simul">&Ctrl; + <keycap>Shift</keycap> + <keycap>Enter</keycap></keycombo> paste the filename. You can + close the emulator by typing + <userinput> + <command>exit</command> + </userinput>.</para> + <para> + Click + <link linkend="termemu_keybindings">here</link> to view the + Terminal emulator keybindings..</para> + </sect2> + + </sect1> + <sect1 id="fnkeys"> + <title>Function (FN) Keys Bar</title> + <!-- OLD +<screenshot> + <screeninfo>Function (FN) Keys Bar</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="fnkeys.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="fnkeys.png" format="EPS"/></imageobject> + <textobject><phrase>Function (FN) Keys Bar</phrase></textobject> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-fnkeys" float="1"> + <title>Function (FN) Keys Bar</title> + <mediaobject> + <imageobject> + <imagedata fileref="fnkeys.png"></imagedata> + </imageobject> + <textobject> + <phrase>Function (FN) Keys Bar</phrase> + </textobject> + </mediaobject> + </figure> + <para>This bar gets its name from the function (FN) keys it + represents. For each button on this bar there is a + corresponding function key that performs the same action. This + bar is derived from the design of the first twin-panel file + managers and the FN keys usually act the same way with two + changes: the + <keycap>F2</keycap> key will open a terminal at the last local + path that the active panel pointed to, and the + <keycap>F9</keycap> key is used to rename files. + <guilabel>Mkdir</guilabel> + <keycap>F7</keycap> can create whole directory trees on the fly + ⪚ + <literal>foo/bar/test</literal>. You can choose to display + <link linkend="faqu_resize">or not</link> the + <guilabel>FN keys bar</guilabel> when starting up + &krusader; via the &konfigstartpg-lnk;, + and you can toggle its use in the current session with the + &viewmenu-lnk;. The actions and + &keybindigs-lnk; performed by the function keys are + configurable since version 1.51, they will remain active with + or without the + <guilabel>FN keys bar</guilabel> displayed.</para> + </sect1> + <sect1 id="folder-tabs"> + <title>Folder Tabs</title> + <!-- OLD +<screenshot> + <screeninfo>Tabbed browsing</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="tabbed_browsing.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="tabbed_browsing.png" format="EPS"/></imageobject> + <textobject><phrase>Tabbed browsing</phrase></textobject> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-tabbedbrowsing" float="1"> + <title>Folder Tabs</title> + <mediaobject> + <imageobject> + <imagedata fileref="tabbed_browsing.png"></imagedata> + </imageobject> + <textobject> + <phrase>Folder Tabs</phrase> + </textobject> + </mediaobject> + </figure> + <para>With &folder-tabs; you can quickly change to + multiple folders; each panel has its own + &folder-tabs;. The &folder-tabs; + positions are saved when closing &krusader;. To + switch between &folder-tabs;, click them with the + mouse. Squeezed &folder-tabs; have tooltips to + display the full path. The following &folder-tabs; + operations are available: + <itemizedlist> + <listitem> + <para>To + <keycap>open a new tab</keycap> and keep the current + directory: &right-click; on a directory and + select + <keycap>open in a new tab</keycap>, or use the + &MMB;, or use + <keycombo action="simul">&Alt;&Ctrl; + <keycap>n</keycap></keycombo>.</para> + </listitem> + <listitem> + <para>To + <keycap>duplicate a tab</keycap>: &right-click; + on the Folder Tab and select + <keycap>duplicate tab</keycap>, or use + <keycombo action="simul"> + &Alt;&Ctrl;&Shift; + <keycap>n</keycap></keycombo>.</para> + </listitem> + <listitem> + <para>To + <keycap>close a tab</keycap> (except the left tab): + &right-click; on the tab and select + <keycap>close tab</keycap>, or use the &MMB;, or + use the Folder tab + <guibutton>"red cross"</guibutton> button, or use + <keycombo action="simul">&Alt;&Ctrl; + <keycap>c</keycap></keycombo>.</para> + </listitem> + <listitem> + <para>To create a + <keycap>"home" tab</keycap>: click on the + <guibutton>Folder Tab Bookmark</guibutton> button.</para> + </listitem> + <listitem> + <para>To + <keycap>change tabs</keycap>: + <keycombo action="simul">&Shift; + <keycap>Left Arrow</keycap></keycombo> or + <keycombo action="simul">&Shift; + <keycap>Right Arrow</keycap></keycombo>.</para> + </listitem> + <listitem> + <para>To open the current folder in a new tab: use + <keycombo action="simul"> + &Ctrl;&Alt;&Enter;</keycombo>.</para> + </listitem> + </itemizedlist></para> + </sect1> + <sect1 id="ui_buttons"> + <title>Buttons</title> + <para>Several buttons for fast operations are available: + <link linkend="main_toolbar">Main Toolbar</link>, + <link linkend="actions_toolbar">Actions Toolbar</link>, + <link linkend="panel_toolbar">Panel Toolbar</link>, + <link linkend="location_toolbar">Location Toolbar</link>, + <link linkend="list_panel">Media</link>, + <link linkend="folderhistory">Folder history</link>, + <link linkend="bookman">Bookmarks</link>, + <link linkend="folder-tabs">Tab</link>, + <link linkend="cmdline">Commandline</link>, + <link linkend="fnkeys">Function keys</link>.</para> + </sect1> +</chapter> diff --git a/doc/en/useraction-xml.docbook b/doc/en/useraction-xml.docbook new file mode 100644 index 0000000..c2676a1 --- /dev/null +++ b/doc/en/useraction-xml.docbook @@ -0,0 +1,217 @@ +<appendix id="useraction-xml"> + <!-- ********************************************************************** + installation.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>useraction.xml</title> + <para>This appendix gives several examples of + <filename>useraction.xml</filename> files. With this you can begin + to discover the power of the &useractions-lnk; and + start learning how to use them. Once you understand how to write + UserActions you will find that &krusader; is an even + more powerful, customizable tool.</para> + <para>Please consider uploading your UserActions at + &kde-files-url; as we are collecting them. If your + UserAction is selected by us it will be shipped with + &krusader; at the next release. We provide also an + &useractionsforum-url;.</para> + +<itemizedlist> + <listitem><para>Runs <command>uptime</command> + <programlisting> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="uptime" > + <title>Up-time</title> + <tooltip>tells how long since the computer has been booted</tooltip> + <icon>clock</icon> + <category>information</category> + <description same_as="tooltip" /> + <command executionmode="collect_output" >uptime</command> + <defaultshortcut>Alt+Ctrl+U</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Runs <command>ls -l</command> + <programlisting> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="ls -l" > + <title>ls -l in curremt dir</title> + <description same_as="tooltip" /> + <command executionmode="collect_output" >ls -l %aPath% %oPath%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Echo Placeholder + <programlisting> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="test_placeholder" > + <title>Echo Placeholder</title> + <tooltip>Echo's the placeholder values</tooltip> + <category>Testing</category> + <description same_as="tooltip" /> + <command executionmode="collect_output" onmultiplefiles="call_each" >echo -e "aPath %aPath()% \naCurrent: %aCurrent()%"</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>This useraction copies current path and filename to clipboard: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="clipboard current" > + <title>Copy to Clipboard</title> + <tooltip>Copy to clipboard</tooltip> + <icon>klipper</icon> + <category>System</category> + <description>Copy current path and filename to clipboard</description> + <command>%_Clipboard("%aCurrent%")%</command> + <defaultshortcut>Win+C</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Selects <literal role="extension">.diff</literal> and <literal role="extension">*.h</literal> in the active panel: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="test_select" > + <title>Add selection *.diff and *.h</title> + <category>Selection</category> + <command>%aSelect("*.diff", "add")% %aSelect("*.h", "add")%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Active panel changes to <filename>mnt/floppy</filename> (bookmark): + <programlisting> +<!DOCTYPE KrusaderUserActions> +<action name="mnt/floppy bookmark" > + <title>Jump to /mnt/floppy</title> + <category>Bookmarks</category> + <command>%aGoto("/mnt/floppy", "yes")%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Select in the non-active panel, all filenames that are highlighted in the active panel: + <programlisting> +<!DOCTYPE KrusaderUserActions> + <action name="asdfasdf" > + <title>Select in Other Panel</title> + <category>Selection</category> + <description>Select all filenames that are selected in the active panel, also in the non-active panel</description> + <command>%oSelect("%aList("selected", " ", "Yes")%")%</command> + </action> +</KrusaderUserActions</programlisting> + </para></listitem> + + <listitem><para>Make a backup of the current file/folder to <filename>foo.bak</filename> into the current directory: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="backup current" > + <title>Backup in Current Directory</title> + <tooltip>Backup in current directory</tooltip> + <icon>filesaveas</icon> + <category>System</category> + <description same_as="tooltip" /> + <command>%_Copy("%aCurrent%", "%_Ask("new name", "%aCurrent%.bak")")%</command> + <defaultshortcut>Shift+F5</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Opens <link linkend="krusearcher">KruSearcher</link>: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="search" > + <title>Search Test</title> + <command>%_NewSearch("Search 2")%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Sets the selected picture as wallpaper: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="set wallpaper" > + <title>Set as Wallpaper</title> + <tooltip>Set as wallpaper</tooltip> + <icon>image</icon> + <category>Service Menu</category> + <description>Set as wallpaper (scaled)</description> + <command>dcop kdesktop KBackgroundIface setWallpaper "%aCurrent%" 6</command> + <defaultshortcut>Win+W</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>This useraction edits a file with root permissions using <command>kdesu</command>: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="edit as root" > + <title>Edit as Root</title> + <tooltip>Edit as root</tooltip> + <icon>kwrite</icon> + <category>System</category> + <description>Edit a file with root permissions using kdesu</description> + <command>kdesu kedit %aCurrent%</command> + <defaultshortcut>Win+F4</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>This useraction Add item(s) to Amarok playlist: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="amarok enqueue" > + <title>Enqueue in Amarok</title> + <tooltip>Append selected item(s) to Amarok playlist</tooltip> + <icon>amarok</icon> + <category>Multimedia</category> + <description same_as="tooltip" /> + <command>amarok --append %aList("Selected")%</command> + <defaultshortcut>Win+A</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Opens <link linkend="synchronizer">Synchronizer</link>: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="synchronizer" > + <title>Synchronizer</title> + <command>%_Sync("Sync 2")%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + +</itemizedlist> + +</appendix> diff --git a/doc/en/useractions.docbook b/doc/en/useractions.docbook new file mode 100644 index 0000000..2c3b5fd --- /dev/null +++ b/doc/en/useractions.docbook @@ -0,0 +1,644 @@ +<sect1 id="useractions"> + <!-- ********************************************************************** + useractions.docbook + ++++++++++++++++++++++++++ + (C)opyright : (C) 2000 - 2008 + All Rights Reserved 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>UserActions</title> + <indexterm> + <primary>UserActions</primary> + </indexterm> + <!-- Thanks to Jonas Bar --> + <para>With ActionMan you can set up, configure and manage + UserActions. Some general settings are configured with + <link linkend="konfig-useractions">Konfigurator</link>. With + UserActions you can perform actions on files in the panel or to + access &krusader; internal functions with parameters + directly using placeholders. The actions integrate seamlessly + into &kde;'s action system, which means that the + standard Edit Toolbar and Edit Shortcut dialogs will show + UserActions, too. The UserActions are stored in + <filename> + ~/.kde/share/apps/krusader/useraction.xml</filename> (the file + structure is documentated in doxygen headers of UserActionXML). + Several + <link linkend="useraction-xml">examples</link> are included in the + documentation. UserActions can be edited / added / imported / + exported by using ActionMan. The default UserActions are stored + in + <filename> + ~/.kde/share/apps/krusader/useraction-examples.xml</filename>. + UserActions can appear nearly everywhere where "normal" KActions + can be placed. The actions integrate seamlessly into + &kde; action system, which means that the standard + Edit Toolbar and Edit Shortcut dialogs will show UserActions, + too. They can even be placed in the menu bar, but for that the + <filename>krusaderui.rc</filename> file must be edited. A few + examples: + <itemizedlist> + <listitem> + <para> + <link linkend="useractions-menu">Useractions Menu</link> + </para> + </listitem> + <listitem> + <para>&usermenu-lnk;</para> + </listitem> + <listitem> + <para>&actions-toolbar-lnk;</para> + </listitem> + <listitem> + <para>right click menus</para> + </listitem> + <listitem> + <para>&etc;</para> + </listitem> + </itemizedlist>&krusader;'s UserActions tool is very + powerful and customizable if you are familiar with writing + UserActions in general.</para> + <tip> + <para>Several UserActions are provided by default. Please + <link linkend="help_krusader">upload your favorite + UserActions</link> so that they become available for the + &krusader; community. Thanks! We provide also an + &useractionsforum-url;.</para> + </tip> + <figure id="screenshot-actionman" float="1"> + <title>ActionMan</title> + <mediaobject> + <imageobject> + <imagedata fileref="actionman.png"></imagedata> + </imageobject> + <textobject> + <phrase>ActionMan</phrase> + </textobject> + </mediaobject> + </figure> + <para>Basically, UserActions are a method to call external + programs with variable parameters. For example, you could have a + UserAction with the following + <command>xmms + <option>--enqueue %aList("Selected")%</option></command> to + enqueue all selected items of the active panel to the current + instance of xmms. Additionally, there is limited access to + &krusader; internal functions requiring parameters. + For example, + <command>%aPanelSize("80")%</command> will set the width of the + active panel to 80% of the &krusader; mainwindow. + Since the parameter of placeholders can contain other + placeholders, few scripts are possible. However, scripting can be + done with the &javascript-console-lnk;.</para> + <para> + <emphasis role="bold">Managing UserActions</emphasis> + </para> + <para>Open Konfigurator and choose "UserActions -> + ActionMan", in which you can add, edit, remove, import and export + UserActions. + <itemizedlist> + <listitem> + <para> + <guimenuitem>Add Action</guimenuitem>: If you add an new + action, you get an empty input mask where you can enter all + the properties you desire. The action will be added as soon + as you press + <guimenuitem>Ok</guimenuitem>. Afterwards, the name is shown + in the list on the left.</para> + </listitem> + <listitem> + <para>To edit a UserAction: Select the UserAction on the + left. Then choose it if you want to edit its properties. The + changes will only take effect when you press + <guimenuitem>OK</guimenuitem>.</para> + </listitem> + <listitem> + <para> + <guimenuitem>To remove a UserAction</guimenuitem>: Select the + UserAction on the left and click the remove button.</para> + </listitem> + <listitem> + <para> + <guimenuitem>To import a UserAction</guimenuitem>: If you + import some actions, they will be automatically added to your + list. If there are name conflicts (the names have to be + unique because these are the ID for &kde;'s action + system), you are asked to resolve them. For this, the list on + the left will only show the actions where conflicts exist. + You can now give them new names or remove them.</para> + </listitem> + <listitem> + <para> + <guimenuitem>Export Action</guimenuitem>: If you export a + UserAction you have to give a filename in which to store it. + If it does not exist, it will be created. If the file already + contains UserActions, the action you are exporting will be + added to that file.</para> + </listitem> + </itemizedlist>All actions you have defined are now shown in the + user menu and in &kde; dialogs for changing shortcuts + and managing the toolbar. In addition, all actions available for + the current item will also show up in the right click + menu.</para> + <para> + <emphasis role="bold"> + <guimenuitem>Basic Properties</guimenuitem> + </emphasis> + </para> + <para> + <guimenuitem>"Distinct Name", "Title" and "Command + line"</guimenuitem>are always required, all the other properties + are optional. + <itemizedlist> + <listitem> + <para> + <guimenuitem>"Distinct Name"</guimenuitem>: A unique name of + the UserAction, used to identify it for &kde;'s + action system.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Icon button"</guimenuitem>: The icon for your + UserAction.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Category"</guimenuitem>: Adds a category for a + better overview. NOTE: This property is not used yet. It is + planned to be used, but has not implemented yet.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Title"</guimenuitem>: The title displayed in + the menus or dialogs.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Tooltip"</guimenuitem>: A tooltip for your + UserAction, ⪚ displayed in the toolbar on + mouseover.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Description"</guimenuitem>: A description of + what the UserAction does. This is also displayed as + <guimenuitem>"What's This"</guimenuitem> if you + <keycombo action="simul">&Shift; + <keycap>F1</keycap></keycombo> click on your + UserAction.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Use Tooltip checkbox"</guimenuitem>: Uses the + tooltip as description.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Command line"</guimenuitem>: The command which + will be executed. You can add placeholder using a GUI with + the + <guibutton>add</guibutton> button.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Startpath"</guimenuitem>: The working directory + for the command which will be executed.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Execution mode"</guimenuitem>:</para> + <itemizedlist> + <listitem> + <para> + <guimenuitem>"Normal"</guimenuitem>: Normal execution + mode.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Run in terminal"</guimenuitem>: Runs the + command in the terminal.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Collect output"</guimenuitem>: Collects the + output of the executed program in a &GUI; + window.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Separate standard error"</guimenuitem>: + When "Collect output" is used the stdout and stderr are + separately collected.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + <guimenuitem>"Command accepts"</guimenuitem>:</para> + <itemizedlist> + <listitem> + <para> + <guimenuitem>"Local files (no URLs)"</guimenuitem>: Tells + the placeholder it should return local addresses.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"URLs (local and remote)"</guimenuitem>: + Tells the placeholder it should return + &URL;s.</para> + </listitem> + </itemizedlist> + </listitem> + <!-- Not yet implemented, but will be after 1.50 stable is released + <listitem><para><guimenuitem>"On multiple selection"</guimenuitem>: </para> + <itemizedlist> + <listitem><para><guimenuitem>"separate call for each file"</guimenuitem>: executes the command for each selected file. + </para></listitem> + </itemizedlist> + </listitem> --> + <listitem> + <para> + <guimenuitem>"Shortcut button"</guimenuitem>: Configures a + shortcut for the UserAction.</para> + </listitem> + </itemizedlist></para> + <para> + <emphasis role="bold">Command-line syntax:</emphasis> + </para> + <para>Basically, everything you type in the command line will get + executed (if you type "ls -l", "ls -l" gets executed). You have + the possiblity to get a character string from + &krusader; which represents the current state of the + panel. This is done using placeholders. A placeholder begins with + a percent-sign ('%') and is followed by a panel indicator ('a' + for the active, 'o' for the other, 'l' for the left and 'r' for + the right panel. If the placeholder doesn't need a panel to + operate on, you have to indicate this by an underscore ('_')). + Then comes the name of the placeholder (see the list below), + which may get some parameters enclosed in quotes. Finally, again + the percent sign.</para> + <para>This sounds very complicated, so let's make an example: + '%aList("Selected")%' is replaced by a list of all selected items + in the active panel. So a command like 'xmms --enqueue + %aList("All", " ", "", "*.mp3")%' will execute xmms with a list + of all .mp3s in the current panel, separated by a single + blank.</para> + <para>Currently, these placeholders are implemented: + <itemizedlist> + <listitem> + <para> + <userinput>Path</userinput> - replaced by the panels + path</para> + <orderedlist> + <listitem> + <para>&useraction-optional-parameter; + Automatic escape spaces. &useraction-default; + yes</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Count</userinput> - replaced by the number of + <first parameter></para> + <orderedlist> + <listitem> + <para>&useraction-parameter; Which items; + either "All", "Selected", "Files" or "Dirs"</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Filter</userinput> - replaced by the panel's filter + mask</para> + </listitem> + <listitem> + <para> + <userinput>Current</userinput> - replaced by the current + item</para> + <orderedlist> + <listitem> + <para>&useraction-optional-parameter; Omit the + current path. &useraction-default; no</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + Automatic escape spaces. &useraction-default; + yes</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>List</userinput> - replaced by a list of all + <first parameter></para> + <orderedlist> + <listitem> + <para>&useraction-parameter; Which items; + either "All", "Selected", "Files" or "Dirs"</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + Separator between the items. + &useraction-default; + " "</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; Omit the + current path. &useraction-default; no</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + Filtermask (for all but "Selected"). + &useraction-default; *</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + Automatic escape spaces. &useraction-default; + yes</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Select</userinput> - manipulates the selection in a + panel</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; Filtermask</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + manipulate in which way; either "Set", "Add" or "Remove". + &useraction-default; "Set"</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Goto</userinput> - changes the panels' path to + <first parameter></para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A relative or + absolute path, or an URL</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; Open the + location in a new tab. &useraction-default; + no</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Ask</userinput> - asks the user for some text and + is replaced by the answer</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; The + Question</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; A + default answer</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; A + caption for the question box</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Clipboard</userinput> - manipulates the + clipboard</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; The text that + should go to the clipboard (you may want to use + "%aCurrent%" here)</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; Append + the text to the current content of the clipboard with + this separator</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Copy</userinput> - copies a file, useful for quick, + local backups</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; What should be + copied</para> + </listitem> + <listitem> + <para>&useraction-parameter; Where it should + be copied</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Sync</userinput> - opens the Synchronizer with a + given profile</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A profile for the + Synchronizer</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>NewSearch</userinput> - opens the search windows + with a given profile</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A profile for the + search module</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Profile</userinput> - loads a given panel + profile</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A panel + profile</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Each</userinput> - splits the commandline into a + list. These commands are executed one after another.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A list item (all, + all files, all dirs, all selected).</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Move</userinput> - move from source to + destination.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A source</para> + </listitem> + <listitem> + <para>&useraction-parameter; A + destination</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>PanelSize</userinput> - change the ratio between + the two panels.</para> + <orderedlist> + <listitem> + <para>&useraction-optional-parameter; A + integer value, e.g., 80 makes the active panel use 80% of + &krusader;'s width (height in vertical mode), + omitting the parameter means 50%.</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Ask</userinput> - cancel the execution.</para> + <orderedlist> + <listitem> + <para>&useraction-optional-parameter; A string + for the cancel question.</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Script</userinput> - executes an external + <link linkend="javascript_console"> + Javascript</link> file.</para> + <para>NOTE: This is still experimental and the interface may + change, feedback is always welcome.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; path to the + external foo.js file, absolute path or relative to + <filename> + <kde-app-data>/krusader/js/</filename>. + <kde-app-data> is + <filename>$(kde-config + --localprefix)/share/apps/</filename> or + <filename>$(kde-config --prefix)/share/apps/</filename>, + for those who don't know where to copy the + scripts/extensions. If all the needed files (normally + <filename>.js</filename> and maybe + <filename>.ui</filename>) are in one of these dirs it's + sufficient to give the file name only as 1. + parameter.</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; a list + of variables which should be set, like "return=cmd; + a=lalala; b='%_Ask(..)'" so that the placeholder is + replaced be the content of the variable cmd and the other + two have already these values when the script + starts.</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>ListFile</userinput> - is replaced by path/file name + of a temporary file containing a list of items</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; + path/filename</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>ColSort</userinput> - set the sorting on a column + of a specific panel.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; Column: Either + "Name", "Ext", "Type", "Size", "Modified", "Perms", + "rwx", "Owner" and "Group"</para> + </listitem> + <listitem> + <para>&useraction-parameter; Sort sequence: + Either "Toggle", "Asc", "Desc"</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>View</userinput> - set the view mode.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; View mode: Either + "generic", "text", "hex"</para> + </listitem> + <listitem> + <para>&useraction-parameter; Window Mode: + Either "tab", "window"</para> + </listitem> + </orderedlist> + </listitem> + </itemizedlist>A GUI-based helper for placeholder adding is + provided. Spaces In Path, Current and List are by default, + automatically escaped. There is one more important thing to know: + All placeholders that interact with &krusader; + internal functions are called at expand time (meaning directly + when the placeholders are replaced). External programs are + called at execution time (meaning after all placeholders are + replaced).</para> + <para> + <emphasis role="bold"> + <guimenuitem>Advanced Properties</guimenuitem> + </emphasis> + </para> + <para>Here you can configure where your command should be visible + (for the right click menu) In addition, it is possible to change + the command executed and confirm it separately. You can also set + a user under which the command should be executed. + <itemizedlist> + <listitem> + <para>Configures if the action is valid for a Protocol, Path, + Mime type or File name.</para> + </listitem> + <listitem> + <para>Tweaking the command line before being executed.</para> + </listitem> + <listitem> + <para>Set a different user for the execution (this has no + effect in &krusader; internal functions)</para> + </listitem> + </itemizedlist></para> +</sect1> diff --git a/doc/en/using-krusader.docbook b/doc/en/using-krusader.docbook new file mode 100644 index 0000000..f19d719 --- /dev/null +++ b/doc/en/using-krusader.docbook @@ -0,0 +1,426 @@ +<chapter id="basic-functions"> + <!-- ********************************************************************** + using-krusader.docbook + +++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + 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., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, 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 + &konfiglookandfeel-lnk;</para> + </listitem> + </orderedlist>We will only mention the most important + keyboard shortcuts with the default configuration, but keep + in mind that most of the &keybindigs-lnk; 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 + &keybindigs-lnk; tab at the + &konfiglookandfeel-lnk;.</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 (&ie;: 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 	 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 &Esc; 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 	 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 + &mouse-selection-modes-lnk;, 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">&Shift; + <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">&Shift; + <keycap>Home</keycap></keycombo> selects everything above + the cursor (and deselects everything below the cursor, if + selected).</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <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 &editmenu-lnk; 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), ⪚ 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. &Esc; 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 &konfiglookandfeel-lnk; 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 + &mouse-selection-modes-lnk; settings). This list + gives an overview of the most important context menus. Use + them to discover the available commands. + <itemizedlist> + <listitem> + <para>&main-toolbar-lnk; (orientation, text + position, icon size)</para> + </listitem> + <listitem> + <para>&list-panel-lnk; on a file or + directory</para> + </listitem> + <listitem> + <para>&cmdline-lnk; (undo, paste, text + completion...)</para> + </listitem> + <listitem> + <para>&termemu-lnk; (send signal, font, + history...)</para> + </listitem> + <listitem> + <para>&foldertabs-lnk; (new, duplicate, + close)</para> + </listitem> + <listitem> + <para> + <link linkend="krusearcher">KruSearcher</link> Search + results file list (F3 View, F4 Edit)</para> + </listitem> + <listitem> + <para>&mountman-lnk; (unmount, + format...)</para> + </listitem> + <listitem> + <para>&syncdirs-lnk; File List</para> + </listitem> + <listitem> + <para>&useractions-lnk;</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>&bookmarks-lnk; 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="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, + <keycombo action="simul">&Shift; + <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>When you delete files in your local system, they are + not completely erased and the information stored in them can + be recovered using special software and hardware tools. If + you want to erase a file without recoverable traces, select + the file and use + <emphasis role="bold"> + <menuchoice> + <guimenu>Right-Click menu</guimenu> + <guimenuitem>Shred</guimenuitem> + </menuchoice> + </emphasis>.</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 + &konfiglookandfeel-lnk;. + <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> diff --git a/doc/en/vfs.docbook b/doc/en/vfs.docbook new file mode 100644 index 0000000..8acb910 --- /dev/null +++ b/doc/en/vfs.docbook @@ -0,0 +1,83 @@ +<sect1 id="vfs"> + <title>Virtual file systems (VFS)</title> + <indexterm> + <primary>VFS</primary> + </indexterm> + <para>A basic + <link linkend="features">OFM feature</link> is VFS, this an + abstracted layer over all kinds of archived information (ZIP + files, FTP servers, TAR archives, NFS filesystems, SAMBA shares, + ISO cd/dvd images, RPM catalogs, etc.), which allows the user to + access all the information in these divergent types of + filesystems transparently - just like entering an ordinary + sub-directory. &krusader; supports several virtual + file systems: + <itemizedlist> + <listitem> + <para> + <link linkend="remote-connections">Remote connections + VFS</link>: provides the capability of working with a remote + connection session (FTP, NFS, Samba, FISH, SFTP) like with + local filesystems. It is perfect for complex remote operations + and almost as powerful as most standalone GUI remote + clients.</para> + </listitem> + <listitem> + <para> + <link linkend="archives">Archive VFS</link>: allows to browse + archives in VFS as it was a directory (ace, arj, bzip2, deb, + gzip, iso, lha, rar, rpm, tar, zip and 7-zip).</para> + </listitem> + <listitem> + <para> + <link linkend="archives">Search VFS</link>: + <guibutton>Feed to listbox</guibutton> places the search + results in VFS.</para> + </listitem> + <listitem> + <para> + <link linkend="synchronizer">Synchronizer VFS</link>: places + the synchronizer results in VFS.</para> + </listitem> + </itemizedlist>Actions you perform on the files in VFS are + performed on the 'real' files. You do not just delete files from + the VFS - you delete them from your hard drive. Limitations: you + ca not create directories inside a VFS.</para> + <para>It is possible to keep the directory structure when doing a + from copy from a virtual folder to a non virtual folder, by + selecting the "Keep virtual directory structure" check box of the + copy dialog. Imagine the following virtual folder: + <screen><prompt>$</prompt> <userinput>file:/home/myhome/mydir1/myfile1</userinput></screen> + <screen><prompt>$</prompt> <userinput>file:/home/myhome/mydir1/myfile2</userinput></screen> + <screen><prompt>$</prompt> <userinput>file:/home/myhome/mydir2/myfile3</userinput></screen> + Then do the following steps: + <itemizedlist> + <listitem> + <para>go to the virtual folder and select the files</para> + </listitem> + <listitem> + <para>select a destination folder (non virtual!)</para> + </listitem> + <listitem> + <para>press + <keycap>F5</keycap>-> copy dialog + appears</para> + </listitem> + <listitem> + <para>Check + <guilabel>Keep virtual directory structure</guilabel></para> + </listitem> + <listitem> + <para>Select + <filename>/home/myhome/</filename> for base + &URL;</para> + </listitem> + <listitem> + <para>Start copy by pressing OK</para> + </listitem> + </itemizedlist>The result will be: + <screen><prompt>$</prompt> <userinput>destinationdir/mydir1/myfile1</userinput></screen> + <screen><prompt>$</prompt> <userinput>destinationdir/mydir1/myfile2</userinput></screen> + <screen><prompt>$</prompt> <userinput>destinationdir/mydir2/myfile3</userinput></screen> + </para> +</sect1> diff --git a/doc/en/viewer-editor.docbook b/doc/en/viewer-editor.docbook new file mode 100644 index 0000000..b9a845a --- /dev/null +++ b/doc/en/viewer-editor.docbook @@ -0,0 +1,1127 @@ +<sect1 id="krviewer"> + <title>KrViewer: &krusader;'s internal + viewer-editor</title> + <indexterm> + <primary>Viewer</primary> + <seealso>Editor</seealso> + </indexterm> + <para>Pressing &Enter; on a selected file + <emphasis>opens the file with the associated + application</emphasis>. The editor-viewer is tabbed, configure it + on the &konfiggereral-lnk;</para> + <sect2 id="krview"> + <title>Viewer</title> + <para>To view a file as fast as possible according to its type, + just put it under the cursor and press + <keycap>F3</keycap>. &krusader;'s internal viewer is + actually a part of &konqueror;, which can basically + view every file type viewable by &konqueror; + (⪚ display pictures, play music, show the content + of an archive). This is called the 'Generic viewer', for which + you need to configure the mime types.</para> + <para>The viewer works as follows: + <itemizedlist> + <listitem> + <para>It tries to view the file with the + <emphasis>'Generic viewer'.</emphasis></para> + </listitem> + <listitem> + <para>When the file type (mime type) cannot be determined or + when a file (⪚ a binary) doesn't have an + associated action, it disables the 'generic viewer'. The + file is treated as a text file, which 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>You can configure the default viewer mode on the + &konfiggereral-lnk; .</para> + <para> + <keycombo action="simul">&Shift; + <keycap>F3</keycap></keycombo>views a &URL; on + demand, ⪚: + <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.</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 + <literal role="extension">tar.gz</literal> archive.</para> + </listitem> + </itemizedlist></para> + <para>KrViewer can have the following menus: + <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 can 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 + &kioslaves1-url; We cannot and do not want to + change it, usings these libraries reduces the amount of + written code. So we do not have to reinvent the wheel + ;-)</para> + </note> + </sect2> + <sect2 id="kredit"> + <title>Editor</title> + <indexterm> + <primary>Editor</primary> + </indexterm> + <para>&krusader;'s internal editor has almost + everything that 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 + default 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 quite self-explanatory. ;-)</para> + <!-- FILE menu --> + <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 another 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 + <literal role="extension">HTML</literal> format.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>P</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Print</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Print the file.</para> + </listitem> + </varlistentry> + </variablelist> + <!-- EDIT menu --> + <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>Block Selection Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggle Block Selection, which will + activate/deactivate the block selection + possibility.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>Insert</keycap> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Overwrite Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggle Insert/Overwrite 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 line number.</para> + </listitem> + </varlistentry> + </variablelist> + <!-- VIEW menu --> + <variablelist id="kredit_view_menu"> + <title> + <guimenu>View</guimenu>menu</title> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F7</keycap> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Switch to Command Line.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Display Command Line.</para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Schema.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Set Schema ⪚ &krusader; + Normal, &krusader; Printing, &kate; + Normal, &kwrite; Normal.</para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F10</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> + <guimenu>View</guimenu> + <guimenuitem>Dynamic Word Wrap Indicators</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Off, Follow Line Numbers, Always On.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Shows Static Word Wrap + marker</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F6</keycap> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Show Icon Border</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows 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>Show Scrollbar Marks.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F9</keycap> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Hide Folding Markers</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Code Folding.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Set Encoding</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>⪚ ISO8859-1, utf8, utf16, tscii, ... + .</para> + </listitem> + </varlistentry> + </variablelist> + <!-- BOOKMARKS menu --> + <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>Set Bookmark</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Bookmark</guimenu> + <guimenuitem>Clear All Bookmarks</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <!-- These entries are gone on my system with kde3.3.2 + +<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> + <!-- TOOLS menu --> + <variablelist id="kredit_tools_menu"> + <title> + <guimenu>Tools</guimenu>menu</title> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Read Only Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Filetype Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Highlight mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Highlight mode for scripts, programming languages, + markup file, &etc;: ⪚ + <literal role="extension">HTML, Bash, C++, XML, Makefile, + Diff, ...</literal>.</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></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></para> + <!-- TODO--> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Clean Indentation</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO--> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>D</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>D</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> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Uppercase</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Lowercase</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Capitalize</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>J</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Join Lines</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Word Wrap Document</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO--> + </listitem> + </varlistentry> + </variablelist> + <!-- SETTINGS -> CONFIGURE EDITOR menu --> + <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>Indentation</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Indentation configuration: Automatically indent, + use Spaces to indent, 	 Keys indent, + &Backspace; key unindents, 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., + Whitespace 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: ⪚ kTexteditor + incremental search plugin, kTexteditor insert file + plugin, kTexteditor kdatatoolplugin...</para> + </listitem> + </varlistentry> + </variablelist> + <!-- KRVIEWER menu --> + <variablelist id="kredit_krviewer_menu"> + <title> + <guimenu>KrViewer</guimenu>menu</title> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <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; (⪚ + 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;&Shift; + <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;&Shift; + <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> + <keycombo action="simul">&Alt; + <keycap>Right</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Next Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Next browsing Tab.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>Left</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Previous Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Previous browsing Tab.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>D</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Detach Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Detach browsing Tab and open in a new + window.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut>&Esc;</shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Close current Tab.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Close current browsing Tab.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut>&Ctrl; + <keycap>Q</keycap></shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Close</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Closes &krusader;'s viewer/editor + window.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> +</sect1> |