<!-- ********************************************************************** copyright : (C) 2000-2018 Rafi Yanai, Shie Erlich, Frank Schoolmeesters & the Krusader Krew e-mail : krusader-devel@googlegroups.com web site : https://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. * *********************************************************************** --> <chapter id="faq"> <title>Frequently Asked Questions (&FAQ;)</title> <indexterm> <primary>FAQ</primary> </indexterm> <para>If you have problems with &krusader; please check the <link linkend="installation">Installation procedure</link>, 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 &plasma; to run?</para> </question> <answer> <para> <emphasis>No, &krusader; does not need the &plasma; window manager</emphasis> to run on your computer but &krusader;'s natural environment is &plasma;, because it relies on services provided by the &kf5-full; base libraries. Only some shared libraries are needed ⪚ &kf5; libraries, &Qt; libraries, &etc; This means that &krusader; runs on <ulink url="http://www.gnome.org"><application>GNOME</application></ulink>, <ulink url="http://www.afterstep.org/"><application>AfterStep</application></ulink>, <ulink url="http://www.xfce.org/"><application>XFce</application></ulink> and other window managers provided the appropriate 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 &plasma; window manager to use &krusader;; you can still use <ulink url="http://www.gnome.org"><application>GNOME</application></ulink>, <ulink url="http://www.afterstep.org/"><application>AfterStep</application></ulink>, <ulink url="http://www.xfce.org/"><application>XFce</application></ulink> or another window manager. However, the configuration of the &krusader; fonts and some behavior is done by running <command>systemsettings</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 &kf5; KIO Slaves to access remote file systems, and support for only a limited number of file system types are shipped with &kf5; libraries, most of the KIO Slave are bundled with &kf5-full; (including fish, sftp and tar).</para> <para></para> <!-- Empty line to make it more readable --> <para>To summarize, if you want a working &krusader; - install &kf5-full;. If you want a functional &krusader; then you need &kf5-full; and some additional &plasma; packages. For maximum functionality, &krusader; needs some &kde; Applications (&ark;, &kdiff3;, <application>KRename</application>), but the &plasma; 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-compiler &gcc; when you compile &krusader; from source (see the next question).</para> <para>Take a look at the <link linkend="compilation">&krusader; dependencies</link> paragraph of our install chapter.</para> <para> If you need more details please take a look at the <ulink url="http://packages.ubuntu.com/precise/krusader">&krusader; requirements</ulink> on Ubuntu. The "depends" are required, the "suggests" make &krusader; more powerful.</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>make</command> complains about missing libs or headers. What do I need to do?</para> </question> <answer> <para>Install the missing packages.</para> <para>Take a look at the <link linkend="compilation">Compilation requirements</link> paragraph of our install chapter.</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 <trademark class="registered">Debian</trademark> based distributions. These are usually included with your distribution. <tip> <para>If you cannot find the needed package, use <ulink url="http://rpmfind.net/linux/rpm2html/search.php?query=krusader&submit=Search+...">rpmfind</ulink> 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 <trademark class="registered">Debian</trademark> 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 am 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 <ulink url="http://www.rpm.org/">rpm.org</ulink> and read the <ulink url="http://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/index.html">RPM Guide</ulink> 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 am trying to install binary foo (RPM or DEB package), but it fails. What is 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 <ulink url="http://freshmeat.net/projects/krusader/">freshmeat.net</ulink> or <ulink url="http://www.kde-apps.org/content/show.php?content=10214">KDE-APPS.org</ulink>. If you still cannot find the appropriate package for your &Linux; distribution, we recommend searching for it with <ulink url="http://rpmfind.net/linux/rpm2html/search.php?query=krusader&submit=Search+...">rpmfind</ulink> or <ulink url="http://rpm.pbone.net/index.php3/stat/3/search/krusader">rpmpbone</ulink>.</para> <para>In general, a package for an older version of your distribution 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 cannot 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 cannot find an RPM or DEB package for &krusader;, what to do?</para> </question> <answer> <para>Check if your distribution provides &krusader;, if it does not then contact your distribution creator and ask them to include &krusader;!</para> <para>Did you take a look at the &URL;s on the <link linkend="installation">Installation procedure</link> page? If you have and found nothing, you can always compile &krusader; from source. Even if you feel you have not 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 <link linkend="faqi_help_request">help request</link> if you encounter problems.</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 is wrong?</para> </question> <answer> <para>The <filename>krusaderui.rc</filename> file is stored in <filename> /usr/share/kxmlgui5/krusader/krusaderui.rc</filename>. When you change the <guilabel>Toolbar</guilabel>, &plasma; makes a copy of that file in the home folder at <filename> ~/.local/share/kxmlgui5/krusader/krusaderui.rc</filename>. If &krusader; was previously installed on your computer, and you install a newer &krusader; version the <filename> ~/.local/share/kxmlgui5/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, &plasma; will automatically replace the old <filename> ~/.local/share/kxmlgui5/krusader/krusaderui.rc</filename> with the newer version when starting the new &krusader; for the first time (&plasma; will detect the newer version number in the first line).</para> <para>If you install a development 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> ~/.local/share/kxmlgui5/krusader/krusaderui.rc</option> </userinput></para> <para>If the <filename> ~/.local/share/kxmlgui5/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> <note> <para> The default folder for the local configuration file <filename>kxmlgui5/krusaderui.rc</filename> is <filename class="directory">~/.local/share</filename>. You can determine the needed folder in your system using the <userinput>qtpaths --paths GenericDataLocation</userinput> command in terminal. </para> </note> <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 <link linkend="faq">FAQ</link>. If you cannot 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 <ulink url="http://groups.google.com/group/krusader-users">&krusader;-users</ulink> mailing list. But before posting a help request, please try the following: <orderedlist> <listitem> <para>Use the search function on the <ulink url="https://forum.kde.org/viewforum.php?f=225">&kde; Forum</ulink>, your problem might be solved or discussed already.</para> </listitem> <listitem> <para>If you cannot 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 <ulink url="http://www.rpm.org/">rpm.org</ulink> and in the <ulink url="http://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/index.html">RPM Guide</ulink> 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>krusader-1.xx.tar.gz</filename> to <filename class="directory"> /usr/scr/RPM/SOURCE</filename></para> </listitem> <listitem> <para>Copy <filename>krusader.spec</filename> to <filename class="directory"> /usr/scr/RPM/SPECS</filename></para> </listitem> <listitem> <para>Edit <filename>krusader.spec</filename> and add your name, your email 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_git_version"> <para>Why does &krusader;-git 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;-git will show an older version number, so ignore the version number and check the download date. We simply have not yet decided what the next version number will be.</para> <para></para> <!-- Empty line to make it more readable --> </answer> </qandaentry> <qandaentry> <question id="faqi_mac_dbus"> <para>Why does &krusader; not start on &MacOS;?</para> </question> <answer> <para>Please read carefully the <ulink url="http://www.macports.org/">macports.org</ulink> installation instructions. Do not forget to start <application>dbus</application>. <screen>########################################################## # Do not forget that dbus needs to be started as the local # user (not with sudo) before any KDE programs will launch # To start it run the following command: # launchctl load /Library/LaunchAgents/org.freedesktop.dbus-session.plist ########################################################## ###################################################### # Programs will not start until you run the command # 'sudo chown -R $USER ~/Library/Preferences/KDE' # replacing $USER with your username. ###################################################### </screen></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_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 do not hang the entire application event loop, but we do not think that the time is right for adding threads, we are not sure that *all* the &kf5; 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 cannot 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>Settings</guimenu> <guimenuitem>Show FN Keys Bar</guimenuitem> </menuchoice> and you will 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_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> You can try to configure smb.conf with appropriate &systemsettings; module.</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"> /usr/{lib or lib64}/qt5/plugins</filename></para> <para>Copy the <filename>krarc.protocol</filename> file into <filename class="directory"> /usr/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 &kf5; 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. Do not forget to run <command># ldconfig</command> on this directory when you are done.</para> <para></para> <!-- Empty line to make it more readable --> </answer> </qandaentry> <qandaentry> <question id="faqu_external_tool"> <para>What to do if an external tool does not 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 <link linkend="konfig-dependencies">Konfigurator Dependencies page</link>. 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 <link linkend="konfig-protocols">Konfigurator Protocol page</link> If it does not work, backup your <filename><envar>XDG_CONFIG_HOME</envar>/krusaderrc</filename> (default is <filename>$<envar>HOME</envar>/.config/krusaderc</filename>) configuration file and remove it from this location. Restart &krusader;, &krusader; will now start the first start configuration wizard, follow these guidelines. </para> <!-- Empty line to make it more readable --> </answer> </qandaentry> <qandaentry> <question id="faqu_jar"> <para>How to executing jar files (and not enter the jar archive)?</para> </question> <answer> <para>Go to the <link linkend="konfig-protocols">Konfigurator Protocol page</link> and remove <guilabel>application/x-jar</guilabel> from the krarc node, &krusader; should no longer enter the archive. Global file associations are handled by &plasma; and not by &krusader;. To associate the jar extension: <itemizedlist> <listitem> <para>Open &plasma; &systemsettings;: <application>systemsettings</application> </para> </listitem> <listitem> <para> <menuchoice> <guimenu>Applications</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> <!-- 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>System Settings</guimenu> <guimenuitem>Network</guimenuitem> <guimenuitem> Settings</guimenuitem> <guimenuitem>Connection Preferences</guimenuitem> </menuchoice>, <guilabel>Enable Passive Mode (PASV)</guilabel> has to be turned on or off, depending on its 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 <ulink url="http://slacksite.com/other/ftp.html">Active &FTP; vs. Passive &FTP;, a Definitive Explanation</ulink>.</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 &systemsettings;. 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 do not add <literal role="extension">.part</literal> suffix when copying files via &FTP;?</para> </question> <answer> <para>When uploading files a <literal role="extension">.part</literal> suffix is added to the filename, once the upload is complete the filename is renamed automagically to remove the <literal role="extension">.part</literal> suffix. This works great but sometimes some &FTP; servers do not allow a rename operation. You can solve this by unchecking the checkbox <guilabel>Mark partially uploaded files</guilabel> in &plasma; &systemsettings;. The check box is located at <menuchoice> <guimenu>Network</guimenu> <guimenuitem>Settings</guimenuitem> <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 is 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>The media:/ protocol was removed since &kde; 4. Please use mtp:/ protocol instead.</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 &plasma; System sounds, and not related to &krusader;. If you want to disable them globally open your &plasma; &systemsettings; ( <application>systemsettings</application>): <menuchoice> <guimenu>Personalization</guimenu> <guisubmenu>Notifications</guisubmenu> <guimenuitem>Manage Notifications</guimenuitem> </menuchoice>, <guilabel>Event Source: "Plasma Workspace" </guilabel> and uncheck sound items you do not like.</para> <para></para> <!-- Empty line to make it more readable --> </answer> </qandaentry> <qandaentry> <question id="faqu_remoteMan"> <para>Where the remote connection manager?</para> </question> <answer> <para>Use our Bookmark Manager. Use a <link linkend="remote-connections">remote &URL;</link> and bookmark it.</para> <para></para> <!-- Empty line to make it more readable --> </answer> </qandaentry> <qandaentry> <question id="faqu_mimetypemagic_archives"> <para>Why does not MIME type 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 System Settings</guimenu> <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 &plasma; to use it?</para> </question> <answer> <para><link linkend="konfigurator">Konfigurator</link> is &krusader;s configuration module, if you have installed &krusader; then you have also Konfigurator. For some reason some people think it is an other &plasma; application, but it is not, so you do not need to install the full fledged &plasma; to use Konfigurator. When running &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 ~/.config/krusaderrc /home/foo_user/.config</command></userinput></screen> And when the other user is Root use: <screen><prompt>#</prompt> <userinput><command>cp ~/.config/krusaderrc /root/.config</command></userinput></screen> </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 is 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 krusader-users <ulink url="https://krusader.org/get-involved/mailing-lists/index.html">mailing list</ulink>. For information on what remains to be done look at the <ulink url="http://groups.google.com/group/krusader-devel">&krusader;-devel mailing list</ulink>. We review and discuss every submission.</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 is 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>Preferably, you can start a discussion with the developers on the krusader-devel <ulink url="https://krusader.org/get-involved/mailing-lists/index.html">mailing lists</ulink> or on the <ulink url="https://phabricator.kde.org/tag/krusader/">&krusader; Phabricator page</ulink>. Unfortunately, we cannot 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 the &krusader; group on the <ulink url="https://git.reviewboard.kde.org/groups/krusader/">Review Board</ulink>, so that all patch proposals stay organised and do not 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 <ulink url="https://git.reviewboard.kde.org/groups/krusader/">Review Board</ulink>, 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 (<trademark class="copyright">FreeBSD</trademark>/<trademark class="registered">NetBSD</trademark>/<trademark class="registered">OpenBSD</trademark>/&MacOS;).</para> </listitem> <listitem> <para>&kde; 3.3- &kde; 3.5 and even on GNOME with &kde;libs (for &krusader;-2.x) .</para> </listitem> <listitem> <para>GCC 2.95 - GCC 5.4</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> <emphasis role="bold">Check</emphasis> if the bug is already posted in the <ulink url="https://bugs.kde.org">online bug list</ulink> of the Bug Tracking System.</para> </listitem> <listitem> <para>If you cannot 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 KIO Slaves or &kf5-full; bug, and not a &krusader; bug. &krusader; uses the &kf5; libraries and the KIO Slave 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 --> <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;-git, compile &krusader;-git in debugmode and install it, than check if the bug still exist. <screen><prompt>$</prompt> <userinput><command>cmake</command> <option>-DCMAKE_BUILD_TYPE=debugfull</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 information before the crash, it is almost sure, that we may fix or tell you what to do. </para> <!-- Empty line to make it more readable --> </answer> </qandaentry> <qandaentry> <question id="faqg_crashhandler"> <para>What to do if the KDEcrashhandler sends no useful 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;-git, compile &krusader;-git in debugmode and install it, than check if the bug still exist. <screen><prompt>$</prompt> <userinput><command>cmake</command> <option>-DCMAKE_BUILD_TYPE=debugfull</option></userinput></screen> If the KDEKrashhandler still does not provide useful 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 valgrind tool. </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 5 <ulink url="https://krusader.org/get-involved/mailing-lists/index.html">mailing lists</ulink>. 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 do not even need to subscribe to follow the action on the mailing lists. <itemizedlist> <listitem> <para><ulink url="http://groups.google.com/group/krusader-devel">&krusader;-devel</ulink> 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><ulink url="http://groups.google.com/group/krusader-users">&krusader;-users</ulink> is the &krusader; users mailing list. Here you can ask for help and talk with the &krusader; users and developers.</para> </listitem> </itemizedlist></para> <para></para> <!-- Empty line to make it more readable --> </answer> </qandaentry> <qandaentry> <question id="faqg_newsfeeds"> <para>Does &krusader; provide news feeds?</para> </question> <answer> <para>Yes, we do. Several news feeds in various formats are available. <ulink url="http://groups.google.com/group/krusader-devel/feeds">krusader-devel feed</ulink>, <ulink url="http://groups.google.com/group/krusader-users/feeds">krusader-users feed</ulink>.</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 <ulink url="http://freenode.net">freenode.org</ulink> 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>, <link linkend="faq">FAQ</link> and <ulink url="http://groups.google.com/group/krusader-devel">&krusader;-devel</ulink> (please use the search function ) cannot 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 search function of the <ulink url="https://forum.kde.org/viewforum.php?f=225">&kde; Forum</ulink>, 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 is why we have created this <link linkend="faq">FAQ</link>. This allows us to spend more time developing &krusader;.</para> <!-- <para>The <ulink url="http://www.krusader.org/phpBB/index.php">&krusader; Forum</ulink> is split into seven sections: <itemizedlist> <listitem> <para><ulink url="http://www.krusader.org/phpBB/viewforum.php?f=7">News and Announcements Forum</ulink>: all the latest news.</para> </listitem> <listitem> <para><ulink url="http://krusader.sourceforge.net/phpBB/viewforum.php?f=12">NewsLetter Forum</ulink>: all newsletters.</para> </listitem> <listitem> <para><ulink url="http://www.krusader.org/phpBB/viewforum.php?f=3">Bug Discussion Forum</ulink>: discussions about bugs, please DO NOT use the forum for <link linkend="faqg_bug_report">bug reports</link> (except if you are unsure if you have found a bug).</para> </listitem> <listitem> <para><ulink url="http://www.krusader.org/phpBB/viewforum.php?f=6">New Features Discussion/Requests Forum</ulink>: discussions about new features for future &krusader; versions.</para> </listitem> <listitem> <para><ulink url="http://www.krusader.org/phpBB/viewforum.php?f=10">ToDo Forum</ulink> 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 do not care about a feature just simply do not vote on that feature. Unregistered users may only browse the <ulink url="http://www.krusader.org/phpBB/viewforum.php?f=10">ToDo Forum</ulink>. The <ulink url="http://www.krusader.org/todo.php">ToDo ranking system</ulink> 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><ulink url="http://www.krusader.org/phpBB/viewforum.php?f=11">UserActions Forum</ulink>: discussions about <link linkend="useractions">UserActions</link>. Posting your own User Actions is greatly appreciated. We plan to include the best ones in the next &krusader; releases.</para> </listitem> <listitem> <para><ulink url="http://www.krusader.org/phpBB/viewforum.php?f=1">General Discussion Forum</ulink>: everything that is &krusader; related and does not belong in the other forums.</para> </listitem> </itemizedlist></para>--> <para>Thank you for your co-operation!</para> <!--<para>We provide a <ulink url="http://krusader.sf.net/phpBB/rss.php">RSS feed</ulink> for our forums. You do not have to check for new posts all the time, instead the news will come to you!</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>If you are interested in translating the &krusader; GUI or documentation, please contact the <ulink url="http://l10n.kde.org/teams-list.php">KDE translation team</ulink> of your language.</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>, <link linkend="faqg_bug_report">bug reports</link>, 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 a <link linkend="kde4_mac_install">&MacOS;-X port</link> with the help of <ulink url="http://www.macports.org/">macports.org</ulink> , the port is maintained by <ulink url="http://www.krusader.org/developers.php">Jonas Bähr</ulink>, all feedback is welcome. A recommended native file manager for &MacOS; is <ulink url="http://www.likemac.ru/english/"><trademark class="copyright">Disk Order</trademark></ulink> (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> <!-- the port is unavailable now <para>Yes, there is a <link linkend="kde4_win_install">&Windows; port</link> since 18 June 2008. Before &krusader; can be used several &Qt;4-libraries and &kde;4-libraries need to be installed.--> <para>No, there was a port but it is unmaintained and unavailable now. A recommended native file manager for &Windows; is <ulink url="http://www.ghisler.com/"><trademark class="copyright">Total Commander</trademark></ulink> (shareware).</para> <para>If you want to help with porting please join <ulink url="http://windows.kde.org/">The KDE on Windows Initiative</ulink>. Some useful tips on porting can be found in the <ulink url="https://commits.kde.org/krusader?path=INSTALL"><filename>INSTALL</filename></ulink> file of the &krusader; sources, it contains all latest compilation instructions.</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 <ulink url="http://www.softpanorama.org/OFM/index.shtml">Orthodox File Manager (OFM)</ulink> 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>