[src/trunk]: src/usr.sbin/makemandb Improve wording, and add reference to man...

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

details:   https://anonhg.NetBSD.org/src/rev/df2509a796d2
branches:  trunk
changeset: 345970:df2509a796d2
user:      abhinav <abhinav%NetBSD.org@localhost>
date:      Sat Jun 18 06:36:18 2016 +0000

description:
Improve wording, and add reference to mandoc(3)
Ok from wiz@

diffstat:

 usr.sbin/makemandb/makemandb.8 |  20 +++++++++++---------
 1 files changed, 11 insertions(+), 9 deletions(-)

diffs (59 lines):

diff -r 59ff71844abb -r df2509a796d2 usr.sbin/makemandb/makemandb.8
--- a/usr.sbin/makemandb/makemandb.8    Fri Jun 17 21:59:06 2016 +0000
+++ b/usr.sbin/makemandb/makemandb.8    Sat Jun 18 06:36:18 2016 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: makemandb.8,v 1.9 2016/05/22 05:03:17 abhinav Exp $
+.\" $NetBSD: makemandb.8,v 1.10 2016/06/18 06:36:18 abhinav Exp $
 .\"
 .\" Copyright (c) 2011 Abhinav Upadhyay <er.abhinav.upadhyay%gmail.com@localhost>
 .\" All rights reserved.
@@ -29,7 +29,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd March 3, 2015
+.Dd June 18, 2016
 .Dt MAKEMANDB 8
 .Os
 .Sh NAME
@@ -44,14 +44,14 @@
 The
 .Nm
 utility traverses the directories containing man pages, parses the manual
-pages with the help of libmandoc and builds an Sqlite database
+pages with the help of
+.Xr mandoc 3
+and builds an Sqlite database
 to support full text searches by
 .Xr apropos 1 .
 It obtains the list of directories to traverse using the
-.Fl Ar path
-and
 .Fl p
-options of
+option of
 .Xr man 1 .
 .Pp
 It supports the following options:
@@ -69,9 +69,10 @@
 .Xr apropos 1
 and also to substantially save disk space.
 .It Fl o
-Use this option to optimize the index for speed and also
-to significantly reduce disk space usage.
-This is a somewhat expensive operation.
+Use this option to optimize the index for faster search by
+.Xr apropos 1
+and also to significantly reduce disk space usage.
+This is an expensive I/O operation.
 .It Fl Q
 Print only fatal error messages (i.e., when the database is left in
 an inconsistent state and needs manual intervention).
@@ -119,6 +120,7 @@
 .Xr apropos 1 ,
 .Xr man 1 ,
 .Xr whatis 1 ,
+.Xr mandoc 3 ,
 .Xr man.conf 5
 .Sh AUTHORS
 .An Abhinav Upadhyay