summaryrefslogtreecommitdiffstats
path: root/mandocdb.8
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2011-12-25 13:08:12 +0000
committerIngo Schwarze <schwarze@openbsd.org>2011-12-25 13:08:12 +0000
commit20c8cad8f64887c77b09b3ee81ab573973c2d6e6 (patch)
tree788c6f3afb0867f662ec3352acb374205c73e982 /mandocdb.8
parenta9b480b159576bf3235468875295d97ac101703c (diff)
downloadmandoc-20c8cad8f64887c77b09b3ee81ab573973c2d6e6.tar.gz
Implement test mode (makewhatis -t), required for pkg_create(8).
Always do all consistency checks; when any one fails, decide whether to print a message, or skip the file, or both, or none. While here, do some cleanup as well: * Bail out on conflicting options. * Do not crash with -a if there are plain files in the root dir. * Collect some related variables into structs. Feedback and OK kristaps@.
Diffstat (limited to 'mandocdb.8')
-rw-r--r--mandocdb.824
1 files changed, 20 insertions, 4 deletions
diff --git a/mandocdb.8 b/mandocdb.8
index 938a9a9e..5a3b980a 100644
--- a/mandocdb.8
+++ b/mandocdb.8
@@ -22,19 +22,21 @@
.Nd index UNIX manuals
.Sh SYNOPSIS
.Nm
-.Op Fl av
+.Op Fl avW
.Op Fl C Ar file
.Nm
-.Op Fl av
+.Op Fl avW
.Ar dir ...
.Nm
-.Op Fl v
+.Op Fl vW
.Fl d Ar dir
.Op Ar
.Nm
-.Op Fl v
+.Op Fl vW
.Fl u Ar dir
.Op Ar
+.Nm
+.Fl t Ar
.Sh DESCRIPTION
The
.Nm
@@ -88,6 +90,17 @@ Merge (remove and re-add)
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
@@ -96,6 +109,9 @@ from the database in
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