From: Mark Wooding <mdw@distorted.org.uk>
Date: Tue, 17 Nov 2015 17:10:32 +0000 (+0000)
Subject: doc/clang.tex: Document `argument' accessors together.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/sod/commitdiff_plain/52e2a70f115d79f743314f98420e69f7e5ac62b8

doc/clang.tex: Document `argument' accessors together.

I'm not happy about the description, but the general shape is right.
---

diff --git a/doc/clang.tex b/doc/clang.tex
index 03b447d..0806f1d 100644
--- a/doc/clang.tex
+++ b/doc/clang.tex
@@ -597,13 +597,13 @@ function type is the type of the function's return value.
   argument name.
 \end{describe}
 
-\begin{describe}{fun}{argument-name @<argument> @> @<name>}
-  Return the name of the @<argument>, as it was supplied to @|make-argument|.
-\end{describe}
-
-\begin{describe}{fun}{argument-type @<argument> @> @<c-type>}
-  Return the type of the @<argument>, as it was supplied to @|make-argument|.
-\end{describe}
+\begin{describe*}
+  {\dhead{fun}{argument-name @<argument> @> @<name>}
+   \dhead{fun}{argument-type @<argument> @> @<c-type>}}
+  Accessor functions for @|argument| objects.  They return the name (for
+  @|argument-name|) or type (for @|argument-type|) from the object, as passed
+  to @|make-argument|.
+\end{describe*}
 
 \begin{describe}{gf}
     {commentify-argument-name @<name> @> @<commentified-name>}