Re: Dangling reference in zshroadmap(1) (was: Re: test for newline in a variable--unexpected results sometimes)

[dana <dana@xxxxxxx>]

On 16 Sep 2018, at 16:44, Daniel Shahaf <d.s@xxxxxxxxxxxxxxxxxx> wrote:
>zshroadmap(1) refers to a "Shell Grammar" section, but there's no such
>section in the man pages:

Oh, i didn't notice because i always use the HTML version:

http://zsh.sourceforge.net/Doc/Release/Shell-Grammar.html

I guess it's designed with the sections that get separate pages (like
'Parameters') in mind? The top-level heading seems to be omitted if the first
immediate descendant is a sub-section. The same is true of other sections like
'Invocation', 'Files', and 'Jobs & Signals'.

Confusingly, the first two sections mentioned above each contain a sub-section
with the same name, so the exact part of the documentation being referred to is
unclear/inconsistent. (In the man pages, the top-level headings are missing, so
that leaves only the sub-headings. But in the HTML version, the links take you
to the top of the entire section.)

Not sure how to address that

dana