			HELLO

to all of you. After having being away and not been able to work on
xemp & tcemp, I'm back again, just in time to study for my exams. I
will devote some of my time to empire, but will not really start untill
february.
------------------------------------------------------------------------------
		    PLEASE HELP ME

As I want all the documentation available with the next release of xemp
(& tcemp), there is a lot of work to do. Therefore I'm asking all of you
to help me to write the documentation. If everybody writes some help,
xemp could be released in (relative) short notice.
------------------------------------------------------------------------------
			 TODO

I would like the next info to be written:

Sector commands:
	attack		break		build		buy
	capitol		convert		demobilize	designate
	distribute	enlist		explore		fire
	grind		move		radar		sell
	shoot		spy		territory	wipe

Ship commands:
	assault		board		fleetadd	load
	mine		name		navigate	radar
	scrap		scuttle		sonar		torpedo
	unload		upgrade	

Plane commands:
	arm		bomb		drop		fly
	harden		launch		load		paradrop
	recon		scrap		scuttle		transport
	unload		wingadd

Concepts:
	technology	research	work		available
	fallout		efficiency	deliver		distribute
	market		power (...)	produce		financial
	overview	plague		sector-types	ksu-options
	deity		news		headlines	communications

Info
	census		ship		plane		nuke
	show [spnb]	

Xemp
	compiling	menus		startup		startup
	xemprc		(help)

Tcemp
	compiling	menus		startup		startup
	xemprc		buttons		(help)

Parser
	syntax		programs	highlight	expression

And any other info-file you (or I) might think of.
------------------------------------------------------------------------------
			MACROS

The following macro's have been written to help everyone writing
documentation. This is just a quick reference, take a look at the
docs I wrote to see how they work. When you write a command, you
can use the templates I've written.

.Sh <Subject header>	New subject. Will be printed at the top of each page.
			Will also be added to the table of contents.

.s1			One empty line, bnut allocates some space to the
			bottum of the page.

.Cm <Command-name>	Sector command
.Pc <Command-name>	Plane command
.Sc <Command-name>	Ship command
.Nc <Command-name>	Nuke command

.Np <Subject>		New paragraph with <Subject>

.Cd			Command description

.Ko <Ksu-option>	This command only works if "ksu-option" is defined
			in the game.

.Bi <args> ..		Binding
.Be <key> <args>	Binding example
.Bx <key> <args>	Another Binding example

.Cs			Cost of the command

.Ag			Again header.
.Na			You can't redo this command.

.Ba			This command will always be buffered.
.Bf			This command will only be buffered if you use forced
			buffering.
.Bn			This command cannot be buffered.

.So <source-file>	Where the source can be found

.Sa <info-file> ..	See also

.Sl			Shift left (indent left)
.Sr			Shift right (undo a .Sl)

.Si <long word>		Set indent
.Ir			Indent right (To position set by .Si)
.Ei			End indent

------------------------------------------------------------------------------
			SHOW COMMAND

To view a doc-file you just wrote, use the show command:

show file.t	-- use nroff & more
show -v file.t	-- use nroff & vi
show -x file.t	-- use troff & xtroff
------------------------------------------------------------------------------
			MAILING LIST

I've set up two mailing lists: xemp-doc & xemp-pr (documentation and
programming). When I release tcemp, I will also add a xemp-users
list. To join a mailing list, send mail with the following subject to
me (hjvissc@cs.vu.nl):

Subject: ML ADD (xemp-doc, <username>, <address>)

	Example: I would send a message with the subject:
		 ML ADD (xemp-doc, Henk-Jan Visscher, hjvissc@cs.vu.nl)

To forward an article, use

Subject: ML ADD (xemp-pr, Some new info files)

	Which will be sent to all users which have subscribed to this
	list, under the subject "Some new info files".

To remove yourself from a mailing list use the following subject:

Subject: ML DELETE (xemp-pr, <address>)

	But do not use this to soon, something goes wrong, I think..
------------------------------------------------------------------------------
			WHERE TO GET

Connect to: star.cs.vu.nl (or ftp.cs.vu.nl)
and get:    [pub/]xemp/secret/info.01.tar.Z

Unpack in the xemp-directory. This will extract the 'show' program
and the info files.
------------------------------------------------------------------------------
Thanks for your help in advance,
Henk-Jan.

     +-------------------+---------------------------------------------+
     | Henk-Jan Visscher |   If something works the first time,        |
     | hjvissc@cs.vu.nl  |     try to hide your astonishment.          |
     +-------------------+---------------------------------------------+
