faq.docbook

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

          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
                (&eg; 
                <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 (&eg; 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> &eg; 
                <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 &eg;
          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