faq.docbook

LINUX 下, 以 QT/KDE 写的档案管理员

              <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, &eg; 
          <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 &amp; 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
          &lt;Last Session&gt; 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-&gt;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 
              <guibutt