documentation for menu item JAL-860

diff --git a/help/html/features/viewingpdbs.html b/help/html/features/viewingpdbs.html
index a6f5de9..679f353 100755 (executable)
--- a/help/html/features/viewingpdbs.html
+++ b/help/html/features/viewingpdbs.html
@@ -44,8 +44,17 @@ structure is selected, one of the following will happen:</p>
        PDB viewer</a> help page for more information about the display.</li>
 </ul>
 
+       <p>
+               Additionally, if several of the sequences in the currently selected
+               region of the alignment have associated structures, then Jalview will
+               provide a 'View <em>X</em> structures' entry in the submenu. This
+               option will open a new Jmol view containing all the structures
+               available for all selected sequences, superimposed using the currently
+               selected region of the alignment. (<em>This capability was added
+                       in Jalview 2.7</em>)
+       </p>
 
-<p>To associate PDB files with a sequence, right click on a sequence
+       <p>To associate PDB files with a sequence, right click on a sequence
 ID and select "Structure<strong>&rarr;</strong> Associate Structure with
 Sequence", and one of the submenus:</p>
 

diff --git a/src/jalview/gui/PopupMenu.java b/src/jalview/gui/PopupMenu.java
index 30feec2..477136f 100644 (file)
--- a/src/jalview/gui/PopupMenu.java
+++ b/src/jalview/gui/PopupMenu.java
@@ -402,6 +402,7 @@ public class PopupMenu extends JPopupMenu
         final PDBEntry[] pe = pdbe.values().toArray(new PDBEntry[pdbe.size()]);
         final JMenuItem gpdbview;
         structureMenu.add(gpdbview=new JMenuItem("View "+pdbe.size()+" structures."));
+        gpdbview.setToolTipText("Open a new Jmol view with all structures associated with the current selection and superimpose them using the alignment.");
         gpdbview.addActionListener(new ActionListener()
         {