graduated feature colour documentation

diff --git a/help/html/features/featuresFormat.html b/help/html/features/featuresFormat.html
index 6b86d22..2e40a19 100755 (executable)
--- a/help/html/features/featuresFormat.html
+++ b/help/html/features/featuresFormat.html
@@ -27,10 +27,35 @@ parser is available.</p>
 contains tab separated text fields. <strong>No comments are
 allowed</strong>.</p>
 <p>The first set of lines contain type definitions:<strong>
-<pre><em>Feature label</em>&#9;<em>Feature Colour</em></pre> </strong>A feature
-type has a text label, and a colour (specified as a red,green,blue 24
-bit triplet either in hexadecimal (eg. 00ff00) or as comma separated
-numbers (ranging from 0 to 255)).</p>
+<pre><em>Feature label</em>&#9;<em>Feature Colour</em><!-- &#9<em>Feature links</em>  --></pre> </strong>A feature
+type has a text label, and a colour specification. This can be either:
+<ul>
+       <li>A single colour specified as either a red,green,blue 24 bit
+       triplet in hexadecimal (eg. 00ff00) or as comma separated numbers
+       (ranging from 0 to 255))</li>
+       <li>A graduated colour specified as a &quot;|&quot; separated list
+       of fields:<pre>
+&lt;mincolor&gt;|&lt;maxcolor&gt;|[absolute|]&lt;minvalue&gt;|&lt;maxvalue&gt;[|&lt;thresholdtype&gt;|[&lt;threshold value&gt;]]
+</pre>The fields are as follows
+       <ul>
+               <li><em>mincolor</em> and <em>maxcolor</em><br>
+               Colour triplets specified as hexadecimal or comma separated values</li>
+               <li><em>absolute</em><br>
+               An optional switch indicating that the <em>minvalue</em> and <em>maxvalue</em>
+               parameters should be left as is, rather than rescaled according to the
+               range of scores for this feature type.
+               <li><em>minvalue</em> and <em>maxvalue</em><br>
+               Minimum and maximum values defining the range of scores for which the colour range will be defined over. If minvalue is greater than maxvalue then the linear mapping will have negative gradient.
+               </li>
+               <li><em>thresholdtype</em> <br>
+               Either &quot;none&quot;, &quot;below&quot;, or &quot;above&quot;. <em>below</em>
+               and <em>above</em> require an additional <em>threshold value</em>
+               which is used to control the display of features with a score either
+               below or above the value.</li>
+       </ul>
+       </li>
+</ul>
+</p>
 <p>The remaining lines in the file are the sequence annotation
 definitions, where the now defined features are attached to regions on
 particular sequences, optionally with some descriptive text (displayed
@@ -38,7 +63,7 @@ in a tooltip when the mouse is near the feature on that sequence). There
 are two alternate ways of referring to a sequence, either by its text
 ID, or its index in an associated alignment.
 <pre>
-<em>description</em>&#9;<em>sequenceId</em>&#9;<em>sequenceIndex</em>&#9;<em>start</em>&#9;<em>end</em>&#9;<em>featureType</em></pre>
+<em>description</em>&#9;<em>sequenceId</em>&#9;<em>sequenceIndex</em>&#9;<em>start</em>&#9;<em>end</em>&#9;<em>featureType</em>&#9;<em>score (optional)</em></pre>
 Normally, sequence features are associated with sequences rather than
 alignments, and the sequenceIndex field is given as &quot;-1&quot;. In
 order to specify a sequence by its index in a particular alignment, the
@@ -46,23 +71,26 @@ sequenceId should be given as &quot;ID_NOT_SPECIFIED&quot;, otherwise
 the sequenceId field will be used in preference to the sequenceIndex
 field.
 </p>
-<p>The description may contain simple HTML
-document body tags if enclosed by &quot;&lt;html&gt;&lt;/html&gt;&quot; and
-these will be rendered as formatted tooltips in the Jalview Application
-(the Jalview applet is not capable of rendering HTML tooltips, so all
-formatting tags will be removed).<br>
-<em>Attaching Links to Sequence Features</em>
-<br>Any anchor tags in an html formatted description line will be translated 
-into URL links. A link symbol will be displayed adjacent to any feature which
-includes links, and these are made available from the 
-<a href="../menus/popupMenu.html#sqid.popup">links submenu</a> of the 
-popup menu which is obtained by right-clicking when a link symbol is 
+<p>The description may contain simple HTML document body tags if
+enclosed by &quot;&lt;html&gt;&lt;/html&gt;&quot; and these will be
+rendered as formatted tooltips in the Jalview Application (the Jalview
+applet is not capable of rendering HTML tooltips, so all formatting tags
+will be removed).<br>
+<em>Attaching Links to Sequence Features</em> <br>
+Any anchor tags in an html formatted description line will be translated
+into URL links. A link symbol will be displayed adjacent to any feature
+which includes links, and these are made available from the <a
+       href="../menus/popupMenu.html#sqid.popup">links submenu</a> of the
+popup menu which is obtained by right-clicking when a link symbol is
 displayed in the tooltip.<br>
 <em>Non-positional features</em><br>
-Specify the <em>start</em> and <em>end</em> for a feature to be <strong>0</strong> in order to attach it to the whole sequence.
-Non-positional features are shown in a tooltip when the mouse hovers over the seuqence ID panel, and any embedded links can be accessed from the popup menu. 
+Specify the <em>start</em> and <em>end</em> for a feature to be <strong>0</strong>
+in order to attach it to the whole sequence. Non-positional features are
+shown in a tooltip when the mouse hovers over the sequence ID panel, and
+any embedded links can be accessed from the popup menu.
+<em>Scores</em><br>
+Scores can be associated with sequence features, and used to sort sequences or shade the alignment (this was added in jalview 2.4.X). The score field is optional, and malformed scores will be ignored.
 </p>
-
 <p>Feature annotations can be collected into named groups by
 prefixing definitions with lines of the form:<strong><pre>startgroup&#9;groupname</pre></strong>..
 and subsequently post-fixing the group with:<strong><pre>endgroup&#9;groupname</pre></strong>Feature