aboutsummaryrefslogtreecommitdiff
path: root/docs/autodocifier.pl
AgeCommit message (Collapse)Author
2001-03-06minor cleanupJohn Beppu
2001-02-26- changed the way POD is generated such that the dashedJohn Beppu
line appears at the bottom instead of the top. The indentation semantics of POD make the first item in the (=over,=back) block look weird the other way. - implemented a way to encode example usage into usage.h One would define a macro called "${applet}_example_usage" which would expand to the example text. - The example usage is considered optional, but trivial and full usage are not. Here's an example using chown. ---- before #define chown_trivial_usage \ "[OPTION]... OWNER[<.|:>[GROUP] FILE..." #define chown_full_usage \ "Change the owner and/or group of each FILE to OWNER and/or GROUP.\n" \ "\nOptions:\n" \ "\t-R\tChanges files and directories recursively." #define chown_example_usage \ "\t$ ls -l /tmp/foo\n" \ "\t-r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo\n" \ "\t$ chown root /tmp/foo\n" \ "\t$ ls -l /tmp/foo\n" \ "\t-r--r--r-- 1 root andersen 0 Apr 12 18:25 /tmp/foo\n" \ "\t$ chown root.root /tmp/foo\n" \ "\tls -l /tmp/foo\n" \ "\t-r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo\n" ---- after =item I<chown> chown [OPTION]... OWNER[<.|:>[GROUP] FILE... Change the owner and/or group of each FILE to OWNER and/or GROUP. Options: -R Changes files and directories recursively. Example: $ ls -l /tmp/foo -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo $ chown root /tmp/foo $ ls -l /tmp/foo -r--r--r-- 1 root andersen 0 Apr 12 18:25 /tmp/foo $ chown root.root /tmp/foo ls -l /tmp/foo -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo -------------------------------
2001-02-24...John Beppu
2001-02-24refinementJohn Beppu
2001-02-23formatting ...John Beppu
2001-02-23Added some documentation and made --sgml use sgml_from_usage().John Beppu
pod_from_usage() is the default generator.
2001-02-23During POD generation, it inserts a blank line before linesJohn Beppu
that were intended to be indented.
2001-02-23forgot to remove some debugging noiseJohn Beppu
2001-02-23This one should be able to deal with the USAGE macros a littleJohn Beppu
more robustly. I also blow away any USAGE_NOT_\w+ macros.
2001-02-23forgot a comma.John Beppu
2001-02-23I can't leave it alone.John Beppu
2001-02-23minor cleanup... all that's left to do isJohn Beppu
* make headers and footers for both the POD and SGML content * make an SGML generator * finish the command-line handling Also, some of the documentation in usage.h will have to be adjusted. expr needs some lines to be indented, and ls has a stray comma. I may have missed some things... but it looks OK for the most part.
2001-02-23This is the remixed autodocufier.pl.John Beppu
2001-02-22First pass at making up an automagical usage message extractor, whichEric Andersen
will be used (when it works) to autogenerate documentation. Based on code written by Mark Whitley.