[OpenAFS-Doc] Re: [Fwd: documentation patches]
ted creedon
tcreedon@easystreet.com
Sun, 5 Aug 2007 16:56:52 -0700
Is this now in cvs? If so where?
thanks
-----Original Message-----
From: openafs-doc-admin@openafs.org [mailto:openafs-doc-admin@openafs.org]
On Behalf Of Russ Allbery
Sent: Sunday, August 05, 2007 2:08 PM
To: Jason Edgecombe
Cc: openafs-doc@openafs.org
Subject: [OpenAFS-Doc] Re: [Fwd: documentation patches]
Jason Edgecombe <jason@rampaginggeek.com> writes:
> Hi,
> Get your fresh, hot patches!!
> New man pages: pod1/fs_setcrypt, pod1/fs_getcrypt, pod5/CellAlias
Thanks! Committed with some editing. A few notes:
* Cross-references to man pages should be in the form:
L<page(1)>,
L<other-page(8)>,
L<something(5)>
Note the commas and the lack of blank lines between the references so
that they're wrapped together on one line in the man page output.
* Flags should be given with B<-flag> when defined or referenced or as
C<-flag> when talking about an example of what someone would type. See
the pod2man man page for details on style here.
* Use three spaces of indentation for verbatim text, such as in examples.
* In examples, put "% " before commands the user types.
Overall, this looks really good. I'm starting on your other man pages
now.
--
Russ Allbery (rra@stanford.edu) <http://www.eyrie.org/~eagle/>
_______________________________________________
OpenAFS-doc mailing list
OpenAFS-doc@openafs.org
https://lists.openafs.org/mailman/listinfo/openafs-doc