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.