Implement w layout specifier (minimum column width).

[mandoc.git] / makewhatis.8

diff --git a/makewhatis.8 b/makewhatis.8
index 02c4cc354bd63f13d18db636726b3651e7a03cf4..9f307a351d3dc8ae59ae8d13f102a1e79779f7d9 100644 (file)
--- a/makewhatis.8
+++ b/makewhatis.8
@@ -1,7 +1,7 @@
-.\"    $Id: makewhatis.8,v 1.2 2014/04/25 12:13:15 schwarze Exp $
+.\"    $Id: makewhatis.8,v 1.6 2017/05/17 22:27:12 schwarze Exp $

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

-.\" Copyright (c) 2011, 2012 Ingo Schwarze <schwarze@openbsd.org>
+.\" Copyright (c) 2011, 2012, 2014, 2017 Ingo Schwarze <schwarze@openbsd.org>

 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above


@@ -15,7 +15,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: April 25 2014 $
+.Dd $Mdocdate: May 17 2017 $

 .Dt MAKEWHATIS 8
 .Os
 .Sh NAME
 .Dt MAKEWHATIS 8
 .Os
 .Sh NAME


@@ -74,13 +74,13 @@ and
 .Sm on
 in that directory.
 Existing databases are replaced.
 .Sm on
 in that directory.
 Existing databases are replaced.

+If a directory contains no manual pages, no database is created in that
+directory.

 If
 .Ar dir
 is not provided,
 .Nm
 uses the default paths stipulated by
 If
 .Ar dir
 is not provided,
 .Nm
 uses the default paths stipulated by

-.Xr manpath 1 ,
-or

 .Xr man.conf 5 .
 .Pp
 The arguments are as follows:
 .Xr man.conf 5 .
 .Pp
 The arguments are as follows:


@@ -98,7 +98,7 @@ format.
 Display all files added or removed to the index.
 With a second
 .Fl D ,
 Display all files added or removed to the index.
 With a second
 .Fl D ,

-also show all keyswords added for each file.
+also show all keywords added for each file.

 .It Fl d Ar dir
 Merge (remove and re-add)
 .Ar
 .It Fl d Ar dir
 Merge (remove and re-add)
 .Ar


@@ -132,11 +132,22 @@ Remove
 .Ar
 from the database in
 .Ar dir .
 .Ar
 from the database in
 .Ar dir .

+If that causes the database to become empty, also delete the database file.

 .El
 .Pp
 If fatal parse errors are encountered while parsing, the offending file
 is printed to stderr, omitted from the index, and the parse continues
 with the next input file.
 .El
 .Pp
 If fatal parse errors are encountered while parsing, the offending file
 is printed to stderr, omitted from the index, and the parse continues
 with the next input file.

+.Sh ENVIRONMENT
+.Bl -tag -width MANPATH
+.It Ev MANPATH
+A colon-separated list of directories to create databases in.
+Ignored if a
+.Ar dir
+argument or the
+.Fl t
+option is specified.
+.El

 .Sh FILES
 .Bl -tag -width Ds
 .It Pa mandoc.db
 .Sh FILES
 .Bl -tag -width Ds
 .It Pa mandoc.db