faq.docbook

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

<chapter id="faq">
  <!-- **********************************************************************
                               faq.docbook
                          ++++++++++++++++++++
  copyright            : (C) 2000 - 2008
                          Rafi Yanai, Shie Erlich, Frank Schoolmeesters
                          & the Krusader Krew
  e-mail               : [e-mail]
  web site             : http://www.krusader.org
  description          : a Krusader Documentation File

***************************************************************************
* Permission is granted to copy, distribute and/or modify this            *
* document under the terms of the GNU Free Documentation License,         *
* Version 1.1 or any later version published by the Free Software         *
* Foundation; with no Invariant Sections, no Front-Cover Texts and        *
* no Back-Cover Texts.  A copy of the license is available on the         *
* GNU site http://www.gnu.org/licenses/fdl.html or by writing to:         *
* Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,    *
* MA 02111-1307, USA.                                                     *
*********************************************************************** -->
  <title>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 &eg;
          &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; (&eg;
          when you have installed &krusader; with a
          binary RPM) you need less libraries than if you compile
          &krusader; from source. &eg; 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 (&eg; 
          <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>&lt;/path/to/rpmfile/&gt; 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>&lt;/path/to/rpmfile&gt; 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>&lt;/path/to/rpmfile&gt; 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