Implement test mode (makewhatis -t), required for pkg_create(8).

[mandoc.git] / mandocdb.8

diff --git a/mandocdb.8 b/mandocdb.8
index 0469c13b0c456bbd5b14ddcaf44fdde34e4eea76..270bab92fa0c02f7932103d7ea0407264b9406ec 100644 (file)
--- a/mandocdb.8
+++ b/mandocdb.8
@@ -1,4 +1,4 @@
-.\"    $Id: mandocdb.8,v 1.12 2011/12/12 02:00:49 schwarze Exp $
+.\"    $Id: mandocdb.8,v 1.15 2011/12/25 13:08:12 schwarze Exp $

 .\"
 .\" Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
 .\"
 .\" Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"


@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"

-.Dd $Mdocdate: December 12 2011 $
+.Dd $Mdocdate: December 25 2011 $

 .Dt MANDOCDB 8
 .Os
 .Sh NAME
 .Dt MANDOCDB 8
 .Os
 .Sh NAME


@@ -22,19 +22,21 @@
 .Nd index UNIX manuals
 .Sh SYNOPSIS
 .Nm
 .Nd index UNIX manuals
 .Sh SYNOPSIS
 .Nm

-.Op Fl av
+.Op Fl avW

 .Op Fl C Ar file
 .Nm
 .Op Fl C Ar file
 .Nm

-.Op Fl av
+.Op Fl avW

 .Ar dir ...
 .Nm
 .Ar dir ...
 .Nm

-.Op Fl v
+.Op Fl vW

 .Fl d Ar dir
 .Op Ar
 .Nm
 .Fl d Ar dir
 .Op Ar
 .Nm

-.Op Fl v
+.Op Fl vW

 .Fl u Ar dir
 .Op Ar
 .Fl u Ar dir
 .Op Ar

+.Nm
+.Fl t Ar

 .Sh DESCRIPTION
 The
 .Nm
 .Sh DESCRIPTION
 The
 .Nm


@@ -88,6 +90,17 @@ Merge (remove and re-add)
 to the database in
 .Ar dir
 without truncating it.
 to the database in
 .Ar dir
 without truncating it.

+.It Fl t Ar
+Check the given
+.Ar files
+for potential problems.
+No databases are modified.
+Implies
+.Fl a
+and
+.Fl W .
+All diagnostic messages are printed to the standard output;
+the standard error output is not used.

 .It Fl u Ar dir
 Remove
 .Ar
 .It Fl u Ar dir
 Remove
 .Ar


@@ -96,6 +109,9 @@ from the database in
 without truncating it.
 .It Fl v
 Display all files added or removed to the index.
 without truncating it.
 .It Fl v
 Display all files added or removed to the index.

+.It Fl W
+Print warnings about potential problems with manual pages
+to the standard error output.

 .El
 .Pp
 If fatal parse errors are encountered while parsing, the offending file
 .El
 .Pp
 If fatal parse errors are encountered while parsing, the offending file


@@ -110,20 +126,19 @@ database with record values consisting of
 .Pp
 .Bl -enum -compact
 .It
 .Pp
 .Bl -enum -compact
 .It

-the string
-.Cm mdoc ,
-.Cm man ,
+the character
+.Cm d ,
+.Cm a ,

 or
 or

-.Cm cat
+.Cm c

 to indicate the file type
 .Po
 to indicate the file type
 .Po

-file in

 .Xr mdoc 7 ,
 .Xr man 7 ,
 and post-formatted, respectively
 .Pc ,
 .It
 .Xr mdoc 7 ,
 .Xr man 7 ,
 and post-formatted, respectively
 .Pc ,
 .It

-the filename,
+the filename relative to the databases' path,

 .It
 the manual section,
 .It
 .It
 the manual section,
 .It


@@ -137,9 +152,7 @@ and the description.
 .Pp
 Each of the above is NUL-terminated.
 .Pp
 .Pp
 Each of the above is NUL-terminated.
 .Pp

-Both the manual section and description may be zero-length if the record
-is unassigned.
-Entries are sequentially-numbered, but the filenames are unordered.
+If the record value is zero-length, it is unassigned.

 .Ss Keyword Database
 The keyword database,
 .Pa mandoc.db ,
 .Ss Keyword Database
 The keyword database,
 .Pa mandoc.db ,