===================================================================
RCS file: /cvs/mandoc/man.7,v
retrieving revision 1.45
retrieving revision 1.47
diff -u -p -r1.45 -r1.47
--- mandoc/man.7	2009/11/02 09:56:42	1.45
+++ mandoc/man.7	2009/11/05 08:40:16	1.47
@@ -1,4 +1,4 @@
-.\"	$Id: man.7,v 1.45 2009/11/02 09:56:42 kristaps Exp $
+.\"	$Id: man.7,v 1.47 2009/11/05 08:40:16 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 5 2009 $
 .Dt MAN 7
 .Os
 .
@@ -109,8 +109,9 @@ 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).  A numerical representation 3, 2, or 1
+(bold, italic, and Roman, respectively) may be used instead.
 .
 .
 .Ss Whitespace
@@ -547,11 +548,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
@@ -841,9 +840,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