README

   1                         ROX-Filer
   2                         A RISC OS-like filer for X
   3                         by Thomas Leonard
   4
   5
   6
   7 Quick start
   8 ~~~~~~~~~~~
   9 Type this ($ is the shell prompt):
  10
  11         $ ./install.sh
  12
  13 and follow the on-screen instructions. If you want to compile as a normal
  14 user and install as root then you should do this instead:
  15
  16         $ ROX-Filer/AppRun --compile
  17         $ su
  18         [ enter root password ]
  19         $ ./install.sh
  20
  21
  22 CVS notes
  23 ~~~~~~~~~
  24 If you got this from CVS then you'll need to have 'autoconf' installed
  25 before you can compile (the snapshots on the FTP site don't require this).
  26
  27 You will also need to create the postscript manual from the Lyx file and
  28 run 'dist' in 'ROX-Filer/src/po' to get the translations.
  29
  30 Instructions on getting rox via CVS can be found at:
  31
  32         http://sourceforge.net/cvs/?group_id=7023
  33
  34 Once you have a version of rox from CVS you can update it by simply doing
  35
  36         $ cvs -z3 update
  37
  38 from inside the 'rox' directory.
  39
  40 Finally, remember that the CVS version is the very latest developer code. It
  41 has not been well tested. It may have bugs. It may not even compile. You
  42 have been warned!
  43
  44
  45 ROX-Filer
  46 ~~~~~~~~~
  47 Help for ROX-Filer can be found in the directory ROX-Filer/Help.
  48
  49
  50 Files
  51 ~~~~~
  52
  53 Two places are used for MIME-handling configuration files:
  54
  55 <Choices>/MIME-info/*
  56         Contains the rules for guessing a file's type from its name.
  57         Many programs come with files called '<prog>.mime' which contain
  58         additional rules. Put these files in the MIME-info directory too.
  59
  60 <Choices>/MIME-types/*
  61         Contains programs or symlinks which will be run.
  62         For example:
  63
  64         $ rox picture.gif
  65         is like doing
  66         $ <Choices>/MIME-types/image_gif picture.gif
  67         or, if that isn't found,
  68         $ <Choices>/MIME-types/image picture.gif
  69
  70 In both cases, <Choices> is all the directories in your CHOICESPATH
  71 environment variable, which defaults to:
  72
  73         ~/Choices:/usr/local/share/Choices:/usr/share/Choices
  74
  75 The leftmost directory listed is searched first, followed by the others in
  76 order. If the string starts with a `:' then saving is disabled and no program
  77 will attempt to save any configuration into it. For more details, see:
  78
  79         <http://rox.sourceforge.net/choices.php3>
  80
  81
  82 Conditions
  83 ~~~~~~~~~~
  84 This program is free software; you can redistribute it and/or modify
  85 it under the terms of the GNU General Public License as published by
  86 the Free Software Foundation; either version 2 of the License, or
  87 (at your option) any later version.
  88
  89 This program is distributed in the hope that it will be useful,
  90 but WITHOUT ANY WARRANTY; without even the implied warranty of
  91 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  92 GNU General Public License for more details.
  93
  94 You should have received a copy of the GNU General Public License
  95 along with this program; if not, write to the Free Software
  96 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  97
  98 Please report any bugs to me, <tal197@users.sourceforge.net>.