Warning, /utilities/krusader/doc/handbook/faq.docbook is written in an unsupported language. File is not indexed.

0001 <!--
0002     SPDX-FileCopyrightText: 2000-2003 Shie Erlich <erlich@users.sourceforge.net>
0003     SPDX-FileCopyrightText: 2000-2003 Rafi Yanai <yanai@users.sourceforge.net>
0004     SPDX-FileCopyrightText: 2004-2010 Frank Schoolmeesters <codeknight@users.sourceforge.net>
0005     SPDX-FileCopyrightText: 2000-2022 Krusader Krew <https://krusader.org>
0006 -->
0007 <chapter id="faq">
0008   <title>Frequently Asked Questions (&FAQ;)</title>
0009   <indexterm>
0010     <primary>FAQ</primary>
0011   </indexterm>
0012   <para>If you have problems with &krusader; please
0013   check the
0014   <ulink url="https://krusader.org/get-involved/index.html">installation
0015   procedure</ulink>, as your problem may be
0016   caused by a bad installation.</para>
0017   <para>The &FAQ; is divided into three sections: 
0018   <itemizedlist>
0019     <listitem>
0020       <para>
0021       <link linkend="faq_installation">Installation
0022       &FAQ;</link> (this page)</para>
0023     </listitem>
0024     <listitem>
0025       <para>
0026       <link linkend="faq_usage">Usage
0027       &FAQ;</link> (issues with running/using
0028       &krusader;)</para>
0029     </listitem>
0030     <listitem>
0031       <para>
0032       <link linkend="faq_general">General
0033       &FAQ;</link> (bug reports, forum, mailing list,
0034       ...)</para>
0035     </listitem>
0036   </itemizedlist>If you feel that a &FAQ; is missing or
0037   if something is not clear to you, please 
0038   <link linkend="editors_note">let us know</link>.</para>
0039   <sect1 id="faq_installation">
0040     <title>Installation &FAQ;</title>
0041     <qandaset>
0042       <qandaentry>
0043         <question id="faqi_kdelibs">
0044           <para>Does &krusader; need &plasma; to
0045           run?</para>
0046         </question>
0047         <answer>
0048           <para>
0049           <emphasis>No, &krusader; does not need the
0050           &plasma; window manager</emphasis> to run on your
0051           computer but &krusader;'s natural environment
0052           is &plasma;, because it relies on services
0053           provided by the &kf5-full; base libraries. Only
0054           some shared libraries are needed &eg;
0055           &kde-frameworks; libraries, &Qt; libraries,
0056           &etc; This means that &krusader;
0057           runs on <ulink url="https://www.gnome.org"><application>GNOME</application></ulink>,
0058           <ulink url="http://www.afterstep.org/"><application>AfterStep</application></ulink>, <ulink url="https://www.xfce.org/"><application>XFce</application></ulink> and
0059           other window managers provided the appropriate libraries
0060           are installed on your computer. All this is not a problem
0061           since the apt-get world can resolve these dependencies
0062           instantly.</para>
0063           <para></para>
0064           <!-- Empty line to make it more readable -->
0065           <para>You do not need to switch to the &plasma;
0066           window manager to use &krusader;; you can
0067           still use <ulink url="https://www.gnome.org"><application>GNOME</application></ulink>,
0068           <ulink url="http://www.afterstep.org/"><application>AfterStep</application></ulink>, <ulink url="https://www.xfce.org/"><application>XFce</application></ulink> or
0069           another window manager. However, the configuration of the
0070           &krusader; fonts and some behavior is done by
0071           running 
0072           <command>systemsettings</command>.</para>
0073           <para></para>
0074           <!-- Empty line to make it more readable -->
0075           <para>A lot depends on what you want to do with
0076           &krusader;. You should know that
0077           &krusader; uses the &kde-frameworks;
0078           KIO Slaves to access remote file
0079           systems, and support for only a limited number of file
0080           system types are shipped with &kde-frameworks; libraries,
0081           most of the KIO Slave are bundled with
0082           &kf5-full; (including fish, sftp and tar).</para>
0083           <para></para>
0084           <!-- Empty line to make it more readable -->
0085           <para>To summarize, if you want a working
0086           &krusader; - install &kf5-full;. If
0087           you want a functional &krusader; then you need
0088           &kf5-full; and some additional &plasma; packages. For maximum
0089           functionality, &krusader; needs some &kde; Applications
0090           (&ark;, &kdiff3;, <application>KRename</application>), but the
0091           &plasma; window manager is optional.</para>
0092           <para></para>
0093           <!-- Empty line to make it more readable -->
0094         </answer>
0095       </qandaentry>
0096       <qandaentry>
0097         <question id="faqi_rpm-notfound">
0098           <para>I cannot find a package for
0099           &krusader;, what to do?</para>
0100         </question>
0101         <answer>
0102           <para>Check if your distribution provides
0103           &krusader;, if it does not then contact your
0104           distribution creator and ask them to include
0105           &krusader;!</para>
0106           <para>Did you take a look at the
0107           <ulink url="https://krusader.org/get-involved/index.html">installation
0108           procedure</ulink> page? If you have and
0109           found nothing, you can always compile
0110           &krusader; from source. Feel free
0111           to post a <link linkend="faqi_help_request">help request</link> if you encounter
0112           problems.</para>
0113           <para></para>
0114           <!-- Empty line to make it more readable -->
0115         </answer>
0116       </qandaentry>
0117  
0118       <qandaentry>
0119         <question id="faqi_help_request">
0120           <para>I am having trouble compiling and installing
0121           &krusader;, how do I send a help
0122           request?</para>
0123         </question>
0124         <answer>
0125           <para>Please read our detailed 
0126           <ulink url="https://krusader.org/get-involved/index.html">installation
0127           procedure</ulink> and the <link linkend="faq">FAQ</link>. If you
0128           cannot find a solution to your problem then feel free to
0129           post a 
0130           <emphasis role="bold">help request</emphasis> at our
0131           &krusader; forum or use the
0132           <ulink url="https://groups.google.com/group/krusader-users">&krusader;-users</ulink> mailing list. But before
0133           posting a help request, please try the following: 
0134           <orderedlist>
0135             <listitem>
0136               <para>Use the search function on the <ulink url="https://forum.kde.org/viewforum.php?f=225">&kde; Forum</ulink>, your problem
0137               might be solved or discussed already.</para>
0138             </listitem>
0139             <listitem>
0140               <para>If you cannot find a solution, please make a
0141               note of the following issues: 
0142               <itemizedlist>
0143                 <listitem>
0144                   <para>the &krusader; version
0145                   used</para>
0146                 </listitem>
0147                 <listitem>
0148                   <para>the &Linux; distribution +
0149                   version used</para>
0150                 </listitem>
0151                 <listitem>
0152                   <para>a good description of the problem</para>
0153                 </listitem>
0154               </itemizedlist>Without this information, it is very
0155               difficult for us to help you. 
0156               <note>
0157                 <para>If you give us the error messages
0158                 (&eg; 
0159                 <command>make</command> error messages) please start
0160                 with the FIRST error message, all the error
0161                 messages which follow the first error message are
0162                 consequences and not the cause of your
0163                 problem.</para>
0164               </note></para>
0165             </listitem>
0166             <listitem>
0167               <para>Send out your help request.</para>
0168             </listitem>
0169           </orderedlist></para>
0170           <para>Thank you for your co-operation!</para>
0171           <para></para>
0172           <!-- Empty line to make it more readable -->
0173         </answer>
0174       </qandaentry>
0175       <qandaentry>
0176         <question id="faqi_git_version">
0177           <para>Why does &krusader;-git show an old
0178           version number in the about box?</para>
0179         </question>
0180         <answer>
0181           <para>Because we only change the version number just
0182           before we do a new release. &krusader;-git
0183           will show an older version number, so ignore the version
0184           number and check the download date. We simply have not yet
0185           decided what the next version number will be.</para>
0186           <para></para>
0187           <!-- Empty line to make it more readable -->
0188         </answer>
0189       </qandaentry>
0190  </qandaset>
0191   </sect1>
0192   <sect1 id="faq_usage">
0193     <title>Usage &FAQ;</title>
0194     <qandaset>
0195       <qandaentry>
0196         <question id="faqu_dead_mountpoint">
0197           <para>Why does &krusader; freeze or hang on a
0198           dead mountpoint?</para>
0199         </question>
0200         <answer>
0201           <para>When &krusader; is &eg;
0202           browsing an &NFS; share and the &NFS; server goes down,
0203           &krusader; will freeze. This
0204           &krusader; (and all other open internal
0205           viewers/editors) freeze is fatal, and can only be
0206           corrected with the 
0207           <command>kill -9</command>. We have no solution for this.
0208           This is an issue not confined to file managers, or even
0209           the &Linux; OS! The problem is that you <quote>hang</quote>
0210           on the first access to the dead share - so there is no
0211           way around it, no check to avoid it, even 
0212           <command>ls</command> will freeze. Just trying to read
0213           something - anything - is enough to get you stuck. The
0214           one and only way around this architectural problem is
0215           using a multi-threaded design - this way if we get stuck,
0216           we do not hang the entire application event loop, but we
0217           do not think that the time is right for adding threads, we
0218           are not sure that *all* the &kde-frameworks; systems out
0219           there are using &Qt;-mt (the multi threaded
0220           version of the &Qt; library), and the &krusader;
0221           Krew may not be the right people to address this major
0222           issue in any case; so currently this is just a bug we
0223           have to learn to live with.</para>
0224           <para></para>
0225           <!-- Empty line to make it more readable -->
0226         </answer>
0227       </qandaentry>
0228       <qandaentry>
0229         <question id="faqu_resize">
0230           <para>When I try to resize &krusader; to make
0231           it smaller, I discover that I cannot resize it below a
0232           certain size. Why?</para>
0233         </question>
0234         <answer>
0235           <para>See the 
0236           <guibutton>F1, F2</guibutton> (&etc;) buttons?
0237           They are not allowing &krusader; to downsize
0238           as they have a minimum size. Just disable them 
0239             <menuchoice>
0240               <guimenu>Settings</guimenu>
0241               <guimenuitem>Show FN Keys Bar</guimenuitem>
0242             </menuchoice>
0243           and you will be able to resize
0244           &krusader; to your liking. Since version 1.51
0245           we have improved this greatly: when downsizing the
0246           buttons will look like 'F5 ..py'. When the button faces
0247           are too small to read a tooltip will give the complete
0248           text. The minimum width is 45 pixels for each
0249           button.</para>
0250           <para></para>
0251           <!-- Empty line to make it more readable -->
0252         </answer>
0253       </qandaentry>
0254 
0255       <qandaentry>
0256         <question id="faqu_samba_codepage">
0257           <para>
0258           &Samba; ISO 8859-x codepage /
0259           What to do if &krusader; does not read shared
0260           folders containing special international
0261           characters?</para>
0262         </question>
0263         <answer>
0264           <para>&krusader; does not handle (yet) 
0265           &Samba; ISO 8859-x codepages, if
0266           you use a codepage different than 8859-1 you will have to
0267           do a manual configuration. Create or modify the file: 
0268           <filename>~/.smb/smb.conf</filename>
0269           <programlisting>[global] 
0270           workgroup = MyWorkGroup (ex. WORKGROUP) 
0271           client code page = MyCodePage (ex. 852)
0272           character set = MyCharSet (ex. ISO8859-2)
0273           </programlisting>
0274           You can try to configure smb.conf with appropriate 
0275           &systemsettings; module.</para>
0276           <para></para>
0277           <!-- Empty line to make it more readable -->
0278         </answer>
0279       </qandaentry>
0280       
0281 <qandaentry>
0282   <question id="faqu_external_tool">
0283   <para>What to do if an external tool does not seem to work?</para>
0284   </question>
0285   <answer>
0286   <para>&krusader; uses several programs as <link linkend="konfig-dependencies">external tools</link>, 
0287         and sometimes they appear not to work.
0288         
0289        Open a terminal and check if tool foo is installed.
0290        <screen><prompt>$</prompt> <userinput><command>foo</command></userinput></screen> 
0291 
0292        Check if tool foo is properly configured in the <link linkend="konfig-dependencies">Konfigurator Dependencies page</link>.
0293 
0294        For Archiving tools: autodetect the archives again with the <guibutton>Auto Configure</guibutton> button
0295        in the <link linkend="konfig-archives">Konfigurator archive page</link>. 
0296        
0297        Check the <link linkend="konfig-protocols">Konfigurator Protocol page</link>
0298    
0299        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.
0300      Restart &krusader;, &krusader; will now start the first start configuration wizard, follow these guidelines.
0301    
0302     </para>
0303   <!-- Empty line to make it more readable -->
0304   </answer>
0305 </qandaentry>
0306 
0307 <qandaentry>
0308   <question id="faqu_jar">
0309   <para>How to executing jar files (and not enter the jar archive)?</para>
0310   </question>
0311   <answer>
0312   <para>Go to the <link linkend="konfig-protocols">Konfigurator Protocol page</link> and remove <guilabel>application/x-jar</guilabel> 
0313         from the krarc node, &krusader; should no longer enter the archive.
0314         Global file associations are handled by &plasma; and not by &krusader;.
0315         To associate the jar extension:
0316         <itemizedlist>
0317             <listitem>
0318               <para>Open &plasma; &systemsettings;: <application>systemsettings</application>
0319               </para>
0320             </listitem>
0321             <listitem>
0322               <para>
0323                <menuchoice>
0324                  <guimenu>Applications</guimenu>
0325                  <guimenuitem>File Associations</guimenuitem>
0326               </menuchoice>
0327               </para>
0328             </listitem>
0329             <listitem>
0330               <para>Enter <filename>jar</filename> as filename pattern
0331               </para>
0332             </listitem>
0333             <listitem>
0334               <para>Add <filename>java</filename> as application
0335               </para>
0336             </listitem>
0337            </itemizedlist>
0338    </para>
0339   <!-- Empty line to make it more readable -->
0340   </answer>
0341 </qandaentry>
0342 
0343       <!-- Thanks to Dirk Eschler -->
0344       <qandaentry>
0345         <question id="faqu_ftp_firewall">
0346           <para>Why do I have trouble with my &FTP;
0347           connection?</para>
0348         </question>
0349         <answer>
0350           <para>This problem often occurs when you are behind a
0351           firewall or proxy. Open 
0352             <menuchoice>
0353               <guimenu>System Settings</guimenu>
0354               <guimenuitem>Network</guimenuitem>
0355               <guimenuitem> Settings</guimenuitem>
0356               <guimenuitem>Connection Preferences</guimenuitem>
0357             </menuchoice>, 
0358           <guilabel>Enable Passive Mode (PASV)</guilabel> has to
0359           be turned on or off, depending on its current setting.
0360           Now try your &FTP; session again to see if it
0361           works. Also, make sure you have no other &FTP;
0362           sessions open (using web browsers, &etc;), they can cause
0363           complications. More information can be found in
0364           <ulink url="https://slacksite.com/other/ftp.html">Active &FTP; vs. Passive &FTP;, a Definitive Explanation</ulink>.</para>
0365           <para></para>
0366           <!-- Empty line to make it more readable -->
0367         </answer>
0368       </qandaentry>
0369       <!-- Thanks to Karai Csaba -->
0370       <qandaentry>
0371         <question id="faqu_ftp_http_proxy">
0372           <para>I get 
0373           <errorcode>&FTP; protocol not supported by
0374           &krusader;</errorcode> error when trying to
0375           open a remote &FTP; folder, what to
0376           do?</para>
0377         </question>
0378         <answer>
0379           <para>The reason for this error is that '&FTP;
0380           via &HTTP; proxy' feature is not yet supported
0381           by &krusader;. This error may be caused by a
0382           misconfiguration of the proxy settings in
0383           &systemsettings;. Modify the proxy settings to
0384           not use &HTTP; proxy and &FTP; will
0385           work.</para>
0386           <para></para>
0387           <!-- Empty line to make it more readable -->
0388         </answer>
0389       </qandaentry>
0390 
0391       <qandaentry>
0392         <question id="faqu_no_part">
0393           <para>How do not add <literal role="extension">.part</literal> suffix when copying files via &FTP;?</para>
0394         </question>
0395         <answer>
0396           <para>When uploading files a <literal role="extension">.part</literal> suffix is added to the filename,
0397                 once the upload is complete the filename is renamed automagically 
0398                 to remove the <literal role="extension">.part</literal> suffix.
0399                 This works great but sometimes some &FTP; servers do not allow a rename operation.
0400                 You can solve this by unchecking the checkbox 
0401                 <guilabel>Mark partially uploaded files</guilabel> in &plasma; &systemsettings;. 
0402                 The check box is located at 
0403                 <menuchoice>
0404                  <guimenu>Network</guimenu>
0405                  <guimenuitem>Settings</guimenuitem>
0406                  <guimenuitem>Connection Preferences</guimenuitem>
0407                 </menuchoice>.</para>
0408           <!-- Empty line to make it more readable -->
0409         </answer>
0410       </qandaentry>
0411 
0412       <qandaentry>
0413         <question id="faqu_close_connection">
0414           <para>How can I close a remote connection
0415           (&eg; a &FTP; connection)?</para>
0416         </question>
0417         <answer>
0418           <para>It is explained in the 
0419           <link linkend="remote-connections">remote connections
0420           chapter</link>.</para>
0421           <para></para>
0422           <!-- Empty line to make it more readable -->
0423         </answer>
0424       </qandaentry>
0425       <qandaentry>
0426         <question id="faqu_media_protocol">
0427           <para>I am experiencing problems with the media:/
0428           protocol, why?</para>
0429         </question>
0430         <answer>
0431           <para>The media:/ protocol was removed since &kde; 4. Please use mtp:/ protocol instead.</para>
0432           <para></para>
0433           <!-- Empty line to make it more readable -->
0434         </answer>
0435       </qandaentry>
0436       <!-- Thanks to thepieman at the Krusader Forum -->
0437       <qandaentry>
0438         <question id="faqu_sound">
0439           <para>How can I disable the default sounds,
0440           &eg; when I do a delete action?</para>
0441         </question>
0442         <answer>
0443           <para>Those are the default &plasma; System
0444           sounds, and not related to &krusader;. If you
0445           want to disable them globally open your &plasma;
0446           &systemsettings; (
0447           <application>systemsettings</application>): 
0448             <menuchoice>
0449               <guimenu>Personalization</guimenu>
0450               <guisubmenu>Notifications</guisubmenu>
0451               <guimenuitem>Manage Notifications</guimenuitem>
0452             </menuchoice>, 
0453           <guilabel>Event Source: "Plasma Workspace"
0454           </guilabel> and uncheck sound items you
0455           do not like.</para>
0456           <para></para>
0457           <!-- Empty line to make it more readable -->
0458         </answer>
0459       </qandaentry>
0460       <qandaentry>
0461         <question id="faqu_remoteMan">
0462           <para>Where the remote connection manager?</para>
0463         </question>
0464         <answer>
0465           <para>Use our Bookmark Manager. Use a  
0466           <link linkend="remote-connections">remote
0467           &URL;</link> and bookmark it.</para>
0468           <para></para>
0469           <!-- Empty line to make it more readable -->
0470         </answer>
0471       </qandaentry>
0472       <qandaentry>
0473         <question id="faqu_mimetypemagic_archives">
0474           <para>Why does not &MIME; type magic sometimes work inside
0475           archives?</para>
0476         </question>
0477         <answer>
0478           <para>When you enter an archive and press 
0479           <keycap>F3</keycap> to view a file that has no known
0480           extension, &eg; 
0481           <filename>README, INSTALL</filename> &etc; And
0482           if the viewer opens in hex-mode instead of the usual
0483           mode, than you need to configure:
0484             <menuchoice>
0485               <guimenu>&kde; System Settings</guimenu>
0486               <guimenuitem>File Associations</guimenuitem>
0487               <guimenuitem>Application</guimenuitem>
0488               <guimenuitem>octet-stream</guimenuitem>
0489             </menuchoice>, 
0490           <guilabel>binary viewer</guilabel> needs to be
0491           removed.</para>
0492           <para></para>
0493           <!-- Empty line to make it more readable -->
0494         </answer>
0495       </qandaentry>
0496 
0497       <qandaentry>
0498         <question id="faqu_konfigurator">
0499           <para>Where is Konfigurator, do i need to install the &plasma; to use it?</para>
0500         </question>
0501         <answer>
0502           <para><link linkend="konfigurator">Konfigurator</link> is &krusader;s configuration module,
0503                 if you have installed &krusader; then you have also Konfigurator.
0504                 For some reason some people think it is an other &plasma; application, but it is not, so
0505                 you do not need to install the full fledged &plasma; to use Konfigurator.
0506                 When running &krusader;, use 
0507                 <menuchoice>
0508                  <guimenu>Settings</guimenu>
0509                  <guimenuitem>Configure &krusader;...</guimenuitem>
0510                 </menuchoice>, and it will start 
0511                 <link linkend="konfigurator">Konfigurator</link>. 
0512                 Please read the manual, &krusader; has many many configuration options, 
0513                 a lot of things can be customized to your needs with <link linkend="konfigurator">Konfigurator</link>. 
0514           </para>
0515           <para></para>
0516           <!-- Empty line to make it more readable -->
0517         </answer>
0518       </qandaentry>
0519 
0520       <qandaentry>
0521         <question id="faqu_equal_lookandfeel">
0522           <para>How can I set the look &amp; feel of 2
0523           different users to be the same?</para>
0524         </question>
0525         <answer>
0526           <para>Presuming that the current setup is the good
0527           configuration, you can copy the configuration to the
0528           other user. 
0529           <screen><prompt>#</prompt> <userinput><command>cp ~/.config/krusaderrc /home/foo_user/.config</command></userinput></screen>
0530           And when the other user is Root use: 
0531           <screen><prompt>#</prompt> <userinput><command>cp ~/.config/krusaderrc /root/.config</command></userinput></screen>
0532           </para>
0533           <para></para>
0534           <!-- Empty line to make it more readable -->
0535         </answer>
0536       </qandaentry>
0537 
0538       <qandaentry>
0539         <question id="faqu_custom_embed_term">
0540           <para>How to customize the embedded terminal of &krusader;?</para>
0541         </question>
0542         <answer>
0543           <para>In order to change properties of the
0544           embedded terminal emulator of &krusader;: you
0545           can right-click on it and choose an option,
0546           and if you don't find there what you are looking
0547           for, you can use the 
0548             <menuchoice>
0549               <guimenu>Settings</guimenu>
0550             </menuchoice>
0551           menu of &konsole;
0552           (because &krusader; uses a &konsole; KPart for its
0553           embedded terminal). In that menu, other items
0554           are seen (like 
0555             <menuchoice>
0556               <guimenuitem>"Manage Profiles..."</guimenuitem>
0557             </menuchoice>).
0558           </para>
0559           <para></para>
0560           <!-- Empty line to make it more readable -->
0561       </answer>
0562       </qandaentry>
0563 
0564     </qandaset>
0565   </sect1>
0566   <sect1 id="faq_general">
0567     <title>General &FAQ;</title>
0568     <qandaset>
0569       <qandaentry>
0570         <question id="faqg_wish">
0571           <para>How can I report a wish, a suggestion, or a
0572           comment?</para>
0573         </question>
0574         <answer>
0575           <para>An open source project's greatest strength is
0576           derived from getting user feedback. That is why we love
0577           to hear what you have to say. Your <quote>gripes</quote> are our
0578           instructions. After about 6 months, programmers can no
0579           longer see their own mistakes. It is natural. We want the
0580           ideas, qritiques, and feedback because we all want to
0581           make &krusader; the best and most useful file
0582           manager available anywhere.</para>
0583           <para>The most convenient way to contact us is to use the krusader-users
0584           <ulink url="https://krusader.org/get-involved/mailing-lists/index.html">mailing list</ulink>. For information on what
0585           remains to be done look at the
0586           <ulink url="https://groups.google.com/group/krusader-devel">&krusader;-devel mailing list</ulink>. We review and discuss every
0587           submission.</para>
0588           <para></para>
0589           <!-- Empty line to make it more readable -->
0590         </answer>
0591       </qandaentry>
0592       <qandaentry>
0593         <question id="faqg_patch">
0594           <para>How can I send a patch?</para>
0595         </question>
0596         <answer>
0597           <para>It is not easy to write patch guidelines, but here
0598           are some. 
0599           <orderedlist numeration="arabic">
0600             <listitem>
0601               <para>Patches, new code or new features are always
0602               welcome!</para>
0603             </listitem>
0604             <listitem>
0605               <para>Focus only on one problem at a time, so the
0606               developers can easily understand you, and commit your patch
0607               it works.</para>              
0608             </listitem>
0609             <listitem>
0610               <para>Preferably, you can start a discussion
0611               with the developers on the krusader-devel
0612               <ulink url="https://krusader.org/get-involved/mailing-lists/index.html">mailing lists</ulink> or on the
0613               <ulink url="https://invent.kde.org/utilities/krusader/-/merge_requests">&krusader; GitLab page</ulink>. Unfortunately, we cannot apply
0614               a patch if the patch is in conflict with the <quote>general
0615               design</quote> of the &krusader; code (read for more
0616               instructions in this FAQ).
0617               Please send only one change request per mail, so
0618               that the discussion is easier to follow. The
0619               modifications should be committed step by step,
0620               checking each line.
0621               </para>
0622             </listitem>
0623             <listitem>
0624              <para>Submit your patch files on the <ulink url="https://invent.kde.org/utilities/krusader/-/merge_requests">GitLab</ulink>,
0625               so that all patch proposals stay organised and do not get lost,
0626               tar.gz archives or diffs are usually ok.
0627               Do not copy changes into a mail. Most mailers will change the
0628               white spaces, so that the diff will not apply or the
0629               code snipped does not diff. In the past, patch mails went lost or disorganized in many many mails,
0630               so please use the <ulink url="https://community.kde.org/Infrastructure/GitLab">GitLab</ulink>, thanks! 
0631               </para> 
0632             </listitem>
0633             <listitem>
0634               <para>Use portable solutions, &krusader;
0635               should run on: 
0636               <itemizedlist>
0637                 <listitem>
0638                   <para>All POSIX
0639                   (&Linux;/BSD/&UNIX;-like
0640                   OSes), &Solaris;.</para>
0641                 </listitem>
0642                 <listitem>
0643                   <para>All BSD Platforms
0644                   (<trademark class="copyright">FreeBSD</trademark>/<trademark class="registered">NetBSD</trademark>/<trademark class="registered">OpenBSD</trademark>/&MacOS;).</para>
0645                 </listitem>
0646                 <listitem>
0647                   <para>&kde; 3.3- &kde;
0648                   3.5 and even on GNOME with
0649                   kdelibs (for &krusader;-2.x) .</para>
0650                 </listitem>
0651                 <listitem>
0652                   <para>GCC 2.95 - GCC 5.4</para>
0653                 </listitem>
0654               </itemizedlist>Architecture changes are made by the
0655               team only.</para>
0656             </listitem>
0657             <listitem>
0658               <para>A final note: always keep in mind a patch might
0659               be rejected. Either it has side effects, which we
0660               could not fix or it contradicts with the idea behind
0661               the patched module. In this sense, a software project
0662               differs from, let's say a wiki: a software project
0663               has to have someone to make all the final decisions.
0664               Otherwise the software will not work. Furthermore:
0665               keep in mind that the examination of patches might
0666               take time, as we all have private lives.</para>
0667             </listitem>
0668           </orderedlist></para>
0669           <para></para>
0670           <!-- Empty line to make it more readable -->
0671         </answer>
0672       </qandaentry>
0673       <qandaentry>
0674         <question id="faqg_bug_report">
0675           <para>How can I report a bug?</para>
0676         </question>
0677         <answer>
0678           <para>Bugs?!?!? Well, ok.... We have an online Bug
0679           Tracking System.</para>
0680           <para>Using the online bug-tracker helps us have a clear
0681           and orderly way to know how many bugs are open, bug
0682           priority and follow-ups. It saves us from browsing
0683           through the entire &krusader; forum, searching
0684           for yesterdays bug. Please use this system.</para>
0685           <para>Before reporting a bug, please read the following: 
0686           <orderedlist>
0687             <listitem>
0688               <para>
0689               <emphasis role="bold">Check</emphasis> if the bug is
0690               already posted in the <ulink url="https://bugs.kde.org">online bug list</ulink>
0691               of the Bug Tracking System.</para>
0692             </listitem>
0693             <listitem>
0694               <para>If you cannot find this bug mentioned, please 
0695               <emphasis role="bold">submit</emphasis> it into the
0696               bug tracker by clicking the 
0697               <guibutton>Submit New</guibutton> button in the
0698               bug-tracker window. Please submit the following
0699               issues: the &krusader; version used, the
0700               &Linux; distribution + version used,
0701               processor type, and as good a description of the
0702               problem as you can manage.</para>
0703             </listitem>
0704           </orderedlist></para>
0705           <para>Thank you for your co-operation!</para>
0706           <note>
0707             <para>If possible, try to do the same operation with
0708             &konqueror; or another &kde;
0709             application. If you encounter the same problem then it
0710             is possibly a KIO Slaves or
0711             &kf5-full; bug, and not a
0712             &krusader; bug. &krusader; uses
0713             the &kde-frameworks; libraries and the
0714             KIO Slave for many operations. In
0715             some cases you can encounter problems if your
0716             distribution is incorrectly configured, please test it
0717             first as explained above.</para>
0718           </note>
0719           <para></para>
0720           <!-- Empty line to make it more readable -->
0721           <para></para>
0722           <!-- Empty line to make it more readable -->
0723         </answer>
0724       </qandaentry>
0725       
0726 <qandaentry>
0727   <question id="faqg_valgrint">
0728   <para>How can i send good debug or crash reports?</para>
0729   </question>
0730   <answer>
0731   <para>Usually binary packages that are been used by your distribution do not contain debug information.
0732         Since we usually only develop and fix &krusader;-git, compile &krusader;-git in debugmode and install it, than check if the bug still exist.
0733         <screen><prompt>$</prompt> <userinput><command>cmake</command> <option>-DCMAKE_BUILD_TYPE=debugfull</option></userinput></screen>  
0734 
0735         Install <ulink url="https://valgrind.org">valgrind</ulink>, a suite of tools for debugging and profiling &Linux; programs.
0736 
0737         Run Valgrind/&krusader;
0738         <screen><prompt>$</prompt> <userinput><command>valgrind</command> <option>--tool=memcheck</option> <replaceable>{foo_path}/krusader</replaceable></userinput></screen>
0739         
0740         The valgrind tool will write to stdout, what really happens.
0741         If you could send these information before the crash, it is almost sure, that we may fix or tell you what to do.
0742   </para>
0743   <!-- Empty line to make it more readable -->
0744   </answer>
0745 </qandaentry>
0746 
0747 <qandaentry>
0748   <question id="faqg_crashhandler">
0749   <para>What to do if the KDEcrashhandler sends no useful backtrace information?</para>
0750   </question>
0751   <answer>
0752   <para>Usually binary packages that are been used by your distribution do not contain debug information.
0753         Since we usually only develop and fix &krusader;-git, compile &krusader;-git in debugmode and install it, than check if the bug still exist.
0754         <screen><prompt>$</prompt> <userinput><command>cmake</command> <option>-DCMAKE_BUILD_TYPE=debugfull</option></userinput></screen> 
0755  
0756        If the KDEKrashhandler still does not provide useful backtrace information, than sometimes a coredump will give better information. 
0757        Run Krusader, with disabled crashhandler.
0758        <screen><prompt>$</prompt> <userinput><command>krusader</command> <option>--nocrashhandler</option></userinput></screen>
0759 
0760        On a crash you will get a <filename>.core</filename> file, usually in your home folder.
0761 
0762        Run <ulink url="https://sourceware.org/gdb/">gdb</ulink>, the GNU Project Debugger
0763        
0764        <screen><prompt>$</prompt> <userinput><command>gdb</command> <option>-c</option> <replaceable>corefile krusader</replaceable></userinput></screen>
0765        
0766        Now type <command>bt</command> to get the backtrace and type <command>q</command> to quit gdb.
0767 
0768        Often the best debug results will be given when using the valgrind tool.
0769   </para>
0770   <!-- Empty line to make it more readable -->
0771   </answer>
0772 </qandaentry>
0773       
0774 <qandaentry>
0775         <question id="faqg_mail_list">
0776           <para>Does &krusader; have a mailing
0777           list?</para>
0778         </question>
0779         <answer>
0780           <para>Yes, currently we have several
0781           <ulink url="https://krusader.org/get-involved/mailing-lists/index.html">mailing lists</ulink>. No spam, no bother, just
0782           &krusader;. Feel free to subscribe and
0783           unsubscribe.</para>
0784           <para>Tip. our mailing lists can be browsed online or
0785           read with a newsreader, so that you do not even need to
0786           subscribe to follow the action on the mailing lists. 
0787           <itemizedlist>
0788             <listitem>
0789               <para><ulink url="https://groups.google.com/group/krusader-devel">&krusader;-devel</ulink> is the developer
0790               mailing list (read-only). If you want to follow the
0791               development of &krusader; on the cutting
0792               edge, this is the list to follow.</para>
0793             </listitem>
0794             <listitem>
0795               <para><ulink url="https://groups.google.com/group/krusader-users">&krusader;-users</ulink> is the
0796               &krusader; users mailing list. Here you
0797               can ask for help and talk with the
0798               &krusader; users and developers.</para>
0799             </listitem>
0800             <listitem>
0801               <para><ulink url="http://groups.google.com/group/krusader-news">&krusader;-news</ulink> is a very low volume
0802               list, used for announcements of new
0803               versions or critical bugfixes.</para>
0804             </listitem>
0805           </itemizedlist></para>
0806           <para></para>
0807           <!-- Empty line to make it more readable -->
0808         </answer>
0809       </qandaentry>
0810       <qandaentry>
0811         <question id="faqg_newsfeeds">
0812           <para>Does &krusader; provide
0813           news feeds?</para>
0814         </question>
0815         <answer>
0816           <para>Yes, we do. Several news feeds in various formats
0817           are available. <ulink url="https://groups.google.com/group/krusader-devel/feeds">krusader-devel feed</ulink>,
0818           <ulink url="https://groups.google.com/group/krusader-users/feeds">krusader-users feed</ulink> and
0819           <ulink url="https://groups.google.com/group/krusader-news/feeds">krusader-news feed</ulink>.</para>
0820           <para></para>
0821           <!-- Empty line to make it more readable -->
0822         </answer>
0823       </qandaentry>
0824       <qandaentry>
0825         <question id="faqg_kru-forum">
0826           <para>How does the &krusader; forum
0827           work?</para>
0828         </question>
0829         <answer>
0830           <para>In the spirit of freedom of speech, everything that
0831           is &krusader; related can be discussed in our
0832           forum. It does not matter if you are a newcomer or an
0833           advanced user, everyone is welcome. An open source
0834           project's greatest strength is derived from getting user
0835           feedback. That is why we love to hear what you have to
0836           say. With your feedback we can make &krusader;
0837           better and better; otherwise, we are not aware of issues
0838           and ideas you may have. But please remember the
0839           following, so that we can maintain some order in the
0840           chaos.</para>
0841           <para>If the 
0842           <link linkend="index">Documentation</link>,
0843           <link linkend="faq">FAQ</link> and
0844           <ulink url="https://groups.google.com/group/krusader-devel">&krusader;-devel</ulink> (please use the search function
0845           ) cannot help you, do not hesitate to post on our forum.
0846           The &krusader; Krew or the
0847           &krusader; community is always available to
0848           help you.</para>
0849           <para>Please use the search function of the <ulink url="https://forum.kde.org/viewforum.php?f=225">&kde; Forum</ulink>, your issue may
0850           have been previously discussed (this allows us to
0851           minimize the double/triple/... postings). If your issue
0852           has already been discussed in the past there is a great
0853           chance that you will have an instant solution to your
0854           problem. If the issue is currently being discussed, you
0855           can join in the discussion. Some questions are asked over
0856           and over again, that is why we have created this
0857           <link linkend="faq">FAQ</link>. This allows us to spend more time
0858           developing &krusader;.</para>
0859 <!--          <para>The <ulink url="https://krusader.org/phpBB/index.php">&krusader; Forum</ulink> is split into seven
0860           sections: 
0861           <itemizedlist>
0862             <listitem>
0863               <para><ulink url="https://krusader.org/phpBB/viewforum.php?f=7">News and Announcements Forum</ulink>: all the latest
0864               news.</para>
0865             </listitem>
0866              <listitem>
0867               <para><ulink url="http://krusader.sourceforge.net/phpBB/viewforum.php?f=12">NewsLetter Forum</ulink>: all newsletters.</para>
0868             </listitem>
0869             <listitem>
0870               <para><ulink url="https://krusader.org/phpBB/viewforum.php?f=3">Bug Discussion Forum</ulink>: discussions about
0871               bugs, please DO NOT use the forum for
0872               <link linkend="faqg_bug_report">bug reports</link> (except if you are
0873               unsure if you have found a bug).</para>
0874             </listitem>
0875             <listitem>
0876               <para><ulink url="https://krusader.org/phpBB/viewforum.php?f=6">New Features Discussion/Requests Forum</ulink>: discussions
0877               about new features for future &krusader;
0878               versions.</para>
0879             </listitem>
0880             <listitem>
0881               <para><ulink url="https://krusader.org/phpBB/viewforum.php?f=10">ToDo Forum</ulink> here you will find
0882               the list of the planned features. Registered users
0883               will be able to VOTE and COMMENT on the TODO items.
0884               Here you get the chance to push your favourite
0885               features (+3) and still prefer certain features over
0886               others (+1), if you do not care about a feature just
0887               simply do not vote on that feature. Unregistered users
0888               may only browse the <ulink url="https://krusader.org/phpBB/viewforum.php?f=10">ToDo Forum</ulink>. The
0889               <ulink url="https://krusader.org/todo.php">ToDo ranking system</ulink> contains the results
0890               based on the votes. 
0891               <link linkend="faqg_patch">Adding ToDo items</link> or
0892               removing ToDo items which have been implemented will
0893               be done by the &krusader; Krew.</para>
0894             </listitem>
0895             <listitem>
0896               <para><ulink url="https://krusader.org/phpBB/viewforum.php?f=11">UserActions Forum</ulink>: discussions
0897               about <link linkend="useractions">UserActions</link>. Posting your own
0898               User Actions is greatly appreciated. We plan to
0899               include the best ones in the next
0900               &krusader; releases.</para>
0901             </listitem>
0902             <listitem>
0903               <para><ulink url="https://krusader.org/phpBB/viewforum.php?f=1">General Discussion Forum</ulink>: everything that
0904               is &krusader; related and does not belong
0905               in the other forums.</para>
0906             </listitem>
0907               </itemizedlist></para>-->
0908           <para>Thank you for your co-operation!</para>
0909           <!--<para>We provide a <ulink url="http://krusader.sf.net/phpBB/rss.php">RSS feed</ulink> for our forums.
0910           You do not have to check for new posts all the time, instead the news
0911           will come to you!</para>-->
0912           <para></para>
0913           <!-- Empty line to make it more readable -->
0914         </answer>
0915       </qandaentry>
0916       <qandaentry>
0917         <question id="faqg_i18n">
0918           <para>How can I translate &krusader; into my
0919           native language?</para>
0920         </question>
0921         <answer>
0922           <para>If you are interested in translating the &krusader; &GUI; or documentation, please contact the
0923                <ulink url="https://l10n.kde.org/teams-list.php">KDE translation team</ulink> of your language.</para>
0924           <para></para>
0925           <!-- Empty line to make it more readable -->
0926         </answer>
0927       </qandaentry>
0928       <qandaentry>
0929         <question id="faqg_support">
0930           <para>How can I support &krusader;?</para>
0931         </question>
0932         <answer>
0933           <para>You can 
0934           <link linkend="help_krusader">
0935           support</link> &krusader; in many different
0936           ways. Please send us 
0937           <link linkend="faqg_wish">feedback</link>,
0938           <link linkend="faqg_bug_report">bug reports</link>, patches, 
0939           <link linkend="help_krusader">donations</link>,
0940           translations, ...</para>
0941           <para></para>
0942           <!-- Empty line to make it more readable -->
0943         </answer>
0944       </qandaentry>
0945       <qandaentry>
0946         <question id="faqg_mcstyle">
0947           <para>Why is &konqueror; in <quote>Midnight
0948           Commander style</quote> not an
0949           <link linkend="gloss-ofm">OFM</link>?</para>
0950         </question>
0951         <answer>
0952           <para>The two panels and a commandline are available, all
0953           the other stuff like 
0954           <link linkend="features">OFM features</link> and the 
0955           <link linkend="gloss-ofm">OFM</link> interaction with the
0956           user is missing from this profile.</para>
0957           <para></para>
0958           <!-- Empty line to make it more readable -->
0959         </answer>
0960       </qandaentry>
0961       <qandaentry>
0962         <question id="faqg_why_ofm">
0963           <para>Why should I use an 
0964           <link linkend="gloss-ofm">OFM</link>?</para>
0965         </question>
0966         <answer>
0967           <para>An <ulink url="https://www.softpanorama.org/OFM/index.shtml">Orthodox File Manager (OFM)</ulink> is much faster than a one
0968           panel filemanager and faster than the command line. If
0969           you would like to know 
0970           <ulink url="https://www.softpedia.com/reviews/linux/Krusader-18193.shtml">
0971           how &krusader; feels</ulink>, there is only
0972           one way to discover: install it on your computer and use
0973           it for a while. If you prefer to waste time and lose
0974           productivity, continue to use one panel filemanagers
0975           which are based on &Windows; Explorer. Matej
0976           Urban&ccaron;i&ccaron; has written
0977           a 
0978           <ulink url="https://murban.blogspot.com/2006/01/krusader-and-konqueror-twin-versus-one.html">
0979           blog</ulink> on why 
0980           <link linkend="gloss-ofm">OFM</link> is better than a one
0981           panel filemanager.</para>
0982           <para></para>
0983           <!-- Empty line to make it more readable -->
0984         </answer>
0985       </qandaentry>
0986     </qandaset>
0987   </sect1>
0988   <!--
0989   <qandaentry>
0990       <question><para> </para></question>
0991       <answer>
0992         <para> </para>
0993         <para> </para> // Empty line to make it more readable
0994       </answer>
0995   </qandaentry>
0996 -->
0997 </chapter>