GNOME Commander Version 1.0.1 Copyright (C) 2001-2003 Marcus Bjurman http://www.nongnu.org/gcmd/ Topics: --------------------- 1. Introduction 2. Contributing 3. Building 4. Communication 5. FAQ 6. Known problems 1. Introduction -------------------------------- GNOME Commander is a nice and fast file manager for the GNOME desktop. Read the sections "FAQ" and "Known problems" to see if there are some known problems with the version you are using. The TODO file might also contain some clues when running into problems. The ChangeLog contains a detailed description on what has changed. For normal users the NEWS file might be a better place to look since it contains change summaries between the different versions. 2. Contributing -------------------------------- If you're not an programmer but have some good ideas for stuff that you want to see in this program, check the TODO file first before sending email. If you want to submit a patch please do so but remember the following: * Send an email with the patch to the developers mailing list. DO NOT send the patch as an attachment. Instead include it as text right after the your description of what it does. * Please use the -u flag when generating the patch. * Write a good explanation of what the patch does. Special note for translators: * Send translations as gzipped or bzipped attachments to avoid losing language specific characters. * The encoding of the files should be UTF-8. Special note for pixel tweakers: * Help on the default low-res mime theme (pixmaps/mime-icons) is very welcome. 3. Building -------------------------------- This is a list of required libraries: * gnome-libs: Used for the graphics of the program. * gnome-vfs: Used for most of the file handling. If you have the libraries above the "./configure; make; make install" procedure should work like a charm. This is a strongly recommended library: * FAM (http://oss.sgi.com/projects/fam/index.html): Used to monitoring file alterations, which means that when you create/delete/modify a file this program gets a message from FAM so it can update it's directory views. You can build this program without FAM but then you'll have to prepare to do a lot of manual reloading since even files that are altered with this program won't show up until you manually reload. Update: from 0.9.8 and on files modified within GC should update without FAM. 4. Communication -------------------------------- This project has two mailing lists, one for users and one for developers. Subscription to those mailing lists can be done at: users: http://mail.freesoftware.fsf.org/mailman/listinfo/gcmd-users devel: http://mail.freesoftware.fsf.org/mailman/listinfo/gcmd-devel You can also find email addresses of the people who have created gnome-commander in the AUTHORS file. 5. FAQ -------------------------------- [Q1] When will GNOME Commander support browsing of compressed archives? [A1] This will be done when GnomeVFS gets it working. All file operations are done using this API so it would be very impractical to implement it using some other library. [Q2] Some of the keyboard shortcuts in GNOME Commander are also used by my window manager, can they be changed? [A2] Not at the moment, but maybe later on. [Q3] When will GC be using gnome2? [A3] Somewhere down the line from a stable v1.0. 6. Known problems -------------------------------- Problem: GNOME Commander sometime crashes when searching for files in the search dialog on RedHat 8.0 Solution: This is because the shipped gnome-vfs-1.0.5 package has some backported gnome-vfs-2.0 patch that breaks it. Upgrading to the new version in rawhide solves the problem. TIP: If you compile the new version from source-rpm you dont have to update 100+ other rpms to solve dependencies.