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>