From b23b1bcc57e37fd5bf2244278ab7a005ef97438e Mon Sep 17 00:00:00 2001
From: perry <perry@NetBSD.org>
Date: Thu, 24 Apr 2003 03:15:45 +0000
Subject: [PATCH] Document what happens when you don't have any dependency
 lines in a file, and downgrade "must" to "should" in a couple of places.
 Answers a documentation complaint from Jeremy C. Reed in PR misc/21251

---
 sbin/rcorder/rcorder.8 | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/sbin/rcorder/rcorder.8 b/sbin/rcorder/rcorder.8
index b6be326feaaf..ede71b0b3f3a 100644
--- a/sbin/rcorder/rcorder.8
+++ b/sbin/rcorder/rcorder.8
@@ -1,4 +1,4 @@
-.\"	$NetBSD: rcorder.8,v 1.5 2002/10/03 15:41:44 wiz Exp $
+.\"	$NetBSD: rcorder.8,v 1.6 2003/04/24 03:15:45 perry Exp $
 .\"
 .\" Copyright (c) 1998
 .\" 	Perry E. Metzger.  All rights reserved.
@@ -30,7 +30,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd July 17, 2000
+.Dd April 23, 2003
 .Dt RCORDER 8
 .Os
 .Sh NAME
@@ -50,7 +50,7 @@ shell scripts in which certain files must be executed before others.
 .Pp
 Each file passed to
 .Nm
-must be annotated with special lines (which look like comments to the
+should be annotated with special lines (which look like comments to the
 shell) which indicate the dependencies the files have upon certain
 points in the sequence, known as
 .Dq conditions ,
@@ -64,7 +64,7 @@ Within each file, a block containing a series of
 .Dq BEFORE
 and
 .Dq KEYWORD
-lines must appear.
+lines should appear.
 The format of the lines is rigid.
 Each line must begin with a single
 .Dq # ,
@@ -126,6 +126,14 @@ A file may contain zero
 lines, in which case it provides no conditions, and may contain zero
 .Dq REQUIRE
 lines, in which case it has no dependencies.
+A file containing no
+.Dq PROVIDE ,
+.Dq REQUIRE ,
+or
+.Dq BEFORE
+lines may be output at an arbitrary position in the dependency
+ordering.
+.Pp
 There must be at least one file with no dependencies in the set of
 arguments passed to
 .Nm