From 98ec5e76a88638596bb55271c5e91a26f266703d Mon Sep 17 00:00:00 2001
From: mtm <mtm@FreeBSD.org>
Date: Mon, 9 Jun 2008 09:07:58 +0000
Subject: Document the misleading nature of the REQUIRE line. The patch in the
 PR has been heavily edited for style(9) and clarity. Mistakes are mine.

PR: bin/124251
---
 sbin/rcorder/rcorder.8 | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

(limited to 'sbin/rcorder')

diff --git a/sbin/rcorder/rcorder.8 b/sbin/rcorder/rcorder.8
index 6a0c570..82330c3 100644
--- a/sbin/rcorder/rcorder.8
+++ b/sbin/rcorder/rcorder.8
@@ -31,7 +31,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 17, 2000
+.Dd June 9, 2008
 .Dt RCORDER 8
 .Os
 .Sh NAME
@@ -152,6 +152,25 @@ processing the stated condition.
 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 which scripts must be placed before it in
+the dependency ordering.
+For example,
+if your script has a
+.Dq Li REQUIRE
+on
+.Dq Li named ,
+it means the script must be placed after the 
+.Dq Li named
+script in the dependency ordering,
+not necessarily that it requires
+.Xr named 8
+to be started or enabled.
 .Sh SEE ALSO
 .Xr rc 8
 .Sh HISTORY
-- 
cgit v1.1