From 79f0d3a99a7f79e2c9389fc711721eab191aae01 Mon Sep 17 00:00:00 2001
From: Brett Morgan <brett@brettmorgan.net>
Date: Thu, 23 Jul 2015 11:12:07 -0400
Subject: [PATCH] added fix for components.xml merging.  If the description tag
 contained embedded html, it needs to be escaped in the resulting merged
 components.xml.

---
 leiningen-core/pom.xml                        |  14 +-
 src/leiningen/uberjar.clj                     |  26 +-
 test/leiningen/test/uberjar.clj               |  18 +-
 .../components1.xml                           |  73 +++
 .../components2.xml                           | 218 ++++++++
 .../expected-components.xml                   | 516 ++++++++++++++++++
 6 files changed, 854 insertions(+), 11 deletions(-)
 create mode 100644 test_projects/uberjar-components-merging/components1.xml
 create mode 100644 test_projects/uberjar-components-merging/components2.xml
 create mode 100644 test_projects/uberjar-components-merging/expected-components.xml

diff --git a/leiningen-core/pom.xml b/leiningen-core/pom.xml
index 6f2b48bc..50fd4560 100644
--- a/leiningen-core/pom.xml
+++ b/leiningen-core/pom.xml
@@ -3,7 +3,7 @@
   <groupId>leiningen-core</groupId>
   <artifactId>leiningen-core</artifactId>
   <packaging>jar</packaging>
-  <version>2.5.1</version>
+  <version>2.5.2-SNAPSHOT</version>
   <name>leiningen-core</name>
   <description>Library for core functionality of Leiningen.</description>
   <url>https://github.com/technomancy/leiningen</url>
@@ -14,11 +14,11 @@
     </license>
   </licenses>
   <scm>
-    <connection>scm:git:git://github.com/technomancy/leiningen.git</connection>
-    <developerConnection>scm:git:ssh://git@github.com/technomancy/leiningen.git</developerConnection>
-    <tag>f48846ff3cce9158d2c8ec5e6b488d45d74d286d
+    <connection>scm:git:git://github.com/towler73/leiningen.git</connection>
+    <developerConnection>scm:git:ssh://git@github.com/towler73/leiningen.git</developerConnection>
+    <tag>7045e666e10bfe4dbb6630b497fd94dbc257519f
 </tag>
-    <url>https://github.com/technomancy/leiningen</url>
+    <url>https://github.com/towler73/leiningen</url>
   </scm>
   <build>
     <sourceDirectory>src</sourceDirectory>
@@ -43,7 +43,7 @@
   <repositories>
     <repository>
       <id>central</id>
-      <url>http://repo1.maven.org/maven2/</url>
+      <url>https://repo1.maven.org/maven2/</url>
       <snapshots>
         <enabled>false</enabled>
       </snapshots>
@@ -106,7 +106,7 @@
     <dependency>
       <groupId>org.clojure</groupId>
       <artifactId>tools.nrepl</artifactId>
-      <version>0.2.3</version>
+      <version>0.2.6</version>
       <exclusions>
         <exclusion>
           <groupId>org.clojure</groupId>
diff --git a/src/leiningen/uberjar.clj b/src/leiningen/uberjar.clj
index 2e2d450e..74fe1c59 100644
--- a/src/leiningen/uberjar.clj
+++ b/src/leiningen/uberjar.clj
@@ -15,10 +15,30 @@
            (java.util.zip ZipFile ZipOutputStream ZipEntry)
            (org.apache.commons.io.output CloseShieldOutputStream)))
 
+(defn- tree-edit
+  "Walk the componment xml dom looking for description tag"
+  [zipper editor]
+  (loop [loc zipper]
+    (if (zip/end? loc)
+      (zip/root loc)
+      (if (= :description (:tag (zip/node loc)))
+        (let [new-loc (zip/edit loc editor)]
+          (recur (zip/next new-loc)))
+        (recur (zip/next loc))))))
+
+(defn- html-escape-editor
+  "Escape <,>,& from content"
+  [node]
+  (let [content (get (:content node) 0)]
+    (if-not (nil? content)
+      (assoc-in node [:content 0] (clojure.string/escape content {\< "&lt;" \> "&gt;" \& "&amp;" \" "&quot;"}))
+      node)))
+
 (defn- components-read [ins]
-  (->> ins xml/parse zip/xml-zip zip/children
-       (filter #(= (:tag %) :components))
-       first :content))
+  (let [zipper (->> ins xml/parse zip/xml-zip)]
+    (->> (tree-edit zipper html-escape-editor) zip/xml-zip zip/children
+         (filter #(= (:tag %) :components))
+         first :content)))
 
 (defn- components-write [out components]
   (binding [*out* (PrintWriter. out)]
diff --git a/test/leiningen/test/uberjar.clj b/test/leiningen/test/uberjar.clj
index 49897437..4479b403 100644
--- a/test/leiningen/test/uberjar.clj
+++ b/test/leiningen/test/uberjar.clj
@@ -2,10 +2,11 @@
   (:require [leiningen.uberjar :refer :all]
             [clojure.test :refer :all]
             [clojure.java.shell :refer [sh]]
+            [clojure.xml :as xml]
             [leiningen.test.helper :refer [sample-no-aot-project
                                            uberjar-merging-project
                                            provided-project]])
-  (:import (java.io File)
+  (:import (java.io File FileOutputStream)
            (java.util.zip ZipFile)))
 
 (deftest test-uberjar
@@ -41,6 +42,21 @@
                     (.getInputStream zf)
                     slurp read-string)))))))
 
