=================================================================== RCS file: /cvs/mandoc/Attic/mandocdb.8,v retrieving revision 1.17 retrieving revision 1.17.2.2 diff -u -p -r1.17 -r1.17.2.2 --- mandoc/Attic/mandocdb.8 2011/12/25 21:00:23 1.17 +++ mandoc/Attic/mandocdb.8 2014/03/17 09:04:52 1.17.2.2 @@ -1,6 +1,7 @@ -.\" $Id: mandocdb.8,v 1.17 2011/12/25 21:00:23 schwarze Exp $ +.\" $Id: mandocdb.8,v 1.17.2.2 2014/03/17 09:04:52 schwarze Exp $ .\" -.\" Copyright (c) 2011 Kristaps Dzonsons +.\" Copyright (c) 2011, 2012 Kristaps Dzonsons +.\" Copyright (c) 2011, 2012 Ingo Schwarze .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above @@ -14,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. .\" -.Dd $Mdocdate: December 25 2011 $ +.Dd $Mdocdate: March 17 2014 $ .Dt MANDOCDB 8 .Os .Sh NAME @@ -70,14 +71,16 @@ and .Op Ar arch Li / .Ar title . Sy 0 .Sm on -in that directory; -existing databases are truncated. +in that directory. +Existing databases are replaced. If .Ar dir is not provided, .Nm uses the default paths stipulated by -.Xr man 1 . +.Xr manpath 1 , +or +.Xr man.conf 5 . .Pp The arguments are as follows: .Bl -tag -width "-C file" @@ -125,7 +128,7 @@ is printed to stderr, omitted from the index, and the with the next input file. .Ss Index Database The index database, -.Pa whatis.index , +.Pa mandoc.index , is a .Xr recno 3 database with record values consisting of @@ -161,7 +164,7 @@ Each of the above is NUL-terminated. If the record value is zero-length, it is unassigned. .Ss Keyword Database The keyword database, -.Pa whatis.db , +.Pa mandoc.db , is a .Xr btree 3 database of NUL-terminated keywords (record length is non-zero string @@ -225,12 +228,12 @@ or respectively, grows as a multiple of the index length and input size. .Sh FILES .Bl -tag -width Ds -.It Pa whatis.db +.It Pa mandoc.db A .Xr btree 3 keyword database mapping keywords to a type and file reference in -.Pa whatis.index . -.It Pa whatis.index +.Pa mandoc.index . +.It Pa mandoc.index A .Xr recno 3 database of indexed file-names. @@ -285,9 +288,42 @@ arguments. .Xr btree 3 , .Xr recno 3 , .Xr man.conf 5 -.Sh AUTHORS +.Sh HISTORY +A +.Nm makewhatis +utility first appeared in +.Bx 2 . +It was rewritten in +.Xr perl 1 +for +.Ox 2.7 +and in C for +.Ox 5.1 . +.Pp The +.Ar dir +argument first appeared in +.Nx 1.0 ; +the options +.Fl dtu +in +.Ox 2.7 ; +and the options +.Fl aCvW +in +.Ox 5.1 . +.Sh AUTHORS +.An -nosplit +.An Bill Joy +wrote the original +.Bx +.Nm makewhatis +in February 1979, +.An Marc Espie +started the Perl version in 2000, +and the current version of .Nm -utility was written by -.An Kristaps Dzonsons , -.Mt kristaps@bsd.lv . +was written by +.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv +and +.An Ingo Schwarze Aq Mt schwarze@openbsd.org .