37adfded75ec133c1fd2b4cb86e4757e76a54de5
mspeir
  Wed Sep 9 15:29:55 2026 -0700
trackDb docs: describe minAc and vcfDoMinAc, and fix two mislabelled vcfDoMaf rows, refs #38010

The last two VCF settings with no description anywhere. Both were absent from
trackDbLibrary, trackDbDoc and trackDbHub.v3, so registering them in
tagTypes.tab last commit made them legal but still undiscoverable.

minAc is a real filter, not just a UI default: minAcFail() in vcfTrack.c takes
the largest alternate allele count from the AC field of the INFO column and
drops the record when it is below the setting. Records whose INFO has no usable
AC are never dropped, which is worth saying since it is the surprising half.
vcfDoMinAc gates the matching control, like its three siblings.

Rows follow the placement the sibling settings already use: minAc beside
minFreq in the vcfTabix table, vcfDoMinAc beside vcfDoMaf in both the vcfTabix
and vcfPhasedTrio tables.

While adding those, trackDbDoc.html turned out to carry two rows with
class="vcfDoMaf" whose anchor and format line both read vcfDoQual, so the page
listed vcfDoQual twice and never showed vcfDoMaf's syntax. Copy-paste, present
in both the vcfTabix and vcfPhasedTrio tables. Corrected.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

diff --git src/hg/htdocs/goldenPath/help/trackDb/trackDbDoc.html src/hg/htdocs/goldenPath/help/trackDb/trackDbDoc.html
index fb1d96f2f67..ce7e927a180 100755
--- src/hg/htdocs/goldenPath/help/trackDb/trackDbDoc.html
+++ src/hg/htdocs/goldenPath/help/trackDb/trackDbDoc.html
@@ -1193,38 +1193,44 @@
     <TR class="related" VALIGN=TOP><TD class="hapClusterHeight"><A NAME="hapClusterHeight"><IMG class='toggle detail setF'>
         <div class="format"><code>hapClusterHeight &lt;N&gt;</code></div>
     </TD></TR>
 
     <TR class="related1st" VALIGN=TOP><TD class="applyMinQual"><A NAME="applyMinQual"><IMG class='toggle detail setG'>
         <div class="format"><I>Related settings:</I><BR>
 	  <code>applyMinQual &lt;true|false&gt;</code></div>
     </TD></TR>
     <TR class="related" VALIGN=TOP><TD class="minQual"><A NAME="minQual"><IMG class='toggle detail setG'>
         <div class="format"><code>minQual &lt;<EM>Q</EM>&gt;</code></div>
     </TD></TR>
 
     <TR VALIGN=TOP><TD class="minFreq"><A NAME="minFreq"><IMG class='toggle detail'>
         <div class="format"><code>minFreq &lt;<EM>F</EM>&gt;</code></div>
     </TD></TR>
+    <TR VALIGN=TOP><TD class="minAc"><A NAME="minAc"><IMG class='toggle detail'>
+        <div class="format"><code class="level-new">minAc &lt;<EM>N</EM>&gt;</code></div>
+    </TD></TR>
     <TR VALIGN=TOP><TD class="vcfDoFilter"><A NAME="vcfDoFilter"><IMG class='toggle detail'>
         <div class="format"><code class="level-new">vcfDoFilter &lt;on/off&gt;</code></div>
     </TD></TR>
     <TR VALIGN=TOP><TD class="vcfDoQual"><A NAME="vcfDoQual"><IMG class='toggle detail'>
         <div class="format"><code class="level-new">vcfDoQual &lt;on/off&gt;</code></div>
     </TD></TR>
