===================================================================
RCS file: /cvs/mandoc/man.7,v
retrieving revision 1.51
retrieving revision 1.54
diff -u -p -r1.51 -r1.54
--- mandoc/man.7	2009/11/12 08:00:21	1.51
+++ mandoc/man.7	2009/11/16 08:46:59	1.54
@@ -1,4 +1,4 @@
-.\"	$Id: man.7,v 1.51 2009/11/12 08:00:21 kristaps Exp $
+.\"	$Id: man.7,v 1.54 2009/11/16 08:46:59 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 12 2009 $
+.Dd $Mdocdate: November 16 2009 $
 .Dt MAN 7
 .Os
 .
@@ -67,15 +67,7 @@ line termination.
 Blank lines are acceptable; where found, the output will assert a
 vertical space.
 .
-.Pp
-The
-.Sq \ec
-escape is common in historical
-.Nm
-documents; if encountered at the end of a word, it ensures that the
-subsequent word isn't off-set by whitespace.
 .
-.
 .Ss Comments
 Text following a
 .Sq \e\*" ,
@@ -118,6 +110,9 @@ A numerical representation 3, 2, or 1 (bold, italic, a
 respectively) may be used instead.  A text decoration is only valid, if
 specified in free-form text, until the next macro invocation; if
 specified within a macro, it's only valid until the macro closes scope.
+Note that macros like
+.Sx \&BR
+open and close a font scope with each argument.
 .Pp
 Text may also be sized with the
 .Sq \es
@@ -144,8 +139,7 @@ Both
 .Sq \es
 and
 .Sq \ef
-attributes are forgotten when exiting a subsequent (or current) macro
-invocation.
+attributes are forgotten when entering or exiting a macro block.
 .
 .
 .Ss Whitespace