On 9/6/2026 23:43, Jun T wrote:
2026/09/07 12:27、I wrote: Another example is the cross reference from one man page to another, such as 'See FILENAME GENERATION in zshexpn(1)' (in zshmisc(1)).I've found a script zsh_sectref.py in rebuild/sphinx-config/. What is this script intended for? The cross reference among man pages will be fixed in the future?
It's a custom extension that was deprecated at creation to handle YODL's sectref until we hand rewrote that to use the "sphinx" way with :ref: and :doc: but those don't give us the extra prose in man, just the cross refs in info and html. We can fix the extension but the extension was meant to be temporary not something we would have to maintain.