cplusplus / cplusplus/draft

figure out what's wrong with the "Allocator requirements" table and prevent it ever happening again

Open
#1,571 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TeX
Stars
221
Forks
813
Avg merge
16h 4m
Merged PRs (30d)
36

Description

See #1567 for pictures of the problem: under some circumstances we end up with parts of a longtable outside the typeblock, overlapping the bottom margin and sometimes flowing off the bottom of the page.

TeX is providing us with no warning or other indication that this is happening.

See this reduced example of sources triggering the problem:

Rendering of reduced example

My suspicion is that it's a bug in the longtable package.

The required setup for the problem appears to be a page that contains:

  1. A table (in my case, at the top of the page, but I don't know whether that matters).
  2. A longtable that entirely fits within the page.
  3. Another longtable.

Under those circumstances, the permitted height of the second longtable before it first breaks to a new page appears to be miscomputed by an amount equal to the height of the floating table.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the reduced example linked in the issue and compare its behavior with the three listed page conditions: a table, a fitting longtable, and another longtable. Investigate the longtable package's height calculation and the behavior described in #1567. Done means the cause is identified and the same layout failure can no longer occur without an indication.

Written by the indexing model from the issue text.

Assessment

Tech stack
tex
Domain
documentation
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.