X-Git-Url: https://git.distorted.org.uk/~mdw/sod/blobdiff_plain/d9db9c73add5814057a80e9969c74419ce30e664..588e0b33325ff27288c3762aeb9b05afff3d1139:/doc/misc.tex diff --git a/doc/misc.tex b/doc/misc.tex index 178e6ef..32e2e75 100644 --- 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 @ @> @} \dhead{gf}{merge-error-present-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 @ 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 @ and @ in a file, and wish to \emph{unread} @: return an @ and @ at which we might plausibly re-read the character, so that - the next call to \descref{update-position}{fun} will return us to @ + the next call to \descref{fun}{update-position} will return us to @ and @. (Specifically, the @ will likely be wrong if @ 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* @ \&rest @} - 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