1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
|
INSTALL file for launcher version 0.85
Ethan Gold <etgold@cs.columbia.edu>
0: Support Files
----------------
The launcher script itself should run out-of-the-box. However it
does need access to a couple files before it will do anything useful.
It needs to be able to find a type-to-extension map in the format
of Apache's mime.types file. A sample is included. It also needs
to be able to find a file which maps MIME types to handlers. This
is in a launcher-specific format and a sample is also included.
In order for the Launcher to be able to use the Unix "file" command
effectively, it must be able to specify to the file command the location
of a magic number file containing useful MIME output strings. A sample from
the Apache distribution is included.
You may wish to use versions of these files that you already have
at your site.
Recommended locations:
/etc/mime.types
~/.mime.types for users additions - note that Netscape may
write a file here which is in a completely differerent
and unuseable format.
/etc/launcher.map
~/.launcher.map
/etc/magic.mime - you probably should NOT overwrite your
existing /etc/magic
~/.magic.mime
The Launcher should operate if any of these files are missing
as long as at least one launcher.map file is found.
If both magic.mime and mime.types are missing, the Launcher will
have no way of typing a file. The config files can be installed
entirely in your own directory if you don't want to or can't add
files to /etc. Or you can mix and match any combination of local
and global file locations. For widespread global configuration on
an NFS filesystem you might want to use /usr/local/etc instead of
/etc. The global definitions section at the top of the launcher(.tcl)
file is easily edited to reflect non-vanilla installations.
1. Edit the top of the Makefile to reflect your desired installation
location.p
Run "make install"
OR
copy launcher.tcl to /usr/local/bin/launcher, or anywhere in your path
copy launcherchoice.tcl to /usr/local/bin/launcherchoice, or anywhere in your path
2. For global support file installation, run
"make installfilesglobal"
OR
For local support file installation, run
"make installfileslocal"
OR
Copy the example mapping file, mime.types file, and magic.mime
file to a location you would rather use. If you do not use
the Makefile to do this you will have to edit the launcher.tcl
script directly to reflect the locations of the support files.
If you have existing copies of these files, do not overwrite them
blindly as you will lose any changes you have made.
3. Edit ~/.launcher.map or /etc/launcher.map to reflect your preferences.
The first handler defined for each type is the default. If more than
one handler is defined per you will be prompted to choose one of them
unless the "--default" commandline option is used, in which case all
user queries are suppressed and the first defined hanlder is automatically
invoked.
4. Test by trying to open a file with the launcher.
5. Try using launcher from netscape by editing your helpers
list and entering "launcher %s" for types that are
defined in your .launcher.map file
|