Subject: Re: misc/33130: rcorder(8) poorly documented
To: None <misc-bug-people@netbsd.org, gnats-admin@netbsd.org,>
From: Denis Lagno <dlagno@rambler.ru>
List: netbsd-bugs
Date: 03/22/2006 16:50:02
The following reply was made to PR misc/33130; it has been noted by GNATS.

From: Denis Lagno <dlagno@rambler.ru>
To: gnats-bugs@netbsd.org
Cc: misc-bug-people@netbsd.org, gnats-admin@netbsd.org,
	netbsd-bugs@netbsd.org
Subject: Re: misc/33130: rcorder(8) poorly documented
Date: Wed, 22 Mar 2006 19:46:15 +0300

 On Wed, Mar 22, 2006 at 03:30:02PM +0000, Martin Husemann scribed:
 >  May I suggest to add a more practical explanation to the man page instead,
 >  i.e. at least mentioning "shutdown" and the way we use it in rc.d for
 >  KEYWORD.
 
 Those things are already well documented.  KEYWORD per se is documented in description
 of -s and -k options in rcorder(8)
 And usage of KEYWORDs shutdown and nostart in rc process is documented in rc(8)
 
 >  Your nice description how to build the DAG could go into a comment in
 >  the source, or an explanatory file there, but IMHO is not very usefull
 >  in a man page.
 
 Well, it is up to you to decide.
 
 Problem is that behaviour of PROVIDES, REQUIRES and BEFORE words 
 and relationship between files and conditions are almost not documented.
 It is not even obvious from manpage that files and conditions lie in separate namespaces.
 
 -- denis