GNOME Commander Version 1.10.2 Copyright (C) 2001-2006 Marcus Bjurman <marbj499@student.liu.se> Copyright (C) 2007-2012 Piotr Eljasiak <epiotr@use.pl> Copyright (C) 2013-2019 Uwe Scholz <u.scholz83@gmx.de> http://gcmd.github.io/ Topics: --------------------- 1. Introduction 2. Contributing 3. Building 4. Communication 5. Problem reporting 1. Introduction -------------------------------- GNOME Commander is a fast and powerful twin-panel file manager for the GNOME desktop. Read the section "Known Bugs and Limitations" in the documentation (by pressing F1) 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 most users the NEWS file might be a better place to look since it contains change summaries between the different versions. GNOME Commander is released under the GNU General Public License (GPL) version 2, see the file 'COPYING' for more information. The official web site is: http://gcmd.github.io/ You can download the latest GNOME Commander tarball from the gnome ftp server: http://ftp.gnome.org/pub/GNOME/sources/gnome-commander/ 2. Contributing -------------------------------- Ideas: If have some good ideas for stuff that you want to see in this program you should check the TODO file first before sending email. After that you're welcome to start a discussion on the mailing lists. Translations: * This program is in the GNOME git repository, translations should be commited directly to the tree there. Cool hacks: * Send an email with the patch to the developers mailing list. * Please use the -u flag when generating the patch as it makes the patch more readable. * Write a good explanation of what the patch does. Plugins: * If you have created a new plugin let us know about it on the mailing list. 3. Building -------------------------------- GNOME Commander requires glib >= 2.44.0, GTK+ >= 2.18.0, gnome >= 2.4.0 and gnome-keyring >= 2.22 libraries. Additionally GNOME Commander may require: * gnome-vfs >= 2.0.0 Used for most of the file handling. If gnome-vfs is built to use fam gnome-commander makes use of that functionality by being able to update its visible directories even when files are create/deleted or changed by other programs. * unique >= 0.9.3 Optional - for uniqueness support: only one running instance at a time * python >= 2.5 Optional - for python plugins support. * exiv2 >= 0.14 Optional - for Exif and IPTC support. * taglib >= 1.4 Optional - for ID3, Vorbis, FLAC and APE support. * libgsf >= 1.12.0 Optional - for OLE and ODF support. * poppler >= 0.18 Optional - for PDF support. If you install GNOME Commander by manually compiling the sources, keep in mind that on most Linux distributions you have to install the development packages for the above libraries to be found by the configure script. These packages are normaly indicated by a "-dev" or "-devel" suffix, e.g. libgnome-dev, taglib-dev, etc. Simple install procedure: % tar -xf gnome-commander-1.10.2.tar.xz # unpack the sources % cd gnome-commander-1.10.2 # change to the toplevel directory % ./configure # run the `configure' script % make # build GNOME Commander [ Become root if necessary ] % make install # install GNOME Commander See the file 'INSTALL' for more detailed information. 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: https://lists.nongnu.org/mailman/listinfo/gcmd-users devel: https://lists.nongnu.org/mailman/listinfo/gcmd-devel You can also find email addresses of the people who have created gnome-commander in the AUTHORS file. 5. Problem reporting -------------------------------- Bugs should be reported to the GitLab instance of Gnome (https://gitlab.gnome.org/GNOME/gnome-commander/issues). You will need to create an account for yourself. You can also report bugs using the GNOME program bug-buddy. In the bug report please include: * Information about your system. For instance: - What operating system and version - What version of X - What version of the gtk+, glib and gnome libraries - For Linux, what version of the C library And anything else you think is relevant. * How to reproduce the bug. * If the bug was a crash, the exact text that was printed out when the crash occurred. * Further information such as stack traces may be useful, but is not necessary. If you do send a stack trace, and the error is an X error, it will be more useful if the stack trace is produced running the test program with the --sync command line option. See the file 'BUGS' for the list of known bugs.