[DOXIA-521] improved comment to define why Pegdown html output has to be tweaked to match Doxia Xhtml Sink convention

git-svn-id: https://svn.apache.org/repos/asf/maven/doxia/doxia/trunk@1726934 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownToDoxiaHtmlSerializer.java b/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownToDoxiaHtmlSerializer.java
index a636d0f..8068d42 100644
--- a/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownToDoxiaHtmlSerializer.java
+++ b/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownToDoxiaHtmlSerializer.java
@@ -43,7 +43,9 @@
     @Override
     public void visit( VerbatimNode node )
     {
-        printer.println().print( "<div class=\"source\"><pre>" ); // better than "<pre><code>" from Pegdown
+        // Pegdown renders verbatim as "<pre><code>", but Doxia base Xhtml Sink renders as "<div class=..><pre>"
+        // see XhtmlBaseParser.verbatim() implementation
+        printer.println().print( "<div class=\"source\"><pre>" );
         String text = node.getText();
         // print HTML breaks for all initial newlines
         while ( text.charAt( 0 ) == '\n' )