You need a C compiler and a working Tcl/Tk installation. (The
elite-editor program needs Tk; the rest of the tools don't.)
- The Makefile works on my Debian GNU/Linux box, but I'm not
- making any promises about anyone else's. I've successfully
+ The Makefile works on my Debian GNU/Linux box (potato), but I'm
+ not making any promises about anyone else's. I've successfully
built earlier versions of everything under Cygwin, against
ActiveState's Tcl 8.4, but I've forgotten the Holy Runes. I do
have the `.def' file I used to build the DLL, though, for
whatever that's worth. (If you want to hack the Makefile to
work under Windows, I'll take a patch.)
+ The runes for Debian woody are:
+
+ $ make INCLUDES=/usr/include/tcl8.3
+ $ ROOTLY make install prefix=/usr
+
+ (where ROOTLY is some command which does things with root
+ privileges, say `sudo', `become root' or, at a pinch, `su -c')
+ because the Tcl installation no longer looks in /usr/local/lib,
+ worse luck.
+
The theory is that you should edit the Makefile for your system
and say `make'; then, as some suitably privileged person, say
`make install' and stand well back. Everything should then be
- elite-path [-g GALAXY] [-w WEIGHT] PLANET PLANET ...
+ elite-path [-g GALAXY] [-w WEIGHT] [-a ACC] PLANET PLANET ...
Computes a route through a GALAXY (default is standard galaxy
1), starting at the first PLANET listed, via the second, via the
fuel Minimize absolute distance. For those on a
tight budget.
+ The `-a' option controls what total is accumulated down the
+ right hand side of the summaries:
+
+ none No running total down the right hand side.
+
+ distance Accumulate distance, in lightyears.
+
+ weight Accumulate the shortest-path weight function.
+
+ Beneath the path is printed a total for distance and weight if
+ these are interesting and not already displayed. The weight for
+ `hops' and `fuel' are simply the hop count and distance in
+ lightyears respectively; the other weight functions use
+ appropriate square-law functions.
+
elite-reach [-d DIST] [GALAXY ...]
as the variables described above.
+ elite-cmdr [FILE] [-OPTION | ATTR | ATTR=VALUE | FILE] ...
+
+ A command-line Elite commander editor and viewer. With a single
+ argument, reads a commander file and displays its contents as a
+ human readable table. The arguments may be special options,
+ attribute names, attribute assignments, or filenames.
+
+ The special options are:
+
+ -show Write the commander data to standard output as a
+ human-readable table. This is the default if no
+ other output action is requested.
+
+ -load FILE Read the commander file named FILE.
+
+ -save FILE Write the modified commander data to FILE.
+
+ -reset Reset the commander to the default `JAMESON'
+ settings.
+
+ -dump Write the commander data to standard output in
+ the form of a script which can be read back by
+ the `-read' option.
+
+ -read FILE Read attribute/value pairs from FILE, and modify
+ the commander accordingly.
+
+ An attribute name on its own is a request to print the current
+ value of that attribute. An assignment ATTR=VALUE makes ATTR
+ have the requested VALUE.
+
+ The attributes, their meanings, and the acceptable values are as
+ follows:
+
+ mission The commander's current mission. (0 is no
+ mission; 1 is searching for the Constrictor; 2
+ is killed the Constrictor; 3 is waiting for the
+ second mission; 4 is heading for Ceerdi; 5 is
+ heading for Birera; and 6 is all missions
+ completed.) Must be an integer between 0 and
+ 255.
+
+ score Current number of kills. Must be an integer
+ between 0 a 65535, or one of the strings
+ `harmless', `mostly-harmless', `poor',
+ `average', `above-average', `competent',
+ `dangerous', `deadly', or `elite'.
+
+ credits Number of credits. Must be between 0 and
+ 429496729.5.
+
+ cargo Size of cargo bay. Must be between 4 and 255.
+
+ gal-number Number of the current galaxy. Note that this
+ doesn't affect which galaxy the commander is
+ actually in -- set gal-seed for that. Must be
+ between 1 and 8.
+
+ gal-seed Which galaxy the commander is in. May be any
+ galaxy-spec.
+
+ world Which world the commander is docked at. May be
+ any planet-spec describing a world in the
+ correct galaxy. (Note that, since the commander
+ file actually stores the location as an x, y
+ pair and chooses the closest world to those
+ coordinates, and there are coincident pairs of
+ worlds, it is not possible to have a commander
+ start at some worlds.)
+
+ market-fluc The market fluctuation byte. Affects prices at
+ the space station. Must be an integer between 0
+ and 255.
+
+ fuel Amount of fuel. Must be between 0 and 25.5.
+
+ energy-unit Strength of the ship's energy unit. May be an
+ integer between 0 (none) and 255 (scary cheat)
+ or one of the strings `none', `standard', or
+ `naval'.
+
+ front-laser, rear-laser, left-laser, light-laser
+ Strength of appropriate laser. May be an
+ integer between 0 (none) and 255 (scary cheat)
+ or one of the strings `none', `pulse', `beam',
+ `mining', or `military'.
+
+ ecm, fuel-scroop, enery-bomb, escape-pod,
+ docking-computer, gal-hyperdrive
+ Whether the ship has various bits of equipment.
+ One of `yes', `true', or `on' for yes, or `no',
+ `false' or `off' for no.
+
+ missiles Number of missiles carried. Must be an integer
+ between 0 and 255.
+
+ hold-ITEM, station-ITEM
+ Quantity of some item in the ship's hold, or at
+ the station. Must be an integer between 0 and
+ 255. ITEM must be one of `food', `textiles',
+ `radioactives', `slaves', `liquor-wines',
+ `luxuries', `narcotics', `computers',
+ `machinery', `alloys', `firearms', `furs',
+ `minerals', `gold', `platinum', `gem-stones', or
+ `alien-items'.
+
+ # A special attribute which is never printed. Its
+ value is ignored. This may be used to insert
+ comments in script files.
+
+ Anything else is assumed to be a filename, and loaded as for the
+ `-load' option.
+
+
elite-prices [-g GALAXY] [-s SORT] [FROM TO]
Shows minimum, average and maximum profit (in that order, in
3. The graphical editor
- elite-editor [GALAXY | FILE]
+ elite-editor [GALAXY | FILE | -jameson]
Starts the RIGHT ON COMMAND-LINE Commander Editor and Map. This
is a Tk program -- you'll need that installed to run it.
the home and destination worlds, and the distance between them.
You can type new names (or any old planet spec) into either to
select different planets. The change will take place when you
- press return or when the input focus moves.
+ press return or when the input focus moves. Pressing control-
+ return will pop up the appropriate planet info window.
The `Compute path' lets you do the same kinds of computations as
the elite-path tool. It plots a route from the home to the
unrewarding) or pirates (risky and tedious), and start trading
food and other cheap items.
-$Id: README,v 1.3 2003/02/26 01:12:30 mdw Exp $
+$Id: README,v 1.6 2003/03/04 10:25:43 mdw Exp $
\f
Local variables:
mode: text
~mdw / rocl / blobdiff