[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