=================================================================== RCS file: /cvs/mandoc/mdoc.7,v retrieving revision 1.77 retrieving revision 1.79 diff -u -p -r1.77 -r1.79 --- mandoc/mdoc.7 2009/11/12 05:50:12 1.77 +++ mandoc/mdoc.7 2010/01/01 13:35:30 1.79 @@ -1,4 +1,4 @@ -.\" $Id: mdoc.7,v 1.77 2009/11/12 05:50:12 kristaps Exp $ +.\" $Id: mdoc.7,v 1.79 2010/01/01 13:35:30 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: November 12 2009 $ +.Dd $Mdocdate: January 1 2010 $ .Dt MDOC 7 .Os . @@ -140,7 +140,7 @@ A numerical representation 3, 2, or 1 (bold, italic, a respectively) may be used instead. A text decoration is valid within the current font scope only: if a macro opens a font scope alongside its own scope, such as -.Sx \&Bf +.Sx \&Bf .Cm \&Sy , in-scope invocations of .Sq \ef @@ -1596,6 +1596,22 @@ is provided. .Ss \&Fc .Ss \&Fd .Ss \&Fl +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 . +. .Ss \&Fn .Ss \&Fo .Ss \&Fr @@ -1830,7 +1846,13 @@ file re-write .Pp .Bl -dash -compact .It +Historic .Xr groff 1 +does not print a dash for empty +.Sx \&Fl +arguments. This behaviour has been discontinued. +.It +.Xr groff 1 behaves strangely (even between versions) when specifying .Sq \ef escapes within line-macro scopes. These aberrations have been @@ -1838,7 +1860,7 @@ normalised. .It Negative scaling units are now truncated to zero instead of creating interesting conditions, such as with -.Sx \&sp +.Sx \&sp .Cm \-1i . Furthermore, the .Sq f @@ -1849,7 +1871,7 @@ standalone double-quote in formatted output. This idi behaviour is no longer applicable. .It Display types -.Sx \&Bd +.Sx \&Bd .Fl center and .Fl right @@ -1880,7 +1902,7 @@ made historic groff .Qq go orbital but is a proper delimiter in this implementation. .It -.Sx \&It +.Sx \&It .Fl nested is assumed for all lists (it wasn't in historic groff): any list may be nested and