svn commit: r652490 - /maven/doxia/doxia/trunk/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java

[ltheussl]

Author: ltheussl
Date: Thu May  1 05:08:27 2008
New Revision: 652490

URL: http://svn.apache.org/viewvc?rev=652490&view=rev
Log:
[DOXIA-234] Deprecate some sink methods

Modified:
    
maven/doxia/doxia/trunk/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java

Modified: 
maven/doxia/doxia/trunk/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java
URL: 
http://svn.apache.org/viewvc/maven/doxia/doxia/trunk/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java?rev=652490&r1=652489&r2=652490&view=diff
==============================================================================
--- 
maven/doxia/doxia/trunk/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java
 (original)
+++ 
maven/doxia/doxia/trunk/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java
 Thu May  1 05:08:27 2008
@@ -895,7 +895,7 @@
      * Starts a cell element which defines a cell that contains data.
      *
      * @param width the size of the cell.
-     * @see #tableCell(SinkEventAttributes).
+     * @deprecated Use #tableCell(SinkEventAttributes) instead.
      */
     void tableCell( String width );
 
@@ -934,7 +934,7 @@
      * Starts a cell element which defines a cell that contains header 
information.
      *
      * @param width the size of the header cell.
-     * @see #tableHeaderCell(SinkEventAttributes).
+     * @deprecated Use #tableHeaderCell(SinkEventAttributes) instead.
      */
     void tableHeaderCell( String width );
 
@@ -1013,7 +1013,7 @@
      * Starts an element which indicates that whitespace in the enclosed text 
has semantic relevance.
      *
      * @param boxed true to add a box, false otherwise
-     * @see #verbatim(SinkEventAttributes).
+     * @deprecated Use #verbatim(SinkEventAttributes) instead.
      */
     void verbatim( boolean boxed );
 
@@ -1145,69 +1145,48 @@
     /**
      * Starts an italic element.
      *
-     * @see #italic(SinkEventAttributes).
+     * @deprecated Use [EMAIL PROTECTED] #text(String,SinkEventAttributes)} 
with
+     *              [EMAIL PROTECTED] SinkEventAttributes#STYLE STYLE} instead.
      */
     void italic();
 
     /**
-     * Starts an italic element.
-     *
-     * <p>
-     *   Supported attributes are the [EMAIL PROTECTED] SinkEventAttributes 
base attributes}.
-     * </p>
-     *
-     * @param attributes A set of [EMAIL PROTECTED] SinkEventAttributes}, may 
be <code>null</code>.
-     */
-    void italic( SinkEventAttributes attributes );
-
-    /**
      * Ends an italic element.
+     *
+     * @deprecated Use [EMAIL PROTECTED] #text(String,SinkEventAttributes)} 
with
+     *              [EMAIL PROTECTED] SinkEventAttributes#STYLE STYLE} instead.
      */
     void italic_();
 
     /**
      * Starts a bold element.
      *
-     * @see #bold(SinkEventAttributes).
+     * @deprecated Use [EMAIL PROTECTED] #text(String,SinkEventAttributes)} 
with
+     *              [EMAIL PROTECTED] SinkEventAttributes#STYLE STYLE} instead.
      */
     void bold();
 
     /**
-     * Starts a bold element.
-     *
-     * <p>
-     *   Supported attributes are the [EMAIL PROTECTED] SinkEventAttributes 
base attributes}.
-     * </p>
-     *
-     * @param attributes A set of [EMAIL PROTECTED] SinkEventAttributes}, may 
be <code>null</code>.
-     */
-    void bold( SinkEventAttributes attributes );
-
-    /**
      * Ends a bold element.
+     *
+     * @deprecated Use [EMAIL PROTECTED] #text(String,SinkEventAttributes)} 
with
+     *              [EMAIL PROTECTED] SinkEventAttributes#STYLE STYLE} instead.
      */
     void bold_();
 
     /**
      * Starts a monospaced element.
      *
-     * @see #monospaced(SinkEventAttributes).
+     * @deprecated Use [EMAIL PROTECTED] #text(String,SinkEventAttributes)} 
with
+     *              [EMAIL PROTECTED] SinkEventAttributes#STYLE STYLE} instead.
      */
     void monospaced();
 
     /**
-     * Starts a monospaced element.
-     *
-     * <p>
-     *   Supported attributes are the [EMAIL PROTECTED] SinkEventAttributes 
base attributes}.
-     * </p>
-     *
-     * @param attributes A set of [EMAIL PROTECTED] SinkEventAttributes}, may 
be <code>null</code>.
-     */
-    void monospaced( SinkEventAttributes attributes );
-
-    /**
      * Ends a monospaced element.
+     *
+     * @deprecated Use [EMAIL PROTECTED] #text(String,SinkEventAttributes)} 
with
+     *              [EMAIL PROTECTED] SinkEventAttributes#STYLE STYLE} instead.
      */
     void monospaced_();
 
@@ -1259,11 +1238,13 @@
      *   be normalized to the System EOL by an implementing Sink.
      * </p>
      * <p>
-     *   Supported attributes are the [EMAIL PROTECTED] SinkEventAttributes 
base attributes}
-     *   plus [EMAIL PROTECTED] SinkEventAttributes#VALIGN VALIGN} (values 
"sub", "sup") and
-     *   [EMAIL PROTECTED] SinkEventAttributes#DECORATION DECORATION} (values 
"underline",
-     *   "overline", "line-through").
+     *   Supported attributes are the [EMAIL PROTECTED] SinkEventAttributes 
base attributes} plus
      * </p>
+     * <blockquote>
+     *   [EMAIL PROTECTED] SinkEventAttributes#VALIGN VALIGN} (values "sub", 
"sup"),
+     *   [EMAIL PROTECTED] SinkEventAttributes#DECORATION DECORATION} (values 
"underline", "overline", "line-through"),
+     *   [EMAIL PROTECTED] SinkEventAttributes#STYLE STYLE} (values "italic", 
"bold", "monospaced").
+     * </blockquote>
      *
      * @param text The text to write.
      * @param attributes A set of [EMAIL PROTECTED] SinkEventAttributes}, may 
be <code>null</code>.