Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Tidy up longtable captions and labels [minor] #621

Merged
merged 1 commit into from
Apr 19, 2022

Conversation

jmarshall
Copy link
Member

No changes to the text or even to the formatting. Removes a LaTeX warning.

Move \label to \endlastfoot so it is emitted once even for a multi-page table. Fixes #605.

We don't currently use \listoftables; nonetheless use \caption[] and \caption[TOC_text]{…} to emit only one contents entry per table.

@jmarshall jmarshall added the vcf label Jan 5, 2022
@jkbonfield
Copy link
Contributor

Sadly I see latexdiff is failing. I've had this recently too in other projects.

I really struggled to get it to not produce buggy output within a few specific tables, and in the end took the approach of producing a new table environment specifically to avoid latexdiff from exploding. Ie:

% To enable avoidance of latexdiff on a few selected tables.
\newenvironment{tablex}{\table}{\endtable}

That rather sucks though!

@jmarshall
Copy link
Member Author

I suspect Yossi (#404) and Michael (#570 (comment)) are correct in their theory that these latexdiff failures are down to cross-references to filtered-out unchanged pages. I consider that a limitation within latexdiff that we should hope they fix in due course, and the revamped CI infrastructure will ignore these latexdiff failures rather than failing the whole thing.

Move \label to \endlastfoot so it is emitted once even for a
multi-page table. Fixes samtools#605.

We don't currently use \listoftables; nonetheless use \caption[]
in \endfoot (and plain \caption in \endlastfoot) so only one contents
entry is emitted per table. Move the "Continued..." text away from
\endfirsthead and \endlastfoot so that it is suppressed when the table
is not broken across multiple pages.
@jmarshall jmarshall marked this pull request as ready for review January 6, 2022 21:40
@d-cameron d-cameron merged commit 4f5a0fe into samtools:master Apr 19, 2022
@jmarshall jmarshall deleted the table-captions branch April 19, 2022 10:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

table:reserved-genotypes multiply defined in VCFv4.3.tex and VCFv4.4.draft.tex
3 participants