(svn r2723) Make the manual page more informative

docs/openttd.6

@@ -1,50 +1,70 @@
 .\"                                      Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.TH OPENTTD 6 "September 16, 2004"
 .\" Please adjust this date whenever revising the manpage.
-.\"
+.Dd July 27, 2005
-.\" Some roff macros, for reference:
+.Dt OPENTTD 6
-.\" .nh        disable hyphenation
+.Sh NAME
-.\" .hy        enable hyphenation
+.Nm openttd 
-.\" .ad l      left justify
+.Nd An open source clone of the Microprose game "Transport Tycoon Deluxe"
-.\" .ad b      justify to both left and right margins
+.Sh SYNOPSIS
-.\" .nf        disable filling
+.Nm
-.\" .fi        enable filling
+.Op Fl Defhi
-.\" .br        insert line break
+.Op Fl G Ar seed
-.\" .sp <n>    insert n+1 empty lines
+.Op Fl d Ar [level | cat=lvl[, ...]]
-.\" for manpage-specific macros, see man(7)
+.Op Fl g Ar [savegame]
-.SH NAME
+.Op Fl l Ar language
-openttd \-  An open source clone of the Microprose game "Transport Tycoon Deluxe"
+.Op Fl n Ar [host[#player][:port]]
-.SH SYNOPSIS
+.Op Fl r Ar widthxheight
-.B openttd
+.Op Fl t Ar date
-.RI [ options ]
+.Op Fl m Ar driver
-.br
+.Op Fl s Ar driver
-.SH DESCRIPTION
+.Op Fl v Ar driver
-Unfortunately, there is no real manpage for openttd yet. Hopefully someone
+.Sh OPTIONS
-will write one soon. For now you should use
+.Bl -tag -width ".Fl n Ar host[#player][:port]"
-.B openttd -h
+.It Fl D
-for more information, or check our Wiki manual: http://wiki.openttd.org/
+Start a dedicated server
-.PP
+.It Fl G Ar seed
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+Seed the pseudo random number generator
-.\" \fI<whatever>\fP escape sequences to invoke bold face and italics, 
+.It Fl d Ar [level]
-.\" respectively.
+Set debug verbosity for all categories to
-.\" \fBopenttd\fP is a program that...
+.Ar level
-.SH OPTIONS
+or 1 if omitted
-Wouldn't we like to have something here?
+.It Fl d Ar cat=level[, ...]
-.\" below are commented out, to serve as layout examples for when somebody
+Set debug verbosity for a specific category
-.\" does actually fill this page
+.It Fl e
-.\" .TP
+Start in world editor mode
-.\" .B \-h, \-\-help
+.It Fl f
-.\" Show summary of options.
+Fork into background (dedicated only, see
-.\" .TP
+.Fl D )
-.\" .B \-v, \-\-version
+.It Fl g Ar [savegame]
-.\" Show version of program.
+Load
-.\" .SH SEE ALSO
+.Ar savegame
-.\" .BR bar (1),
+at start or start a new game if omitted
-.\" .BR baz (1).
+.It Fl h
-.br
+Display a summary of all options and available drivers
-.SH AUTHOR
+.It Fl i
-This manual page was written by Matthijs Kooijman <matthijs@katherina.student.utwente.nl>,
+Force to use the DOS palette (use this if you see a lot of magenta)
-for the Debian project (but may be used by others).
+.It Fl l Ar language
+Set the language
+.It Fl m Ar driver
+Set the music driver, see
+.Fl h
+.It Fl n
+Start a network server
+.It Fl n Ar host[#player][:port]
+Join a network game, optionally specify player to play as and port to connect to
+.It Fl r Ar widthxheight
+Set the resolution
+.It Fl s Ar driver
+Set the sound driver, see
+.Fl h
+.It Fl t Ar date
+Set the starting date
+.It Fl v Ar driver
+Set the video driver, see
+.Fl h
+.Sh SEE ALSO
+http://wiki.openttd.org/
+.Sh HISTORY
+Transport Tycoon Deluxe was written by Chris Sawyer and published by Microprose.
+.Nm
+is a free reimplementation.