diff --git a/docs/jvm_options.sgml b/docs/jvm_options.sgml
index 88881ed9676b56143ba4d3367717b23740cec1b9..a350bce8a2c6a96ee1cb28fd98537165b9d31fd5 100644
--- a/docs/jvm_options.sgml
+++ b/docs/jvm_options.sgml
@@ -44,6 +44,24 @@ using these file types).
       </PARA>
     </SECT2>
 
+    <SECT2 ID="JVM-CHADO">
+       <TITLE><LITERAL>-Dchado="hostname:port/database?username"</LITERAL></TITLE>
+      <PARA>
+This is used to get &prog; to look for the database. The address of the database
+(hostname, port and name) can be conveniently included
+(e.g. -Dchado="genedb-db.sanger.ac.uk:5432/snapshot?genedb_ro") and
+these details are then the default database address in the popup login window. 
+      </PARA>
+    </SECT2>
+
+    <SECT2 ID="JVM-CHADO-READONLY">
+       <TITLE><LITERAL>-Dread_only</LITERAL></TITLE>
+      <PARA>
+For a read only chado connection -Dread_only is specified on the command line
+(e.g. art -Dchado="genedb-db.sanger.ac.uk:5432/snapshot?genedb_ro" -Dread_only).
+      </PARA>
+    </SECT2>
+
     <SECT2 ID="JVM-FWD-LINES">
        <TITLE><LITERAL>-Dshow_forward_lines=false</LITERAL></TITLE>
       <PARA>
diff --git a/docs/next_gen.sgml b/docs/next_gen.sgml
index adbdb1d0cd1bcc9436a9db0ce6ecfe48f218da64..7bacc39c4b3ccbb8f9df510168e8d0c84f9ad95f 100644
--- a/docs/next_gen.sgml
+++ b/docs/next_gen.sgml
@@ -1,12 +1,18 @@
   <SECT2 ID="FILEMENU-READ-BAM">
     <TITLE>Read BAM / VCF ...</TITLE>
      <PARA>
-Read a BAM file that has been sorted and indexed using <ULINK
-URL="http://samtools.sourceforge.net/">samtools</ULINK>. This provides an integrated
-<ULINK URL="http://bamview.sourceforge.net/">BamView</ULINK> panel displaying
-sequence alignment mappings to a reference sequence. This require Artemis to
-be run with Java 1.6 as it makes use of <ULINK URL="http://picard.sourceforge.net/">
-picard</ULINK> to read from the BAM file.
+&prog; can read in and visualise BAM, VCF and BCF files. These files need
+to be indexed as described below. They require &prog; to be run with at least
+Java 1.6.
+     </PARA>
+     <PARA>
+BAM files need to be sorted and indexed using <ULINK
+URL="http://samtools.sourceforge.net/">samtools</ULINK>. The index file should be in
+the same directory as the BAM file. This provides an integrated
+<ULINK URL="http://bamview.sourceforge.net/">BamView</ULINK> panel in &prog;, displaying
+sequence alignment mappings to a reference sequence. Multiple BAM files can be loaded
+in from here either by selecting each file individually or by selecting a file of
+path names to the BAM files.
       </PARA>
       <PARA>
 Variant Call Format (<ULINK