===================================================================
RCS file: /cvs/mandoc/mdoc.7,v
retrieving revision 1.185
retrieving revision 1.187
diff -u -p -r1.185 -r1.187
--- mandoc/mdoc.7	2011/04/06 11:39:25	1.185
+++ mandoc/mdoc.7	2011/05/21 15:55:42	1.187
@@ -1,4 +1,4 @@
-.\"	$Id: mdoc.7,v 1.185 2011/04/06 11:39:25 kristaps Exp $
+.\"	$Id: mdoc.7,v 1.187 2011/05/21 15:55:42 schwarze Exp $
 .\"
 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2010 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,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: April 6 2011 $
+.Dd $Mdocdate: May 21 2011 $
 .Dt MDOC 7
 .Os
 .Sh NAME
@@ -97,8 +97,6 @@ Within a macro line, the following terms are reserved:
 .Pq reserved-word vertical bar
 .El
 .Pp
-Use of reserved terms is described in
-.Sx MACRO SYNTAX .
 For general use in macro lines, these can be escaped with a non-breaking
 space
 .Pq Sq \e& .
@@ -1176,8 +1174,9 @@ See also
 and
 .Sx \&Sy .
 .Ss \&Bk
-Keep the output generated from each macro input line together
-on one single output line.
+For each macro, keep its output together on the same output line,
+until the end of the macro or the end of the input line is reached,
+whichever comes first.
 Line breaks in text lines are unaffected.
 The syntax is as follows:
 .Pp