You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by mi...@apache.org on 2023/01/22 18:17:16 UTC

[maven-doxia] branch DOXIA-685 updated (f0a5b480 -> 73a00a9d)

This is an automated email from the ASF dual-hosted git repository.

michaelo pushed a change to branch DOXIA-685
in repository https://gitbox.apache.org/repos/asf/maven-doxia.git


 discard f0a5b480 [DOXIA-685] Replace SinkEventAttributes#BOXED and clearly separate between regular verbatim and verbatim source (code)
     new 73a00a9d [DOXIA-685] Replace SinkEventAttributes#BOXED with #SOURCE to clearly separate between regular verbatim and verbatim source (code)

This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version.  This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:

 * -- * -- B -- O -- O -- O   (f0a5b480)
            \
             N -- N -- N   refs/heads/DOXIA-685 (73a00a9d)

You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.

Any revisions marked "omit" are not gone; other references still
refer to them.  Any revisions marked "discard" are gone forever.

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:


[maven-doxia] 01/01: [DOXIA-685] Replace SinkEventAttributes#BOXED with #SOURCE to clearly separate between regular verbatim and verbatim source (code)

Posted by mi...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

michaelo pushed a commit to branch DOXIA-685
in repository https://gitbox.apache.org/repos/asf/maven-doxia.git

commit 73a00a9dead29b02c12c7d1365e2273ff502724a
Author: Michael Osipov <mi...@apache.org>
AuthorDate: Mon Jan 9 12:30:28 2023 +0100

    [DOXIA-685] Replace SinkEventAttributes#BOXED with #SOURCE to clearly separate between regular verbatim and verbatim source (code)
    
    This closes #135
---
 .../org/apache/maven/doxia/macro/EchoMacro.java    |  3 +--
 .../maven/doxia/macro/snippet/SnippetMacro.java    | 12 ++++++++--
 .../maven/doxia/parser/Xhtml5BaseParser.java       | 14 ++++++------
 .../doxia/sink/impl/SinkEventAttributeSet.java     |  9 ++++++++
 .../maven/doxia/sink/impl/Xhtml5BaseSink.java      | 13 ++++++-----
 .../maven/doxia/sink/impl/AbstractSinkTest.java    | 16 ++++++-------
 .../doxia/sink/impl/SinkEventAttributeSetTest.java | 18 +++++++--------
 .../maven/doxia/sink/impl/SinkTestDocument.java    |  8 +++----
 .../maven/doxia/sink/impl/SinkUtilsTest.java       |  6 ++---
 .../org/apache/maven/doxia/sink/impl/TextSink.java |  6 ++---
 .../maven/doxia/sink/impl/Xhtml5BaseSinkTest.java  | 19 ++++++++--------
 .../apache/maven/doxia/module/apt/AptMarkup.java   | 16 ++++++-------
 .../apache/maven/doxia/module/apt/AptParser.java   |  8 +++----
 .../org/apache/maven/doxia/module/apt/AptSink.java | 26 +++++++++++-----------
 .../maven/doxia/module/apt/AptParserTest.java      |  8 +++----
 .../apache/maven/doxia/module/apt/AptSinkTest.java |  6 ++---
 .../maven/doxia/module/fml/FmlContentParser.java   |  2 +-
 .../doxia/module/markdown/MarkdownMarkup.java      |  8 +++----
 .../doxia/module/markdown/MarkdownParser.java      |  5 +----
 .../maven/doxia/module/markdown/MarkdownSink.java  |  4 ++--
 .../doxia/module/markdown/MarkdownParserTest.java  |  4 ++--
 .../doxia/module/markdown/MarkdownSinkTest.java    |  6 ++---
 .../apache/maven/doxia/module/xdoc/XdocParser.java |  2 +-
 .../apache/maven/doxia/module/xdoc/XdocSink.java   | 16 ++++++-------
 .../maven/doxia/module/xdoc/XdocSinkTest.java      |  6 ++---
 .../maven/doxia/module/xhtml5/Xhtml5Parser.java    | 18 +++++++--------
 .../maven/doxia/module/xhtml5/Xhtml5SinkTest.java  |  4 ++--
 .../java/org/apache/maven/doxia/sink/Sink.java     |  2 +-
 .../maven/doxia/sink/SinkEventAttributes.java      |  2 +-
 29 files changed, 142 insertions(+), 125 deletions(-)

diff --git a/doxia-core/src/main/java/org/apache/maven/doxia/macro/EchoMacro.java b/doxia-core/src/main/java/org/apache/maven/doxia/macro/EchoMacro.java
index 97ac03fd..91ef7174 100644
--- a/doxia-core/src/main/java/org/apache/maven/doxia/macro/EchoMacro.java
+++ b/doxia-core/src/main/java/org/apache/maven/doxia/macro/EchoMacro.java
@@ -22,7 +22,6 @@ import javax.inject.Named;
 import javax.inject.Singleton;
 
 import org.apache.maven.doxia.sink.Sink;
