===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/mandoc/Attic/mdoc.7,v
retrieving revision 1.24
retrieving revision 1.25
diff -c -r1.24 -r1.25
*** src/usr.bin/mandoc/Attic/mdoc.7	2010/04/02 12:39:47	1.24
--- src/usr.bin/mandoc/Attic/mdoc.7	2010/04/07 23:15:05	1.25
***************
*** 1,4 ****
! .\"	$Id: mdoc.7,v 1.24 2010/04/02 12:39:47 schwarze Exp $
  .\"
  .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
  .\"
--- 1,4 ----
! .\"	$Id: mdoc.7,v 1.25 2010/04/07 23:15:05 schwarze Exp $
  .\"
  .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
  .\"
***************
*** 14,20 ****
  .\" 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 2 2010 $
  .Dt MDOC 7
  .Os
  .
--- 14,20 ----
  .\" 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 7 2010 $
  .Dt MDOC 7
  .Os
  .
***************
*** 860,866 ****
  .It Sx \&Ot  Ta    \&No     Ta    \&No     Ta    n
  .It Sx \&Ox  Ta    Yes      Ta    Yes      Ta    n
  .It Sx \&Pa  Ta    Yes      Ta    Yes      Ta    n
! .It Sx \&Pf  Ta    \&No     Ta    Yes      Ta    1
  .It Sx \&Pp  Ta    \&No     Ta    \&No     Ta    0
  .It Sx \&Rv  Ta    \&No     Ta    \&No     Ta    n
  .It Sx \&Sm  Ta    \&No     Ta    \&No     Ta    1
--- 860,866 ----
  .It Sx \&Ot  Ta    \&No     Ta    \&No     Ta    n
  .It Sx \&Ox  Ta    Yes      Ta    Yes      Ta    n
  .It Sx \&Pa  Ta    Yes      Ta    Yes      Ta    n
! .It Sx \&Pf  Ta    Yes      Ta    Yes      Ta    1
  .It Sx \&Pp  Ta    \&No     Ta    \&No     Ta    0
  .It Sx \&Rv  Ta    \&No     Ta    \&No     Ta    n
  .It Sx \&Sm  Ta    \&No     Ta    \&No     Ta    1
***************
*** 974,983 ****
  memory, not a physical (post) address.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Ad [0,$]
! \&.Ad 0x00000000
! .Ed
  .
  .Ss \&An
  Author name.  This macro may alternatively accepts the following
--- 974,981 ----
  memory, not a physical (post) address.
  .Pp
  Examples:
! .D1 \&.Ad [0,$]
! .D1 \&.Ad 0x00000000
  .
  .Ss \&An
  Author name.  This macro may alternatively accepts the following
***************
*** 998,1008 ****
  section, the default is not to split.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.An -nosplit
! \&.An J. E. Hopcraft ,
! \&.An J. D. Ullman .
! .Ed
  .Pp
  .Em Remarks :
  the effects of
--- 996,1003 ----
  section, the default is not to split.
  .Pp
  Examples:
! .D1 \&.An -nosplit
! .D1 \&.An J. D. Ullman .
  .Pp
  .Em Remarks :
  the effects of
***************
*** 1019,1027 ****
  arguments.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Fl -key= Ns Ao Ar val Ac
! .Ed
  .Pp
  See also
  .Sx \&Aq .
--- 1014,1020 ----
  arguments.
  .Pp
  Examples:
! .D1 \&.Fl -key= \&Ns \&Ao \&Ar val \&Ac
  .Pp
  See also
  .Sx \&Aq .
***************
*** 1038,1046 ****
  Encloses its arguments in angled brackets.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Fl -key= Ns Aq Ar val
! .Ed
  .Pp
  .Em Remarks :
  this macro is often abused for rendering URIs, which should instead use
--- 1031,1037 ----
  Encloses its arguments in angled brackets.
  .Pp
  Examples:
! .D1 \&.Fl -key= \&Ns \&Aq \&Ar val
  .Pp
  .Em Remarks :
  this macro is often abused for rendering URIs, which should instead use
***************
*** 1061,1071 ****
  is used as a default.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Fl o Ns Ar file1
! \&.Ar
! \&.Ar arg1 , arg2 .
! .Ed
  .
  .Ss \&At
  Formats an AT&T version.  Accepts at most one parameter:
--- 1052,1060 ----
  is used as a default.
  .Pp
  Examples:
! .D1 \&.Fl o \&Ns \&Ar file1
! .D1 \&.Ar
! .D1 \&.Ar arg1 , arg2 .
  .
  .Ss \&At
  Formats an AT&T version.  Accepts at most one parameter:
***************
*** 1081,1090 ****
  Note that these parameters do not begin with a hyphen.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.At
