On Fri, May 01, 2020 at 09:59:08PM +0200, Sebastian Urban wrote: > > That looks like it would work but I doubt whether it would be worth > > adding and documenting it. > > As for "worth adding", if someone would be in my situation it would > help him. He would only has to use different @...heading in his own > TEXI file, no need to change TEXINFO.TEX. Maybe, as a documentation, > simple comment in TEXINFO.TEX would be sufficient, e.g. between lines > I added there is: > > % \thischapterheading is the same as \thischapter except it is blank > % for the first page of a chapter. This is to prevent the chapter name > % being shown twice. > > so put here a similar line about "thissectionheading" and done. Plain > simple, for "advanced" usage.
For one thing @thischapterheading is not a good name for this. Also there would have to be similar commands for all the @this* commands listed in Info node "(texinfo)Custom Headings": @thistitle, etc. > This would be "good enough" way, below is more desired option. > > > It might be better to have an option just to output the page number > > on new chapter pages rather than adding new commands > > @thischapterheading, @thissectionheading and so on. At the same > > time, I doubt how much it would be used. > > Hmmm... the thing is predefined headings (@setchapter on, off, odd; > @headings double) don't put heading (with chapter) on new chapter > page, only custom @evenheading, @oddheading, @everyheading do. I > would say that this is at least inconsistency. > [...] > > So, I think instead of option "just to output the page number", user > defined heading with @thischapter, @thissection should not appear in > heading on new chapter page BY DEFAULT. The page number should stay, > as it was mentioned earlier - for reference. When I first implemented the hiding of the chapter name I deliberately left user-defined headings as they were because users may have preferred the existing behaviour. > What is worse, they (the latter group) don't do it well, i.e. on new > chapter page without sections, on which section should be printed in > heading - heading has only page number (if it was set). This leads to > sometimes empty (except for the number) headings on new chapter pages > and worse looking document. [...] > > I'm not sure if 2.5MB is OK for mailing list, so if it's OK and PDF I > edited will be still needed I will send it in the next e-mail. > Meanwhile please take a look at official PDF here: > https://www.gnu.org/software/emacs/manual/pdf/emacs.pdf > PDF pages 26, 58, 60, 93, 140, 154, 236, 246, 279, 377 and probably it > happens later as well. This appears to be a bug. @section isn't involved in the case here: all the blank headings occur on the last page of the chapter. I downloaded the Texinfo sources for the Emacs manual from https://www.gnu.org/software/emacs/manual/emacs.html and reproduced the problem. I am working on it.
