summaryrefslogtreecommitdiff
path: root/docs/autodocifier.pl (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Fix double quote handling.Matt Kraai2001-04-101-3/+3
|
* - autodocifier.pl :: continuation() was modified such that '#'John Beppu2001-04-051-3/+3
| | | | is handled correctly.
* - documentation updates and a minor tweak to POD generationJohn Beppu2001-04-051-6/+55
|
* - generated middle section of busybox.pod w/ autodocifier.plJohn Beppu2001-03-151-7/+6
| | | | - updated autodocifier.pl to use tab to indent example section
* - properly indent Examples section in pod generatorJohn Beppu2001-03-151-2/+7
|
* Update the documentation so examples are autoincluded in the output text.Eric Andersen2001-03-151-1/+7
| | | | | Fix up docs/busybox.pod with the latest autogenerated output. -Erik
* minor cleanupJohn Beppu2001-03-061-2/+2
|
* - changed the way POD is generated such that the dashedJohn Beppu2001-02-261-10/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 -------------------------------
* ...John Beppu2001-02-241-3/+1
|
* refinementJohn Beppu2001-02-241-12/+16
|
* formatting ...John Beppu2001-02-231-2/+2
|
* Added some documentation and made --sgml use sgml_from_usage().John Beppu2001-02-231-9/+24
| | | | pod_from_usage() is the default generator.
* During POD generation, it inserts a blank line before linesJohn Beppu2001-02-231-5/+17
| | | | that were intended to be indented.
* forgot to remove some debugging noiseJohn Beppu2001-02-231-3/+1
|
* This one should be able to deal with the USAGE macros a littleJohn Beppu2001-02-231-3/+6
| | | | more robustly. I also blow away any USAGE_NOT_\w+ macros.
* forgot a comma.John Beppu2001-02-231-2/+2
|
* I can't leave it alone.John Beppu2001-02-231-8/+7
|
* minor cleanup... all that's left to do isJohn Beppu2001-02-231-5/+5
| | | | | | | | | | | * 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.
* This is the remixed autodocufier.pl.John Beppu2001-02-231-80/+175
|
* First pass at making up an automagical usage message extractor, whichEric Andersen2001-02-221-0/+88
will be used (when it works) to autogenerate documentation. Based on code written by Mark Whitley.