d19b85083618569a8b3400a8d17a3d2028ef223d
lrnassar
  Tue Sep 29 15:38:31 2026 -0700
The itemRgb doc said a color setting "in the same stanza" loses to an explicit itemRgb on, which is narrower than bedItemRgb() behaves: both settings go through trackDbSetting(), which walks the parent chain, and the two lookups are independent, so a parent's itemRgb on beats a color set on the child itself. Reworded that and the matching colorFields sentence, and added the changes.html row this should have had. Caught by CR of 64adf565f28. refs #36212

diff --git src/hg/htdocs/goldenPath/help/trackDb/changes.html src/hg/htdocs/goldenPath/help/trackDb/changes.html
index 75ef51ebe3d..75ba64a30d1 100755
--- src/hg/htdocs/goldenPath/help/trackDb/changes.html
+++ src/hg/htdocs/goldenPath/help/trackDb/changes.html
@@ -32,30 +32,44 @@
 
 <DIV class="trackDbDoc_intro">
 <H1>Track Database Definition</H1>
 
 <p>This document summarizes the changes to the <a href="trackDbHub.html">UCSC Genome Browser Hub TrackDb specification</a>.<p>
 
 <TABLE class="settingsTable" id="Common_Settings">
 <tbody>
 <tr valign="TOP">
 <th width="100">Date</th>
 <th width="15%">Track Types</th>
 <th width="15%">Link to Doc</th>
 <th>Change</th>
 </tr>
 
+<tr>
+    <td>2026-09-21</td>
+    <td>bed, bigBed, bedDetail, bedGraph, bedLogR</td>
+    <td><a href="trackDbHub.html#itemRgb">itemRgb</a></td>
+    <td>A track that sets both <code>itemRgb on</code> and
+    <a href="trackDbHub.html#color">color</a> again takes its item colors from the file's
+    RGB column and its label color from <code>color</code>; since 2025 <code>color</code> had
+    won outright. Both settings are inherited from a track's <code>parent</code>, and an
+    explicit <code>itemRgb</code> wins wherever it is set. The <code>itemRgb</code> entry now
+    lists all four combinations, and the
+    <a href="trackDbHub.html#colorFields">colorFields</a> entry no longer says that any
+    <code>color</code> setting suppresses item coloring.</td>
+</tr>
+
 <tr>
     <td>2026-09-18</td>
     <td>all</td>
     <td><a href="trackDbHub.html#html">html</a></td>
     <td>A hub's track description page now has variables substituted into it.
     <code>${db}</code>, <code>${organism}</code>, <code>${Organism}</code>,
     <code>${ORGANISM}</code>, <code>${date}</code> and <code>${downloadsServer}</code> were
     already available on UCSC's own track descriptions and now work in a hub's as well.
     <code>${track}</code> and <code>${parentTrack}</code> are new: they give a track's name
     and the name of its container in the form the Genome Browser uses, so the page of a
     track inside a <a href="trackDbHub.html#compositeTrack">compositeTrack</a> or a
     <a href="trackDbHub.html#superTrack">superTrack</a> can link back to the container's own
     page. A dollar sign followed by anything else is left alone.</td>
 </tr>
 <tr>