Re: [Flightgear-devel] RFC: man pages

[Curtis L. O. <cu...@fl...>]

Quick comment is that Tony Peden is the primary author of fgjs as I
recall.

Cameron Moore writes:
> 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
> -- 
> Cameron Moore
> 
> _______________________________________________
> Flightgear-devel mailing list
> Fli...@li...
> http://lists.sourceforge.net/lists/listinfo/flightgear-devel

-- 
Curtis Olson   Human Factors Research Lab       FlightGear Project
Twin Cities    cu...@hf...                cu...@fl...
Minnesota      http://www.menet.umn.edu/~curt   http://www.flightgear.org