-<p>The key_value_pairs allow you to define a description and to colour the group
- in various ways. All, none or some of the following values could be used for
- a group:</p>
-<p>description=Text <br>
- colour=Helix Propensity<br>
- pidThreshold=0<br>
- consThreshold=0<br>
- outlineColour=red <br>
- displayBoxes=true<br>
- displayText=false<br>
- colourText=false<br>
- textCol1=black<br>
- textCol2=black<br>
- textColThreshold=0<br>
- idColour=ff3322<br>
- <!-- Not yet implemented in 2.5 release
- hide=false<br>
- hidecols=false<br> -->
- showunconserved=false</p>
-<ul><li><em>New Features in 2.4:</em><br>if the <strong>idColour</strong> property
-is given without specifying a colour scheme with the <strong>colour</strong>
-property, then the idColour will also be used to colour the sequence.</li>
-<li>the <strong>colour</strong> property can take either a colour scheme name,
- or a single colour specification (either a colour name like 'red' or an RGB
- triplet like 'ff0066'). If a single colour is specified, then the group
- will be coloured with that colour.</li>
- <!-- <li><em>New Features in 2.5</em></li>
- <li>hide and hidecols instruct jalview to hide the sequences or columns covered by the group.</li> -->
- <li>Sequence associated Groups<br>If a group is defined after a valid
- <em>SEQUENCE_REF</em> sequence reference statement, the sequence representative
- for the group will be set to the referenced sequence.<!-- <br><strong>Note:</strong> if the <em>hide</em>
- property is set then only the representative sequence for the group will be shown in the alignment.--></li>
-</ul>
-<p> </p>
-<p>An example Annotation file is given below:
-<pre>#Comment lines follow the hash symbol
+ <p>The currently supported set of sequence group key-value pairs
+ that can be provided here are :</p>
+ <table border="1">
+ <tbody>
+ <tr>
+ <td width="50%">Key</td>
+ <td>Value</td>
+ </tr>
+ <tr>
+ <td width="50%">description</td>
+ <td>Text - may include simple HTML tags</td>
+ </tr>
+ <tr>
+ <td width="50%">colour</td>
+ <td>A string resolving to a valid Jalview colourscheme
+ (e.g. Helix Propensity)</td>
+ </tr>
+ <tr>
+ <td width="50%">pidThreshold</td>
+ <td>A number from 0-100 specifying the Percent Identity
+ Threshold for colouring columns in the group or alignment</td>
+ </tr>
+ <tr>
+ <td width="50%">consThreshold</td>
+ <td>A number from 0-100 specifying the degree of bleaching
+ applied for conservation colouring</td>
+ </tr>
+ <tr>
+ <td width="50%">outlineColour</td>
+ <td>Line colour used for outlining the group (default is
+ red)</td>
+ </tr>
+ <tr>
+ <td width="50%">displayBoxes</td>
+ <td>Boolean (default true) controlling display of shaded
+ box for each alignment position</td>
+ </tr>
+ <tr>
+ <td width="50%">displayText</td>
+ <td>Boolean (default true) controlling display of text for
+ each alignment position</td>
+ </tr>
+ <tr>
+ <td width="50%">colourText</td>
+ <td>Boolean (default false) specifying whether text should
+ be shaded by applied colourscheme</td>
+ </tr>
+ <tr>
+ <td width="50%">textCol1</td>
+ <td>Colour for text when shown on a light background</td>
+ </tr>
+ <tr>
+ <td width="50%">textCol2</td>
+ <td>Colour for text when shown on a dark background</td>
+ </tr>
+ <tr>
+ <td width="50%">textColThreshold</td>
+ <td>Number from 0-100 specifying switching threshold
+ between light and dark background</td>
+ </tr>
+ <tr>
+ <td width="50%">idColour</td>
+ <td>Colour for highlighting the Sequence ID labels for this
+ group<br />If <em>idColour</em> is given but <em>colour</em>
+ is not, then idColor will also be used for the group
+ background colour.
+ </td>
+ </tr>
+ <tr>
+ <td width="50%">showunconserved</td>
+ <td>Boolean (default false) indicating whether residues
+ should only be shown that are different from current reference
+ or consensus sequence</td>
+ </tr>
+ <tr>
+ <td width="50%">hide</td>
+ <td>Boolean (default false) indicating whether the rows in
+ this group should be marked as hidden.<br /> <em>Note:</em>
+ if the group is sequence associated (specified by
+ SEQUENCE_REF), then all members will be hidden and marked as
+ represented by the reference sequence.
+ </td>
+ </tr>
+ <!-- <tr><td width="50%">hidecols</td><td>Boolean (default false) indicating whether columns in this groushould be marked as hidden</td></tr> -->
+ </tbody>
+ </table>
+
+ <p>
+ <strong>Specifying colours in PROPERTIES key-value pairs</strong><br />
+ The <strong>colour</strong> property can take either a colour scheme
+ name, or a single colour specification (either a colour name like
+ 'red' or an RGB triplet like 'ff0066'). If a single colour is
+ specified, then the group will be coloured with that colour.
+ </p>
+ <hr />
+ <p>
+ <strong><a name="seqgrprefs">SEQUENCE_REF and GROUP_REF</a></strong><br />
+ By default, annotation is associated with the alignment as a whole.
+ However, it is also possible to have an annotation row associated
+ with a specific sequence, or a sequence group. Clicking the
+ annotation label for sequence or group associated annotation will
+ highlight the associated rows in the alignment, and double clicking
+ will select those rows, allowing further analysis. While group
+ associated annotation remains associated with a particular
+ alignment, sequence associated annotation can move with a sequence -
+ so copying a sequence to another alignment will also copy its
+ associated annotation.
+ </p>
+ <p>You can associate an annotation with a sequence by preceding
+ its definition with the line:
+ <pre>SEQUENCE_REF	<em>seq_name</em>	<em>[startIndex]</em>
+ </pre>
+ All Annotations defined after a SEQUENCE_REF command will then be
+ associated with that sequence, and the first field in the Value field
+ list will (optionally) be placed at the
+ <em>startIndex</em>'th column.
+ </p>
+
+ <p>Sequence associations are turned off for subsequent annotation
+ definitions by:
+ <pre>SEQUENCE_REF	ALIGNMENT</pre>
+ </p>
+ <p>Similarly, since Jalview 2.5, group associated annotation can
+ be defined by preceding the row definitions with the line:
+ <pre>GROUP_REF	<em>group_name</em>
+ </pre>
+ Group association is turned off for subsequent annotation rows by:
+ <pre>GROUP_REF	<em>ALIGNMENT</em>
+ </pre>
+ </p>
+ <hr />
+ <p>
+ <strong><a name="refsandviews">VIEW_SETREF,
+ VIEW_HIDECOL and HIDE_INSERTIONS</a></strong><br /> Since Jalview 2.9, the
+ Annotations file has also supported the definition of reference
+ sequences and hidden regions for an alignment view.
+ </p>
+ <!-- <p>
+ <em>VIEW_DEF</em> allows the current view to be named according to the
+ first argument after the tab character. If a second argument is
+ provided, then a new view is created with the given name, and
+ properties.
+ </p> -->
+ <p>
+ <em>VIEW_SETREF</em><br />Marks the first sequence in the
+ alignment, or alternately, the one specified by the most recent <em>SEQUENCE_REF</em>
+ statement, as the <a href="../calculations/referenceseq.html">reference
+ sequence</a> for the alignment.
+ </p>
+ <p>
+ <em>HIDE_INSERTIONS</em><br />This command hides all gapped
+ positions in the current target sequence. Any columns already hidden
+ will be re-displayed.<br /> <br>The current target sequence is
+ either the one specified by the most recent <em>SEQUENCE_REF</em>
+ statement, the alignment's reference sequence, or the first sequence
+ in the alignment.
+ </p>
+ <p>
+ <em>VIEW_HIDECOLS</em><br />Modifies the visibility of columns in
+ the view. The statement is followed by a single argument consisting
+ of a comma separated series of single integers or integer pairs
+ (like <em>3-4</em>). These define columns (starting from the
+ left-hand column 0) that should be marked as hidden in the alignment
+ view.
+ </p>
+
+ <hr />
+ <p>
+ <strong><a name="compatibility">COMPATIBILITY NOTES</a></strong><br />
+ The interpretation of the COMBINE statement in <em>Version
+ 2.8.1</em> was refined so that only annotation line graphs with the
+ given names ands the same <strong>SEQUENCE_REF</strong> and <strong>GROUP_REF</strong>
+ scope are grouped.
+ </p>
+ <hr />
+
+ <p>
+ <strong><a name="exampleann">EXAMPLES</a></strong><br /> An example
+ Annotation file is given below. Copy and paste the contents into a
+ text file and load it onto the Jalview example protein alignment.
+ </p>
+ <pre>#Comment lines follow the hash symbol