Tidy up longtable captions and labels [minor]

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. (This is emitted from \endfoot so would need revisiting if a table goes over more than two pages.)
samtools · Jan 6, 2022 · 5380fec · 5380fec
1 parent 285295e
commit 5380fec
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 6 deletions.
diff --git a/VCFv4.3.tex b/VCFv4.3.tex
@@ -351,11 +351,12 @@ \subsubsection{Fixed fields}
   \endhead
     \hline
     \multicolumn{4}{l}{} \\
-    \caption{\label{table:reserved-info}Reserved INFO keys (continued on next page)}
+    \caption[Reserved INFO keys]{Reserved INFO keys (continued on next page)}
   \endfoot
     \hline
     \multicolumn{4}{l}{} \\
-    \caption{Reserved INFO keys (continued from previous page)}
+    \caption[]{Reserved INFO keys (continued from previous page)}
+    \label{table:reserved-info}
   \endlastfoot
 	AA		& 1		& String	& Ancestral allele \\
 	AC		& A		& Integer	& Allele count in genotypes, for each ALT allele, in the same order as listed  \\
@@ -413,8 +414,13 @@ \subsubsection{Genotype fields}
   \endhead
       \hline
       \multicolumn{4}{l}{} \\
-      \caption{\label{table:reserved-genotypes}Reserved genotype keys}
+      \caption[Reserved genotype keys]{Reserved genotype keys (continued on next page)}
   \endfoot
+      \hline
+      \multicolumn{4}{l}{} \\
+      \caption[]{Reserved genotype keys (continued from previous page)}
+      \label{table:reserved-genotypes}
+  \endlastfoot
       AD		& R		& Integer	& Read depth for each allele \\
       ADF		& R		& Integer	& Read depth for each allele on the forward strand \\
       ADR		& R		& Integer	& Read depth for each allele on the reverse strand \\

diff --git a/VCFv4.4.draft.tex b/VCFv4.4.draft.tex
@@ -356,11 +356,12 @@ \subsubsection{Fixed fields}
   \endhead
     \hline
     \multicolumn{4}{l}{} \\
-    \caption{\label{table:reserved-info}Reserved INFO keys (continued on next page)}
+    \caption[Reserved INFO keys]{Reserved INFO keys (continued on next page)}
   \endfoot
     \hline
     \multicolumn{4}{l}{} \\
-    \caption{Reserved INFO keys (continued from previous page)}
+    \caption[]{Reserved INFO keys (continued from previous page)}
+    \label{table:reserved-info}
   \endlastfoot
 	AA		& 1		& String	& Ancestral allele \\
 	AC		& A		& Integer	& Allele count in genotypes, for each ALT allele, in the same order as listed  \\
@@ -418,8 +419,13 @@ \subsubsection{Genotype fields}
   \endhead
       \hline
       \multicolumn{4}{l}{} \\
-      \caption{\label{table:reserved-genotypes}Reserved genotype keys}
+      \caption[Reserved genotype keys]{Reserved genotype keys (continued on next page)}
   \endfoot
+      \hline
+      \multicolumn{4}{l}{} \\
+      \caption[]{Reserved genotype keys (continued from previous page)}
+      \label{table:reserved-genotypes}
+  \endlastfoot
       AD		& R		& Integer	& Read depth for each allele \\
       ADF		& R		& Integer	& Read depth for each allele on the forward strand \\
       ADR		& R		& Integer	& Read depth for each allele on the reverse strand \\