Documented behaviour of interpreting parsable/callable macros.

diff --git a/mdoc.7 b/mdoc.7
index b64f4931320fa6c4adba3585764cfb56c8ac39ea..92c3892bf70a45c8ca2dc669b0b52649e5615831 100644 (file)
--- a/mdoc.7
+++ b/mdoc.7
@@ -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>
 .\"
 .\"
 .\" 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.
 .\"
 .\" 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---------------------------------------------
 .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
 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
 .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----------------------
 .Em Scope
 column, if applicable, describes closure rules.
 .\" SUB-SECTION----------------------