Problems with ".html"

[JJ]

The problem

htmlify.p6 yields two errors, probably related to the same file:

html/syntax/.html got empty filename

[JJ]

It's generated by the '' page, or at least that is what appears in the '.html' file.

[ronaldxs]

If you go into doc/Language/glossary.pod6 and remove the sections for =head1 Sigil and =head1 Variable then the two got empty filename errors go away.

In htmlify.p6 routine sub find-definitions(...) there is a clause:

given $subkinds {
...
    when 'variable'|'sigil'|'twigil'|'declarator'|'quote' {
        # TODO: More types of syntactic features
        %attr = :kind<syntax>,
                     :categories($subkinds),
        ;
    }
...

Most (all other?) entries from Language/glossary.pod6 are ignored but, because of the clause above, 'Sigil' and 'Variable' are added to the document registry $*DR with empty names. Later, when write-disambiguation-files tries to loop through for $*DR.grouped-by('name').kv -> $name, $p the empty name is used for the .html file.

I don't understand enough about disambiguation and what find-definitions is trying to collect in $*DR to try to fix. I looked at some of local # document lines in the local code but could not figure out enough from there and would be interested if someone knows of other helpful documentation.

[tisonkun]

For the sigil part, I checked https://docs.perl6.org/js/search.js and lookup https://docs.perl6.org/language/variables.html#index-entry-%21%2525_%28sigil%29

All sigil are X<>-ed manually. I'd like to remove 'sigil' from the very line, since its meaning is weird. If we want to make something searchable/indexed, use X<> as Pod6 spec.

In fact, such utils things guess users intention, huh, at least not document how it guessing. Since we have a number of contributors, unexpected issues occur due to that.

[tisonkun]

Oh, I just find it is about disambiguation...

[JJ]

This was fixed by #1997 . Thanks!