I wasn't actually talking about options. I just made an off the cuff comment about embedding the man page in the executable.
Maybe we should talk about this, because its not Solaris documentation convention, but I doubt it is hard to resolve. Check out getopts() in Solaris. This is the invention of Don and myself. I think its rather nice. It does long and short options. We do have fairly rigorous rules about options. Mostly that the long form of options are optional, while the short forms are required. If there is a discussion about this, it is another case. - jek3 > From: Joerg.Schilling at fokus.fraunhofer.de (Joerg Schilling) ... > Glenn Fowler <gsf at research.att.com> wrote: > > > > > On Fri, 22 Sep 2006 14:17:42 -1000 (HST) Joseph Kowalski wrote: > > > I think this is confusing things because David seems to have done the > > > Linux thing of embedding the man page in the executable. That is an > > ^^^^^^^^^^^ > > > > if you are talking about gnu getopts_long() or --help output, > > that's a gross simplification > > the ast self-documentation supports l10n and multiple output formats > > and provides short and long options along with runtime querying > > Let me add some information that may be of interest in order to prevent > confusion: > > - I believe that the main point may be that may be that ksh itself > outputs the long documentation, correct? > > - while many people believe that long options are Linux specific, > this is a result of using GNU tools > > - while many people believe that long options are a GNU invention, > I did use them in my software long before GNU/FSF exists. > > - there are better (and more POSIX compliant) option parsers than > GNU getopt_long() e.g. my getargs() family > > - POSIX defines how option parsing should be done and POSIX lists > getopt() as POSUX interface but POSIX does not require programs > to use getopt() to actually do option parsing. > > J?rg > > -- > EMail:joerg at schily.isdn.cs.tu-berlin.de (home) J?rg Schilling D-13353 > Berlin > js at cs.tu-berlin.de (uni) > schilling at fokus.fraunhofer.de (work) Blog: http://schily.blogspot.com/ > URL: http://cdrecord.berlios.de/old/private/ ftp://ftp.berlios.de/pub/schily
