===================================================================
RCS file: /cvs/mandoc/mdoc.7,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -p -r1.54 -r1.55
--- mandoc/mdoc.7	2009/07/27 12:35:54	1.54
+++ mandoc/mdoc.7	2009/07/29 08:58:11	1.55
@@ -1,4 +1,4 @@
-.\"	$Id: mdoc.7,v 1.54 2009/07/27 12:35:54 kristaps Exp $
+.\"	$Id: mdoc.7,v 1.55 2009/07/29 08:58:11 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: July 27 2009 $
+.Dd $Mdocdate: July 29 2009 $
 .Dt MDOC 7
 .Os
 .\" SECTION---------------------------------------------
@@ -242,10 +242,21 @@ closes it out.
 The
 .Em Callable
 column indicates that the macro may be called subsequent to the initial
-line-macro.  The
+line-macro.  If a macro is not callable, then its invocation after the
+initial line macro is interpreted as opaque text, such that
+.Sq \&.Fl Sh
+produces
+.Sq Fl Sh .
+.\" PARAGRAPH------------
+.Pp
+The
 .Em Parsable
 column indicates whether the macro may be followed by further
-(ostensibly callable) macros.  The
+(ostensibly callable) macros.  If a macro is not parsable, subsequent
+macro invocations on the line will be interpreted as opaque text.
+.\" PARAGRAPH------------
+.Pp
+The
 .Em Scope
 column, if applicable, describes closure rules.
 .\" SUB-SECTION----------------------