From: Kristaps Dzonsons <kristaps@bsd.lv>
Date: Wed, 29 Jul 2009 08:58:11 +0000 (+0000)
Subject: Documented behaviour of interpreting parsable/callable macros.
X-Git-Tag: VERSION_1_9_0~12
X-Git-Url: https://git.cameronkatri.com/mandoc.git/commitdiff_plain/c993c635420328ac3aca50c9201fdf095a4a97f6?ds=inline

Documented behaviour of interpreting parsable/callable macros.
---

diff --git a/mdoc.7 b/mdoc.7
index b64f4931..92c3892b 100644
--- 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>
 .\"
@@ -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----------------------