-import org.apache.maven.doxia.sink.impl.SinkEventAttributeSet;
 
 /**
  * A simple macro that prints out the key and value of some supplied parameters.
@@ -32,7 +31,7 @@ import org.apache.maven.doxia.sink.impl.SinkEventAttributeSet;
 public class EchoMacro extends AbstractMacro {
     /** {@inheritDoc} */
     public void execute(Sink sink, MacroRequest request) {
-        sink.verbatim(SinkEventAttributeSet.BOXED);
+        sink.verbatim();
 
         sink.text("echo" + EOL);
 
diff --git a/doxia-core/src/main/java/org/apache/maven/doxia/macro/snippet/SnippetMacro.java b/doxia-core/src/main/java/org/apache/maven/doxia/macro/snippet/SnippetMacro.java
index e808925c..0739c381 100644
--- a/doxia-core/src/main/java/org/apache/maven/doxia/macro/snippet/SnippetMacro.java
+++ b/doxia-core/src/main/java/org/apache/maven/doxia/macro/snippet/SnippetMacro.java
@@ -38,7 +38,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * A macro that prints out the content of a file or a URL.
+ * A macro that prints out the (source code) content of a file or a URL.
  */
 @Singleton
 @Named("snippet")
@@ -100,6 +100,14 @@ public class SnippetMacro extends AbstractMacro {
             verbatim = Boolean.valueOf(verbatimParam);
         }
 
+        boolean source = true;
+
+        String sourceParam = (String) request.getParameter("source");
+
+        if (sourceParam != null && !"".equals(sourceParam)) {
+            source = Boolean.valueOf(sourceParam);
+        }
+
         String encoding = (String) request.getParameter("encoding");
 
         URL url;
@@ -135,7 +143,7 @@ public class SnippetMacro extends AbstractMacro {
         }
 
         if (verbatim) {
-            sink.verbatim(SinkEventAttributeSet.BOXED);
+            sink.verbatim(source ? SinkEventAttributeSet.SOURCE : null);
 
             sink.text(snippet.toString());
 
diff --git a/doxia-core/src/main/java/org/apache/maven/doxia/parser/Xhtml5BaseParser.java b/doxia-core/src/main/java/org/apache/maven/doxia/parser/Xhtml5BaseParser.java
index a10c817e..72dbd9a6 100644
--- a/doxia-core/src/main/java/org/apache/maven/doxia/parser/Xhtml5BaseParser.java
+++ b/doxia-core/src/main/java/org/apache/maven/doxia/parser/Xhtml5BaseParser.java
@@ -802,16 +802,16 @@ public class Xhtml5BaseParser extends AbstractXmlParser implements HtmlMarkup {
     }
 
     private boolean handleDivStart(XmlPullParser parser, SinkEventAttributeSet attribs, Sink sink) {
-        String divclass = parser.getAttributeValue(null, Attribute.CLASS.toString());
+        String divClass = parser.getAttributeValue(null, Attribute.CLASS.toString());
 
-        this.divStack.push(divclass);
+        this.divStack.push(divClass);
 
-        if ("content".equals(divclass)) {
+        if ("content".equals(divClass)) {
             SinkEventAttributeSet atts = new SinkEventAttributeSet(attribs);
             atts.removeAttribute(SinkEventAttributes.CLASS);
             sink.content(atts);
         }
-        if ("source".equals(divclass)) {
+        if ("verbatim".equals(divClass) || "verbatim source".equals(divClass)) {
             return false;
         } else {
             sink.division(attribs);
@@ -821,12 +821,12 @@ public class Xhtml5BaseParser extends AbstractXmlParser implements HtmlMarkup {
     }
 
     private boolean handleDivEnd(Sink sink) {
-        String divclass = divStack.pop();
+        String divClass = divStack.pop();
 
-        if ("content".equals(divclass)) {
+        if ("content".equals(divClass)) {
             sink.content_();
         }
-        if ("source".equals(divclass)) {
+        if ("verbatim".equals(divClass) || "verbatim source".equals(divClass)) {
             return false;
         } else {
             sink.division_();
diff --git a/doxia-core/src/main/java/org/apache/maven/doxia/sink/impl/SinkEventAttributeSet.java b/doxia-core/src/main/java/org/apache/maven/doxia/sink/impl/SinkEventAttributeSet.java
index 7363f823..02289e2c 100644
--- a/doxia-core/src/main/java/org/apache/maven/doxia/sink/impl/SinkEventAttributeSet.java
+++ b/doxia-core/src/main/java/org/apache/maven/doxia/sink/impl/SinkEventAttributeSet.java
@@ -51,9 +51,17 @@ public class SinkEventAttributeSet implements SinkEventAttributes, Cloneable {
 
     /**
      * An unmodifiable attribute set containing only a boxed attribute.
+     *
+     * @deprecated use {@link source} for source code
      */
+    @Deprecated
     public static final SinkEventAttributes BOXED;
 
+    /**
+     * An unmodifiable attribute set containing only a source attribute.
+     */
+    public static final SinkEventAttributes SOURCE;
+
     /**
      * An unmodifiable attribute set containing only a bold attribute.
      */
@@ -94,6 +102,7 @@ public class SinkEventAttributeSet implements SinkEventAttributes, Cloneable {
         OVERLINE = new SinkEventAttributeSet(DECORATION, "overline").unmodifiable();
         LINETHROUGH = new SinkEventAttributeSet(DECORATION, "line-through").unmodifiable();
         BOXED = new SinkEventAttributeSet(DECORATION, "boxed").unmodifiable();
+        SOURCE = new SinkEventAttributeSet(DECORATION, "source").unmodifiable();
 
         BOLD = new SinkEventAttributeSet(STYLE, "bold").unmodifiable();
         ITALIC = new SinkEventAttributeSet(STYLE, "italic").unmodifiable();
diff --git a/doxia-core/src/main/java/org/apache/maven/doxia/sink/impl/Xhtml5BaseSink.java b/doxia-core/src/main/java/org/apache/maven/doxia/sink/impl/Xhtml5BaseSink.java
index 86ffca24..819fb32e 100644
--- a/doxia-core/src/main/java/org/apache/maven/doxia/sink/impl/Xhtml5BaseSink.java
+++ b/doxia-core/src/main/java/org/apache/maven/doxia/sink/impl/Xhtml5BaseSink.java
@@ -1105,7 +1105,7 @@ public class Xhtml5BaseSink extends AbstractXmlSink implements HtmlMarkup {
     }
 
     /**
-     * The default class style for boxed is <code>source</code>.
+     * The default class style is <code>verbatim</code>, for source is {@code verbatim source}.
      *
      * {@inheritDoc}
      * @see javax.swing.text.html.HTML.Tag#DIV
@@ -1128,19 +1128,22 @@ public class Xhtml5BaseSink extends AbstractXmlSink implements HtmlMarkup {
             atts = new SinkEventAttributeSet();
         }
 
-        boolean boxed = false;
+        boolean source = false;
 
         if (atts.isDefined(SinkEventAttributes.DECORATION)) {
-            boxed = "boxed"
+            source = "source"
                     .equals(atts.getAttribute(SinkEventAttributes.DECORATION).toString());
         }
 
         SinkEventAttributes divAtts = null;
+        String divClass = "verbatim";
 
-        if (boxed) {
-            divAtts = new SinkEventAttributeSet(Attribute.CLASS.toString(), "source");
+        if (source) {
+            divClass += " source";
         }
 
+        divAtts = new SinkEventAttributeSet(Attribute.CLASS.toString(), divClass);
+
         atts.removeAttribute(SinkEventAttributes.DECORATION);
 
         writeStartTag(HtmlMarkup.DIV, divAtts);
diff --git a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/AbstractSinkTest.java b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/AbstractSinkTest.java
index 3725e7e5..6953f07a 100644
--- a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/AbstractSinkTest.java
+++ b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/AbstractSinkTest.java
@@ -773,21 +773,21 @@ public abstract class AbstractSinkTest extends AbstractModuleTest {
     }
 
     /**
-     * Checks that the sequence <code>[verbatim(SinkEventAttributeSet.BOXED), text(text),
+     * Checks that the sequence <code>[verbatim(SinkEventAttributeSet.SOURCE), text(text),
      * verbatim_()]</code>, invoked on the current sink, produces the
-     * same result as {@link #getVerbatimBlock getVerbatimBlock}(text).
+     * same result as {@link #getVerbatimSourceBlock getVerbatimSourceBlock}(text).
      */
     @Test
-    public void testVerbatim() {
+    public void testVerbatimSource() {
         String text = "Text";
-        sink.verbatim(SinkEventAttributeSet.BOXED);
+        sink.verbatim(SinkEventAttributeSet.SOURCE);
         sink.text(text);
         sink.verbatim_();
         sink.flush();
         sink.close();
 
         String actual = testWriter.toString();
-        String expected = getVerbatimBlock(text);
+        String expected = getVerbatimSourceBlock(text);
 
         assertEquals(expected, actual, "Wrong verbatim!");
     }
@@ -1001,7 +1001,7 @@ public abstract class AbstractSinkTest extends AbstractModuleTest {
     /**
      * Checks that the sequence <code>[text(text)]</code>,
      * invoked on the current sink, produces the same result as
-     * {@link #getTextBlock getTextBlock()}.
+     * {@link #getTextBlock getTextBlock()}(text).
      */
     @Test
     public void testText() {
@@ -1338,9 +1338,9 @@ public abstract class AbstractSinkTest extends AbstractModuleTest {
      * Returns a Verbatim block generated by this sink.
      * @param text The text to use.
      * @return The result of invoking a Verbatim block on the current sink.
-     * @see #testVerbatim()
+     * @see #testVerbatimSource()
      */
-    protected abstract String getVerbatimBlock(String text);
+    protected abstract String getVerbatimSourceBlock(String text);
 
     /**
      * Returns a HorizontalRule block generated by this sink.
diff --git a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkEventAttributeSetTest.java b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkEventAttributeSetTest.java
index 10ede6dc..a3a47245 100644
--- a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkEventAttributeSetTest.java
+++ b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkEventAttributeSetTest.java
@@ -79,7 +79,7 @@ public class SinkEventAttributeSetTest {
 
         sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.BOLD);
         assertEquals(1, sinkEventAttributeSet.getAttributeCount());
-        sinkEventAttributeSet.removeAttributes(SinkEventAttributeSet.BOXED);
+        sinkEventAttributeSet.removeAttributes(SinkEventAttributeSet.SOURCE);
         assertEquals(1, sinkEventAttributeSet.getAttributeCount());
         sinkEventAttributeSet.removeAttributes(SinkEventAttributeSet.BOLD);
         assertEquals(0, sinkEventAttributeSet.getAttributeCount());
@@ -91,7 +91,7 @@ public class SinkEventAttributeSetTest {
     @Test
     public void testIsDefined() {
         assertFalse(sinkEventAttributeSet.isDefined(SinkEventAttributes.DECORATION));
-        sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.BOXED);
+        sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.SOURCE);
         assertTrue(sinkEventAttributeSet.isDefined(SinkEventAttributes.DECORATION));
     }
 
@@ -103,7 +103,7 @@ public class SinkEventAttributeSetTest {
         SinkEventAttributes instance = new SinkEventAttributeSet(SinkEventAttributeSet.BOLD);
         sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.BOLD);
         assertTrue(instance.isEqual(sinkEventAttributeSet));
-        instance.addAttributes(SinkEventAttributeSet.BOXED);
+        instance.addAttributes(SinkEventAttributeSet.SOURCE);
         assertFalse(instance.isEqual(sinkEventAttributeSet));
     }
 
@@ -120,7 +120,7 @@ public class SinkEventAttributeSetTest {
         SinkEventAttributes instance = new SinkEventAttributeSet(SinkEventAttributeSet.BOLD);
         sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.BOLD);
         assertTrue(instance.equals(sinkEventAttributeSet));
-        instance.addAttributes(SinkEventAttributeSet.BOXED);
+        instance.addAttributes(SinkEventAttributeSet.SOURCE);
         assertFalse(instance.equals(sinkEventAttributeSet));
     }
 
@@ -172,7 +172,7 @@ public class SinkEventAttributeSetTest {
     public void testContainsAttributes() {
         sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.JUSTIFY);
         assertTrue(sinkEventAttributeSet.containsAttributes(SinkEventAttributeSet.JUSTIFY));
-        assertFalse(sinkEventAttributeSet.containsAttributes(SinkEventAttributeSet.BOXED));
+        assertFalse(sinkEventAttributeSet.containsAttributes(SinkEventAttributeSet.SOURCE));
     }
 
     /**
@@ -237,7 +237,7 @@ public class SinkEventAttributeSetTest {
 
         result = sinkEventAttributeSet.clone();
         assertEquals(sinkEventAttributeSet, result);
-        sinkEventAttributeSet.setResolveParent(SinkEventAttributeSet.BOXED);
+        sinkEventAttributeSet.setResolveParent(SinkEventAttributeSet.SOURCE);
         // assertFalse(sinkEventAttributeSet.equals(result));
     }
 
@@ -265,12 +265,12 @@ public class SinkEventAttributeSetTest {
         String expected = "";
         assertEquals(expected, sinkEventAttributeSet.toString());
 
-        sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.BOXED);
-        expected = " decoration=boxed";
+        sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.SOURCE);
+        expected = " decoration=source";
         assertEquals(expected, sinkEventAttributeSet.toString());
 
         sinkEventAttributeSet.addAttributes(SinkEventAttributeSet.CENTER);
-        expected = " decoration=boxed align=center";
+        expected = " decoration=source align=center";
         assertEquals(expected, sinkEventAttributeSet.toString());
     }
 }
diff --git a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkTestDocument.java b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkTestDocument.java
index 83573a54..c4d5d676 100644
--- a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkTestDocument.java
+++ b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkTestDocument.java
@@ -81,8 +81,8 @@ public class SinkTestDocument {
 
         generateList(sink);
 
-        sink.verbatim(SinkEventAttributeSet.BOXED);
-        sink.text("Verbatim text not contained in list item 3");
+        sink.verbatim(SinkEventAttributeSet.SOURCE);
+        sink.text("Verbatim source text not contained in list item 3");
         sink.verbatim_();
 
         generateNumberedList(sink);
@@ -258,8 +258,8 @@ public class SinkTestDocument {
         sink.definedTerm_();
         sink.definition();
         sink.text("of definition list.");
-        sink.verbatim(SinkEventAttributeSet.BOXED);
-        sink.text("Verbatim text" + eol + "                        in a box        ");
+        sink.verbatim(SinkEventAttributeSet.SOURCE);
+        sink.text("Verbatim source text" + eol + "                        in a box        ");
         sink.verbatim_();
         sink.definition_();
         sink.definitionListItem_();
diff --git a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkUtilsTest.java b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkUtilsTest.java
index 8cf0309b..f7a56a66 100644
--- a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkUtilsTest.java
+++ b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/SinkUtilsTest.java
@@ -39,14 +39,14 @@ public class SinkUtilsTest {
     public void testGetAttributeString() {
         assertEquals("", SinkUtils.getAttributeString(null));
 
-        AttributeSet att = new SinkEventAttributeSet(SinkEventAttributeSet.BOXED);
-        String expResult = " decoration=\"boxed\"";
+        AttributeSet att = new SinkEventAttributeSet(SinkEventAttributeSet.SOURCE);
+        String expResult = " decoration=\"source\"";
         String result = SinkUtils.getAttributeString(att);
         assertEquals(expResult, result);
 
         SinkEventAttributes at = new SinkEventAttributeSet(SinkEventAttributeSet.BOLD);
         at.addAttributes(att);
-        expResult = " style=\"bold\" decoration=\"boxed\"";
+        expResult = " style=\"bold\" decoration=\"source\"";
         result = SinkUtils.getAttributeString(at);
         assertEquals(expResult, result);
 
diff --git a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/TextSink.java b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/TextSink.java
index 0f422317..34c74b68 100644
--- a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/TextSink.java
+++ b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/TextSink.java
@@ -807,16 +807,16 @@ public class TextSink extends AbstractSink {
 
     @Override
     public void verbatim(SinkEventAttributes attributes) {
-        boolean boxed = false;
+        boolean source = false;
 
         if (attributes != null && attributes.isDefined(SinkEventAttributes.DECORATION)) {
-            boxed = "boxed"
+            source = "source"
                     .equals(attributes
                             .getAttribute(SinkEventAttributes.DECORATION)
                             .toString());
         }
 
-        write("begin:verbatim, boxed: " + boxed);
+        write("begin:verbatim, source: " + source);
     }
 
     @Override
diff --git a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/Xhtml5BaseSinkTest.java b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/Xhtml5BaseSinkTest.java
index d82ee3fe..530936e1 100644
--- a/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/Xhtml5BaseSinkTest.java
+++ b/doxia-core/src/test/java/org/apache/maven/doxia/sink/impl/Xhtml5BaseSinkTest.java
@@ -808,31 +808,32 @@ public class Xhtml5BaseSinkTest {
      * Test of verbatim method, of class Xhtml5BaseSink.
      */
     @Test
-    public void testVerbatim() {
+    public void testVerbatimSource() {
         try {
             sink = new Xhtml5BaseSink(writer);
 
-            sink.verbatim(SinkEventAttributeSet.BOXED);
+            sink.verbatim(SinkEventAttributeSet.SOURCE);
             sink.verbatim_();
         } finally {
             sink.close();
         }
 
-        assertEquals("<div class=\"source\">" + LS + "<pre></pre></div>", writer.toString());
+        assertEquals("<div class=\"verbatim source\">" + LS + "<pre></pre></div>", writer.toString());
 
-        checkVerbatimAttributes(attributes, "<div>" + LS + "<pre style=\"bold\"></pre></div>");
+        checkVerbatimAttributes(attributes, "<div class=\"verbatim\">" + LS + "<pre style=\"bold\"></pre></div>");
 
         final SinkEventAttributes att = new SinkEventAttributeSet(SinkEventAttributes.ID, "id");
-        checkVerbatimAttributes(att, "<div>" + LS + "<pre id=\"id\"></pre></div>");
+        checkVerbatimAttributes(att, "<div class=\"verbatim\">" + LS + "<pre id=\"id\"></pre></div>");
 
         att.addAttribute(Attribute.CLASS, "class");
-        checkVerbatimAttributes(att, "<div>" + LS + "<pre id=\"id\" class=\"class\"></pre></div>");
+        checkVerbatimAttributes(att, "<div class=\"verbatim\">" + LS + "<pre id=\"id\" class=\"class\"></pre></div>");
 
-        att.addAttribute(SinkEventAttributes.DECORATION, "boxed");
-        checkVerbatimAttributes(att, "<div class=\"source\">" + LS + "<pre id=\"id\" class=\"class\"></pre></div>");
+        att.addAttribute(SinkEventAttributes.DECORATION, "source");
+        checkVerbatimAttributes(
+                att, "<div class=\"verbatim source\">" + LS + "<pre id=\"id\" class=\"class\"></pre></div>");
 
         att.removeAttribute(Attribute.CLASS.toString());
-        checkVerbatimAttributes(att, "<div class=\"source\">" + LS + "<pre id=\"id\"></pre></div>");
+        checkVerbatimAttributes(att, "<div class=\"verbatim source\">" + LS + "<pre id=\"id\"></pre></div>");
     }
 
     private void checkVerbatimAttributes(final SinkEventAttributes att, final String expected) {
diff --git a/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptMarkup.java b/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptMarkup.java
index 3c0691cc..bf2d2d65 100644
--- a/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptMarkup.java
+++ b/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptMarkup.java
@@ -80,8 +80,8 @@ public interface AptMarkup extends TextMarkup {
     /** Syntax for the bold style start: "&lt;&lt;" */
     String BOLD_START_MARKUP = StringUtils.repeat(String.valueOf(LESS_THAN), 2);
 
-    /** Syntax for the boxed verbatim start: "+------+" */
-    String BOXED_VERBATIM_START_MARKUP = PLUS + StringUtils.repeat(String.valueOf(MINUS), 6) + PLUS;
+    /** Syntax for the verbatim source start: "+------+" */
+    String VERBATIM_SOURCE_START_MARKUP = PLUS + StringUtils.repeat(String.valueOf(MINUS), 6) + PLUS;
 
     /** Syntax for the header start: " -----" */
     String HEADER_START_MARKUP = SPACE + StringUtils.repeat(String.valueOf(MINUS), 5);
@@ -116,8 +116,8 @@ public interface AptMarkup extends TextMarkup {
     /** Syntax for the mono-spaced style start: "&lt;&lt;&lt;" */
     String MONOSPACED_START_MARKUP = StringUtils.repeat(String.valueOf(LESS_THAN), 3);
 
-    /** Syntax for the non boxed verbatim start: "------" */
-    String NON_BOXED_VERBATIM_START_MARKUP = StringUtils.repeat(String.valueOf(MINUS), 6);
+    /** Syntax for the verbatim start: "------" */
+    String VERBATIM_START_MARKUP = StringUtils.repeat(String.valueOf(MINUS), 6);
 
     /** Syntax for the non breaking space: "\ " */
     String NON_BREAKING_SPACE_MARKUP = String.valueOf(BACKSLASH) + SPACE;
@@ -146,9 +146,9 @@ public interface AptMarkup extends TextMarkup {
     /** Syntax for the table row start: "*--" */
     String TABLE_ROW_START_MARKUP = STAR + StringUtils.repeat(String.valueOf(MINUS), 2);
 
-    /** Syntax for the boxed verbatim end: "+------+" */
-    String BOXED_VERBATIM_END_MARKUP = BOXED_VERBATIM_START_MARKUP;
+    /** Syntax for the verbatim source end: "+------+" */
+    String VERBATIM_SOURCE_END_MARKUP = VERBATIM_SOURCE_START_MARKUP;
 
-    /** Syntax for the non boxed verbatim end: "------" */
-    String NON_BOXED_VERBATIM_END_MARKUP = NON_BOXED_VERBATIM_START_MARKUP;
+    /** Syntax for the verbatim end: "------" */
+    String VERBATIM_END_MARKUP = VERBATIM_START_MARKUP;
 }
diff --git a/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptParser.java b/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptParser.java
index 62e40d39..9bbdef60 100644
--- a/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptParser.java
+++ b/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptParser.java
@@ -1837,8 +1837,8 @@ public class AptParser extends AbstractTextParser implements AptMarkup {
 
     /** A Verbatim Block. */
     private class Verbatim extends Block {
-        /** boxed. */
-        private boolean boxed;
+        /** source. */
+        private boolean source;
 
         /**
          * Constructor.
@@ -1854,7 +1854,7 @@ public class AptParser extends AbstractTextParser implements AptMarkup {
 
             StringBuilder buffer = new StringBuilder();
             char firstChar = firstLine.charAt(0);
-            boxed = (firstChar == PLUS);
+            source = (firstChar == PLUS);
 
             while (AptParser.this.line != null) {
                 String l = AptParser.this.line;
@@ -1908,7 +1908,7 @@ public class AptParser extends AbstractTextParser implements AptMarkup {
 
         /** {@inheritDoc} */
         public void traverse() throws AptParseException {
-            AptParser.this.sink.verbatim(boxed ? SinkEventAttributeSet.BOXED : null);
+            AptParser.this.sink.verbatim(source ? SinkEventAttributeSet.SOURCE : null);
             AptParser.this.sink.text(text);
             AptParser.this.sink.verbatim_();
         }
diff --git a/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptSink.java b/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptSink.java
index 2c5fa544..0ce30749 100644
--- a/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptSink.java
+++ b/doxia-modules/doxia-module-apt/src/main/java/org/apache/maven/doxia/module/apt/AptSink.java
@@ -85,8 +85,8 @@ public class AptSink extends AbstractTextSink implements AptMarkup {
     /**  verbatimFlag. */
     private boolean verbatimFlag;
 
-    /**  boxed verbatim. */
-    private boolean isBoxed;
+    /**  verbatim source. */
+    private boolean isSource;
 
     /**  gridFlag for tables. */
     private boolean gridFlag;
@@ -168,7 +168,7 @@ public class AptSink extends AbstractTextSink implements AptMarkup {
         this.bufferFlag = false;
         this.itemFlag = false;
         this.verbatimFlag = false;
-        this.isBoxed = false;
+        this.isSource = false;
         this.gridFlag = false;
         this.cellCount = 0;
         this.cellJustif = null;
@@ -566,20 +566,20 @@ public class AptSink extends AbstractTextSink implements AptMarkup {
     public void verbatim(SinkEventAttributes attributes) {
         MutableAttributeSet atts = SinkUtils.filterAttributes(attributes, SinkUtils.SINK_VERBATIM_ATTRIBUTES);
 
-        boolean boxed = false;
+        boolean source = false;
 
         if (atts != null && atts.isDefined(SinkEventAttributes.DECORATION)) {
-            boxed = "boxed"
+            source = "source"
                     .equals(atts.getAttribute(SinkEventAttributes.DECORATION).toString());
         }
 
         verbatimFlag = true;
-        this.isBoxed = boxed;
+        this.isSource = source;
         write(EOL);
-        if (boxed) {
-            write(EOL + BOXED_VERBATIM_START_MARKUP + EOL);
+        if (source) {
+            write(EOL + VERBATIM_SOURCE_START_MARKUP + EOL);
         } else {
-            write(EOL + NON_BOXED_VERBATIM_START_MARKUP + EOL);
+            write(EOL + VERBATIM_START_MARKUP + EOL);
         }
     }
 
@@ -587,12 +587,12 @@ public class AptSink extends AbstractTextSink implements AptMarkup {
      * {@inheritDoc}
      */
     public void verbatim_() {
-        if (isBoxed) {
-            write(EOL + BOXED_VERBATIM_END_MARKUP + EOL);
+        if (isSource) {
+            write(EOL + VERBATIM_SOURCE_END_MARKUP + EOL);
         } else {
-            write(EOL + NON_BOXED_VERBATIM_END_MARKUP + EOL);
+            write(EOL + VERBATIM_END_MARKUP + EOL);
         }
-        isBoxed = false;
+        isSource = false;
         verbatimFlag = false;
     }
 
diff --git a/doxia-modules/doxia-module-apt/src/test/java/org/apache/maven/doxia/module/apt/AptParserTest.java b/doxia-modules/doxia-module-apt/src/test/java/org/apache/maven/doxia/module/apt/AptParserTest.java
index 1d6abba8..ee736e66 100644
--- a/doxia-modules/doxia-module-apt/src/test/java/org/apache/maven/doxia/module/apt/AptParserTest.java
+++ b/doxia-modules/doxia-module-apt/src/test/java/org/apache/maven/doxia/module/apt/AptParserTest.java
@@ -164,9 +164,9 @@ public class AptParserTest extends AbstractParserTest {
     }
 
     @Test
-    public void testBoxedVerbatim() throws Exception {
-        String text = "+--" + EOL + "boxed verbatim" + EOL + "+--" + EOL + "---" + EOL + "un-boxed verbatim" + EOL
-                + "---" + EOL;
+    public void testVerbatimSource() throws Exception {
+        String text =
+                "+--" + EOL + "verbatim source" + EOL + "+--" + EOL + "---" + EOL + "verbatim" + EOL + "---" + EOL;
 
         SinkEventTestingSink sink = new SinkEventTestingSink();
 
@@ -175,7 +175,7 @@ public class AptParserTest extends AbstractParserTest {
         Iterator<SinkEventElement> it = sink.getEventList().iterator();
 
         assertSinkStartsWith(it, "head", "head_", "body");
-        assertSinkEquals(it.next(), "verbatim", SinkEventAttributeSet.BOXED);
+        assertSinkEquals(it.next(), "verbatim", SinkEventAttributeSet.SOURCE);
         assertSinkStartsWith(it, "text", "verbatim_");
 
         assertSinkEquals(it.next(), "verbatim", new Object[] {null});
diff --git a/doxia-modules/doxia-module-apt/src/test/java/org/apache/maven/doxia/module/apt/AptSinkTest.java b/doxia-modules/doxia-module-apt/src/test/java/org/apache/maven/doxia/module/apt/AptSinkTest.java
index 12f7a871..be173c8c 100644
--- a/doxia-modules/doxia-module-apt/src/test/java/org/apache/maven/doxia/module/apt/AptSinkTest.java
+++ b/doxia-modules/doxia-module-apt/src/test/java/org/apache/maven/doxia/module/apt/AptSinkTest.java
@@ -218,14 +218,14 @@ public class AptSinkTest extends AbstractSinkTest {
     }
 
     /** {@inheritDoc} */
-    protected String getVerbatimBlock(String text) {
+    protected String getVerbatimSourceBlock(String text) {
         return EOL
                 + EOL
-                + AptMarkup.BOXED_VERBATIM_START_MARKUP
+                + AptMarkup.VERBATIM_SOURCE_START_MARKUP
                 + EOL
                 + text
                 + EOL
-                + AptMarkup.BOXED_VERBATIM_START_MARKUP
+                + AptMarkup.VERBATIM_SOURCE_START_MARKUP
                 + EOL;
     }
 
diff --git a/doxia-modules/doxia-module-fml/src/main/java/org/apache/maven/doxia/module/fml/FmlContentParser.java b/doxia-modules/doxia-module-fml/src/main/java/org/apache/maven/doxia/module/fml/FmlContentParser.java
index d58af18a..a6aac363 100644
--- a/doxia-modules/doxia-module-fml/src/main/java/org/apache/maven/doxia/module/fml/FmlContentParser.java
+++ b/doxia-modules/doxia-module-fml/src/main/java/org/apache/maven/doxia/module/fml/FmlContentParser.java
@@ -52,7 +52,7 @@ public class FmlContentParser extends Xhtml5BaseParser implements FmlMarkup {
         } else if (parser.getName().equals(SOURCE_TAG.toString())) {
             verbatim();
 
-            sink.verbatim(SinkEventAttributeSet.BOXED);
+            sink.verbatim(SinkEventAttributeSet.SOURCE);
         } else if (!baseStartTag(parser, sink)) {
             if (isEmptyElement) {
                 handleUnknown(parser, sink, TAG_TYPE_SIMPLE);
diff --git a/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownMarkup.java b/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownMarkup.java
index e0b4d508..f77db838 100644
--- a/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownMarkup.java
+++ b/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownMarkup.java
@@ -100,8 +100,8 @@ public interface MarkdownMarkup extends TextMarkup {
     /** Syntax for the mono-spaced style start: "`" */
     String MONOSPACED_START_MARKUP = "`";
 
-    /** Syntax for the non boxed verbatim start: "```" */
-    String NON_BOXED_VERBATIM_START_MARKUP = "```";
+    /** Syntax for the verbatim start: "```" */
+    String VERBATIM_START_MARKUP = "```";
 
     /** Syntax for the non breaking space: "\ " */
     String NON_BREAKING_SPACE_MARKUP = String.valueOf(BACKSLASH) + SPACE;
@@ -127,6 +127,6 @@ public interface MarkdownMarkup extends TextMarkup {
     /** Syntax for the table row end: "|" */
     String TABLE_ROW_SEPARATOR_MARKUP = String.valueOf(PIPE);
 
-    /** Syntax for the non boxed verbatim end: "```" */
-    String NON_BOXED_VERBATIM_END_MARKUP = "```";
+    /** Syntax for the verbatim end: "```" */
+    String VERBATIM_END_MARKUP = "```";
 }
diff --git a/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownParser.java b/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownParser.java
index 04a2894e..2b454ed1 100644
--- a/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownParser.java
+++ b/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownParser.java
@@ -244,9 +244,8 @@ public class MarkdownParser extends AbstractTextParser implements TextMarkup {
      * 2 special things:
      * <ul>
      * <li> DIV elements are translated as Unknown Sink events
-     * <li> PRE elements are all considered as boxed
      * </ul>
-     * PRE elements need to be "boxed" because the Xhtml5Sink will surround the
+     * PRE elements need to be "source" because the Xhtml5Sink will surround the
      * corresponding verbatim() Sink event with a DIV element with class="source",
      * which is how most Maven Skin (incl. Fluido) recognize a block of code, which
      * needs to be highlighted accordingly.
@@ -260,7 +259,6 @@ public class MarkdownParser extends AbstractTextParser implements TextMarkup {
         @Override
         protected void init() {
             super.init();
-            super.boxed = true;
         }
 
         @Override
@@ -281,7 +279,6 @@ public class MarkdownParser extends AbstractTextParser implements TextMarkup {
             if (!visited) {
                 if (parser.getName().equals(HtmlMarkup.DIV.toString())) {
                     handleUnknown(parser, sink, TAG_TYPE_START);
-                    super.boxed = true;
                     visited = true;
                 }
             }
diff --git a/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownSink.java b/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownSink.java
index 59a56a17..740a2593 100644
--- a/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownSink.java
+++ b/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownSink.java
@@ -542,14 +542,14 @@ public class MarkdownSink extends AbstractTextSink implements MarkdownMarkup {
     public void verbatim(SinkEventAttributes attributes) {
         write(EOL);
         verbatimFlag = true;
-        write(EOL + NON_BOXED_VERBATIM_START_MARKUP + EOL);
+        write(EOL + VERBATIM_START_MARKUP + EOL);
     }
 
     /**
      * {@inheritDoc}
      */
     public void verbatim_() {
-        write(EOL + NON_BOXED_VERBATIM_END_MARKUP + EOL);
+        write(EOL + VERBATIM_END_MARKUP + EOL);
         verbatimFlag = false;
     }
 
diff --git a/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownParserTest.java b/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownParserTest.java
index cbb25ac7..c6362665 100644
--- a/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownParserTest.java
+++ b/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownParserTest.java
@@ -206,11 +206,11 @@ public class MarkdownParserTest extends AbstractParserTest {
         assertFalse(it.hasNext());
 
         // PRE element must be a "verbatim" Sink event that specifies
-        // BOXED = true
+        // SOURCE = true
         SinkEventElement pre = eventList.get(7);
         assertEquals("verbatim", pre.getName());
         SinkEventAttributeSet preAtts = (SinkEventAttributeSet) pre.getArgs()[0];
-        assertTrue(preAtts.containsAttribute(SinkEventAttributes.DECORATION, "boxed"));
+        assertFalse(preAtts.containsAttribute(SinkEventAttributes.DECORATION, "source"));
 
         // * CODE element must be an "inline" Sink event that specifies:
         // * SEMANTICS = "code" and CLASS = "language-java"
diff --git a/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownSinkTest.java b/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownSinkTest.java
index bc6c212f..4cd8b75b 100644
--- a/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownSinkTest.java
+++ b/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownSinkTest.java
@@ -209,14 +209,14 @@ public class MarkdownSinkTest extends AbstractSinkTest {
     }
 
     /** {@inheritDoc} */
-    protected String getVerbatimBlock(String text) {
+    protected String getVerbatimSourceBlock(String text) {
         return EOL
                 + EOL
-                + MarkdownMarkup.NON_BOXED_VERBATIM_START_MARKUP
+                + MarkdownMarkup.VERBATIM_START_MARKUP
                 + EOL
                 + text
                 + EOL
-                + MarkdownMarkup.NON_BOXED_VERBATIM_START_MARKUP
+                + MarkdownMarkup.VERBATIM_START_MARKUP
                 + EOL;
     }
 
diff --git a/doxia-modules/doxia-module-xdoc/src/main/java/org/apache/maven/doxia/module/xdoc/XdocParser.java b/doxia-modules/doxia-module-xdoc/src/main/java/org/apache/maven/doxia/module/xdoc/XdocParser.java
index b04d3b80..a67e90af 100644
--- a/doxia-modules/doxia-module-xdoc/src/main/java/org/apache/maven/doxia/module/xdoc/XdocParser.java
+++ b/doxia-modules/doxia-module-xdoc/src/main/java/org/apache/maven/doxia/module/xdoc/XdocParser.java
@@ -158,7 +158,7 @@ public class XdocParser extends Xhtml5BaseParser implements XdocMarkup {
         } else if (parser.getName().equals(SOURCE_TAG.toString())) {
             verbatim();
 
-            attribs.addAttributes(SinkEventAttributeSet.BOXED);
+            attribs.addAttributes(SinkEventAttributeSet.SOURCE);
 
             sink.verbatim(attribs);
         } else if (parser.getName().equals(PROPERTIES_TAG.toString())) {
diff --git a/doxia-modules/doxia-module-xdoc/src/main/java/org/apache/maven/doxia/module/xdoc/XdocSink.java b/doxia-modules/doxia-module-xdoc/src/main/java/org/apache/maven/doxia/module/xdoc/XdocSink.java
index cbbe8051..b5762771 100644
--- a/doxia-modules/doxia-module-xdoc/src/main/java/org/apache/maven/doxia/module/xdoc/XdocSink.java
+++ b/doxia-modules/doxia-module-xdoc/src/main/java/org/apache/maven/doxia/module/xdoc/XdocSink.java
@@ -44,8 +44,8 @@ public class XdocSink extends Xhtml5BaseSink implements XdocMarkup {
     // Instance fields
     // ----------------------------------------------------------------------
 
-    /** An indication on if we're inside a box (verbatim). */
-    private boolean boxedFlag;
+    /** An indication on if we're inside verbatim source. */
+    private boolean sourceFlag;
 
     private String encoding;
 
@@ -105,7 +105,7 @@ public class XdocSink extends Xhtml5BaseSink implements XdocMarkup {
     protected void init() {
         super.init();
 
-        boxedFlag = false;
+        sourceFlag = false;
     }
 
     /**
@@ -359,15 +359,15 @@ public class XdocSink extends Xhtml5BaseSink implements XdocMarkup {
             atts = new SinkEventAttributeSet();
         }
 
-        boolean boxed = false;
+        boolean source = false;
 
         if (atts.isDefined(SinkEventAttributes.DECORATION)) {
-            boxedFlag = boxed = "boxed".equals(atts.getAttribute(SinkEventAttributes.DECORATION));
+            sourceFlag = source = "source".equals(atts.getAttribute(SinkEventAttributes.DECORATION));
         }
 
         atts.removeAttribute(SinkEventAttributes.DECORATION);
 
-        if (boxed) {
+        if (source) {
             writeStartTag(SOURCE_TAG, atts);
         } else {
             writeStartTag(PRE, atts);
@@ -381,7 +381,7 @@ public class XdocSink extends Xhtml5BaseSink implements XdocMarkup {
      * @see javax.swing.text.html.HTML.Tag#PRE
      */
     public void verbatim_() {
-        if (boxedFlag) {
+        if (sourceFlag) {
             writeEndTag(SOURCE_TAG);
         } else {
             writeEndTag(PRE);
@@ -389,7 +389,7 @@ public class XdocSink extends Xhtml5BaseSink implements XdocMarkup {
 
         setVerbatimFlag(false);
 
-        boxedFlag = false;
+        sourceFlag = false;
     }
 
     /**
diff --git a/doxia-modules/doxia-module-xdoc/src/test/java/org/apache/maven/doxia/module/xdoc/XdocSinkTest.java b/doxia-modules/doxia-module-xdoc/src/test/java/org/apache/maven/doxia/module/xdoc/XdocSinkTest.java
index e2cbfb99..ee951c3b 100644
--- a/doxia-modules/doxia-module-xdoc/src/test/java/org/apache/maven/doxia/module/xdoc/XdocSinkTest.java
+++ b/doxia-modules/doxia-module-xdoc/src/test/java/org/apache/maven/doxia/module/xdoc/XdocSinkTest.java
@@ -239,7 +239,7 @@ public class XdocSinkTest extends AbstractSinkTest {
     }
 
     /** {@inheritDoc} */
-    protected String getVerbatimBlock(String text) {
+    protected String getVerbatimSourceBlock(String text) {
         return "<source>" + text + "</source>";
     }
 
@@ -328,7 +328,7 @@ public class XdocSinkTest extends AbstractSinkTest {
      * Test verbatim.
      */
     @Test
-    public void testBoxedVerbatim() {
+    public void testVerbatimSource() {
         Writer writer = new StringWriter();
         XdocSink sink = null;
 
@@ -337,7 +337,7 @@ public class XdocSinkTest extends AbstractSinkTest {
 
             sink.verbatim(null);
             sink.verbatim_();
-            sink.verbatim(SinkEventAttributeSet.BOXED);
+            sink.verbatim(SinkEventAttributeSet.SOURCE);
             sink.verbatim_();
         } finally {
             sink.close();
diff --git a/doxia-modules/doxia-module-xhtml5/src/main/java/org/apache/maven/doxia/module/xhtml5/Xhtml5Parser.java b/doxia-modules/doxia-module-xhtml5/src/main/java/org/apache/maven/doxia/module/xhtml5/Xhtml5Parser.java
index 1ae9cc64..872e6364 100644
--- a/doxia-modules/doxia-module-xhtml5/src/main/java/org/apache/maven/doxia/module/xhtml5/Xhtml5Parser.java
+++ b/doxia-modules/doxia-module-xhtml5/src/main/java/org/apache/maven/doxia/module/xhtml5/Xhtml5Parser.java
@@ -51,8 +51,8 @@ import org.slf4j.LoggerFactory;
 public class Xhtml5Parser extends Xhtml5BaseParser implements Xhtml5Markup {
     private static final Logger LOGGER = LoggerFactory.getLogger(Xhtml5Parser.class);
 
-    /** For boxed verbatim. */
-    protected boolean boxed;
+    /** For verbatim source. */
+    protected boolean source;
 
     /** Empty elements don't write a closing tag. */
     private boolean isEmptyElement;
@@ -106,10 +106,10 @@ public class Xhtml5Parser extends Xhtml5BaseParser implements Xhtml5Markup {
         } else if (parser.getName().equals(BODY.toString())) {
             sink.body(attribs);
         } else if (parser.getName().equals(DIV.toString())) {
-            String divclass = parser.getAttributeValue(null, Attribute.CLASS.toString());
+            String divClass = parser.getAttributeValue(null, Attribute.CLASS.toString());
 
-            if ("source".equals(divclass)) {
-                this.boxed = true;
+            if ("verbatim source".equals(divClass)) {
+                this.source = true;
             }
 
             baseStartTag(parser, sink); // pick up other divs
@@ -125,8 +125,8 @@ public class Xhtml5Parser extends Xhtml5BaseParser implements Xhtml5Markup {
          * in the content of a PRE element.
          */
         else if (parser.getName().equals(PRE.toString())) {
-            if (boxed) {
-                attribs.addAttributes(SinkEventAttributeSet.BOXED);
+            if (source) {
+                attribs.addAttributes(SinkEventAttributeSet.SOURCE);
             }
 
             verbatim();
@@ -164,7 +164,7 @@ public class Xhtml5Parser extends Xhtml5BaseParser implements Xhtml5Markup {
         } else if (parser.getName().equals(ADDRESS.toString())) {
             sink.address_();
         } else if (parser.getName().equals(DIV.toString())) {
-            this.boxed = false;
+            this.source = false;
             baseEndTag(parser, sink);
         } else if (!baseEndTag(parser, sink)) {
             if (!isEmptyElement) {
@@ -263,7 +263,7 @@ public class Xhtml5Parser extends Xhtml5BaseParser implements Xhtml5Markup {
     protected void init() {
         super.init();
 
-        this.boxed = false;
+        this.source = false;
         this.isEmptyElement = false;
     }
 
diff --git a/doxia-modules/doxia-module-xhtml5/src/test/java/org/apache/maven/doxia/module/xhtml5/Xhtml5SinkTest.java b/doxia-modules/doxia-module-xhtml5/src/test/java/org/apache/maven/doxia/module/xhtml5/Xhtml5SinkTest.java
index 3b14f006..f1dc2916 100644
--- a/doxia-modules/doxia-module-xhtml5/src/test/java/org/apache/maven/doxia/module/xhtml5/Xhtml5SinkTest.java
+++ b/doxia-modules/doxia-module-xhtml5/src/test/java/org/apache/maven/doxia/module/xhtml5/Xhtml5SinkTest.java
@@ -235,8 +235,8 @@ public class Xhtml5SinkTest extends AbstractSinkTest {
     }
 
     /** {@inheritDoc} */
-    protected String getVerbatimBlock(String text) {
-        return "<div class=\"source\">\n<pre>" + text + "</pre></div>";
+    protected String getVerbatimSourceBlock(String text) {
+        return "<div class=\"verbatim source\">\n<pre>" + text + "</pre></div>";
     }
 
     /** {@inheritDoc} */
diff --git a/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java b/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java
index 02ba98a7..8a0021f6 100644
--- a/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java
+++ b/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/Sink.java
@@ -1341,7 +1341,7 @@ public interface Sink {
      *   Supported attributes are the {@link SinkEventAttributes base attributes} plus:
      * </p>
      * <blockquote>
-     *   {@link SinkEventAttributes#DECORATION DECORATION} (value: "boxed"),
+     *   {@link SinkEventAttributes#DECORATION DECORATION} (values: "source"),
      *   {@link SinkEventAttributes#ALIGN ALIGN}, {@link SinkEventAttributes#WIDTH WIDTH}.
      * </blockquote>
      *
diff --git a/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/SinkEventAttributes.java b/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/SinkEventAttributes.java
index 2ec34095..38a30e43 100644
--- a/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/SinkEventAttributes.java
+++ b/doxia-sink-api/src/main/java/org/apache/maven/doxia/sink/SinkEventAttributes.java
@@ -350,7 +350,7 @@ public interface SinkEventAttributes extends MutableAttributeSet {
      * Specifies a decoration for an element.
      *
      * <p>
-     *   Generally accepted values are "underline", "overline", "line-through", "boxed".
+     *   Generally accepted values are "underline", "overline", "line-through", "source".
      * </p>
      */
     String DECORATION = "decoration";