-    <TR VALIGN=TOP><TD class="vcfDoMaf"><A NAME="vcfDoQual"><IMG class='toggle detail'>
-        <div class="format"><code class="level-new">vcfDoQual &lt;on/off&gt;</code></div>
+    <TR VALIGN=TOP><TD class="vcfDoMaf"><A NAME="vcfDoMaf"><IMG class='toggle detail'>
+        <div class="format"><code class="level-new">vcfDoMaf &lt;on/off&gt;</code></div>
+    </TD></TR>
+    <TR VALIGN=TOP><TD class="vcfDoMinAc"><A NAME="vcfDoMinAc"><IMG class='toggle detail'>
+        <div class="format"><code class="level-new">vcfDoMinAc &lt;on/off&gt;</code></div>
     </TD></TR>
     <TR VALIGN=TOP><TD class="sampleMetadataFile"><A NAME="sampleMetadataFile"><IMG class='toggle detail'>
         <div class="format"><code class="level-new">sampleMetadataFile &lt;url&gt;</code></div>
     </TD></TR>
     <TR VALIGN=TOP><TD>
             <P>Additional settings found in the "Item or
             region tracks" section are also available for displaying
             Variant Call Format tracks.</P>
             <A onclick="return jumpTo(this);" HREF="#">maxWindowCoverage</A>,
             <A onclick="return jumpTo(this);" HREF="#">maxWindowToDraw</A>
         </DIV>
     </TD></TR>
     <TR class="examples" VALIGN=TOP><TD class="vcfTabix_example">
         <IMG class='toggle detail'>
         <div class="format"><B>Example of a VCF track:</B></div>
@@ -1257,32 +1263,35 @@
     <TR VALIGN=TOP><TD class="vcfUseAltSampleNames"><A NAME="vcfUseAltSampleNames"><IMG class='toggle detail'>
         <div class="format"><code class="level-full">vcfUseAltSampleNames &lt;on/off&gt;</code></div>
     </TD></TR>
     <TR VALIGN=TOP><TD class="vcfPhasedColorBy"><A NAME="vcfPhasedColorBy"><IMG class='toggle detail'>
         <div class="format"><code class="level-new">vcfPhasedColorBy &lt;mendelDiff|deNovo|function|noColor&gt;</code></div>
     </TD></TR>
     <TR VALIGN=TOP><TD class="geneTrack"><A NAME="geneTrack"><IMG class='toggle detail'>
         <div class="format"><code class="level-new">geneTrack &lt;track&gt;</code></div>
     </TD></TR>
     <TR VALIGN=TOP><TD class="vcfDoFilter"><A NAME="vcfDoFilter"><IMG class='toggle detail'>
         <div class="format"><code class="level-new">vcfDoFilter &lt;on/off&gt;</code></div>
     </TD></TR>
     <TR VALIGN=TOP><TD class="vcfDoQual"><A NAME="vcfDoQual"><IMG class='toggle detail'>
         <div class="format"><code class="level-new">vcfDoQual &lt;on/off&gt;</code></div>
     </TD></TR>
-    <TR VALIGN=TOP><TD class="vcfDoMaf"><A NAME="vcfDoQual"><IMG class='toggle detail'>
-        <div class="format"><code class="level-new">vcfDoQual &lt;on/off&gt;</code></div>
+    <TR VALIGN=TOP><TD class="vcfDoMaf"><A NAME="vcfDoMaf"><IMG class='toggle detail'>
+        <div class="format"><code class="level-new">vcfDoMaf &lt;on/off&gt;</code></div>
+    </TD></TR>
+    <TR VALIGN=TOP><TD class="vcfDoMinAc"><A NAME="vcfDoMinAc"><IMG class='toggle detail'>
+        <div class="format"><code class="level-new">vcfDoMinAc &lt;on/off&gt;</code></div>
     </TD></TR>
     <TR VALIGN=TOP><TD>
             <P>Additional settings found in the "Item or
             region tracks" section are also available for displaying
             Variant Call Format tracks.</P>
             <A onclick="return jumpTo(this);" HREF="#">maxWindowToDraw</A>
         </DIV>
     </TD></TR>
     <TR class="examples" VALIGN=TOP><TD class="vcfPhasedTrio_example">
         <IMG class='toggle detail'>
         <div class="format"><B>Example of a VCF Phased Trio track</B></div>
     </TD></TR>
 </TABLE>
 <BR><BR>