[src/trunk]: src/share/man/man9 document 'include', 'cinclude', 'prefix' and ...

[jdolecek <jdolecek%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/599a1834ede9
branches:  trunk
changeset: 550732:599a1834ede9
user:      jdolecek <jdolecek%NetBSD.org@localhost>
date:      Tue Aug 19 09:29:22 2003 +0000

description:
document 'include', 'cinclude', 'prefix' and 'package'
bump date

diffstat:

 share/man/man9/config.9 |  40 ++++++++++++++++++++++++++++++++++++++--
 1 files changed, 38 insertions(+), 2 deletions(-)

diffs (68 lines):

diff -r 8cd2be391568 -r 599a1834ede9 share/man/man9/config.9
--- a/share/man/man9/config.9   Tue Aug 19 08:31:18 2003 +0000
+++ b/share/man/man9/config.9   Tue Aug 19 09:29:22 2003 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: config.9,v 1.14 2003/06/25 07:08:26 heas Exp $
+.\"     $NetBSD: config.9,v 1.15 2003/08/19 09:29:22 jdolecek Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 25, 2003
+.Dd August 19, 2003
 .Dt CONFIG 9
 .Os
 .Sh NAME
@@ -146,6 +146,12 @@
 previous line.
 Valid statements are:
 .Bl -tag -width xxxxxx
+.It cinclude filename
+Conditionally include contents of file
+.Ar filename
+to currently processed configuration. If the specified
+.Ar filename
+doesn't exist, it is silently ignored.
 .It defflag [filename] {options}
 The space-separated list of pre-processor macros
 .Em options
@@ -276,6 +282,36 @@
 If all of attributes are specified by devices in the machine description
 files, then device switches are added into the device switches' table of
 the kernel in compilation, otherwise they are omitted.
+.It include filename
+Include contents of file
+.Ar filename
+to currently processed configuration. If the specified
+.Ar filename
+doesn't exist, 
+.Xr config 8
+exits with error.
+.It package Ar filename
+Changes prefix to directory of
+.Ar filename ,
+processes contents of
+.Ar filename,
+and switches back to previous prefix. This is syntactic sugar for:
+.Bl -tag -compact -offset indent
+.It prefix Ar dirname(filename)
+.It include Ar basename(filename)
+.It prefix
+.El
+.It prefix Op Ar dirname
+If
+.Ar dirname
+is specified, it is pushed on top of prefix stack. Any further
+files specified via option
+.Ar file
+would have the prefix implicitly prepended before its
+.Ar filename .
+If
+.Ar dirname
+is not specified, pops (removes) a prefix from prefix stack.
 .El
 .Pp
 To allow locators to be wildcarded in the machine description file,