samples/trycatchredo/src/org/apidesign/exceptions/trycatchredo/api/UserQuestionException.java
1.1 --- a/samples/trycatchredo/src/org/apidesign/exceptions/trycatchredo/api/UserQuestionException.java Sun Feb 01 16:29:46 2009 +0100
1.2 +++ b/samples/trycatchredo/src/org/apidesign/exceptions/trycatchredo/api/UserQuestionException.java Sun Feb 01 17:41:32 2009 +0100
1.3 @@ -3,6 +3,7 @@
1.4 import java.io.IOException;
1.5 import javax.swing.JOptionPane;
1.6
1.7 +// BEGIN: trycatchredo.UserQuestionException
1.8 /** Specialized I/O exception to request some kind of user confirmation.
1.9 * A code that needs to ask user shall not attempt to open a dialog itself,
1.10 * rather it shall emit this exception and let its callers show the dialog
1.11 @@ -13,7 +14,9 @@
1.12 */
1.13 public abstract class UserQuestionException extends IOException {
1.14 /** Description of the dialog to show to the user. Whoever catches
1.15 - * this exception shall use {@link #getQuestionPane()}.{@link JOptionPane#createDialog(java.lang.String)}
1.16 + * this exception shall use
1.17 + * {@link #getQuestionPane()}.
1.18 + * {@link JOptionPane#createDialog(java.lang.String)}
1.19 * to construct and display the dialog.
1.20 *
1.21 * @return the pane to display to user
1.22 @@ -27,3 +30,4 @@
1.23 */
1.24 public abstract void confirm(Object option);
1.25 }
1.26 +// END: trycatchredo.UserQuestionException
1.27 \ No newline at end of file