From 1703eeda1546e5360b50d9af512fd388589089b0 Mon Sep 17 00:00:00 2001
From: ltheussl <ltheussl@13f79535-47bb-0310-9956-ffa450edef68>
Date: Sat, 1 Oct 2005 00:00:05 +0000
Subject: [PATCH] Doc update

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@292879 13f79535-47bb-0310-9956-ffa450edef68
---
 xdoc/xdocs/reference/xdocs.xml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/xdoc/xdocs/reference/xdocs.xml b/xdoc/xdocs/reference/xdocs.xml
index ee9b8a3f..2eb4baac 100644
--- a/xdoc/xdocs/reference/xdocs.xml
+++ b/xdoc/xdocs/reference/xdocs.xml
@@ -197,6 +197,23 @@
         </p>
       </subsection>
 
+      <subsection name="Dont put &lt;source&gt; inside paragraphs">
+        <p>Wrong:</p>
+        <source><![CDATA[<p>
+  The following command executes the program:
+  <source>java -jar CoolApp.jar</source>
+</p>]]></source>
+        <p>Correct:</p>
+        <source><![CDATA[<p>
+  The following command executes the program:
+</p>
+<source>java -jar CoolApp.jar</source>]]></source>
+        <p>
+          However, you may put <code>&lt;source&gt;</code> elements inside
+          list items or table rows.
+        </p>
+      </subsection>
+
     </section>
 
     <navbar prev="navfile.html" home="../index.html" next="i18n.html"/>