README for SpaceFM v0.7.0 ALPHA TEST VERSION


USE AT YOUR OWN RISK

    This is an alpha test release - please test functions carefully


For updates and instructions visit:
    http://spacefm.sourceforge.net/
    http://spacefm.sourceforge.net/spacefm-manual-en.html


CONTENTS:

    DESCRIPTION
    PACKAGES
    INSTALLER
    BUILD INSTRUCTIONS 
    MANUAL UN-INSTALL INSTRUCTIONS
    DEBIAN PACKAGING INSTRUCTIONS
    

DESCRIPTION:

    SpaceFM is a multi-panel tabbed file manager with built-in VFS, optional
    udisks-based device manager, customizable menu system, and bash integration.
    SpaceFM is a fork of legacy PCManFM.  Earlier versions of this program were
    released under the name PCManFM-Mod.


PACKAGES:

    Debian/Ubuntu packages are available here:
        http://sourceforge.net/projects/spacefm/files/
        
        For signatures and SHA256 sums see 
            http://spacefm.sourceforge.net/spacefm.SHA256.txt
    
    and are also available in the author's PPA:
        http://igurublog.wordpress.com/downloads/ppa/
    
    Gentoo's portage tree includes spacefm:
        http://packages.gentoo.org/package/x11-misc/spacefm

    Arch Linux's AUR includes spacefm:
        http://aur.archlinux.org/packages.php?ID=55777
    

INSTALLER:

    A self-extracting installer is available:
        http://sourceforge.net/projects/spacefm/files/

        For signatures and SHA256 sums see 
            http://spacefm.sourceforge.net/spacefm.SHA256.txt

    The installer MUST be run in a terminal.  It automatically builds and
    installs.  Run it like this:
    
        bash spacefm-x.x.x-installer.sh
        
    or to see options:
    
        bash spacefm-x.x.x-installer.sh --help

    The installer requires the build dependencies listed below.  If any
    dependencies are missing, examine the error, install missing packages,
    and try again.
       
    To reinstall or upgrade, just run the latest installer again.


BUILD INSTRUCTIONS:

1)  Install required build dependencies (below are Debian package names - 
    packages names on your distro may vary but should be similar):

        autotools-dev dbus desktop-file-utils libc6 libcairo2 libdbus-1-3
        libglib2.0-0 libgtk2.0-0 libpango1.0-0 libstartup-notification0
        libx11-6 shared-mime-info intltool pkg-config libgtk2.0-dev
        libglib2.0-dev fakeroot libstartup-notification0-dev libdbus-1-dev
        libgdk-pixbuf2.0-0
 
    NOTE: libgtk must be >= 2.24.  Debian Squeeze and Ubuntu 10.04 users
        may not be able to install SpaceFM due to repositories missing package
        libgdk-pixbuf2.0-0

    Also Recommended: udisks ktsuss|gksu wget eject lsof

    IF building with HAL support, you also need:
        hal libhal-dev libhal-storage-dev libdbus-glib-1-dev libhal-storage1
        libhal1 libdbus-glib-1-2

    IF disabling inotify support, you also need fam or gamin:
        fam|gamin libfam0|libgamin0 libfam-dev|libgamin-dev

    configure will report anything missing when you run it as shown below.
    
2)  Extract spacefm-x.x.x.tar.xz and enter directory.  The following commands
    will build and install as "/usr/local/bin/spacefm":
    
        ./configure
        make
        sudo make install
        sudo update-mime-database /usr/share/mime > /dev/null
        sudo update-desktop-database -q

    NOTE: If configure reports missing dependencies, install them and run
    configure again before proceeding to make.

    NOTE: If hal support is desired (this will disable udisks support and will
    seriously limit device manager capabilities), add --enable-hal to the
    configure command above.

    NOTE: If you don't want to use the inotify kernel support and instead
    want fam or gamin to detect directory changes, add to configure:
        --disable-inotify
        
    NOTE: SpaceFM supports ktsuss, gksu, gksudo, and kdesu.  To build with an
    additional custom su program ('/usr/bin/mysu' in this example), add:
        --with-preferable-sudo=/usr/bin/mysu  # to the configure command

    For general build information consult the INSTALL file.


MANUAL UN-INSTALL INSTRUCTIONS:

As root:
    rm /usr/local/bin/spacefm
    rm -r /usr/local/share/spacefm
    rm /usr/local/share/pixmaps/spacefm.png
    rm /usr/local/share/pixmaps/spacefm-root.png
    rm /usr/local/share/locale/*/LC_MESSAGES/spacefm.mo
    rm /usr/local/share/applications/spacefm*.desktop
    rm /usr/local/share/mime/packages/spacefm-mime.xml
    update-mime-database /usr/local/share/mime > /dev/null
    update-desktop-database -q


DEBIAN PACKAGING INSTRUCTIONS:

To build a deb file of spacefm:

1)  Install build dependencies (see BUILD INSTRUCTIONS above).

2)  Extract tarball and enter directory.

3)  IF hal support IS desired:

        cp debian/control-hal debian/control
        cp debian/rules-hal debian/rules

4)  Build package:

        dpkg-buildpackage -b

    The package files will appear in the parent directory.


