Re: [Flightgear-devel] RFC: man pages

[Tony P. <ap...@ea...>]

On Wednesday 29 August 2001 02:34 pm, you wrote:
> I've put together a man page for fgfs and fgjs that I'd like some
> feedback on and help with.  You can see my current working version at
> http://wtlug.org/~hrothgar/fgfs/manpages/.  The txt/ directory contains
> a plain text version that you can view with your web browser.
> Otherwise, download the .in files and do `man ./fgfs.1.in`.
>
> The fgjs man page is faily simple.  Any additions to that file are
> welcome since I'm not familiar with that utility.
>
> The fgjs man page is quite long.  Search for "FIXME" to see areas that
> need work.  Here's an overview of the FIXMEs:
>
>   * I'm not sure how to describe all of the IO options.
>   * I have no idea what --joyclient= is for
>   * I don't know what --props= is for
>
> Also, the ENVIRONMENT and FILES sections may need some additions.  All
> listed options came from src/Main/options.cxx.  There are some that are
> not listed in the --help output (which should be added, BTW).  Some may
> be obsolete.  If you have any comments, I'm listening.
>
> Part of my rationale behind doing this is for Ove Kaaven, the debian
> flightgear package maintainer.  Debian requires man pages for all
> binaries (as all distros should), and there are outstanding man page
> "bug" reports[1] for the flightgear package.  And besides that, it's
> still a good idea to have man pages.  :-)
>
> [1] http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=flightgear&archive=no

A couple notes:
It would be nice if  --enable-x and --disable-x were grouped together and the 
default called out.

--vc and --mach work with LaRCsim as well as JSBSim.


-- 
Tony Peden
ap...@ea...
We all know Linux is great ... it does infinite loops in 5 seconds. 
-- attributed to Linus Torvalds