===================================================================
RCS file: /cvs/mandoc/mdoc.7,v
retrieving revision 1.73
retrieving revision 1.74
diff -u -p -r1.73 -r1.74
--- mandoc/mdoc.7	2009/11/02 11:39:40	1.73
+++ mandoc/mdoc.7	2009/11/05 08:40:16	1.74
@@ -1,4 +1,4 @@
-.\"	$Id: mdoc.7,v 1.73 2009/11/02 11:39:40 kristaps Exp $
+.\"	$Id: mdoc.7,v 1.74 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 MDOC 7
 .Os
 .
@@ -131,10 +131,12 @@ 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).  This form is not recommended for 
+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.  This form
+is not recommended for 
 .Nm ,
-which encourages semantic, not presentation, annotation.
+which encourages semantic annotation.
 .
 .
 .Ss Predefined Strings