[busybox-dev] AST versions of fold, mktemp, pathchk,& tty [PSARC/2009/414 FastTrack timeout 07/31/2009]
James Carlson
carlsonj at workingcode.com
Sat Jul 25 16:59:11 PDT 2009
John Sonnenschein wrote:
> I've got a question about this...
>
> Whose responsibility is it to update the man pages and --man command
> then? The people whose jobs it is to update man pages, or the people
> whose jobs it is to update the command line utility?
>
> Basically if a new flag is added in the future for some reason, how will
> one synchronize the man pages?
Usually, that's done by filing a bug against the man pages.
The advantage of keeping the documentation separate is that it's in the
hands of professional documentation writers, who are able to keep a
consistent style across all of the system man pages.
I'm with Garrett about the inadvisability of baking man page
documentation into executables, but for ksh93-related things, I think
that ship has unfortunately sailed.
--
James Carlson 42.703N 71.076W <carlsonj at workingcode.com>
More information about the opensolaris-arc
mailing list