6350025: API documentation for JOptionPane using deprecated methods.

Reviewed-by: jdv

src/java.desktop/share/classes/javax/swing/JOptionPane.java

@@ -272,7 +272,7 @@
  *     JOptionPane pane = new JOptionPane(<i>arguments</i>);
  *     pane.set<i>.Xxxx(...); // Configure</i>
  *     JDialog dialog = pane.createDialog(<i>parentComponent, title</i>);
- *     dialog.show();
+ *     dialog.setVisible(true);
  *     Object selectedValue = pane.getValue();
  *     if(selectedValue == null)
  *       return CLOSED_OPTION;