A missing initialization could randomly cause regular expression

[mandoc.git] / man.options.1

diff --git a/man.options.1 b/man.options.1
index 0fc0bae0f6d6a7683b6ade22f40406f6181ecd2e..9ad608f5e55152a4f96b67703c2f16cba5a4b3fe 100644 (file)
--- 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.6 2017/02/02 20:10:51 schwarze Exp $

 .\"
 .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
 .\"
 .\"
 .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
 .\"


@@ -42,22 +42,30 @@
 .de Bx43
 .Bx 4.3 Pq June 1986 \\$1
 ..
 .de Bx43
 .Bx 4.3 Pq June 1986 \\$1
 ..

-.de Bx44N1
-.Bx 4.3 Net/1 Pq March 3, 1989 \\$1
-..
-.de g102
-.No groff-1.02 Pq after March 1989, before June 1991 \\$1
+.\" option was present in groff-1.01 as contained in 4.3BSD-Net/2
+.\" and no mention of it could be found in the ChangeLog,
+.\" so it's probably older than groff-0.4, where the log started
+.de g04
+.No probably before groff-0.4 Pq before July 14, 1990 \\$1

 ..
 .de Eaton
 .No Eaton Pq before July 7, 1993; 1990/91? \\$1
 ..
 ..
 .de Eaton
 .No Eaton Pq before July 7, 1993; 1990/91? \\$1
 ..

-.\" man-1.6 was released on June 24, 2005.
-.de man16
-.No man-1.6 Pq not before 1993, not after 2005 \\$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

 ..
 ..

-.\" 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
 .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

 ..
 .\"
 .\" --------------------------------------------------------------------
 ..
 .\"
 .\" --------------------------------------------------------------------


@@ -134,17 +142,17 @@ ASCII output mode
 .At7
 .br
 .Nm groff :
 .At7
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .It Fl B
 use specified browser
 .br
 .Nm man :
 .It Fl B
 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
 .Nm groff :
 .It Fl b
 print a backtrace with each warning or error message
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 .Bq obsolete hardware
 report whether the phototypesetter is busy
 .Pp
 .Bq obsolete hardware
 report whether the phototypesetter is busy


@@ -156,12 +164,12 @@ alternate configuration file
 .br
 .Nm apropos , whatis :
 .Bx 4.4 Lite1 Pq April 22, 1994 ,
 .br
 .Nm apropos , whatis :
 .Bx 4.4 Lite1 Pq April 22, 1994 ,

-.man16 ,

 .No man-db Pq Feb 22, 2003 ;
 .Ox , Nx
 .br
 .Nm man :
 .No man-db Pq Feb 22, 2003 ;
 .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 :
 .Ox
 .br
 .Nm mandb , catman , manpath :


@@ -180,7 +188,7 @@ alternate configuration file
 enable compatibility mode
 .br
 .Nm groff :
 enable compatibility mode
 .br
 .Nm groff :

-.Bx44N1
+.No before groff-0.5 Pq before August 3, 1990

 .It Fl c
 do not use a pager
 .br
 .It Fl c
 do not use a pager
 .br


@@ -191,21 +199,10 @@ do not use a pager
 .Nm apropos , whatis , mandoc :
 .Ox 5.7 Pq August 27, 2014
 .Pp
 .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 :
 process given catpath
 .br
 .Nm makewhatis :

-.man16
+.Pq not before 1992, not after 1995

 .Pp
 recreate databases from scratch
 .br
 .Pp
 recreate databases from scratch
 .br


@@ -223,6 +220,17 @@ internal option for use by
 .Nm man :
 .dbI
 .Pp
 .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 :
 recreate nroff versions from SGML sources
 .br
 .Nm catman :


@@ -236,17 +244,17 @@ postprocess with
 .At3 ,
 .At5
 .It Fl D
 .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
 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
 set default input encoding for
 .Xr preconv 1
 .br


@@ -262,7 +270,7 @@ display all files added to
 define a user-defined string
 .br
 .Nm groff :
 define a user-defined string
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 print debugging information
 .br
 .Pp
 print debugging information
 .br


@@ -297,7 +305,7 @@ interpret arguments as file names
 inhibit all error messages
 .br
 .Nm groff :
 inhibit all error messages
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 select output encoding
 .br
 .Pp
 select output encoding
 .br


