1 files changed, 5 insertions, 3 deletions
diff --git a/mdoc.7 b/mdoc.7
index 0a98ba3b..43fd8319 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -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