busybox.git - Copy of git.busybox.net/busybox

Age	Commit message (Collapse)	Author
2001-03-15	Update the documentation so examples are autoincluded in the output text.	Eric Andersen
	Fix up docs/busybox.pod with the latest autogenerated output. -Erik
2001-03-06	minor cleanup	John Beppu

2001-02-26	- changed the way POD is generated such that the dashed	John 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-24	refinement	John Beppu

2001-02-23	formatting ...	John Beppu

2001-02-23	Added some documentation and made --sgml use sgml_from_usage().	John Beppu
	pod_from_usage() is the default generator.
2001-02-23	During POD generation, it inserts a blank line before lines	John Beppu
	that were intended to be indented.
2001-02-23	forgot to remove some debugging noise	John Beppu

2001-02-23	This one should be able to deal with the USAGE macros a little	John Beppu
	more robustly. I also blow away any USAGE_NOT_\w+ macros.
2001-02-23	forgot a comma.	John Beppu

2001-02-23	I can't leave it alone.	John Beppu

2001-02-23	minor cleanup... all that's left to do is	John 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-23	This is the remixed autodocufier.pl.	John Beppu

2001-02-22	First pass at making up an automagical usage message extractor, which	Eric Andersen
	will be used (when it works) to autogenerate documentation. Based on code written by Mark Whitley.