more info about man-1.6 and man-db

1 files changed, 95 insertions, 75 deletions

diff --git a/man.options.1 b/man.options.1
index 0fc0bae0..3c9a77c2 100644
--- a/man.options.1
+++ b/man.options.1
@@ -1,4 +1,4 @@
-.\"	$Id: man.options.1,v 1.2 2017/02/02 02:30:07 schwarze Exp $
+.\"	$Id: man.options.1,v 1.3 2017/02/02 16:58:53 schwarze Exp $
 .\"
 .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
 .\"
@@ -51,13 +51,25 @@
 .de Eaton
 .No Eaton Pq before July 7, 1993; 1990/91? \\$1
 ..
+.\" man-1.5e was released on July 11, 1998.
+.de man15e
+.No man-1.5e Pq not before 1993, not after 1998 \\$1
+..
+.\" man-1.5g was released on April 7, 1999.
+.de man15g
+.No man-1.5g Pq not before 1993, not after 1999 \\$1
+..
 .\" man-1.6 was released on June 24, 2005.
 .de man16
-.No man-1.6 Pq not before 1993, not after 2005 \\$1
+.No man-1.6 Pq not before 2002, not after 2005 \\$1
 ..
-.\" first seen in the initial import of man-db into CVS
+.\" code first seen in the initial import of man-db into CVS ,
+.\" which was more or less debian man-db-2.3.17
+.\" Colin Watson's first release was 2.3.18 on May 14, 2001
+.\" no clue about it found in ChangeLog-2013,
+.\" so it was probably already present before man-db-2.2a4
 .de dbI
-.No man-db Pq before Apr 26, 2001; 1994/95? \\$1
+.No man-db probably before 2.2a4 Pq before Nov 8, 1994 \\$1
 ..
 .\"
 .\" --------------------------------------------------------------------
@@ -139,7 +151,7 @@ ASCII output mode
 use specified browser
 .br
 .Nm man :
-.man16
+.No man-1.6 Pq June 24, 2005
 .It Fl b
 print a backtrace with each warning or error message
 .br
@@ -161,7 +173,8 @@ alternate configuration file
 .Ox , Nx
 .br
 .Nm man :
-.Nx 1.0 Pq Oct 26, 1994 ;
+.Nx 1.0 Pq Oct 26, 1994 ,
+.man15e ;
 .Ox
 .br
 .Nm mandb , catman , manpath :
@@ -191,21 +204,10 @@ do not use a pager
 .Nm apropos , whatis , mandoc :
 .Ox 5.7 Pq August 27, 2014
 .Pp
-disable terminal color output in
-.Xr grotty 1
-.br
-.Nm groff :
-.No groff-1.18.0 Pq Oct 4, 2001
-.Pp
-reformat source page even if cat page exists
-.br
-.Nm man :
-.man16
-.Pp
 process given catpath
 .br
 .Nm makewhatis :
-.man16
+.Pq not before 1992, not after 1995
 .Pp
 recreate databases from scratch
 .br
@@ -223,6 +225,17 @@ internal option for use by
 .Nm man :
 .dbI
 .Pp
+reformat source page even if cat page exists
+.br
+.Nm man :
+.man15e
+.Pp
+disable terminal color output in
+.Xr grotty 1
+.br
+.Nm groff :
+.No groff-1.18.0 Pq Oct 4, 2001
+.Pp
 recreate nroff versions from SGML sources
 .br
 .Nm catman :
@@ -236,17 +249,17 @@ postprocess with
 .At3 ,
 .At5
 .It Fl D
-print debugging info in addition to manual page
-.br
-.Nm man :
-.man16
-.Pp
 reset whatever was set with
 .Ev MANOPT
 .br
 .Nm man :
 .dbI
 .Pp
+print debugging info in addition to manual page
+.br
+.Nm man :
+.man15e
+.Pp
 set default input encoding for
 .Xr preconv 1
 .br
@@ -318,15 +331,15 @@ adjust text to left and right margins
 .Nm nroff :
 .At7
 .Pp
-restrict search by section extension
-.br
-.Nm man :
-.dbI
-.Pp
 use exact matching
 .br
 .Nm apropos , whatis :
 .dbI
+.Pp
+restrict search by section extension
+.br
+.Nm man :
+.No man-db-2.3.5 Pq April 21, 1995
 .It Fl F
 use alternate font directory
 .br
@@ -339,9 +352,9 @@ use alternate font directory
 preformat only, do not display
 .br
 .Nm man :
-.man16
+.No man-1.5g Pq April 7, 1999
 .Pp
-force searchings dirs, do not use index (default)
+force searching dirs, do not use index (default)
 .br
 .Nm man :
 .No illumos , Solaris 9-11
@@ -401,7 +414,7 @@ preprocess with
 produce a global manpath
 .br
 .Nm manpath :
-.dbI
+.No man-db-2.2a7 Pq Nov 16, 1994
 .Pp
 preprocess with
 .Xr grn 1
@@ -426,15 +439,15 @@ read hyphenation patterns from the given file
 .Nm groff :
 .Bx44N1
 .Pp
-use program to render HTML files as text
+produce HTML output
 .br
 .Nm man :
-.man16
+.No man-db-1.3.12 to 1.3.17 Pq not before 1996, not after 2001
 .Pp
-produce HTML output
+use program to render HTML files as text
 .br
 .Nm man :
-.dbI
+.No man-1.6 Pq June 24, 2005
 .It Fl h
 print a help message and exit
 .br
@@ -524,8 +537,8 @@ preprocess with
 source code full text search
 .br
 .Nm man :
-.man16 ;
-.No man-db Pq June 28, 2009 ,
+.man15e ,
+.No man-db Pq June 28, 2009 ;
 .No Solaris 11
 .Pp
 input encoding
