chiark / gitweb /
doc/sod.sty, doc/*.tex: Support category-specific arguments.
[sod] / doc / clang.tex
index 08aac24910abb5cd2f4678910fdbd0c592c5a38e..b572fe44e9a44aed2ae4f8b7384ead8a00b05537 100644 (file)
@@ -208,12 +208,12 @@ argument lists for methods.  This is done by @|c-type-equal-p|.
 
   The generic function @|c-type-equal-p| uses the @|and| method combination.
 
-  \begin{describe}{meth}{c-type-equal-p @<c-type>_1 @<c-type>_2}
+  \begin{describe}{meth}{t,t}{c-type-equal-p @<c-type>_1 @<c-type>_2}
     A default primary method for @|c-type-equal-p| is defined.  It simply
     returns @|nil|.  This way, methods can specialize on both arguments
     without fear that a call will fail because no methods are applicable.
   \end{describe}
-  \begin{describe}{ar-meth}{c-type-equal-p @<c-type>_1 @<c-type>_2}
+  \begin{describe}{ar-meth}{}{c-type-equal-p @<c-type>_1 @<c-type>_2}
     A default around-method for @|c-type-equal-p| is defined.  It returns
     true if @<c-type>_1 and @<c-type>_2 are @|eql|; otherwise it delegates to
     the primary methods.  Since several common kinds of C types are interned,
@@ -270,7 +270,7 @@ argument lists for methods.  This is done by @|c-type-equal-p|.
   Every concrete subclass of @|c-type| is expected to provide a primary
   method on this function.  There is no default primary method.
 
-  \begin{describe}{ar-meth}{pprint-c-type @<c-type> @<stream> @<kernel>}
+  \begin{describe}{ar-meth}{}{pprint-c-type @<c-type> @<stream> @<kernel>}
     A default around method is defined on @|pprint-c-type| which `canonifies'
     non-function @<kernel> arguments.  In particular:
     \begin{itemize}
@@ -375,7 +375,8 @@ methods to \descref{c-qualifier-keyword}{gf}.
   methods exist for qualifier keywords which need special handling, such as
   @|:atomic|; they are not listed here explicitly.
 
-  \begin{describe}{meth}{c-qualifier-keyword @<keyword> @> @<string>}
+  \begin{describe}{meth}{keyword}
+      {c-qualifier-keyword @<keyword> @> @<string>}
     Returns the @<keyword>'s print-name, in lower case.  This is sufficient
     for the standard qualifiers @|:const|, @|:restrict|, and @|:volatile|.
   \end{describe}
@@ -844,11 +845,13 @@ function type is the type of the function's return value.
   including file from defining such names as macros.  This generic function
   is used to convert names into a safe form.
 
-  \begin{describe}{meth}{commentify-argument-name (@<name> null) @> nil}
+  \begin{describe}{meth}{null}
+      {commentify-argument-name (@<name> null) @> nil}
     Returns nil: if the argument name is already omitted, it's safe for use
     in a header file.
   \end{describe}
-  \begin{describe}{meth}{commentify-argument-name (@<name> t) @> @<string>}
+  \begin{describe}{meth}{t}
+      {commentify-argument-name (@<name> t) @> @<string>}
     Returns the print form of @<name> wrapped in a C comment, as
     @`/*@<name>*/'.
   \end{describe}
@@ -1164,7 +1167,7 @@ Temporary names are represented by objects which implement a simple protocol.
   subclasses, but is also usable on its own.
 \end{describe}
 
-\begin{describe}{meth}
+\begin{describe}{meth}{temporary-name}
     {commentify-argument-name (@<name> temporary-name) @> nil}
 \end{describe}