doc/: Reorder the arguments to `\descref'.
authorMark Wooding <mdw@distorted.org.uk>
Sat, 3 Aug 2019 20:12:31 +0000 (21:12 +0100)
committerMark Wooding <mdw@distorted.org.uk>
Sat, 3 Aug 2019 20:15:45 +0000 (21:15 +0100)
commite8d70b1b4abe17f1425aa7b8d4e582cd02372766
tree590d89e80b135ffb60e243873ad07b96a0552401
parentaacae2739986636d9e7921cc0712d506e25c71b8
doc/: Reorder the arguments to `\descref'.

We now have

\descref*{CAT}{NAME}[TEXT]

rather than

\descref*{NAME}[TEXT]{CAT}

which flows much better.  There's a complication, that `\@ifnextchar'
gobbles space while looking for its character: implement a custom
version which doesn't do that.

The call sites were mostly fixed by [long line]

$ sed -i '/\\descref\(\*\)\?\({[^}]\+}\(\[[^]]\+]\)\?\)\({[^}]\+}\)/ s//\\descref\1\4\2/g' doc/*.tex

but some calls run over two lines and had to be found and fixed by hand.
doc/clang.tex
doc/concepts.tex
doc/misc.tex
doc/runtime.tex
doc/sod.sty
doc/syntax.tex