On Sun, Jul 13, 2025 at 5:30 PM Jun. T <takimoto-j@xxxxxxxxxxxxxxxxx> wrote:
Patch is attached as a file (since it's rather long).
2025/07/04 13:48, Jun T <takimoto-j@xxxxxxxxxxxxxxxxx <mailto:takimoto-j@xxxxxxxxxxxxxxxxx>> wrote:
See the section `Filename Generation'
but the section is in zshexpn(1).
In addition to fixing the missing man page name, various minor
fixes (and improvements, hopefully) are included
(using more specific referent, etc.).
Since section names in man pages are in bold ALLCAPS, I
will (try to) use
bf(FILENAME GENERATION)
when referring to the section names. Is this OK?
(I will define a new macro for this)
Four new yodl macros are defined.
nmref(node)(manpage) is for referring to texi node or manpage
(depending on ifnzman or ifzman).
sectref(sectname)(manpage) is for referring to a section in
manpage, or a texi node. There should be a texi node (or anchor)
with the same name as the 'sectname'.
Use anchor() for creating the anchor.
subref(subsectname)(manpage) is similar but for a subsection.
I also patched Util/zyodl.vim to recognize the 4 new macros.
Happened to notice this,
@@ -373,7 +371,7 @@ Define a function which is referenced by any one
of var(word).
Normally, only one var(word) is provided; multiple var(word)s
are usually only useful for setting traps.
The body of the function is the var(list) between
-the tt({) and tt(}). See noderef(Functions).
+the tt({) and tt(}). See sectref(Functions)(blow).
The options of tt(function) have the following meanings:
Which results in this manpage output:
where term is one or more newline or ;. Define a
function which is refer‐
enced by any one of word. Normally, only one word
is provided; multiple
words are usually only useful for setting traps. The
body of the function is
the list between the { and }. See FUNCTIONS in blow(1).
I assume this is an error, since we do not provide a blow.1? But I'm
not sure what you meant for it to say.