

 XFE, X File Explorer File Manager
 Copyright (C) 2002-2008 Roland Baudin
 <http://roland65.free.fr/xfe>
 <http://sourceforge.net/projects/xfe>

 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2, or (at your option) 
 any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of 
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the  
 GNU General Public License for more details.

 Icons were taken from different file managers: gentoo, xplore, dfm, nautilus, and
 some of them were modified.

 This software uses the FOX Toolkit Library (http://www.fox-toolkit.org).
 
 *IMPORTANT REMARKS *
 1. You must use the current stable Fox version 1.6.16 (required!) or higher in the 1.6.x branch. 
    The current version of Xfe neither can be build using the Fox 1.0.x, 1.2.x, 1.4.x, nor using the 1.7.x series.
 
 2. UTF-8 is now supported, thus check that your LANG environment variable is set to be UTF-8 compliant otherwise accents and special
 characters could be wrong displayed. 
  
 Description
 ~~~~~~~~~~~
  X File Explorer (xfe) is a lightweight file manager for X11, written using the FOX toolkit.
  It is desktop independent and can easily be customized.
  It has Commander or Explorer styles and it is very fast and small.
  Xfe is based on the popular, but discontinued X Win Commander, written by Maxim Baranov.

 Features
 ~~~~~~~~
  - Very fast graphic user interface
  - UTF-8 support
  - Commander/Explorer interface with four file manager modes: a) one panel, b) a directory tree
    and one panel, c) two panels and d) a directory tree and two panels
  - Panels synchronization and switching 
  - Integrated text editor (X File Write, xfw)
  - Integrated text viewer (X File View, xfv)
  - Integrated image viewer (X File Image, xfi)
  - Integrated package (rpm or deb) viewer / installer / uninstaller (X File Package, xfp)
  - Copy/cut/paste files from and to your favorite desktop (GNOME/KDE/XFCE/ROX)
  - Drag and Drop files from and to your favorite desktop (GNOME/KDE/XFCE/ROX)
  - Root mode with authentication by su or sudo
  - Status line
  - File associations
  - Optional trash can for file delete operations (trash can directory is ~/.xfe/trash)
  - Auto save registry
  - Double click or single click files and directories navigation
  - Right mouse click pop-up menu in tree list and file list
  - Change file(s) attributes
  - Mount/Unmount devices (Linux only)
  - Warn when mount point are not responding (Linux only)
  - Toolbars
  - Bookmarks
  - Back and forward history lists for directory navigation
  - Path linker for directory navigation
  - Color themes (GNOME, KDE, Windows...)
  - Control themes (flat or rounded gradient)
  - Icon themes (Xfe, GNOME, KDE, XFCE, Tango, Windows...)
  - Create / Extract archives (tar, compress, zip, gzip, bzip2, lzh, rar and ace formats are supported)
  - Tooltips with file properties
  - Progress bars or dialogs for lengthy file operations
  - Thumbnails image previews
  - and much more...

 Key bindings
 ~~~~~~~~~~~~
	* Help 								- F1
	* New file 							- F2
	* New window 						- F3
	* New root window 					- Shift-F3
    * View 								- return
    * Edit 								- F4
    * Copy 								- Ctrl-c
    * Copy to 							- F5, Ctrl-k
    * Cut 								- Ctrl-x
    * Paste 							- Ctrl-v
    * Move 								- F6, Ctrl-d
    * Symlink to						- Ctrl-s
    * Rename 							- Ctrl-n
    * New folder 						- F7
	* New symlink                       - Ctrl-j
	* Open 								- Ctrl-o
    * Move to trash 					- F8, del
	* Delete 							- Shift-del
	* Empty trash can					- Ctrl-del
	* Go to trash                       - Ctrl-F8
	* Go up 							- backspace
	* Go back 							- Ctrl-backspace
	* Go forward 						- Shift-backspace
    * Properties 						- F9
    * One panel 						- Ctrl-F1
    * Tree and one panel 				- Ctrl-F2
    * Two panels 						- Ctrl-F3
    * Tree and two panels 				- Ctrl-F4
	* Synchronize panels                - Ctrl-y
	* Switch panels                     - Ctrl-p
	* Large icons 						- F10
	* Small icons 						- F11
	* Detailed view 					- F12
    * Hidden folders 					- Ctrl-F5
    * Hidden files 						- Ctrl-F6
	* Thumbnails preview 				- Ctrl-F7
    * Execute 							- Ctrl-e
    * Go home 							- Ctrl-h
    * Terminal 							- Ctrl-t
    * Refresh 							- Ctrl-r
    * Select all 						- Ctrl-a
    * Deselect all 						- Ctrl-z
    * Invert selection 					- Ctrl-i
    * Add bookmark 						- Ctrl-b
    * Mount (Linux only) 				- Ctrl-m
    * Unmount (Linux only) 				- Ctrl-u
	* Open file panel context menu 		- Shift-F10
    * Quit 								- Ctrl-q, Ctrl-w
	
 - Drag and Drop operations:
    Dragging a file or group or files (by moving the mouse while maintaining the left button pressed)
	to a directory or a file panel optionally opens a dialog that allows to select the file operation: copy,
	move, link or cancel.

 Install from sources
 ~~~~~~~~~~~~~~~~~~~~
  Type:
  ./configure
  make
  make install
  
  or use the RPM package for Redhat and compatible Linux distributions, or the deb package for Debian
  and compatible distributions.

 Configuration
 ~~~~~~~~~~~~~
  From version 0.98 and above, the configuration scheme was changed. It is now independent of the FOX registry and
  should be more simple and intuitive.
  
  You can perform any Xfe customization (layout, file associations, ...) without editing
  any file by hand. However, you may want to understand the configuration principles,
  because some customizations can easily be done by editing the configurations files.
  Be careful to quit Xfe before hand editing any configuration file, otherwise changes could not be
  taken into account.

  The system-wide configuration file xferc is located in /usr/share/xfe, /usr/local/share/xfe
  or /opt/local/share/xfe, in the given order of precedence. 

  The local configuration files for Xfe, Xfw, Xfv, Xfi, Xfp are located in
  the ~/.xfe directory. They are named xferc, xfwrc, xfvrc, xfirc and xfprc.
  
  At the very first Xfe run, the system-wide configuration file is copied into the local configuration file
  ~/.xfe/xferc which does not exists yet. If the system-wide configuration file is not found (in case of an unusal install
  place), a dialog asks the user to select the right place. It is thus easier to customize Xfe (this is particularly true
  for the file associations) by hand editing because all the local options are located in the same file.

  Default PNG icons are located in /usr/share/xfe/icons/xfe-theme or /usr/local/share/xfe/icons/xfe-theme, depending on your installation.
  You can easily change the icon theme path in Preferences->Themes->Icon theme path. 


 Tips
 ~~~~
