Module Name: src
Committed By: apb
Date: Tue Dec 27 13:15:55 UTC 2011
Modified Files:
src/usr.bin/man: man.conf.5
Log Message:
Document the reality that the _build and _crunch commands should each
contain exactly one "%s". The previous description allowed any number
of "%s" in the _build command, but that does not match the actual
behaviour of either man(1) or catman(8).
To generate a diff of this commit:
cvs rdiff -u -r1.20 -r1.21 src/usr.bin/man/man.conf.5
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/usr.bin/man/man.conf.5
diff -u src/usr.bin/man/man.conf.5:1.20 src/usr.bin/man/man.conf.5:1.21
--- src/usr.bin/man/man.conf.5:1.20 Sat Feb 10 19:27:39 2007
+++ src/usr.bin/man/man.conf.5 Tue Dec 27 13:15:55 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: man.conf.5,v 1.20 2007/02/10 19:27:39 reed Exp $
+.\" $NetBSD: man.conf.5,v 1.21 2011/12/27 13:15:55 apb Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)man.conf.5 8.5 (Berkeley) 1/2/94
.\"
-.Dd April 10, 2006
+.Dd December 27, 2011
.Dt MAN.CONF 5
.Os
.Sh NAME
@@ -98,9 +98,9 @@ The suffix specification may contain the
The rest of the _build line is a shell command line whose standard
output is a formatted manual page that can be directly displayed to
the user.
-Any occurrences of the string
+There should be exactly one occurrence of the string
.Dq %s
-in the shell command line will
+in the shell command line, and it will
be replaced by the name of the file which is being formatted.
.It _crunch
used by
@@ -110,6 +110,10 @@ which originally were compressed man pag
which indicates what kind of compression were used to compress the man page.
The rest of the line must be a shell command line, used to compress the
formatted pages.
+There should be exactly one occurrence of the string
+.Dq %s
+in the shell command line, and it will
+be replaced by the name of the output file.
.It _default
contains the system-wide default man path used to search for man pages.
.It _subdir
