diff -r 0678c9589013 -r 03a451fc2256 samples/trycatchredo/src/org/apidesign/exceptions/trycatchredo/api/UserQuestionException.java
--- a/samples/trycatchredo/src/org/apidesign/exceptions/trycatchredo/api/UserQuestionException.java	Sun Feb 01 16:29:46 2009 +0100
+++ b/samples/trycatchredo/src/org/apidesign/exceptions/trycatchredo/api/UserQuestionException.java	Sun Feb 01 17:41:32 2009 +0100
@@ -3,6 +3,7 @@
 import java.io.IOException;
 import javax.swing.JOptionPane;
 
+// BEGIN: trycatchredo.UserQuestionException
 /** Specialized I/O exception to request some kind of user confirmation.
  * A code that needs to ask user shall not attempt to open a dialog itself,
  * rather it shall emit this exception and let its callers show the dialog
@@ -13,7 +14,9 @@
  */
 public abstract class UserQuestionException extends IOException {
     /** Description of the dialog to show to the user. Whoever catches
-     * this exception shall use {@link #getQuestionPane()}.{@link JOptionPane#createDialog(java.lang.String)}
+     * this exception shall use 
+     * {@link #getQuestionPane()}.
+     * {@link JOptionPane#createDialog(java.lang.String)}
      * to construct and display the dialog.
      * 
      * @return the pane to display to user
@@ -27,3 +30,4 @@
      */
     public abstract void confirm(Object option);
 }
+// END: trycatchredo.UserQuestionException
\ No newline at end of file