doc/: Reorder the arguments to `\descref'.

[sod] / doc / misc.tex

diff --git a/doc/misc.tex b/doc/misc.tex
index 178e6ef..32e2e75 100644 (file)
--- a/doc/misc.tex
+++ b/doc/misc.tex
@@ -398,7 +398,7 @@ be implemented fairly easily using @|merge-lists| below.
      \dhead{gf}{merge-error-candidates @<error> @> @<list>}
      \dhead{gf}{merge-error-present-function @<error> @> @<function>}}
   The @|inconsistent-merge-error| condition class used to represent a failure
-  of the \descref{merge-lists}[function]{fun}.
+  of the \descref{fun}{merge-lists}[function].
 
   The @<candidates> are a list of offending items from the input lists, in
   some order: the error is reporting that the function has failed because it
@@ -533,7 +533,7 @@ to the next column.
   Assume that we are currently at a particular @<line> and @<column> in a
   file, and wish to \emph{unread} @<character>: return an @<old-line> and
   @<old-column> at which we might plausibly re-read the character, so that
-  the next call to \descref{update-position}{fun} will return us to @<line>
+  the next call to \descref{fun}{update-position} will return us to @<line>
   and @<column>.  (Specifically, the @<old-column> will likely be wrong if
   @<character> is a horizontal tab.  It is expected that this won't matter:
   the purpose of this function is to set things up so that the
@@ -572,7 +572,7 @@ to the next column.
   The main purpose for this is to be able to access features of the
   underlying stream which a pretty-printing stream can't proxy.  Most
   notably, this is used by C fragment output, which takes advantage of an
-  underlying \descref{position-aware-output-stream}{cls} to print @|\#line|
+  underlying \descref{cls}{position-aware-output-stream} to print @|\#line|
   directives, so that a C~compiler will blame the original fragment in the
   Sod module source rather than the generated C code.
 \end{describe}
@@ -705,7 +705,7 @@ The following definitions are useful when working with conditions.
 \end{describe}
 
 \begin{describe}{fun}{cerror* @<datum> \&rest @<arguments>}
-  A simplified version of \descref{promiscuous-cerror}{fun} which uses the
+  A simplified version of \descref{fun}{promiscuous-cerror} which uses the
   hardcoded string @|Continue| for the restart.  This makes calling the
   function more similar to other condition-signalling functions, at the
   expense of some usability in environments which don't continue after