! \&.At V.1
! .Ed
  .Pp
  See also
  .Sx \&Bsx ,
--- 1070,1077 ----
  Note that these parameters do not begin with a hyphen.
  .Pp
  Examples:
! .D1 \&.At
! .D1 \&.At V.1
  .Pp
  See also
  .Sx \&Bsx ,
***************
*** 1244,1250 ****
  Examples:
  .Bd -literal -offset indent
  \&.Bo 1 ,
! \&.Dv BUFSIZ Bc
  .Ed
  .Pp
  See also
--- 1231,1237 ----
  Examples:
  .Bd -literal -offset indent
  \&.Bo 1 ,
! \&.Dv BUFSIZ \&Bc
  .Ed
  .Pp
  See also
***************
*** 1254,1262 ****
  Encloses its arguments in square brackets.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Bq 1 , Dv BUFSIZ
! .Ed
  .Pp
  .Em Remarks :
  this macro is sometimes abused to emulate optional arguments for
--- 1241,1247 ----
  Encloses its arguments in square brackets.
  .Pp
  Examples:
! .D1 \&.Bq 1 , \&Dv BUFSIZ
  .Pp
  .Em Remarks :
  this macro is sometimes abused to emulate optional arguments for
***************
*** 1281,1287 ****
  Examples:
  .Bd -literal -offset indent
  \&.Bro 1 , ... ,
! \&.Va n Brc
  .Ed
  .Pp
  See also
--- 1266,1272 ----
  Examples:
  .Bd -literal -offset indent
  \&.Bro 1 , ... ,
! \&.Va n \&Brc
  .Ed
  .Pp
  See also
***************
*** 1291,1299 ****
  Encloses its arguments in curly braces.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Brq 1 , ... , Va n
! .Ed
  .Pp
  See also
  .Sx \&Bro .
--- 1276,1282 ----
  Encloses its arguments in curly braces.
  .Pp
  Examples:
! .D1 \&.Brq 1 , ... , \&Va n
  .Pp
  See also
  .Sx \&Bro .
***************
*** 1303,1312 ****
  no argument is provided.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Bsx 1.0
! \&.Bsx
! .Ed
  .Pp
  See also
  .Sx \&At ,
--- 1286,1293 ----
  no argument is provided.
  .Pp
  Examples:
! .D1 \&.Bsx 1.0
! .D1 \&.Bsx
  .Pp
  See also
  .Sx \&At ,
***************
*** 1327,1336 ****
  argument is provided.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Bx 4.4
! \&.Bx
! .Ed
  .Pp
  See also
  .Sx \&At ,
--- 1308,1315 ----
  argument is provided.
  .Pp
  Examples:
! .D1 \&.Bx 4.4
! .D1 \&.Bx
  .Pp
  See also
  .Sx \&At ,
***************
*** 1348,1356 ****
  .Xr config 8 .
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Cd device le0 at scode?
! .Ed
  .Pp
  .Em Remarks :
  this macro is commonly abused by using quoted literals to retain
--- 1327,1333 ----
  .Xr config 8 .
  .Pp
  Examples:
! .D1 \&.Cd device le0 at scode?
  .Pp
  .Em Remarks :
  this macro is commonly abused by using quoted literals to retain
***************
*** 1363,1372 ****
  keys.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Cm ControlPath
! \&.Cm ControlMaster
! .Ed
  .Pp
  See also
  .Sx \&Fl .
--- 1340,1347 ----
  keys.
  .Pp
  Examples:
! .D1 \&.Cm ControlPath
! .D1 \&.Cm ControlMaster
  .Pp
  See also
  .Sx \&Fl .
***************
*** 1376,1384 ****
  is useful for simple indented statements.  It is followed by a newline.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.D1 Fl abcdefgh
! .Ed
  .Pp
  See also
  .Sx \&Bd
--- 1351,1357 ----
  is useful for simple indented statements.  It is followed by a newline.
  .Pp
  Examples:
! .D1 \&.D1 \&Fl abcdefgh
  .Pp
  See also
  .Sx \&Bd
***************
*** 1409,1419 ****
  If a date does not conform, the current date is used instead.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Dd $\&Mdocdate$
! \&.Dd $\&Mdocdate: July 21 2007$
! \&.Dd July 21, 2007
! .Ed
  .Pp
  See also
  .Sx \&Dt
--- 1382,1390 ----
  If a date does not conform, the current date is used instead.
  .Pp
  Examples:
! .D1 \&.Dd $\&Mdocdate$
! .D1 \&.Dd $\&Mdocdate: July 21 2007$
! .D1 \&.Dd July 21, 2007
  .Pp
  See also
  .Sx \&Dt
***************
*** 1425,1433 ****
  useful for commands and invocations.  It is followed by a newline.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Dl % mandoc mdoc.7 | less
