bin/124251: [patch] add BUGS section to rcorder.8 with REQUIRE explanation

[Edwin Groothuis]

>Number:         124251
>Category:       bin
>Synopsis:       [patch] add BUGS section to rcorder.8 with REQUIRE explanation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 03 22:40:01 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Edwin Groothuis
>Release:        FreeBSD 7.0-RELEASE-p1 i386
>Organization:
-
>Environment:
System: FreeBSD k7.mavetju 7.0-RELEASE-p1 FreeBSD 7.0-RELEASE-p1 #2: Wed May 28 08:12:56 EST 2008 edwin at k7.mavetju:/usr/src/sys/i386/compile/k7 i386


>Description:
Add the following text to the bugs section:

BUGS
     The ``REQUIRE'' keyword is misleading: It doesn't describe which daemons
     have to be running before a script will be started, it describes after
     which scripts a script has to be started.  For example, if your script
     has a ``REQUIRE'' on ``named'', it will start after the ``named'' script
     has been started, even if the named-daemon itself hasn't been started.

>How-To-Repeat:
>Fix:

Index: rcorder.8
===================================================================
RCS file: /home/ncvs/src/sbin/rcorder/rcorder.8,v
retrieving revision 1.4
diff -u -r1.4 rcorder.8
--- rcorder.8	2 Jul 2004 18:37:52 -0000	1.4
+++ rcorder.8	3 Jun 2008 22:37:27 -0000
@@ -152,6 +152,20 @@
 A set of files has a circular dependency which was detected while
 processing the stated file.
 .El
+.Sh BUGS
+The
+.Dq Li REQUIRE
+keyword is misleading:
+It doesn't describe which daemons have to be running before a script
+will be started, it describes after which scripts a script has to
+be started.  For example, if your script has a
+.Dq Li REQUIRE
+on
+.Dq Li named ,
+it will start after the 
+.Dq Li named
+script has been started, even if the named-daemon itself hasn't
+been started.
 .Sh SEE ALSO
 .Xr rc 8
 .Sh HISTORY
>Release-Note:
>Audit-Trail:
>Unformatted: