General FAQ

1. How can I report a wish, a suggestion, or a comment?
2. How can I send a patch?
3. How can I report a bug?
4. How can i send good debug or crash reports?
5. What todo if the KDEcrashhandler sends no usefull backtrace information?
6. Does Krusader have a mailing list?
7. Does Krusader provide newsfeeds?
8. Does Krusader have an IRC channel?
9. How does the Krusader forum work?
10. How can I translate Krusader into my native language?
11. How can I support Krusader?
12. Is there a Mac OS X port?
13. Is there a Windows port?
14. Why is Konqueror in "midnight commander style" not an OFM?
15. Why should I use an OFM?
1.

How can I report a wish, a suggestion, or a comment?

An open source project's greatest strength is derived from getting user feedback. That is why we love to hear what you have to say. Your "gripes" are our instructions. After about 6 months, programmers can no longer see their own mistakes. It's natural. We want the ideas, qritiques, and feedback because we all want to make Krusader the best and most useful file manager available anywhere.

The most convenient way to contact us is to use the Krusader Forum, or the krusader-users mailing lists. For information on what remains to be done look at the ToDo Forum. Adding ToDo items into the ToDo Forum is for developers only, but feel free to post to the New Features Discussion/Requests Forum for things that aren't on the ToDo Forum, but should be. If you have a nice feature request, the Krusader Krew will add your request to the ToDo Forum. We review and discuss every submission. For more information how the forum works click here.

2.

How can I send a patch?

It's not easy to write patch guidelines, but here are some.

  1. Patches, new code or new features are always welcome!

  2. Focus only on one problem at a time, so the developers can easily understand you, and commit your patch it works.

  3. Preferrably, you can start a discussion with the developers on the krusader-devel mailing lists or on the Krusader Forum. Unfortunatly, we can't apply a patch if the patch is in conflict with the "general design" of the Krusader code (read for more instructions in this FAQ). Please send only one change request per mail, so that the discussion is easier to follow. The modifications should be committed step by step, checking each line.

  4. Submit your patch files into our Patch Tracker, so that all patch proposals stay organised and don't get lost, tar.gz archives or diffs are usually ok. Do not copy changes into a mail. Most mailers will change the white spaces, so that the diff will not apply or the code snipped does not diff. In the past, patch mails went lost or disorganized in many many mails, so please use the Patch Tracker, thanks!

  5. Use portable solutions, Krusader should run on:

    • All POSIX (Linux®/BSD/UNIX®-like OSes), Solaris™.

    • All BSD Platforms (FreeBSD®/NetBSD®/OpenBSD®/Mac® OS).

    • KDE 3.3- KDE 3.5 and even on GNOME with KDElibs (for krusader-2.x KDE 4) .

    • GCC 2.95 - GCC 4.1

    Architecture changes are made by the team only.

  6. A final note: always keep in mind a patch might be rejected. Either it has side effects, which we could not fix or it contradicts with the idea behind the patched module. In this sense, a software project differs from, let's say a wiki: a software project has to have someone to make all the final decisions. Otherwise the software will not work. Furthermore: keep in mind that the examination of patches might take time, as we all have private lives.

3.

How can I report a bug?

Bugs?!?!? Well, ok.... We have an online Bug Tracking System.

Using the online bug-tracker helps us have a clear and orderly way to know how many bugs are open, bug priority and follow-ups. It saves us from browsing through the entire Krusader forum, searching for yesterdays bug. Please use this system.

Before reporting a bug, please read the following:

  1. Use the Krusader Forum's Search function , your bug might be already solved . Please DO NOT post new bugs to the Bug Discussion Forum (except if you are not sure that you have found a bug). We use it for bug discussions.

  2. Check if the bug is already posted in the online bug list of the Bug Tracking System.

  3. If you can't find this bug mentioned, please submit it into the bug tracker by clicking the Submit New button in the bug-tracker window. Please submit the following issues: the Krusader version used, the Linux® distribution + version used, processor type, and as good a description of the problem as you can manage.

Thank you for your co-operation!

Note

If possible, try to do the same operation with Konqueror or another KDE application. If you encounter the same problem then it is possibly a KIOSlaves or KDE (kdelibs) bug, and not a Krusader bug. Krusader uses the KDE libraries and the KIOSlaves for many operations. In some cases you can encounter problems if your distribution is incorrectly configured, please test it first as explained above.

Note

If you've got bugs to report please do not use KDE's bugzilla http://bugs.kde.org/, KDE's Bug Tracking System. Report Krusader bugs directly to us.

4.

How can i send good debug or crash reports?

Usually binary packages that are been used by your distribution do not contain debug information. Since we usually only develop and fix Krusader-cvs, compile Krusader-cvs in debugmode and install it, than check if the bug still exist.

$ ./configure --enable-debug=full
Install valgrind, a suite of tools for debugging and profiling Linux® programs. Run Valgrind/Krusader
$ valgrind --tool=memcheck {foo_path}/krusader
The valgrind tool will write to stdout, what really happens. If you could send these informations before the crash, it's almost sure, that we may fix or tell you what to do.

5.

What todo if the KDEcrashhandler sends no usefull backtrace information?

Usually binary packages that are been used by your distribution do not contain debug information. Since we usually only develop and fix Krusader-cvs, compile Krusader-cvs in debugmode and install it, than check if the bug still exist.

