=================================================================== RCS file: /cvs/mandoc/mdoc.7,v retrieving revision 1.83 retrieving revision 1.90 diff -u -p -r1.83 -r1.90 --- mandoc/mdoc.7 2010/01/30 08:55:39 1.83 +++ mandoc/mdoc.7 2010/04/06 17:01:27 1.90 @@ -1,4 +1,4 @@ -.\" $Id: mdoc.7,v 1.83 2010/01/30 08:55:39 kristaps Exp $ +.\" $Id: mdoc.7,v 1.90 2010/04/06 17:01:27 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons .\" @@ -14,7 +14,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: January 30 2010 $ +.Dd $Mdocdate: April 6 2010 $ .Dt MDOC 7 .Os . @@ -860,7 +860,7 @@ then the macro accepts an arbitrary number of argument .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 \&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 @@ -872,7 +872,7 @@ then the macro accepts an arbitrary number of argument .It Sx \&Ux Ta Yes Ta Yes Ta n .It Sx \&Va Ta Yes Ta Yes Ta n .It Sx \&Vt Ta Yes Ta Yes Ta >0 -.It Sx \&Xr Ta Yes Ta Yes Ta >0, <3 +.It Sx \&Xr Ta Yes Ta Yes Ta >0 .It Sx \&br Ta \&No Ta \&No Ta 0 .It Sx \&sp Ta \&No Ta \&No Ta 1 .El @@ -1553,6 +1553,7 @@ subsequent that. It, too, is optional. It must be on .Ar hppa64 , .Ar i386 , .Ar landisk , +.Ar loongson , .Ar luna88k , .Ar mac68k , .Ar macppc , @@ -1634,7 +1635,7 @@ Examples: .Ss \&En .Ss \&Eo .Ss \&Er -Error constants (suggested for use only in section two manuals). +Display error constants. .Pp Examples: .Bd -literal -offset indent @@ -1675,12 +1676,14 @@ is provided. 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. +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: .Bd -literal -offset indent \&.Fl a b c +\&.Fl Pf a b \&.Fl \&.Op Fl o Ns Ar file .Ed @@ -1924,6 +1927,44 @@ See also .Sx \&Ft and .Sx \&Va . +. +.Ss \&Xc +Close a scope opened by +.Sx \&Xo . +. +.Ss \&Xo +Open an extension scope. This macro originally existed to extend the +9-argument limit of troff; since this limit has been lifted, the macro +has been deprecated. +. +.Ss \&Xr +Link to another manual +.Pq Qq cross-reference . +Its calling syntax is +.Pp +.D1 \. Ns Sx \&Xr Cm name section +.Pp +The +.Cm name +and +.Cm section +are the name and section of the linked manual. If +.Cm section +is followed by non-punctuation, an +.Sx \&Ns +is inserted into the token stream. This behaviour is for compatibility +with +.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 . . .Sh COMPATIBILITY