latex2e icon indicating copy to clipboard operation
latex2e copied to clipboard

ltmarks doc should not claim multicol support implemented

Open cfr42 opened this issue 5 months ago • 4 comments

Brief outline of the bug

ltmarks-doc.pdf page 9 includes the following in the description of \__mark_get_marks_for_reinsertion:nNN:

This is, for example, used by multicol when a short balanced multicols is returned to the galley for typesetting.

But, as far as I can tell, multicol is incompatible with the new marks code. There are at least two bug reports in which this is stated and the code doesn't obviously use expl3 syntax at all, so definitely doesn't use this particular function.

Minimal example showing the bug

Really not sure what you want for this. A copy of multicol.sty seems a bit verbose. With apologies to Windows users:

grep '_mark_' $(kpsewhich multicol.sty) 1>&2 2> /tmp/grep.log ; printf %b "exit: $?\n" >> /tmp/grep.log

Log file (required) and possibly PDF file

I was going to upload an empty file, but decided a more verbose version might be more to GitHub's taste.

grep.log

It would be really helpful if you could avoid documenting future code as extant. Maybe mark it as 'planned'? This is the only mention of multicol I could find in the doc. In particular, it wasn't at all obvious to me that I should not try this with ltxdoc and I spent several hours trying to figure out what I was doing wrong. (And it worked so well until \PrintChanges ....)

cfr42 avatar Sep 18 '24 07:09 cfr42