On Tue, Dec 16, 2025 at 11:50:20PM +0100, Patrice Dumas wrote:
> On Mon, Dec 15, 2025 at 08:38:48PM +0000, Gavin Smith wrote:
> > The first issue appears to be easily fixable by adding a single line
> > to the output file:
> >
> > \newtitlemark{\Texinfoheadingchaptername}%
>
> Shouldn't \newtitlemark be called for \Texinfothechapterheading too?
Yes, I believe so. As I can see from the texi2any output, this has two
possible values, one used for @unnumbered and the other used for @chapter
and @appendix. I've committed a change for this and \Texinfotheinclude
which you mention below.
> > The existing output of "Chapter" or "Appendix" in the heading is completely
> > wrong: TeX often continues to process output for a following page before
> > the current page has been finalised, as it has not decided at which point
> > to break the page. This means definitions for the following pages may
> > be active at the point in time the page is output, which is when the
> > headings
> > are set. The "marks" mechanism of TeX exists for exactly this problem.
> >
> > I haven't read the titleps documentation in any detail and am not familiar
> > with how the marks mechanism may differ in LaTeX and/or titleps from plain
> > TeX. However, the main fact you need to understand is that the definitions
> > in
> > a mark stay with the mark's location on a page. This means these
> > definitions
> > can be retrieved after a page breaking decision is made and the heading
> > line is output, even if subsequent redefinitions are made in marks on later
> > pages.
>
> Having read some web information, I understood the theory behind the
> marks, that you aptly summarized. However, the practical way to use
> marks is completly lost on me, and all the documentation I have read on
> that is still very obscure to me. I do not understand what the mark
> commands actually do, what their arguments should be, how to call them,
> where they should be set and so on and so forth.
It may be that TeX has its way of doing things, then LaTeX has a slightly
different way, then later packages have their own way. So to understand
how, for example, marks work in titleps, you also have to understand all
the other layers, which is an awful lot to understand. I personally
find the whole LaTeX "ecosystem" overwhelming, with packages with many
hundreds of pages of documentation.
> I see two other commands that may need some marks, \Texinfotheinclude,
> which could easily become wrong if there are @includes before and after
> the end of a page. And also possibly \Texinfoparttitle, although there
> are end of pages before and after \part.
I didn't do anything with the mark mechanism in texinfo.tex for that reason.
