STABLE14-man-page-style-20070805

Some style fixes and some additional style documentation in README.


(cherry picked from commit e735ef962de3623f8fa11cca92d13151d62b5aaa)
This commit is contained in:
Russ Allbery 2007-08-05 23:12:19 +00:00
parent 2a7341ca28
commit c4acf695ef
5 changed files with 21 additions and 17 deletions

View File

@ -123,7 +123,11 @@ Formatting Standards
References to functions should be noted like function() with the
trailing parens. The POD converters know how to format these sorts of
references appropriately. References to other sections in the same page
should be given as L<SECTION>.
should be given as L<SECTION>. Man pages for all other AFS commands or
file formats referenced in the page should be listed in the SYNOPSIS.
List each reference on its own line for easier addition of other
references later, but don't put blank lines between them. Don't forget
the commas at the end of each line but the last.
Command and output examples should be indented three spaces. Commands
entered by the user should be given on a line beginning with %. If the

View File

@ -678,17 +678,17 @@ The B<afsd> command is normally included in the machine's AFS
initialization file, rather than typed at the command shell prompt. For
most disk caches, the appropriate form is
/usr/vice/etc/afsd
% /usr/vice/etc/afsd
The following command is appropriate when enabling a machine to act as an
NFS/AFS Translator machine serving more than five users.
/usr/vice/etc/afsd -daemons 4 -rmtsys
% /usr/vice/etc/afsd -daemons 4 -rmtsys
The following command initializes a memory cache and sets chunk size to 16
KB (2^14).
/usr/vice/etc/afsd -memcache -chunksize 14
% /usr/vice/etc/afsd -memcache -chunksize 14
=head1 PRIVILEGE REQUIRED