@@ -311,22 +319,22 @@ preprocess with
 .At7
 .br
 .Nm groff :
 .At7
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 adjust text to left and right margins
 .br
 .Nm nroff :
 .At7
 .Pp
 .Pp
 adjust text to left and right margins
 .br
 .Nm nroff :
 .At7
 .Pp

-restrict search by section extension
-.br
-.Nm man :
-.dbI
-.Pp

 use exact matching
 .br
 .Nm apropos , whatis :
 .dbI
 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
 .It Fl F
 use alternate font directory
 .br


@@ -334,14 +342,14 @@ use alternate font directory
 .Bx 4.2 Pq September 1983
 .br
 .Nm groff :
 .Bx 4.2 Pq September 1983
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 preformat only, do not display
 .br
 .Nm man :
 .Pp
 preformat only, do not display
 .br
 .Nm man :

-.man16
+.No man-1.5g Pq April 7, 1999

 .Pp
 .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
 .br
 .Nm man :
 .No illumos , Solaris 9-11


@@ -364,7 +372,7 @@ mode
 set the default font family
 .br
 .Nm groff :
 set the default font family
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 force formatting even if cat page is newer
 .br
 .Pp
 force formatting even if cat page is newer
 .br


@@ -401,7 +409,7 @@ preprocess with
 produce a global manpath
 .br
 .Nm manpath :
 produce a global manpath
 .br
 .Nm manpath :

-.dbI
+.No man-db-2.2a7 Pq Nov 16, 1994

 .Pp
 preprocess with
 .Xr grn 1
 .Pp
 preprocess with
 .Xr grn 1


@@ -424,22 +432,22 @@ output to a DASI 300 terminal in 12-pitch mode
 read hyphenation patterns from the given file
 .br
 .Nm groff :
 read hyphenation patterns from the given file
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 .Pp

-use program to render HTML files as text
+produce HTML output

 .br
 .Nm man :
 .br
 .Nm man :

-.man16
+.No man-db-1.3.12 to 1.3.17 Pq not before 1996, not after 2001

 .Pp
 .Pp

-produce HTML output
+use program to render HTML files as text

 .br
 .Nm man :
 .br
 .Nm man :

-.dbI
+.No man-1.6 Pq June 24, 2005

 .It Fl h
 print a help message and exit
 .br
 .Nm groff :
 .It Fl h
 print a help message and exit
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .br
 .Nm man :
 .Eaton ;
 .br
 .Nm man :
 .Eaton ;


@@ -497,7 +505,7 @@ read standard input after the input files are exhausted
 .At7
 .br
 .Nm groff :
 .At7
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 ignore case when matching manual page names
 .br
 .Pp
 ignore case when matching manual page names
 .br


@@ -524,8 +532,8 @@ preprocess with
 source code full text search
 .br
 .Nm man :
 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
 .No Solaris 11
 .Pp
 input encoding


@@ -567,18 +575,18 @@ display on a Tektronix 4014 terminal
 pass argument to the spooler
 .br
 .Nm groff :
 pass argument to the spooler
 .br
 .Nm groff :

-.Bx44N1
-.Pp
-print list of locales
-.br
-.Nm manpath :
-.Fx Pq Nov 23, 1999
+.No groff-0.6 Pq Sep 14, 1990

 .Pp
 use alternate
 .Xr locale 1
 .br
 .Nm man , apropos , whatis :
 .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
 .Pp
 use
 .Xr locale 1


@@ -590,12 +598,12 @@ specified in the environment
 spool the output
 .br
 .Nm groff :
 spool the output
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 interpret arguments as file names
 .br
 .Nm man :
 .Pp
 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 :
 .Ox 5.7 Pq Aug 30, 2014
 .br
 .Nm apropos , whatis , mandoc :


@@ -630,7 +638,7 @@ override manual page search path
 .br
 .Nm apropos , whatis :
 .Bx43 ,
 .br
 .Nm apropos , whatis :
 .Bx43 ,

-.dbI ;
+.No before man-db-2.2a14 Pq before Dec 16, 1994 ;

 .Ox , No illumos
 .br
 .Nm catman :
 .Ox , No illumos
 .br
 .Nm catman :