+(deftest test-components-merger
+  (let [file1 (str "test_projects/uberjar-components-merging/components1.xml")
+        file2 (str "test_projects/uberjar-components-merging/components2.xml")
+        readxml (components-merger 0)
+        combine (components-merger 1)
+        writexml (components-merger 2)
+        combined-xml (combine (readxml file1) (readxml file2))
+        expected-xml (xml/parse "test_projects/uberjar-components-merging/expected-components.xml")
+        result-file "test_projects/uberjar-components-merging/result-components.xml"
+        out-file (FileOutputStream. (File. result-file))]
+      (writexml out-file combined-xml)
+      (is (= expected-xml (xml/parse result-file)))
+    )
+    )
+
 ;; TODO: this breaks on Java 6
 (deftest ^:disabled test-uberjar-provided
   (let [bootclasspath "-Xbootclasspath/a:leiningen-core/lib/clojure-1.4.0.jar"
diff --git a/test_projects/uberjar-components-merging/components1.xml b/test_projects/uberjar-components-merging/components1.xml
new file mode 100644
index 00000000..8cf00aa7
--- /dev/null
+++ b/test_projects/uberjar-components-merging/components1.xml
@@ -0,0 +1,73 @@
+<component-set>
+  <components>
+    <component>
+      <role>org.apache.maven.doxia.Doxia</role>
+      <implementation>org.apache.maven.doxia.DefaultDoxia</implementation>
+      <description>Simple implementation of the Doxia interface:
+uses a ParserManager to lookup a parser.</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.parser.manager.ParserManager</role>
+          <field-name>parserManager</field-name>
+        </requirement>
+      </requirements>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.Macro</role>
+      <role-hint>echo</role-hint>
+      <implementation>org.apache.maven.doxia.macro.EchoMacro</implementation>
+      <description>A simple macro that prints out the key and value of some supplied parameters.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.manager.MacroManager</role>
+      <implementation>org.apache.maven.doxia.macro.manager.DefaultMacroManager</implementation>
+      <description>Default implementation of &lt;code&gt;MacroManager&lt;/code&gt;</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.macro.Macro</role>
+          <field-name>macros</field-name>
+        </requirement>
+      </requirements>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.Macro</role>
+      <role-hint>snippet</role-hint>
+      <implementation>org.apache.maven.doxia.macro.snippet.SnippetMacro</implementation>
+      <description>A macro that prints out the content of a file or a URL.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.Macro</role>
+      <role-hint>swf</role-hint>
+      <implementation>org.apache.maven.doxia.macro.SwfMacro</implementation>
+      <description>Macro for embedding Flash (SWF) within Maven documentation.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.Macro</role>
+      <role-hint>toc</role-hint>
+      <implementation>org.apache.maven.doxia.macro.toc.TocMacro</implementation>
+      <description>Macro to display a &lt;code&gt;Table Of Content&lt;/code&gt; in a given &lt;code&gt;Sink&lt;/code&gt;.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.module.site.manager.SiteModuleManager</role>
+      <implementation>org.apache.maven.doxia.module.site.manager.DefaultSiteModuleManager</implementation>
+      <description>Simple implementation of the SiteModuleManager interface.</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.module.site.SiteModule</role>
+          <field-name>siteModules</field-name>
+        </requirement>
+      </requirements>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.parser.manager.ParserManager</role>
+      <implementation>org.apache.maven.doxia.parser.manager.DefaultParserManager</implementation>
+      <description>Simple implementation of the &lt;code&gt;ParserManager&lt;/code&gt; interface.</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.parser.Parser</role>
+          <field-name>parsers</field-name>
+        </requirement>
+      </requirements>
+    </component>
+  </components>
+</component-set>
diff --git a/test_projects/uberjar-components-merging/components2.xml b/test_projects/uberjar-components-merging/components2.xml
new file mode 100644
index 00000000..914663bc
--- /dev/null
+++ b/test_projects/uberjar-components-merging/components2.xml
@@ -0,0 +1,218 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+
+<component-set>
+  <!-- Doxia core -->
+  <components>
+    <component>
+      <role>org.apache.maven.doxia.macro.Macro</role>
+      <role-hint>echo</role-hint>
+      <implementation>org.apache.maven.doxia.macro.EchoMacro</implementation>
+      <description>A simple macro that prints out the key and value of some supplied
+      parameters.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.manager.MacroManager</role>
+      <implementation>org.apache.maven.doxia.macro.manager.DefaultMacroManager</implementation>
+      <description>Default implementation of &lt;code&gt;MacroManager&lt;/code&gt;</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.macro.Macro</role>
+          <field-name>macros</field-name>
+        </requirement>
+      </requirements>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.Macro</role>
+      <role-hint>snippet</role-hint>
+      <implementation>org.apache.maven.doxia.macro.snippet.SnippetMacro</implementation>
+      <description>A macro that prints out the content of a file or a URL.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.Macro</role>
+      <role-hint>swf</role-hint>
+      <implementation>org.apache.maven.doxia.macro.SwfMacro</implementation>
+      <description>Macro for embedding Flash (SWF) within Maven documentation.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.macro.Macro</role>
+      <role-hint>toc</role-hint>
+      <implementation>org.apache.maven.doxia.macro.toc.TocMacro</implementation>
+      <description>Macro to display a &lt;code&gt;Table Of Content&lt;/code&gt; in a
+        given &lt;code&gt;Sink&lt;/code&gt;.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.parser.manager.ParserManager</role>
+      <implementation>org.apache.maven.doxia.parser.manager.DefaultParserManager</implementation>
+      <description>Simple implementation of the
+        &lt;code&gt;ParserManager&lt;/code&gt; interface.</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.parser.Parser</role>
+          <field-name>parsers</field-name>
+        </requirement>
+      </requirements>
+    </component>
+
+    <!-- Doxia apt -->
+    <component>
+      <role>org.apache.maven.doxia.parser.Parser</role>
+      <role-hint>apt</role-hint>
+      <implementation>org.apache.maven.doxia.module.apt.AptParser</implementation>
+      <description>The APT parser.</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.macro.manager.MacroManager</role>
+          <field-name>macroManager</field-name>
+        </requirement>
+      </requirements>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>apt</role-hint>
+      <implementation>org.apache.maven.doxia.module.apt.AptSinkFactory</implementation>
+      <description>APT implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia confluence -->
+    <component>
+      <role>org.apache.maven.doxia.parser.Parser</role>
+      <role-hint>confluence</role-hint>
+      <implementation>org.apache.maven.doxia.module.confluence.ConfluenceParser</implementation>
+      <description>Parse the &lt;a href=&quot;http://www.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>confluence</role-hint>
+      <implementation>org.apache.maven.doxia.module.confluence.ConfluenceSinkFactory</implementation>
+      <description>Confluence implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia docbook -->
+    <component>
+      <role>org.apache.maven.doxia.parser.Parser</role>
+      <role-hint>docbook</role-hint>
+      <implementation>org.apache.maven.doxia.module.docbook.DocBookParser</implementation>
+      <description>Parse a &lt;code&gt;Docbook&lt;/code&gt; document and emit events
+        into the specified doxia Sink.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>docbook</role-hint>
+      <implementation>org.apache.maven.doxia.module.docbook.DocbookSinkFactory</implementation>
+      <description>Docbook implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia fml -->
+    <component>
+      <role>org.apache.maven.doxia.parser.Parser</role>
+      <role-hint>fml</role-hint>
+      <implementation>org.apache.maven.doxia.module.fml.FmlParser</implementation>
+      <description>Parse a fml model and emit events into the specified doxia Sink.</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.macro.manager.MacroManager</role>
+          <field-name>macroManager</field-name>
+        </requirement>
+      </requirements>
+    </component>
+
+    <!-- Doxia fo -->
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>fo</role-hint>
+      <implementation>org.apache.maven.doxia.module.fo.FoSinkFactory</implementation>
+      <description>FO implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia itext -->
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>itext</role-hint>
+      <implementation>org.apache.maven.doxia.module.itext.ITextSinkFactory</implementation>
+      <description>IText implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia latex -->
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>latex</role-hint>
+      <implementation>org.apache.maven.doxia.module.latex.LatexSinkFactory</implementation>
+      <description>Latex implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia rtf -->
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>rtf</role-hint>
+      <implementation>org.apache.maven.doxia.module.rtf.RtfSinkFactory</implementation>
+      <description>APT implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia twiki -->
+    <component>
+      <role>org.apache.maven.doxia.parser.Parser</role>
+      <role-hint>twiki</role-hint>
+      <implementation>org.apache.maven.doxia.module.twiki.TWikiParser</implementation>
+      <description>Parse the &lt;a href=&quot;http://twiki.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>twiki</role-hint>
+      <implementation>org.apache.maven.doxia.module.twiki.TWikiSinkFactory</implementation>
+      <description>TWiki implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia xdoc -->
+    <component>
+      <role>org.apache.maven.doxia.parser.Parser</role>
+      <role-hint>xdoc</role-hint>
+      <implementation>org.apache.maven.doxia.module.xdoc.XdocParser</implementation>
+      <description>Parse an xdoc model and emit events into the specified doxia Sink.</description>
+      <requirements>
+        <requirement>
+          <role>org.apache.maven.doxia.macro.manager.MacroManager</role>
+          <field-name>macroManager</field-name>
+        </requirement>
+      </requirements>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>xdoc</role-hint>
+      <implementation>org.apache.maven.doxia.module.xdoc.XdocSinkFactory</implementation>
+      <description>Xdoc implementation of the Sink factory.</description>
+    </component>
+
+    <!-- Doxia xhtml -->
+    <component>
+      <role>org.apache.maven.doxia.parser.Parser</role>
+      <role-hint>xhtml</role-hint>
+      <implementation>org.apache.maven.doxia.module.xhtml.XhtmlParser</implementation>
+      <description>Parse an xhtml model and emit events into a Doxia Sink.</description>
+    </component>
+    <component>
+      <role>org.apache.maven.doxia.sink.SinkFactory</role>
+      <role-hint>xhtml</role-hint>
+      <implementation>org.apache.maven.doxia.module.xhtml.XhtmlSinkFactory</implementation>
+      <description>Xhtml implementation of the Sink factory.</description>
+    </component>
+  </components>
+</component-set>
diff --git a/test_projects/uberjar-components-merging/expected-components.xml b/test_projects/uberjar-components-merging/expected-components.xml
new file mode 100644
index 00000000..27115f42
--- /dev/null
+++ b/test_projects/uberjar-components-merging/expected-components.xml
@@ -0,0 +1,516 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<component-set>
+<components>
+<component>
+<role>
+org.apache.maven.doxia.Doxia
+</role>
+<implementation>
+org.apache.maven.doxia.DefaultDoxia
+</implementation>
+<description>
+Simple implementation of the Doxia interface:
+uses a ParserManager to lookup a parser.
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.parser.manager.ParserManager
+</role>
+<field-name>
+parserManager
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<role-hint>
+echo
+</role-hint>
+<implementation>
+org.apache.maven.doxia.macro.EchoMacro
+</implementation>
+<description>
+A simple macro that prints out the key and value of some supplied parameters.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.manager.MacroManager
+</role>
+<implementation>
+org.apache.maven.doxia.macro.manager.DefaultMacroManager
+</implementation>
+<description>
+Default implementation of &lt;code&gt;MacroManager&lt;/code&gt;
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<field-name>
+macros
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<role-hint>
+snippet
+</role-hint>
+<implementation>
+org.apache.maven.doxia.macro.snippet.SnippetMacro
+</implementation>
+<description>
+A macro that prints out the content of a file or a URL.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<role-hint>
+swf
+</role-hint>
+<implementation>
+org.apache.maven.doxia.macro.SwfMacro
+</implementation>
+<description>
+Macro for embedding Flash (SWF) within Maven documentation.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<role-hint>
+toc
+</role-hint>
+<implementation>
+org.apache.maven.doxia.macro.toc.TocMacro
+</implementation>
+<description>
+Macro to display a &lt;code&gt;Table Of Content&lt;/code&gt; in a given &lt;code&gt;Sink&lt;/code&gt;.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.module.site.manager.SiteModuleManager
+</role>
+<implementation>
+org.apache.maven.doxia.module.site.manager.DefaultSiteModuleManager
+</implementation>
+<description>
+Simple implementation of the SiteModuleManager interface.
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.module.site.SiteModule
+</role>
+<field-name>
+siteModules
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.manager.ParserManager
+</role>
+<implementation>
+org.apache.maven.doxia.parser.manager.DefaultParserManager
+</implementation>
+<description>
+Simple implementation of the &lt;code&gt;ParserManager&lt;/code&gt; interface.
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<field-name>
+parsers
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<role-hint>
+echo
+</role-hint>
+<implementation>
+org.apache.maven.doxia.macro.EchoMacro
+</implementation>
+<description>
+A simple macro that prints out the key and value of some supplied
+      parameters.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.manager.MacroManager
+</role>
+<implementation>
+org.apache.maven.doxia.macro.manager.DefaultMacroManager
+</implementation>
+<description>
+Default implementation of &lt;code&gt;MacroManager&lt;/code&gt;
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<field-name>
+macros
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<role-hint>
+snippet
+</role-hint>
+<implementation>
+org.apache.maven.doxia.macro.snippet.SnippetMacro
+</implementation>
+<description>
+A macro that prints out the content of a file or a URL.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<role-hint>
+swf
+</role-hint>
+<implementation>
+org.apache.maven.doxia.macro.SwfMacro
+</implementation>
+<description>
+Macro for embedding Flash (SWF) within Maven documentation.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.macro.Macro
+</role>
+<role-hint>
+toc
+</role-hint>
+<implementation>
+org.apache.maven.doxia.macro.toc.TocMacro
+</implementation>
+<description>
+Macro to display a &lt;code&gt;Table Of Content&lt;/code&gt; in a
+        given &lt;code&gt;Sink&lt;/code&gt;.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.manager.ParserManager
+</role>
+<implementation>
+org.apache.maven.doxia.parser.manager.DefaultParserManager
+</implementation>
+<description>
+Simple implementation of the
+        &lt;code&gt;ParserManager&lt;/code&gt; interface.
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<field-name>
+parsers
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<role-hint>
+apt
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.apt.AptParser
+</implementation>
+<description>
+The APT parser.
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.macro.manager.MacroManager
+</role>
+<field-name>
+macroManager
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+apt
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.apt.AptSinkFactory
+</implementation>
+<description>
+APT implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<role-hint>
+confluence
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.confluence.ConfluenceParser
+</implementation>
+<description>
+Parse the &lt;a href=&quot;http://www.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+confluence
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.confluence.ConfluenceSinkFactory
+</implementation>
+<description>
+Confluence implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<role-hint>
+docbook
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.docbook.DocBookParser
+</implementation>
+<description>
+Parse a &lt;code&gt;Docbook&lt;/code&gt; document and emit events
+        into the specified doxia Sink.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+docbook
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.docbook.DocbookSinkFactory
+</implementation>
+<description>
+Docbook implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<role-hint>
+fml
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.fml.FmlParser
+</implementation>
+<description>
+Parse a fml model and emit events into the specified doxia Sink.
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.macro.manager.MacroManager
+</role>
+<field-name>
+macroManager
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+fo
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.fo.FoSinkFactory
+</implementation>
+<description>
+FO implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+itext
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.itext.ITextSinkFactory
+</implementation>
+<description>
+IText implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+latex
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.latex.LatexSinkFactory
+</implementation>
+<description>
+Latex implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+rtf
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.rtf.RtfSinkFactory
+</implementation>
+<description>
+APT implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<role-hint>
+twiki
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.twiki.TWikiParser
+</implementation>
+<description>
+Parse the &lt;a href=&quot;http://twiki.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+twiki
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.twiki.TWikiSinkFactory
+</implementation>
+<description>
+TWiki implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<role-hint>
+xdoc
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.xdoc.XdocParser
+</implementation>
+<description>
+Parse an xdoc model and emit events into the specified doxia Sink.
+</description>
+<requirements>
+<requirement>
+<role>
+org.apache.maven.doxia.macro.manager.MacroManager
+</role>
+<field-name>
+macroManager
+</field-name>
+</requirement>
+</requirements>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+xdoc
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.xdoc.XdocSinkFactory
+</implementation>
+<description>
+Xdoc implementation of the Sink factory.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.parser.Parser
+</role>
+<role-hint>
+xhtml
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.xhtml.XhtmlParser
+</implementation>
+<description>
+Parse an xhtml model and emit events into a Doxia Sink.
+</description>
+</component>
+<component>
+<role>
+org.apache.maven.doxia.sink.SinkFactory
+</role>
+<role-hint>
+xhtml
+</role-hint>
+<implementation>
+org.apache.maven.doxia.module.xhtml.XhtmlSinkFactory
+</implementation>
+<description>
+Xhtml implementation of the Sink factory.
+</description>
+</component>
+</components>
+</component-set>