@@ -569,16 +582,16 @@ pass argument to the spooler
 .Nm groff :
 .Bx44N1
 .Pp
-print list of locales
-.br
-.Nm manpath :
-.Fx Pq Nov 23, 1999
-.Pp
 use alternate
 .Xr locale 1
 .br
 .Nm man , apropos , whatis :
-.dbI
+.No before man-db-2.2a13 Pq before Dec 15, 1994
+.Pp
+print list of locales
+.br
+.Nm manpath :
+.Fx Pq Nov 23, 1999
 .Pp
 use
 .Xr locale 1
@@ -595,7 +608,7 @@ spool the output
 interpret arguments as file names
 .br
 .Nm man :
-.dbI ,
+.No before man-2.2a7 Pq before Nov 16, 1994 ,
 .Ox 5.7 Pq Aug 30, 2014
 .br
 .Nm apropos , whatis , mandoc :
@@ -630,7 +643,7 @@ override manual page search path
 .br
 .Nm apropos , whatis :
 .Bx43 ,
-.dbI ;
+.No before man-db-2.2a14 Pq before Dec 16, 1994 ;
 .Ox , No illumos
 .br
 .Nm catman :
@@ -877,22 +890,22 @@ set number register
 .Nm groff :
 .Bx44N1
 .Pp
+scan for and remove junk files
+.br
+.Nm catman :
+.Fx Pq March 31, 1995
+.Pp
 set
 .Xr less 1
 prompt
 .br
 .Nm man :
-.dbI
+.No man-db-2.3.5 Pq April 21, 1995
 .Pp
 use regular expression matching
 .br
 .Nm apropos , whatis :
-.dbI
-.Pp
-scan for and remove junk files
-.br
-.Nm catman :
-.Fx Pq March 31, 1995
+.No man-db-2.3.5 Pq April 21, 1995
 .Pp
 turn off formatting
 .br
@@ -944,6 +957,9 @@ silent mode, do not echo commands
 .Pp
 restrict section
 .br
+.Nm makewhatis :
+.man15g
+.br
 .Nm man :
 .Ox 2.3 Pq March 9, 1998 ,
 .Nx Pq June 12, 2000 ;
@@ -956,15 +972,12 @@ restrict section
 .No illumos
 .br
 .Nm whatis :
-.Ox 5.6 Pq April 18, 2014 ,
 .No man-db Pq Nov 16, 2003 ,
+.Ox 5.6 Pq April 18, 2014 ;
 .No illumos
-.br
 .Nm mandoc :
 .Ox 5.7 Pq August 27, 2014
 .br
-.Nm makewhatis :
-.man16
 .Pp
 do not look for stray cats
 .br
@@ -1053,7 +1066,7 @@ preprocess with
 check manual pages in the hierarchy
 .br
 .Nm mandb :
-.dbI
+.No man-db-1.3.12 to 1.3.17 Pq not before 1996, not after 2001
 .Pp
 check files for problems related to
 .Xr mandoc.db 5
@@ -1069,18 +1082,18 @@ unsafe mode
 update database
 .br
 .Nm makewhatis :
-.man16
-.Pp
-update database cache (requires suid)
-.br
-.Nm man :
-.dbI
+.Pq not before 1992, not after 1995
 .Pp
 create user databases only
 .br
 .Nm mandb :
 .dbI
 .Pp
+update database cache (requires suid)
+.br
+.Nm man :
+.No before man-db-2.2a10 Pq before Dec 6, 1994
+.Pp
 remove files from
 .Xr mandoc.db 5
 .br
@@ -1108,7 +1121,7 @@ verbose mode
 .Fx Pq March 15, 1995
 .br
 .Nm makewhatis :
-.man16
+.man15g
 .br
 .Nm apropos , whatis :
 .No man-db Pq Dec 29, 2002
@@ -1132,7 +1145,7 @@ disable the named warning
 list pathnames without additional information
 .br
 .Nm man :
-.man16
+.man15e
 .Pp
 list pathnames of cat files
 .br
@@ -1172,15 +1185,15 @@ database
 .Nx Pq July 27, 1993 ,
 .No Solaris 9-11
 .Pp
-use manpath obtained from man --path
-.br
-.Nm makewhatis :
-.man16
-.Pp
 use wildcard matching
 .br
 .Nm apropos , whatis :
-.dbI
+.No man-db-2.3.5 Pq April 21, 1995
+.Pp
+use manpath obtained from man --path
+.br
+.Nm makewhatis :
+.man15g
 .Pp
 update the
 .Xr whatis 1
@@ -1216,7 +1229,7 @@ do not run preprocessors
 .Bx44N1
 .br
 .Nm man :
-.dbI
+.No man-db-2.2a5 Pq Nov 10, 1994
 .It Fl z
 suppress formatted output from
 .Xr troff 1 ,
@@ -1228,7 +1241,7 @@ print only error messages
 ASCII output mode
 .br
 .Nm man :
-.dbI
+.No man-db-2.3.5 Pq April 21, 1995
 .It Fl \&?
 print a help message and exit
 .br
@@ -1295,9 +1308,16 @@ the OpenBSD CVS repository
 .It
 the NetBSD CVS repository
 .It
-the man-db CVS and git repositories
+the man-db CVS and git repositories (since April 2001)
+.It
+the man-db NEWS file (April 1995 to Dec 2016)
+.It
+the man-db ChangeLog-2013 file (Nov 1994 to Dec 2013)
+.It
+release tarballs man-1.5g (July 1998) to man-1.5p (Jan 2005),
+man-1.6 (June 2005), and man-1.6a to man-1.6g (Dec 2010)
 .It
-the final man-1.6 release tarball
+a makewhatis release tarball without version number from 1995
 .It
 the illumos manual pages on the WWW
 .It