@@ -644,7 +652,7 @@ override manual page search path
 prepend to macro file search path
 .br
 .Nm groff :
 prepend to macro file search path
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 do not show the context of the match
 .br
 .Pp
 do not show the context of the match
 .br


@@ -657,7 +665,7 @@ specify input macro language
 .At7
 .br
 .Nm groff :
 .At7
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .br
 .Nm mandoc :
 .Ox 4.8 Pq April 6, 2009
 .br
 .Nm mandoc :
 .Ox 4.8 Pq April 6, 2009


@@ -698,7 +706,7 @@ do not allow newlines between
 delimiters
 .br
 .Nm groff :
 delimiters
 .br
 .Nm groff :

-.Bx44N1
+.No groff-1.01 Pq Feb 21, 1991

 .It Fl n
 specify a page number for the first page
 .br
 .It Fl n
 specify a page number for the first page
 .br


@@ -706,7 +714,7 @@ specify a page number for the first page
 .At7
 .br
 .Nm groff :
 .At7
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 .Xr nroff 1
 output mode
 .Pp
 .Xr nroff 1
 output mode


@@ -753,7 +761,7 @@ select pages by numbers
 .At7
 .br
 .Nm groff :
 .At7
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 force use of non-localized manual pages
 .br
 .Pp
 force use of non-localized manual pages
 .br


@@ -768,7 +776,7 @@ optimize index for speed and disk space
 pass argument to postprocessor
 .br
 .Nm groff :
 pass argument to postprocessor
 .br
 .Nm groff :

-.Bx44N1
+.No groff-0.6 Pq Sep 14, 1990

 .Pp
 use specified pager
 .br
 .Pp
 use specified pager
 .br


@@ -785,7 +793,7 @@ preprocess with
 .Xr pic 1
 .br
 .Nm groff :
 .Xr pic 1
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 use the given list of preprocessors
 .br
 .Pp
 use the given list of preprocessors
 .br


@@ -862,7 +870,7 @@ postprocess with
 .Xr refer 1
 .br
 .Nm groff :
 .Xr refer 1
 .br
 .Nm groff :

-.g102
+.No groff-1.02 Pq June 2, 1991

 .Pp
 recode to the specified encoding
 .br
 .Pp
 recode to the specified encoding
 .br


@@ -875,24 +883,24 @@ set number register
 .At7
 .br
 .Nm groff :
 .At7
 .br
 .Nm groff :

-.Bx44N1
+.g04
+.Pp
+scan for and remove junk files
+.br
+.Nm catman :
+.Fx Pq March 31, 1995

 .Pp
 set
 .Xr less 1
 prompt
 .br
 .Nm man :
 .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 :
 .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
 .Pp
 turn off formatting
 .br


@@ -935,7 +943,7 @@ preprocess with
 .Xr soelim 1
 .br
 .Nm groff :
 .Xr soelim 1
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 silent mode, do not echo commands
 .br
 .Pp
 silent mode, do not echo commands
 .br


@@ -944,6 +952,9 @@ silent mode, do not echo commands
 .Pp
 restrict section
 .br
 .Pp
 restrict section
 .br

+.Nm makewhatis :
+.man15g
+.br

 .Nm man :
 .Ox 2.3 Pq March 9, 1998 ,
 .Nx Pq June 12, 2000 ;
 .Nm man :
 .Ox 2.3 Pq March 9, 1998 ,
 .Nx Pq June 12, 2000 ;


@@ -956,15 +967,12 @@ restrict section
 .No illumos
 .br
 .Nm whatis :
 .No illumos
 .br
 .Nm whatis :

-.Ox 5.6 Pq April 18, 2014 ,

 .No man-db Pq Nov 16, 2003 ,
 .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
 .No illumos
 .br
 .Nm mandoc :
 .Ox 5.7 Pq August 27, 2014

-.br
-.Nm makewhatis :
-.man16

 .Pp
 do not look for stray cats
 .br
 .Pp
 do not look for stray cats
 .br


@@ -1009,7 +1017,7 @@ select terminal output format
 .Ox 5.7 Pq August 27, 2014
 .br
 .Nm groff :
 .Ox 5.7 Pq August 27, 2014
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .br
 .Nm mandoc :
 .Ox 4.8 Pq April 6, 2009
 .br
 .Nm mandoc :
 .Ox 4.8 Pq April 6, 2009