$ ./configure --enable-debug=full
If the KDEKrashhandler still doesn't provide usefull backtrace information, than sometimes a coredump will give better information. Run Krusader, with disabled crashhandler.
$ krusader --nocrashhandler
On a crash you will get a .core file, usually in your home directory. Run gdb, the GNU Project Debugger
$ gdb -c corefile krusader
Now type bt to get the backtrace and type q to quit gdb. Often the best debug results will be given when using the valgrint tool.

6.

Does Krusader have a mailing list?

Yes, currently we have 6 mailing lists. No spam, no bother, just Krusader. Feel free to subscribe and unsubscribe.

Tip. our mailing lists can be browsed online or read with a newsreader, so that you don't even need to subscribe to follow the action on the mailing lists.

  • Krusader-news is a very low volume list, used for newsletters and announcements of new versions or critical bugfixes. The news can also be read online at latest news and in the News and Announcements Forum which are basically the same but displayed in another format.

  • Krusader-devel is the developer mailing list (read-only). If you want to follow the development of Krusader on the cutting edge, this is the list to follow.

  • Krusader-users is the Krusader users mailing list. Here you can ask for help and talk with the Krusader users and developers.

  • Krusader-i18n is the translations mailing list.

  • Krusader-doc is the documentation mailing list.

  • Krusader-commits (read-only): when the Krusader Krew commits code into CVS, it will be reported in this mailing list. Want to keep track? Waiting for a certain feature/bugfix? Follow Krusader's development here.

7.

Does Krusader provide newsfeeds?

Yes, we do. Several newsfeeds in various formats are available. rss-filerelease feed, rss-forumfeed, krusader-news feed, krusader-devel feed and even additional feeds by gmane.org. krusader-users feed, krusader-i18n feed, krusader-doc feed.

8.

Does Krusader have an IRC channel?

Yes, we do. Feel free to talk to the Krusader Krew and fellow-users via freenode.org servers. The server is irc.freenode.org, the channel is #krusader. Everyone is welcome.

9.

How does the Krusader forum work?

In the spirit of freedom of speech, everything that is Krusader related can be discussed in our forum. It does not matter if you are a newcomer or an advanced user, everyone is welcome. An open source project's greatest strength is derived from getting user feedback. That is why we love to hear what you have to say. With your feedback we can make Krusader better and better; otherwise, we are not aware of issues and ideas you may have. But please remember the following, so that we can maintain some order in the chaos.

If the Documentation, FAQ, Krusader Forum and Krusader-devel (please use the search function ) can't help you, do not hesitate to post on our forum. The Krusader Krew or the Krusader community is always available to help you.

Please use the Search function of the Krusader Forum, your issue may have been previously discussed (this allows us to minimize the double/triple/... postings). If your issue has already been discussed in the past there is a great chance that you will have an instant solution to your problem. If the issue is currently being discussed, you can join in the discussion. Some questions are asked over and over again, that's why we have created this FAQ. This allows us to spend more time developing Krusader.

The Krusader Forum is split into seven sections:

  • News and Announcements Forum: all the latest news.

  • NewsLetter Forum: all newsletters.

  • Bug Discussion Forum: discussions about bugs, please DO NOT use the forum for bug reports (except if you are unsure if you have found a bug).

  • New Features Discussion/Requests Forum: discussions about new features for future Krusader versions.

  • ToDo Forum here you will find the list of the planned features. Registered users will be able to VOTE and COMMENT on the TODO items. Here you get the chance to push your favourite features (+3) and still prefer certain features over others (+1), if you don't care about a feature just simply don't vote on that feature. Unregistered users may only browse the ToDo Forum. The ToDo ranking system contains the results based on the votes. Adding ToDo items or removing ToDo items which have been implemented will be done by the Krusader Krew.

  • UserActions Forum: discussions about UserActions. Posting your own User Actions is greatly appreciated. We plan to include the best ones in the next Krusader releases.

  • General Discussion Forum: everything that is Krusader related and doesn't belong in the other forums.

Thank you for your co-operation!

We provide RSS feeds for our forums. You don't have to check for new posts all the time, instead the news will come to you! To make use of them, simply point your RSS aggregator to here.

10.

How can I translate Krusader into my native language?

Please read the i18n page. It's not difficult to translate! Most anyone can do it, it just takes some time.

11.

How can I support Krusader?

You can support Krusader in many different ways. Please send us feedback, bug reports, patches, donations, translations, ...

12.

Is there a Mac® OS X port?

Yes, there is Mac® OS X port, but you will not have the all the power you would have on Linux®. Please read the Mac® OS X port section for more information. A recommended native file manager for Mac® OS is Disk Order© (shareware).

13.

Is there a Windows® port?

No, but this might change in the future. Please help us with this project, contributions are greatly appreciated. A recommended native file manager for Windows® is Total Commander© (shareware).

14.

Why is Konqueror in "midnight commander style" not an OFM?

The two panels and a commandline are available, all the other stuff like OFM features and the OFM interaction with the user is missing from this profile.

15.

Why should I use an OFM?

An Orthodox File Manager (OFM) is much faster than a one panel filemanager and faster than the command line. If you would like to know how Krusader feels, there is only one way to discover: install it on your computer and use it for a while. If you prefer to waste time and lose productivity, continue to use one panel filemanagers which are based on Windows® Explorer. Matej Urbančič has written a blogon why OFM is better than a one panel filemanager.