Re: Problem with heading appearing on new chapter page

[Gavin Smith]

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.