diff options
author | Kristaps Dzonsons <kristaps@bsd.lv> | 2009-11-12 05:50:12 +0000 |
---|---|---|
committer | Kristaps Dzonsons <kristaps@bsd.lv> | 2009-11-12 05:50:12 +0000 |
commit | 754ffee707861356b63ca9cf6d44f5d683edf9f3 (patch) | |
tree | 8d87e9f691c5f59a89cdcde5a4f89e40f10bc048 /mdoc.7 | |
parent | f2108e6ac6a2dab810b9177f6f302c9032ca4af5 (diff) | |
download | mandoc-754ffee707861356b63ca9cf6d44f5d683edf9f3.tar.gz mandoc-754ffee707861356b63ca9cf6d44f5d683edf9f3.tar.zst mandoc-754ffee707861356b63ca9cf6d44f5d683edf9f3.zip |
Basically re-wrote -Tascii font handling: instead of incrementers for
bold and underline, we use a stack (no cascading, no double-font-mode).
Font modes with \f only affect the current stack point, as documented in
mdoc.7 and man.7. While -mdoc stacks fonts with embedded macros, -man
replaces them (the stack is always size 1). This works for all
invocations in supported systems' manual corpora to date. It doesn't
support groff's insanity with line-scoped \f as documented in mdoc.7.
Diffstat (limited to 'mdoc.7')
-rw-r--r-- | mdoc.7 | 31 |
1 files changed, 25 insertions, 6 deletions
@@ -1,4 +1,4 @@ -.\" $Id: mdoc.7,v 1.76 2009/11/09 05:11:46 kristaps Exp $ +.\" $Id: mdoc.7,v 1.77 2009/11/12 05:50:12 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se> .\" @@ -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 9 2009 $ +.Dd $Mdocdate: November 12 2009 $ .Dt MDOC 7 .Os . @@ -137,7 +137,17 @@ escape followed by an indicator: B (bold), I, (italic), R (Roman), or P .D1 \efBbold\efR \efIitalic\efP .Pp A numerical representation 3, 2, or 1 (bold, italic, and Roman, -respectively) may be used instead. +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 +.Cm \&Sy , +in-scope invocations of +.Sq \ef +are only valid within the font scope of the macro. If +.Sq \ef +is specified outside of any font scope, such as in unenclosed, free-form +text, it will affect the remainder of the document. .Pp Text may also be sized with the .Sq \es @@ -1820,9 +1830,16 @@ file re-write .Pp .Bl -dash -compact .It +.Xr groff 1 +behaves strangely (even between versions) when specifying +.Sq \ef +escapes within line-macro scopes. These aberrations have been +normalised. +.It Negative scaling units are now truncated to zero instead of creating interesting conditions, such as with -.Sq \&sp -1i . +.Sx \&sp +.Cm \-1i . Furthermore, the .Sq f scaling unit, while accepted, is rendered as the default unit. @@ -1832,7 +1849,8 @@ standalone double-quote in formatted output. This idiosyncratic behaviour is no longer applicable. .It Display types -.Sx \&Bd Fl center +.Sx \&Bd +.Fl center and .Fl right are aliases for @@ -1862,7 +1880,8 @@ made historic groff .Qq go orbital but is a proper delimiter in this implementation. .It -.Sx \&It Fl nested +.Sx \&It +.Fl nested is assumed for all lists (it wasn't in historic groff): any list may be nested and .Fl enum |