===================================================================
RCS file: /cvs/mandoc/mdoc.7,v
retrieving revision 1.128
retrieving revision 1.130
diff -u -p -r1.128 -r1.130
--- mandoc/mdoc.7	2010/07/01 15:38:56	1.128
+++ mandoc/mdoc.7	2010/07/04 22:04:04	1.130
@@ -1,6 +1,7 @@
-.\"	$Id: mdoc.7,v 1.128 2010/07/01 15:38:56 schwarze Exp $
+.\"	$Id: mdoc.7,v 1.130 2010/07/04 22:04:04 schwarze Exp $
 .\"
-.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@bsd.lv>
+.\" Copyright (c) 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv>
+.\" Copyright (c) 2010 Ingo Schwarze <schwarze@openbsd.org>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above
@@ -14,7 +15,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: July 1 2010 $
+.Dd $Mdocdate: July 4 2010 $
 .Dt MDOC 7
 .Os
 .Sh NAME
@@ -1139,6 +1140,39 @@ See also
 and
 .Sx \&Dl .
 .Ss \&Bf
+Change the font mode for a scoped block of text.
+Its syntax is as follows:
+.Bd -ragged -offset indent
+.Pf \. Sx \&Bf
+.Oo
+.Fl emphasis | literal | symbolic |
+.Cm \&Em | \&Li | \&Sy
+.Oc
+.Ed
+.Pp
+The
+.Fl emphasis
+and
+.Cm \&Em
+argument are equivalent, as are
+.Fl symbolic
+and
+.Cm \&Sy,
+and
+.Fl literal
+and
+.Cm \&Li .
+Without an argument, this macro does nothing.
+The font mode continues until broken by a new font mode in a nested
+scope or
+.Sx \&Ef
+is encountered.
+.Pp
+See also
+.Sx \&Li ,
+.Sx \&Ef ,
+and
+.Sx \&Sy .
 .Ss \&Bk
 Begins a keep block, containing a collection of macros or text
 to be kept together in the output.
@@ -1159,6 +1193,9 @@ Examples:
 \&.Op o Ar output_file
 \&.Ek
 .Ed
+.Pp
+See also
+.Sx \&Ek .
 .Ss \&Bl
 Begins a list composed of one or more list entries.
 A list is associated with a type, which is a required argument.
@@ -1631,6 +1668,8 @@ and
 .Ss \&Ec
 .Ss \&Ed
 .Ss \&Ef
+Ends a font mode context started by
+.Sx \&Bf .
 .Ss \&Ek
 Ends a keep context started by
 .Sx \&Bk .