! .Ed
  .Pp
  See also
  .Sx \&Bd
--- 1396,1402 ----
  useful for commands and invocations.  It is followed by a newline.
  .Pp
  Examples:
! .D1 \&.Dl % mandoc mdoc.7 | less
  .Pp
  See also
  .Sx \&Bd
***************
*** 1439,1447 ****
  arguments.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.D1 Do April is the cruellest month Dc \e(em T.S. Eliot
! .Ed
  .Pp
  See also
  .Sx \&Dq .
--- 1408,1414 ----
  arguments.
  .Pp
  Examples:
! .D1 \&.D1 \&Do April is the cruellest month \&Dc \e(em T.S. Eliot
  .Pp
  See also
  .Sx \&Dq .
***************
*** 1450,1456 ****
  Encloses its arguments in double quotes.
  .Pp
  Examples:
! .Bd -literal -offset indent
  \&.Dq April is the cruellest month
  \e(em T.S. Eliot
  .Ed
--- 1417,1423 ----
  Encloses its arguments in double quotes.
  .Pp
  Examples:
! .Bd -literal -offset indent -compact
  \&.Dq April is the cruellest month
  \e(em T.S. Eliot
  .Ed
***************
*** 1572,1583 ****
  .El
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Dt FOO 1
! \&.Dt FOO 4 KM
! \&.Dt FOO 9 i386
! \&.Dt FOO 9 KM i386
! .Ed
  .Pp
  See also
  .Sx \&Dd
--- 1539,1548 ----
  .El
  .Pp
  Examples:
! .D1 \&.Dt FOO 1
! .D1 \&.Dt FOO 4 KM
! .D1 \&.Dt FOO 9 i386
! .D1 \&.Dt FOO 9 KM i386
  .Pp
  See also
  .Sx \&Dd
***************
*** 1588,1597 ****
  Defined variables such as preprocessor constants.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Dv BUFSIZ
! \&.Dv STDOUT_FILENO
! .Ed
  .Pp
  See also
  .Sx \&Er .
--- 1553,1560 ----
  Defined variables such as preprocessor constants.
  .Pp
  Examples:
! .D1 \&.Dv BUFSIZ
! .D1 \&.Dv STDOUT_FILENO
  .Pp
  See also
  .Sx \&Er .
***************
*** 1601,1610 ****
  value if no argument is provided.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Dx 2.4.1
! \&.Dx
! .Ed
  .Pp
  See also
  .Sx \&At ,
--- 1564,1571 ----
  value if no argument is provided.
  .Pp
  Examples:
! .D1 \&.Dx 2.4.1
! .D1 \&.Dx
  .Pp
  See also
  .Sx \&At ,
***************
*** 1621,1647 ****
  .Ss \&Ef
  .Ss \&Ek
  .Ss \&El
  .Ss \&Em
  Denotes text that should be emphasised.  Note that this is a
  presentation term and should not be used for stylistically decorating
  technical terms.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Ed Warnings!
! \&.Ed Remarks :
! .Ed
  .
  .Ss \&En
  .Ss \&Eo
  .Ss \&Er
! Error constants (suggested for use only in section two manuals).
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Er EPERM
! \&.Er ENOENT
! .Ed
  .Pp
  See also
  .Sx \&Dv .
--- 1582,1605 ----
  .Ss \&Ef
  .Ss \&Ek
  .Ss \&El
+ .
  .Ss \&Em
  Denotes text that should be emphasised.  Note that this is a
  presentation term and should not be used for stylistically decorating
  technical terms.
  .Pp
  Examples:
! .D1 \&.Em Warnings!
! .D1 \&.Em Remarks :
  .
  .Ss \&En
  .Ss \&Eo
  .Ss \&Er
! Display error constants.
  .Pp
  Examples:
! .D1 \&.Er EPERM
! .D1 \&.Er ENOENT
  .Pp
  See also
  .Sx \&Dv .
***************
*** 1653,1662 ****
  .Xr environ 7 .
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Ev DISPLAY
! \&.Ev PATH
! .Ed
  .
  .Ss \&Ex
  Inserts text regarding a utility's exit values.  This macro must have
--- 1611,1618 ----
  .Xr environ 7 .
  .Pp
  Examples:
! .D1 \&.Ev DISPLAY
! .D1 \&.Ev PATH
  .
  .Ss \&Ex
  Inserts text regarding a utility's exit values.  This macro must have
***************
*** 1676,1690 ****
  Command-line flag.  Used when listing arguments to command-line
  utilities.  Prints a fixed-width hyphen
  .Sq \-
! before each delimited argument.  If no arguments are provided, a hyphen
! is still printed.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Fl a b c
! \&.Fl
! \&.Op Fl o Ns Ar file
! .Ed
  .Pp
  See also
  .Sx \&Cm .
--- 1632,1646 ----
  Command-line flag.  Used when listing arguments to command-line
  utilities.  Prints a fixed-width hyphen
  .Sq \-
! directly followed by each argument.  If no arguments are provided, a hyphen is
! printed followed by a space.  If the argument is a macro, a hyphen is
! prefixed to the subsequent macro output.
  .Pp
  Examples:
! .D1 \&.Fl a b c
! .D1 \&.Fl \&Pf a b
! .D1 \&.Fl
! .D1 \&.Op \&Fl o \&Ns \&Ar file
  .Pp
  See also
  .Sx \&Cm .
***************
*** 1698,1707 ****
  if no argument is provided.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Fx 7.1
! \&.Fx
! .Ed
  .Pp
  See also
  .Sx \&At ,
--- 1654,1661 ----
  if no argument is provided.
  .Pp
  Examples:
! .D1 \&.Fx 7.1
! .D1 \&.Fx
  .Pp
  See also
  .Sx \&At ,
***************
*** 1725,1734 ****
  .D1 \. Ns Sx \&Lk Cm uri Op Cm name
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Lk http://bsd.lv "The BSD.lv Project"
! \&.Lk http://bsd.lv
! .Ed
  .Pp
  See also
  .Sx \&Mt .
--- 1679,1686 ----
  .D1 \. Ns Sx \&Lk Cm uri Op Cm name
  .Pp
  Examples:
! .D1 \&.Lk http://bsd.lv "The BSD.lv Project"
! .D1 \&.Lk http://bsd.lv
  .Pp
  See also
  .Sx \&Mt .
***************
*** 1745,1754 ****
  no argument is provided.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Nx 5.01
! \&.Nx
! .Ed
  .Pp
  See also
  .Sx \&At ,
--- 1697,1704 ----
  no argument is provided.
  .Pp
  Examples:
! .D1 \&.Nx 5.01
! .D1 \&.Nx
  .Pp
  See also
  .Sx \&At ,
***************
*** 1778,1788 ****
  the suggested form.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Os
! \&.Os KTH/CSC/TCS
! \&.Os BSD 4.3
! .Ed
  .Pp
  See also
  .Sx \&Dd
--- 1728,1736 ----
  the suggested form.
  .Pp
  Examples:
! .D1 \&.Os
! .D1 \&.Os KTH/CSC/TCS
! .D1 \&.Os BSD 4.3
  .Pp
  See also
  .Sx \&Dd
***************
*** 1800,1809 ****
  if no argument is provided.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Ox 4.5
! \&.Ox
! .Ed
  .Pp
  See also
  .Sx \&At ,
--- 1748,1755 ----
  if no argument is provided.
  .Pp
  Examples:
! .D1 \&.Ox 4.5
! .D1 \&.Ox
  .Pp
  See also
  .Sx \&At ,
***************
*** 1853,1859 ****
  child macros (at least one must be specified).
  .Pp
  Examples:
! .Bd -literal -offset indent
  \&.Rs
  \&.%A J. E. Hopcroft
  \&.%A J. D. Ullman
--- 1799,1805 ----
  child macros (at least one must be specified).
  .Pp
  Examples:
! .Bd -literal -offset indent -compact
  \&.Rs
  \&.%A J. E. Hopcroft
  \&.%A J. D. Ullman
***************
*** 1886,1894 ****
  Format the UNIX name.  Accepts no argument.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Ux
! .Ed
  .Pp
  See also
  .Sx \&At ,
--- 1832,1838 ----
  Format the UNIX name.  Accepts no argument.
  .Pp
  Examples:
! .D1 \&.Ux
  .Pp
  See also
  .Sx \&At ,
***************
*** 1916,1925 ****
  which is used for function return types.
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Vt unsigned char
! \&.Vt extern const char * const sys_signame[] ;
! .Ed
  .Pp
  See also
  .Sx \&Ft
--- 1860,1867 ----
  which is used for function return types.
  .Pp
  Examples:
! .D1 \&.Vt unsigned char
! .D1 \&.Vt extern const char * const sys_signame[] ;
  .Pp
  See also
  .Sx \&Ft
***************
*** 1955,1965 ****
  .Xr groff 1 .
  .Pp
  Examples:
! .Bd -literal -offset indent
! \&.Xr mandoc 1
! \&.Xr mandoc 1 ;
! \&.Xr mandoc 1 s behaviour
! .Ed
  .
  .Ss \&br
  .Ss \&sp
--- 1897,1905 ----
  .Xr groff 1 .
  .Pp
  Examples:
! .D1 \&.Xr mandoc 1
! .D1 \&.Xr mandoc 1 ;
! .D1 \&.Xr mandoc 1 \&Ns s behaviour
  .
  .Ss \&br
  .Ss \&sp