File list
   - Select files and right click to open a context menu on the selected files
   - Press Ctrl + right click to open a context menu on the file panel
   - When dragging a file/folder to a folder, hold on the mouse on the folder to open it

Tree list
   - Select a folder and right click to open a context menu on the selected folder
   - Press Ctrl + right click to open a context menu on the tree panel
   - When dragging a file/folder to a folder, hold on the mouse on the folder to expand it

Copy/paste file names
   - Select a file and press Ctrl-C to copy its name into the clipboard. Then in a dialog,
   press Ctrl-V to paste the file name.
   - In a file operation dialog, select a filename in the line containing the source name and paste
   it directly to the destination using the middle button of your mouse. Then modify it to suit your needs.


 Build an RPM package
 ~~~~~~~~~~~~~~~~~~~~
 You first need the correct fox-1.6.x and fox-devel-1.6.x packages to be installed.
 To create an RPM package from the Xfe sources, simply type:
   rpmbuild -ta xfe-VVV.tar.gz
 where VVV is the Xfe version number (e.g. 0.80).
 
 The created RPM package xfe-VVV-1.i386.rpm is usually located in /usr/src/rpm/RPM/i386, but this
 may vary depending on your distribution and/or your customizations.
 
 To install the created RPM package xfe-VVV-1.i386.rpm, enter the following command (as root):
   rpm -Uvh xfe-VVV-1.i386.rpm
 
 
 Build a Debian package
 ~~~~~~~~~~~~~~~~~~~~~~
 You first need the correct libfox1.6 and libfox1.6-dev packages to be installed.
 Extract the sources and enter the source directory:
   tar zxvf xfe-VVV.tar.gz
   cd xfe-VVV
 
 Then, build the Debian package (no need to sign the package, thus the -uc -us options):
   fakeroot dpkg-buildpackage -uc -us
 
 And finally, install the created package (as root):
   cd ..
   dpkg -i xfe_VVV-1_i386.deb


Build a self extracting package
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 You first need the correct FOX libraries 1.6.x installed and working on your system.
 First, extract the sources and enter the source directory:
   tar zxvf xfe-VVV.tar.gz
   cd xfe-VVV
 
 Create the required shell scripts makesfx.sh, header.sh and sfx.sh:
 ./configure
 
 Create the self extracting binary package:
 sh makesfx.sh
 
 And finally, install it to /usr/local (as root):
 sh xfe-VVV-i386.sh


 Bugs
 ~~~~
  Please report bugs to Roland Baudin <roland65@free.fr>..

 
 Translations
 ~~~~~~~~~~~~
  Xfe is now available in 18 languages. To translate Xfe to your language, open with a software like poedit,
  kbabel or gtranslator the xfe.pot file in the po directory of the source tree and fill it with your
  translated strings, and then send it back to me.
 
 
 Patches
 ~~~~~~~
  If you have coded some interesting patch, please send it to me, I will try to include it in the next release...

 Enjoy!
 
 Many thanks to Maxim Baranov for his excellent X Win Commander and to all people that have provided useful
 patches, tests and advices.
 
 [Last revision: 12/05/2008]



