===================================================================
RCS file: /cvs/mandoc/man.7,v
retrieving revision 1.44
retrieving revision 1.48
diff -u -p -r1.44 -r1.48
--- mandoc/man.7	2009/11/02 09:53:15	1.44
+++ mandoc/man.7	2009/11/09 05:11:46	1.48
@@ -1,4 +1,4 @@
-.\"	$Id: man.7,v 1.44 2009/11/02 09:53:15 kristaps Exp $
+.\"	$Id: man.7,v 1.48 2009/11/09 05:11:46 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 2 2009 $
+.Dd $Mdocdate: November 9 2009 $
 .Dt MAN 7
 .Os
 .
@@ -109,8 +109,34 @@ and
 .Ss Text Decoration
 Terms may be text-decorated using the
 .Sq \ef
-escape followed by an indicator: B (bold), I, (italic), or P and R
-(Roman, or reset).
+escape followed by an indicator: B (bold), I, (italic), R (Roman), or P
+(revert to previous mode):  
+.Pp
+.D1 \efBbold\efR \efIitalic\efP
+.Pp
+A numerical representation 3, 2, or 1 (bold, italic, and Roman,
+respectively) may be used instead.
+.Pp
+Text may also be sized with the
+.Sq \es
+escape, whose syntax is one of
+.Sq \es+-n
+for one-digit numerals;
+.Sq \es(+-nn
+or
+.Sq \es+-(nn
+for two-digit numerals; and
+.Sq \es[+-N] ,
+.Sq \es+-[N] ,
+.Sq \es'+-N' ,
+or
+.Sq \es+-'N'
+for arbitrary-digit numerals:
+.Pp
+.D1 \es+1bigger\es-1
+.D1 \es[+10]much bigger\es[-10]
+.D1 \es+(10much bigger\es-(10
+.D1 \es+'100'much much bigger\es-'100'
 .
 .
 .Ss Whitespace
@@ -547,11 +573,9 @@ and
 render in italics.  Whitespace between arguments is omitted in output.
 .Pp
 Examples:
-.Bd -filled -offset indent
-.Pf \. Sx \&BI
-bold italic bold italic
-.Ed
 .Pp
+.D1 \&.BI bold italic bold italic
+.Pp
 The output of this example will be emboldened
 .Dq bold
 and italicised
@@ -604,12 +628,12 @@ If specified, it's saved for later paragraph left-marg
 saved or default width is used.
 .Pp
 See also
-.Sx IP ,
-.Sx LP ,
-.Sx P ,
-.Sx PP ,
+.Sx \&IP ,
+.Sx \&LP ,
+.Sx \&P ,
+.Sx \&PP ,
 and
-.Sx TP .
+.Sx \&TP .
 .
 .
 .Ss \&I
@@ -661,12 +685,12 @@ argument is used as a leading term, flushed to the lef
 useful for bulleted paragraphs and so on.
 .Pp
 See also
-.Sx HP ,
-.Sx LP ,
-.Sx P ,
-.Sx PP ,
+.Sx \&HP ,
+.Sx \&LP ,
+.Sx \&P ,
+.Sx \&PP ,
 and
-.Sx TP .
+.Sx \&TP .
 .
 .
 .Ss \&IR
@@ -692,12 +716,12 @@ subsequent paragraph, sub-section, section, or end of 
 paragraph left-margin width is re-set to the default.
 .Pp
 See also
-.Sx HP ,
-.Sx IP ,
-.Sx P ,
-.Sx PP ,
+.Sx \&HP ,
+.Sx \&IP ,
+.Sx \&P ,
+.Sx \&PP ,
 and
-.Sx TP .
+.Sx \&TP .
 .
 .
 .Ss \&P
@@ -705,12 +729,12 @@ Synonym for
 .Sx \&LP .
 .Pp
 See also
-.Sx HP ,
-.Sx IP ,
-.Sx LP ,
-.Sx PP ,
+.Sx \&HP ,
+.Sx \&IP ,
+.Sx \&LP ,
+.Sx \&PP ,
 and
-.Sx TP .
+.Sx \&TP .
 .
 .
 .Ss \&PP
@@ -718,12 +742,12 @@ Synonym for
 .Sx \&LP .
 .Pp
 See also
-.Sx HP ,
-.Sx IP ,
-.Sx LP ,
-.Sx P ,
+.Sx \&HP ,
+.Sx \&IP ,
+.Sx \&LP ,
+.Sx \&P ,
 and
-.Sx TP .
+.Sx \&TP .
 .
 .
 .Ss \&R
@@ -841,9 +865,8 @@ string replaces the default rendered volume, which is 
 manual section.
 .Pp
 Examples:
-.Bd -filled -offset indent
-\&.TH CVS 5 "1992-02-12" GNU
-.Ed
+.Pp
+.D1 \&.TH CVS 5 "1992-02-12" GNU
 .
 .
 .Ss \&TP
@@ -864,12 +887,12 @@ If specified, it's saved for later paragraph left-marg
 unspecified, the saved or default width is used.
 .Pp
 See also
-.Sx HP ,
-.Sx IP ,
-.Sx LP ,
-.Sx P ,
+.Sx \&HP ,
+.Sx \&IP ,
+.Sx \&LP ,
+.Sx \&P ,
 and
-.Sx PP .
+.Sx \&PP .
 .
 .
 .Ss \&PD