@@ -1048,12 +1056,12 @@ preprocess with
 .Xr tbl 7
 .br
 .Nm groff :
 .Xr tbl 7
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 check manual pages in the hierarchy
 .br
 .Nm mandb :
 .Pp
 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
 .Pp
 check files for problems related to
 .Xr mandoc.db 5


@@ -1069,18 +1077,18 @@ unsafe mode
 update database
 .br
 .Nm makewhatis :
 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
 .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
 remove files from
 .Xr mandoc.db 5
 .br


@@ -1090,7 +1098,7 @@ remove files from
 print the pipeline on stdout instead of executing it
 .br
 .Nm groff :
 print the pipeline on stdout instead of executing it
 .br
 .Nm groff :

-.Bx44N1
+.No groff-0.6 Pq Sep 2, 1990

 .Pp
 print version information
 .br
 .Pp
 print version information
 .br


@@ -1100,7 +1108,7 @@ print version information
 print version number
 .br
 .Nm groff :
 print version number
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .Pp
 verbose mode
 .br
 .Pp
 verbose mode
 .br


@@ -1108,7 +1116,7 @@ verbose mode
 .Fx Pq March 15, 1995
 .br
 .Nm makewhatis :
 .Fx Pq March 15, 1995
 .br
 .Nm makewhatis :

-.man16
+.man15g

 .br
 .Nm apropos , whatis :
 .No man-db Pq Dec 29, 2002
 .br
 .Nm apropos , whatis :
 .No man-db Pq Dec 29, 2002


@@ -1127,12 +1135,12 @@ produce output on the Versatec printer
 disable the named warning
 .br
 .Nm groff :
 disable the named warning
 .br
 .Nm groff :

-.Bx44N1
+.No groff-0.5 Pq August 14, 1990

 .Pp
 list pathnames without additional information
 .br
 .Nm man :
 .Pp
 list pathnames without additional information
 .br
 .Nm man :

-.man16
+.man15e

 .Pp
 list pathnames of cat files
 .br
 .Pp
 list pathnames of cat files
 .br


@@ -1162,7 +1170,7 @@ list pathnames
 enable the named warning
 .br
 .Nm groff :
 enable the named warning
 .br
 .Nm groff :

-.Bx44N1
+.No groff-0.5 Pq August 14, 1990

 .Pp
 only create the
 .Xr whatis 1
 .Pp
 only create the
 .Xr whatis 1


@@ -1172,15 +1180,15 @@ database
 .Nx Pq July 27, 1993 ,
 .No Solaris 9-11
 .Pp
 .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 :
 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
 .Pp
 update the
 .Xr whatis 1


@@ -1213,27 +1221,27 @@ use the non-compacted version of the macros
 do not run preprocessors
 .br
 .Nm groff :
 do not run preprocessors
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .br
 .Nm man :
 .br
 .Nm man :

-.dbI
+.No man-db-2.2a5 Pq Nov 10, 1994

 .It Fl z
 suppress formatted output from
 .Xr troff 1 ,
 print only error messages
 .br
 .Nm groff :
 .It Fl z
 suppress formatted output from
 .Xr troff 1 ,
 print only error messages
 .br
 .Nm groff :

-.Bx44N1
+.g04

 .It Fl 7
 ASCII output mode
 .br
 .Nm man :
 .It Fl 7
 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
 .Nm groff :
 .It Fl \&?
 print a help message and exit
 .br
 .Nm groff :

-.g102
+.g04

 .br
 .Nm man , manpath :
 .Eaton ;
 .br
 .Nm man , manpath :
 .Eaton ;


@@ -1295,9 +1303,22 @@ the OpenBSD CVS repository
 .It
 the NetBSD CVS repository
 .It
 .It
 the NetBSD CVS repository
 .It

-the man-db CVS and git repositories
+the GNU roff (groff) git repository
+.It
+the 4.3BSD-Net/2 groff CHANGES file (Oct 1990 to March 1991)
+.It
+the 4.3BSD-Net/2 groff ChangeLog file (July 1990 to March 1991)
+.It
+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
 .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
 .It
 the illumos manual pages on the WWW
 .It