On Mon, 1 Jul 2013, Jilles Tjoelker wrote:
On Mon, Jul 01, 2013 at 06:29:53AM +0900, Hiroki Sato wrote:
...
b) Make rc.d/foo always have rc.d/foo(8) manual page.
However, I don't like another set of manual pages.
They could be autogenerated by reading comments and variable values
in the rc.d scripts. Of course the rc.d scripts would have to contain
that information. At least it would be in the same file, helping to
keep the doc in sync with the script. This is not to suggest a full man
page in the script, just a short text summary along with variables that
may be used.
'/etc/rc.d/routed manpage' would return the generated mdoc code.
'/etc/rc.d/routed help' could pipe that output to man.
What filenames or section would be used for the generated man pages?
routed(8) already exists, and "rc.d/routed.8" has problems both as a
filename and an argument to man(1).
_______________________________________________
freebsd-rc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-rc
To unsubscribe, send any mail to "freebsd-rc-unsubscr...@freebsd.org"