Frequently Asked Questions (&FAQ;)FAQIf you have problems with &krusader; please
check the &install-proc-lnk;, as your problem may be
caused by a bad installation.The &FAQ; is divided into three sections:
Installation
&FAQ; (this page)
Usage
&FAQ; (issues with running/using
&krusader;)
General
&FAQ; (bug reports, forum, mailing list,
...)If you feel that a &FAQ; is missing or
if something is not clear to you, please
let us know.Installation &FAQ;Does &krusader; need &kde; to
run?No, &krusader; does not need the
&kde; window manager to run on your
computer but &krusader;'s natural environment
is &kde;, because it relies on services
provided by the &kde; base libraries. Only
some shared libraries are needed ⪚
&kde; libraries, &Qt; libraries,
&etc; This means that &krusader;
runs on &gnome-url;,
&afterstep-url;, &xfce-url; and
other window managers provided the approriate libraries
are installed on your computer. All this is not a problem
since the apt-get world can resolve these dependencies
instantly.You do not need to switch to the &kde;
window manager to use &krusader;; you can
still use &gnome-url;,
&afterstep-url;, &xfce-url; or
another window manager. However, the configuration of the
&krusader; fonts and some behavior is done by
running
kcontrol.A lot depends on what you want to do with
&krusader;. You should know that
&krusader; uses the &kde;
&kioslaves1-url; to access remote file
systems, and support for only a limited number of file
system types are shipped with &tdelibs-url;,
most of the &kioslaves2-url; are bundled with
&tdebase-url; (including fish, sftp and tar).
However, if you want the property-dialog to show
EXIF-data for .jpeg's, you need &kde;graphics.
If you want ID3-infos, you need
&kde;multimedia, and so on.To summarize, if you want a working
&krusader; - install &kde;libs. If
you want a functional &krusader; then you need
&kde;libs + &kde;base. For maximum
functionality, &krusader; needs all of the
&kde; package libraries, but the
&kde; window manager is optional.Which libraries does &krusader; need to
run?For running &krusader; (⪚
when you have installed &krusader; with a
binary RPM) you need less libraries than if you compile
&krusader; from source. ⪚ you
only need the C-compliler &gcc; when you
compile &krusader; from source (see the next
question).Here is a list of the required shared libraries
when you run &krusader;:tdelibs (for the required &kde;
version see the &install-proc-lnk;)libacl1 libart-2.0 libattr1 libaudio2 libc6
libfam0 libfontconfig1libfreetype6 libgcc1 libgcc2 libice6 libidn11
libjpeg62 libkjsembed1libkonq4 libpcre3 libpng12 libqt3-mt libsm6
libstdc++6 libunwind7 libx11-6libxcursor1 libxext6 libxft2 libxi6
libxinerama1 libxrandr2 libxrender1 libxt6
zlib1gIf you need more info please take a look
at the &deb-requirements-url; .I have followed all the steps but
configurecomplains about missing libs
or headers. What do I need to do?Install the missing packages.Here is a list of the required packages to compile
&krusader; from source:gcc-cpp gcc-c++ glibc libgcc1 (other
compilers may work but haven't been tested)autoconf automake XFreelibqt3 libqt-develtdelibs tdelibs-devellibjpeg62 libjpeg-devel libpng3
libmng1fam libfam-develzlib1 arts libart_lgpl2 libstdc++5
libpcre0libkjsembed, if you use the
&javascript-console-lnk;, often found in
a package called KDEbindings(-devel) and
libkonq-dev for the &konqueror;
right-click menu entries.Most RPM-based distributions separate the headers
from the libs. The headers are needed to compile
&krusader;. Look for packages in the form
foo-devel-*.rpm (⪚
tdelibs-devel-foo.i586.rpm) or
foo-dev-*.deb for &debian; based
distributions. These are usually included with your
distribution.
If you ca not find the needed package, use
&rpmfind-url; and click 'missing lib or
header' in the search line. Or use
apt-cache search
foo to find the
corresponding package for &debian; based
distributions.How do I compile &krusader; when I'm
using a 64 bit processor ?As far as we know, there are no issues.
&krusader; is also available on
many other architectures.I have downloaded the Source RPM
krusader-x.xx.dist.src.rpm, what to
do now?Check the ownership and the permissions on
/usr/src/RPM/ and all recursive
directories that your normal user can
read-write-execute in these directories.To produce the binary RPM for your computer,
do this:
$rpm</path/to/rpmfile/> krusader-x.xx.dist.src.rpmIf all
dependencies are OK, a binary RPM
krusader-x.xx.dist.rpm will be
created at
/usr/src/RPM/RPMS/i586 (replace i586 with
your architecture).Test the binary RPM for errors before
installing:
$rpm</path/to/rpmfile> krusader-x.xx.dist.rpm
If the prompt returns without any message,
then everything is OK.Install the binary RPM as usual, for example:
$su -c 'rpm</path/to/rpmfile> krusader-x.xx.dist.rpm'
You will be asked to enter your root
password.Now you can
start &krusader;.For more information about RPM, visit
&rpm-org-url; and read the
&rpm-guide-url; by Eric
Foster-Johnson.I'm trying to install binary foo (RPM or DEB
package), but it fails. What's wrong?Since we only prepare (and use) the source, we have
no way of knowing this. Did you test the binary RPM
before installing?
$rpm</path/to/rpmfile> krusader-x.xx.dist.rpm
If the prompt returns without any message, then
everything is OK. RPM's downloaded from our website are
usually provided by &krusader; users. Visit
your distro website and search for an updated RPM.If the RPM is not OK, try to find another package
at &Linux; software archives such as
&freshmeat-url; or &kde-apps-url;.
If you still can't find the appropriate package for your
&Linux; distribution, we recommend searching
for it with &rpmfind-url; or
&rpmpbone-url;.In general, a package for an older version of your
distrubution or even for another distribution might work
on your computer (⪚ FC RPM's often work on
Mdk and RH, and vice versa), but it is always the best
that you install only RPM's that exactly match your
distribution. If you can't find a package that matches
your distribution version, architecture or distribution,
then use a source RPM. When you use a source RPM, the
Krusader sources will be built, on your computer,
guaranteeing a suitable binary RPM for your specific
distribution and architecture. In addition, this method
results in maximum system speed, since the resulting
binary is customized for your computer. Please read the
previous question, it explains how to install a source
RPM. The best solution is explained in the next
question.I can't find an RPM or DEB package for
&krusader;, what to do?Check if your distribution provides
&krusader;, if it doesn't then contact your
distribution creator and ask them to include
&krusader;!Did you take a look at the &URL;'s on
the &install-proc-lnk; page? If you have and
found nothing, you can always compile
&krusader; from source. Even if you feel you
haven't got the necessary skills, you will probably
succeed in compiling &krusader;: we provide a
very detailed installation procedure. This HowTo enables
newcomers to compile &krusader; from source,
even if they have never done a compilation from source
before, just follow the instructions carefully. Feel free
to post a &help-request-lnk; if you encounter
problems.I've installed &krusader;, but when I
start, only the
"Help" menu appears. Why?In this case only the
Help menu is visible and all other menu
items like ⪚
File and
Select are missing. This is because
some distributions put the
krusaderui.rc file in the wrong
directory. To solve the problem, just copy the
krusaderui.rc file from the package
krusader_trinity/krusader/krusaderui.rc to
$TDEDIR/share/apps/krusader/krusaderui.rc and
~/.kde/share/apps/krusader/krusaderui.rc and
re-run &krusader;. If you have compiled
&krusader; from sources this is often caused
if the &kdeqtdir-lnk; environment variables
are not correctly set. The result is that the
krusaderui.rc file is installed in
the wrong directory. Please read the following question,
as well.Some new menu items are missing after updating
&krusader;, what's wrong?The
krusaderui.rc file is stored in
$TDEDIR/share/apps/krusader/krusaderui.rc.
When you change the
"Toolbar", &kde; makes a
copy of that file in the home directory at
~/.kde/share/apps/krusader/krusaderui.rc. If
Krusader was previously installed on your computer, and
you install a newer &krusader; version the
~/.kde/share/apps/krusader/krusaderui.rc file
must be replaced with the newer version. Note: this will
also reset all your changes on toolbars and
shortcuts!The first line of
krusaderui.rc contains the version
number. After installing a newer &krusader;
version, &kde; will automatically replace the
old
~/.kde/share/apps/krusader/krusaderui.rc with
the newer version when starting the new
&krusader; for the first time
(&kde; will detect the newer version number in
the first line).If you install a CVS or beta version and
&krusader; was already installed on your
computer then you should delete the
krusaderui.rc file from your home
directory to activate the new menu entries
$rmIf the
~/.kde/share/apps/krusader/krusaderui.rc file
is older, then the new menu elements will not be shown.
Read the previous question for information on how to
update the
krusaderui.rc file. If
krusaderui.rc is missing or in a
wrong directory, only the
"Help" menu appears, please read the
previous question.When I run
make, it complains about
libfam.la, what's wrong?The
./configure script does not check for
the presence of
libfam.la, and
make needs
libfam.la to compile
&krusader;. If you know how this can be
solved, please let us know. Install
libfam0-devel-foo.rpm. Note: when
you install &Mandrake;-&Linux; 9.2
with the default settings, this package is not installed.
If you need more information take a look at
&missing-libs-lnk;.&debian; complains about &Qt;
when running
./configure, what's wrong?This problem occurs when you use &gcc;
2.95, you need to install &gcc; 3.2 (or
higher). You also need to set the enviroment variables
"CC, CPP and CXX" before running the
./configure script.
$export CC=/usr/bin/gcc-3.2$export CXX=/usr/bin/g++-3.2$export CPP=/usr/bin/cpp-3.2
For more information please take a look
&debian-qt-a-url; and at the
&debian-qt-b-url; on how to build a
&Qt;/&kde;3 application on
&debian;.I have a
libGLcore.so.1 compile error after
using the &nvidia; installer, what to
do?This problem occurs when you use the
&nvidia; installer and not the official
&nvidia; packages of your distribution.
&krusader; is based on &Qt; which
can be linked against the X OpenGL libraries. As a result
&krusader; may look for OpenGL as well. The
problem is that the &nvidia; installer (prior
to version 7xxx) doesn't perform it's task properly: it
replaces the OpenGL header files (which get included into
&krusader;) but doesn't set the libGL links
correctly. The best solution is to use the
&nvidia; packages provided by your distributor
or a new &nvidia; installer, the current
version at the moment of writing is 7114. If, for some
reason, you must use an old &nvidia; driver,
one solution is the following hack, the exact commands
depend on the distribution used and the version of the
&nvidia; driver (6111 in this example), but it
should read something like this:
$ln -s libGLcore.so.1.0.6111 libGLcore.so.0$ln -s libGLcore.so.1.0.6111 libGLcore.so$ln -s libGLcore.so.1.0.6111 libGLcore.so.1.0.0$ln -s libGLcore.so.1.0.6111 libGLcore.so.0.0.0$ln -s libGLcore.so.1.0.6111 libGL.so$ln -s libGLcore.so.1.0.6111 libGL.so.0$ln -s libGLcore.so.1.0.6111 libGL.so.0.0.0$ln -s libGLcore.so.1.0.6111 libGL.so.1$ln -s libGLcore.so.1.0.6111 libGL.so.1.0.0$ln -s /usr/lib/libGLU.la /usr/X11R6/lib/libGLU.laWhy &krusader;-1.60.x does not compile
with gcc4?Because &krusader;-1.60.x was not gcc4
compatible, it first needs some patches:
add 'class ListPanelFunc;' in
krusader/Panel/listpanel.hadd 'class KMountManGUI;' in
krusader/MountMan/kmountman.hadd 'class KrDetailedViewItem;' in
krusader/Panel/krdetailedview.hMore information can be found in our
forum.I am having trouble compiling and installing
&krusader;, how do I send a help
request?Please read our detailed
installation
procedure and the &faq-lnk;. If you
can't find a solution to your problem then feel free to
post a
help request at our
&krusader; forum or use the
&kruusers-url; mailing list. But before
posting a help request, please try the following:
Use the &kruforumsearch-url;
function on the &forum-lnk;, your problem
might be solved or discussed already.If you can't find a solution, please make a
note of the following issues:
the &krusader; version
usedthe &Linux; distribution +
version useda good description of the problemWithout this information, it is very
difficult for us to help you.
If you give us the error messages
(⪚
make error messages) please start
with the FIRST error message, all the error
messages which follow the first error message are
consequences and not the cause of your
problem.Send out your help request.Thank you for your co-operation!How can I build an RPM package for
&krusader;?If you have experience with compiling from source,
you will probably be able to build a
&krusader; RPM too. Information about RPM can
be found at &rpm-org-url; and in the
&rpm-guide-url; by Eric Foster-Johnson. The
following is the short procedure howto on building an
RPM.NEVER build RPMs when logged in as root. Mistakes
in building packages (⪚ a bad
krusader.spec file) can do serious
damage to your system when logged in as root.Compile &krusader; from source to
check that the compilation works fine.Check the ownership and the permissions on
/usr/src/RPM/ and all recursive
directories that your normal user can
read-write-execute in these directories.Copy
kusader-1.xx.tar.gz to
/usr/scr/RPM/SOURCECopy
kusader.spec to
/usr/scr/RPM/SPECS Tip: the latest
kusader.spec can be found in
CVS.Edit
kusader.spec and add your name,
your e-mail address, the rpm name, ... Other
changes may be needed if
rpmbuild fails.Build the binary and the source RPM with:
$rpmbuild/usr/scr/RPM/SPECS/krusader.spec
If everything went OK you will have a
binary RPM in
/usr/src/RPM/RPMS/i586 (depending on your
architecture) and a source RPM in
/usr/src/RPM/SRPMS/ ⪚
krusader-1.70-beta1.suse10.i586.rpm and
krusader-1.70-beta1.suse10.src.rpmIf the build is not OK you will receive an
error message during the rpmbuild process, try to
fix it and run
rpmbuild again.And finally:
test the RPM
before sending it in.Why does &krusader;-cvs show an old
version number in the about box?Because we only change the version number just
before we do a new release. &krusader;-cvs
will show an older version number, so ignore the version
number and check the download date. We simply haven't yet
decided what the next version number will be.Usage &FAQ;&krusader; keeps crashing, why?We've been receiving a lot of emails and bug
reports (December 2005) regarding random crashes,
especially during file operations such as copy, move,
etc.
These crashes are related to
&Qt; 3.3.5 and NOT
&krusader;. It seems that
&Qt; 3.3.5 introduced a serious bug which is
currently (December 2005) causing random crashes in many
&kde; applications including
&konqueror;. You can use Google to find out
more. As far as we know, &debian;-Sid and
&SuSE; already posted new &Qt;
binaries that fix the problem, and &gentoo;
has masked &Qt; 3.3.5 completely. As for now,
you either need &Qt; 3.3.4 or a fixed
&Qt; 3.3.5 or a higer version, depending on
your distribution. More information is available on our
website.When I try to mount/unmount my cdrom/floppy,
&krusader; reports something about a
supermount, what's this about?Supermount is a daemon which handles the
mounting/unmounting of removable filesystems for you.
Just insert a floppy, and do
cdsupermount will do the mount for you
automatically and transparently. Usually this works fine.
However, supermount misleads the system into thinking
that the
floppy/cdrom is mounted at all times!
This creates some problems for &krusader;, as
it cannot really know when the floppy or CD has been
removed because the system information is not correctly
updated by supermount - is there really a
floppy in the
drive? Of course, this can be
solved, but as for now, we don't consider it a
priority.Why does &krusader; freeze or hang on a
dead mountpoint?When &krusader; is ⪚
browsing an NFS share and the NFS server goes down,
&krusader; will freeze. This
&krusader; (and all other open internal
viewers/editors) freeze is fatal, and can only be
corrected with the
kill -9. We have no solution for this.
This is an issue not confined to file managers, or even
the &Linux; OS! The problem is that you "hang"
on the first access to the dead share - so there is no
way around it, no check to avoid it, even
ls will freeze. Just trying to read
something - anything - is enough to get you stuck. The
one and only way around this architectural problem is
using a multi-threaded design - this way if we get stuck,
we don't hang the entire application event loop, but we
don't think that the time is right for adding threads, we
are not sure that *all* the &kde; systems out
there are using &Qt;-mt (the multi threaded
version of the &Qt; library), and the Krusader
Krew may not be the right people to address this major
issue in any case; so currently this is just a bug we
have to learn to live with.When I try to resize &krusader; to make
it smaller, I discover that I can't resize it below a
certain size. Why?See the
F1, F2 (&etc;) buttons?
They are not allowing &krusader; to downsize
as they have a minimum size. Just disable them
ViewShow FN Keys Bar
and you'll be able to resize
&krusader; to your liking. Since version 1.51
we have improved this greatly: when downsizing the
buttons will look like 'F5 ..py'. When the button faces
are too small to read a tooltip will give the complete
text. The minimum width is 45 pixels for each
button.When I perform some file operations,
&krusader;'s panel doesn't refresh / I'm using
&krusader; with fam installed, but updates to
the panel are not shown. Why?The bad news is that we're not sure why, but it
seems that
fam (file alteration monitor) sometimes
refuses to work. We are looking into this problem to make
sure it is not
our problem. We've tried the same
source code on two different Gentoo installations: one
worked, the other did not. The good news is that if you
disable
fam, &krusader;
will automatically revert to its internal update
mechanism (which is less efficient, but works) without
needing to recompile. You can disable
fam with:
$su -c 'fam -l'
Look at the manpages for more information about
fam.Samba ISO 8859-x codepage /
What to do if &krusader; does not read shared
directories containing special international
characters?&krusader; does not handle (yet)
Samba ISO 8859-x codepages, if
you use a codepage different than 8859-1 you will have to
do a manual configuration. Create or modify the file:
~/.smb/smb.conf[global]
workgroup = MyWorkGroup (ex. WORKGROUP)
client code page = MyCodePage (ex. 852)
character set = MyCharSet (ex. ISO8859-2)
Unfortunately
kcontrol (&kde;
3.1.1) fails to configure smb.conf properly, so this must
be done manually with a text editor.&krusader; reports "krarc:... protocol
not supported" error at opening an archive file, what to
do?Install the krarc slave properly:Copy the
kio_krarc.so,
kio_krarc.la files into
$TDEDIR/lib/trinityCopy the
krarc.protocol file into
$TDEDIR/share/servicesor the directory where the KIO slaves are placed in
your &Linux; distribution.I get the error message "Protocol not supported by
Krusader: "krarc:/path/to/foo-archive", when I try to
open foo-Archive, what to do?The icons, kio_slaves and documentation must be
installed in the correct places in the &kde;
directory tree. The
kio_krarc.* files must be in the same
directory with the other KIO slaves. Try this: locate
kio_tar.* and copy/link the
kio_krarc.* files to the same
location. Don't forget to run
# ldconfig on this directory when
you're done. For more information click
here.What todo if an extenal tool doesn't seem to work?Krusader uses several programs as external tools,
and sometimes they appear not to work.
Open a terminal and check if tool foo is installed.
$foo
Check if tool foo is properly configured in the &konfigdependencie-lnk;.
For Archiving tools: autodetect the archives again with the Auto Configure button
in the Konfigurator archive page.
Check the &konfigprotocol-lnk;
If it doesn't work, backup your ~/.kde/share/config/krusaderrc configuration file and remove it from this location,
Restart Krusader, Krusader will now start the first start configuration wizard, follow these guidelines.
Howto executing jar files (and not enter the jar archive)?Go to the &konfigprotocol-lnk; and remove application/x-jar
from the krarc node, &krusader; should no longer enter the archive.
Global file associations are handled by &kde; and not by &krusader;.
To assosiate the jar extension:
Open &kde;s control center: kcontrolKDE ComponentsFile AssociationsEnter jar as filename pattern
Add java as application
Why do I have trouble with my &FTP;
connection?This problem often occurs when you are behind a
firewall or proxy. Open
KDE Control CenterNetworkPreferences,
"Enable Passive Mode (PASV)" has to
be turned on or off, depending on it's current setting.
Now try your &FTP; session again to see if it
works. Also, make sure you have no other &FTP;
sessions open (using web browsers, etc.), they can cause
complications. More information can be found in
&active-passive-ftp-url;.I get
"FTP protocol not supported by
&krusader;" error when trying to
open a remote &FTP; directory, what to
do?The reason for this error is that '&FTP;
via &HTTP; proxy' feature is not yet supported
by &krusader;. This error may be caused by a
misconfiguration of the proxy settings in
&kcontrolcenter;. Modify the proxy settings to
not use &HTTP; proxy and &FTP; will
work.How don't add ".part" suffix when copying files via ftp?When uploading files a .part suffix is added to the filename,
once the upload is complete the filename is renamed automagically
to remove the .part suffix.
This works great but sometimes some ftp-servers don't allow a rename operation.
You can solve this by unchecking the checkbox
Mark partially uploaded files in &kde;'s control center.
The checkbox is located at
Internet and NetworkConnection Preferences.How can I close a remote connection
(⪚ a FTP connection)?It's explained in the
remote connections
chapter.I am experiencing problems with the media://
protocol, why?At the moment of writing the media:// protocol is
instable, we need to wait until the &kde; team
corrects it, every other protocol works properly with
&krusader;, only media fails. More information
regarding this issue is available in
our forum.How can I disable the default sounds,
⪚ when I do a delete action ?Those are the default &kde; System
sounds, and not related to &krusader;. If you
want to disable them globally open your &kde;
&kcontrolcenter; (
kcontrol):
KDE Control CenterSound &
MultimediaSystem Notifications,
Event Source: "KDE System
Notifications" and uncheck sound items you
don't like.Where is RemoteMan, the remote connection manager
?RemoteMan has been replaced by our Bookmark Manager
since Krusader 1.25-beta1. The Bookmark Manager handles
local files and
remote
&URL;'s the same way. RemoteMan was left
as a selection until &krusader;-1.51 to allow
an easier transition and give you a chance to move your
&bookmarks-lnk;. RemoteMan was disabled, as
announced, in &krusader;-1.60.&URL; transition procedure:
install &krusader;-1.51open the RemoteMan and connect to an
&FTP;once inside, bookmark the current location,
select a name and save.do this for all your connections, all the
&bookmarks-lnk; are now stored in
krbookmarks.xmlinstall &krusader;-1.60, it will use
krbookmarks.xml or import it if
needed.Why doesn't mimetype magic sometimes work inside
archives?When you enter an archive and press
F3 to view a file that has no known
extension, ⪚
README, INSTALL &etc;. And
if the viewer opens in hex-mode instead of the usual
mode, than you need to configure:
KDE Control CenterKDE componentsFile AssociationsApplicationoctet-stream,
binary viewer needs to be
removed.Where is Konfigurator, do i need to install the &kde; Desktop Enviroment to use it?Konfigurator is &krusader;s configuration module,
when you have installed &krusader; than you have also Konfigurator.
For some reason some people think it's an other &kde; application, but it is not, so
you don't need to install the &kde; Desktop Enviroment to use Konfigurator.
When runnig &krusader;, use
SettingsConfigure &krusader;, and it will start
Konfigurator.
Please read the manual, &krusader; has many many configuration options,
a lot of things can be customized to your needs with Konfigurator.
How can I set the look & feel of 2
different users to be the same?Presuming that the current setup is the good
configuration, you can copy the configuration to the
other user.
#cp ~/.kde/share/config/krusaderrc /home/foo_user/.kde/share/config
And when the other user is Root use:
#cp ~/.kde/share/config/krusaderrc /root/.kde/share/configWhy doesn't "save last location" work?Unfortunately the 1.70.x version contains a bug.
The tabs are not saved if a "Panels Save Settings=Tabs"
item is present in the configuration files. The fix is
easy:
open and edit
~/.kde/share/config/krusaderrcremove the "Panels Save Settings" itemand it'll work with the
<Last Session> feature in
Konfigurator. More info can be found in
our forum.Why doesn't the handbook work?This error will happen on &debian; (or
&debian; based) distro with the
krusader_1.51-1_i386.deb package. You will see the next
error message if you try to open the handbook: "The
requested help file could not be found. Check that you
have installed the documentation." To fix it go to
/usr/share/doc/kde/HTML/en/krusader/, you will
see the
foo.docbook.gz files. Now, you need
to extract all these files with root privileges
("File->Unpack" with &krusader;)
to create
foo.docbook files. Now the handbook
will work. This error is fixed in the
krusader_1.60.0-1_i386.deb package and higher
versions.General &FAQ;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
&forum-lnk;, or the krusader-users
&mailing-lists-url;. For information on what
remains to be done look at the
&todoforum-url;. Adding ToDo items into the
&todoforum-url; is for developers only, but
feel free to post to the &featureforum-url;
for things that aren't on the &todoforum-url;,
but should be. If you have a nice feature request, the
&krusader; Krew will add your request to the
&todoforum-url;. We review and discuss every
submission. For more information how the forum works
click
here.How can I send a patch?It's not easy to write patch guidelines, but here
are some.
Patches, new code or new features are always
welcome!Focus only on one problem at a time, so the
developers can easily understand you, and commit your patch
it works.Preferrably, you can start a discussion
with the developers on the krusader-devel
&mailing-lists-url; or on the
&forum-lnk;. 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.
Submit your patch files into our &patch-tracker-url;,
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-url;, thanks!
Use portable solutions, &krusader;
should run on:
All POSIX
(&Linux;/BSD/&UNIX;-like
OSes), &Solaris;.All BSD Platforms
(&freebsd;/&netbsd;/&openbsd;/&MacOS;).&kde; 3.3- &kde;
3.5 and even on GNOME with
&kde;libs (for krusader-2.x &kde; 4) .GCC 2.95 - GCC 4.1Architecture changes are made by the
team only.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.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:
Use the &forum-lnk;'s
&kruforumsearch-url; function , your bug
might be already solved . Please DO NOT post new bugs
to the &bugforum-url; (except if you are
not sure that you have found a bug). We use it for
bug discussions.Check if the bug is
already posted in the &online-buglist-url;
of the Bug Tracking System.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!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 &kioslaves1-url; or
&kde; (tdelibs) bug, and not a
&krusader; bug. &krusader; uses
the &kde; libraries and the
&kioslaves2-url; for many operations. In
some cases you can encounter problems if your
distribution is incorrectly configured, please test it
first as explained above.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.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
Install valgrind, a suite of tools for debugging and profiling &Linux; programs.
Run Valgrind/&krusader;
$valgrind{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.
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
If the KDEKrashhandler still doesn't provide usefull backtrace information, than sometimes a coredump will give better information.
Run Krusader, with disabled crashhandler.
$krusader
On a crash you will get a .core file, usually in your home directory.
Run gdb, the GNU Project Debugger
$gdbcorefile 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.
Does &krusader; have a mailing
list?Yes, currently we have 6
&mailing-lists-url;. 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.
&krunews-url; 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 &krulatestnews-url; and in
the &newsforum-url; which are basically
the same but displayed in another format.&krudevel-url; 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.&kruusers-url; is the
&krusader; users mailing list. Here you
can ask for help and talk with the
&krusader; users and developers.&krui18n-url; is the translations
mailing list.&krudoc-url; is the documentation
mailing list.&krucommits-url; (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.Does &krusader; provide
newsfeeds?Yes, we do. Several newsfeeds in various formats
are available. &filereleasefeed-url;,
&forumfeed-url;, &krunewsfeed-url;,
&krudevelfeed-url; and even
additional feeds by gmane.org.
&kruusersfeed-url;,
&krui18nfeed-url;,
&krudocfeed-url;.Does &krusader; have an IRC
channel?Yes, we do. Feel free to talk to the
&krusader; Krew and fellow-users via
&freenode-url; servers. The server is
irc.freenode.org, the channel is
#krusader. Everyone is
welcome.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-lnk;, &kruforum-url; and
&krudevel-url; (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 &kruforumsearch-url;
function of the &kruforum-url;, 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-lnk;. This allows us to spend more time
developing &krusader;.The &kruforum-url; is split into seven
sections:
&newsforum-url;: all the latest
news.&newsletterforum-url;: all newsletters.&bugforum-url;: discussions about
bugs, please DO NOT use the forum for
&faqbugreports-lnk; (except if you are
unsure if you have found a bug).&featureforum-url;: discussions
about new features for future &krusader;
versions.&todoforum-url; 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 &todoforum-url;. The
&todoranking-url; 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.&useractionsforum-url;: discussions
about &useractions-lnk;. Posting your own
User Actions is greatly appreciated. We plan to
include the best ones in the next
&krusader; releases.&krugenforum-url;: 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 &rss-url;.How can I translate &krusader; into my
native language?Please read the &i18n-page-url;. It's
not difficult to translate! Most anyone can do it, it
just takes some time.How can I support &krusader;?You can
support &krusader; in many different
ways. Please send us
feedback,
&faqbugreports-lnk;, patches,
donations,
translations, ...Is there a &MacOS; X port?Yes, there is &MacOS; X port, but you
will not have the all the power you would have on
&Linux;. Please read the
&MacOS; X port
section for more information. A recommended native
file manager for &MacOS; is
&disk-order-url; (shareware).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 &tcmd-url; (shareware).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.Why should I use an
OFM?An &ofm-url; 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.