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

1 files changed, 289 insertions, 0 deletions

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>&amp;</literal> to the bookmark name
+    &eg; 
+    <literal>&amp;sourceforge, &amp;home,
+    down&amp;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>&eg; 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
+    &eg; 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 &eg; the 
+        <guilabel>Feed to Listbox</guilabel> feature of the search
+        module and the synchronizer. The location toolbar will
+        display &eg; 
+        <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>