| 
Fri Apr 1 08:25:23 EST 2005 rsc
    I applied most of the patch.  Some small notes about writing man pages:
    
    - .B means everything after this in fixed-width font"
    - .BR means alternating fixed-width and roman for successive args
    - so .BR foo looks like a typo (use .B foo)
    - and .B foo, looks bad (put the punctuation in roman with .BR foo ,)
    
    - if the man page isn't true but is simpler than the current story,
      think about (or ask about) making it true.  in this case, 
      mail -c is supposed to create new mail boxes.  you're not supposed
      to need the console.  and it does, if /mail/box is mode 777 like
      it should be.  i just fixed the proto file on sources so mail -c
      should start working again.
    
      now that mail -c works again the example is not really necessary
      anymore.
    
    - if there's only one example use .SH EXAMPLE not EXAMPLES.
    
    - in general i err on the side of leaving the original author's
      voice (usually rob's) in the man page, so for example the parens
      around "There is no need to reboot." stay.
    
    I appreciate your effort.  I'm pointing this stuff out just so
    that future submissions require less work on my part to apply.
    
    Thanks again.
    Russ
 |