svn commit: r776298 - /maven/doxia/site/src/site/xdoc/references/xdoc-format.xml

Tue, 19 May 2009 05:58:42 -0700 

Author: ltheussl
Date: Tue May 19 12:58:17 2009
New Revision: 776298

URL: http://svn.apache.org/viewvc?rev=776298&view=rev
Log:
Add a section about source tag

Modified:
    maven/doxia/site/src/site/xdoc/references/xdoc-format.xml

Modified: maven/doxia/site/src/site/xdoc/references/xdoc-format.xml
URL: 
http://svn.apache.org/viewvc/maven/doxia/site/src/site/xdoc/references/xdoc-format.xml?rev=776298&r1=776297&r2=776298&view=diff
==============================================================================
--- maven/doxia/site/src/site/xdoc/references/xdoc-format.xml (original)
+++ maven/doxia/site/src/site/xdoc/references/xdoc-format.xml Tue May 19 
12:58:17 2009
@@ -29,6 +29,14 @@
   </properties>
 
   <body>
+
+    <section name="Content">
+      <macro name="toc">
+        <param name="fromDepth" value="1"/>
+        <param name="toDepth" value="2"/>
+      </macro>
+    </section>
+
     <section name="The XDoc format">
       <subsection name="Overview">
         <p>
@@ -105,6 +113,17 @@
 
       </subsection>
 
+      <subsection name="The &lt;source&gt; tag">
+        <p>
+        <code>&lt;source&gt;</code> tags are special.
+        Anything within this tag is rendered within a "verbatim box" as 
pre-formatted text.
+        If you are embedding other XML/XHTML markup
+        within the source tags, then you need to place a CDATA section within
+        the source section. Example:
+        </p>
+<source>&lt;source&gt;&lt;![CDATA[ content here &lt;a 
href=""&gt;foo&lt;/a&gt;]]&gt;&lt;/source&gt;</source>
+      </subsection>
+
       <subsection name="Additional sectioning">
         <p>
           Doxia will produce <code>&lt;h2&gt;</code> and

Reply via email to