Re: HTML <title> node names: Not emitting 'Top (Manual name)'

Gavin Smith <[email protected]> Thu, 14 Mar 2024 20:09:00 +0000
Newsgroups gmane.comp.tex.texinfo.general
Message-ID <ZfNZXH6V/dy7uYFF@beigestar>
On Wed, Mar 13, 2024 at 09:25:44PM +0200, Eli Zaretskii wrote:
> > Nobody complained about this breaking any stability.
> 
> Ha! the amount of grief those changes caused the Emacs maintainers is
> beyond complaining.  We have a script that massages the produced HTML
> manuals for the Web site, and we run the script each time another
> Emacs version is released and the manual needs to be updated on the
> Web site.  Every single release of Texinfo, until very recently, would
> break the script and cause me personally and my colleagues a lot of
> gray hair wand wasted time.  So much so that I seriously considered to
> stop updating to the latest Texinfo on the system where I usually work
> on Emacs releases.  Finally, a few Texinfo versions ago, these changes
> have stopped, and we had a few Emacs releases without a single problem
> in this area.  No longer, it looks like...
> 
> And no, I didn't complain, because I never imagined (and don't imagine
> now) that someone would seriously consider backing out the offending
> changes, just because one project suffers from them.  But you'd be
> wrong taking silence for a sign of no problems.

By all means, if changing the page title for the Top node causes
significant problems, we can avoid making this change.  But it is
hard to imagine why it would cause a problem.

I don't mind avoiding this time for the time being, if it is felt
there has been a lot of change to the HTML output recently.  Once
things settle down, we could revisit this.

> Once again: IME making breaking changes "just because we can" is not
> the best strategy for stable projects.  But I'm not a Texinfo
> maintainer, so my opinions on this probably doesn't mean much...

The change being proposed here wasn't for no reason.