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 ⪚
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 (⪚
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 ⪚
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 (⪚ 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 ⪚ 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, ⪚
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 & 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čič 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>