MAVEN-250: Created doc:jslFile to perform arbitrary jsl transformations. Old doc:jsl tag uses doc:jslFile internally

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@112828 13f79535-47bb-0310-9956-ffa450edef68

xdoc/plugin.jelly

@@ -41,8 +41,10 @@
       ${formatter.formatNumber(string,pattern)}
     </define:tag>
 
-    <define:tag name="jsl">
-      <!--
+    <define:tag name="jslFile">
+  	  <!--
+  	   | Basic tag for performing arbitrary jsl transformations
+  	   | on arbitrary jsl inputs.
        | @input
        | @output
        | @stylesheet
@@ -51,6 +53,36 @@
        | @outputMode
        | @prettyPrint
       -->
+ 
+      <util:file name="${input}" var="inputFile" />
+      <x:parse var="doc" xml="${inputFile}"/>
+      
+      <j:set var="stylesheetURI" value="file:${stylesheet}"/>
+      <j:file
+        name="${output}"
+        encoding="${encoding}"
+        omitXmlDeclaration="${omitXmlDeclaration}"
+        outputMode="${outputMode}"
+        prettyPrint="${prettyPrint}">
+        <j:include uri="${stylesheetURI.toString()}"/>
+      </j:file>
+    
+    </define:tag>
+    
+    
+    <define:tag name="jsl">
+      <!--
+       | This tag has a lot of defaults suitable for transforming
+       | documents easily. See jslCore for a tag suitable for
+       | transforming documents how you want.
+       | @input
+       | @output - Will be placed under ${maven.gen.docs}
+       | @stylesheet
+       | @encoding
+       | @omitXmlDeclaration
+       | @outputMode
+       | @prettyPrint
+      -->
     
       <!-- 
       @todo make sure the output directory exists.
@@ -82,17 +114,14 @@
       
       <mkdir dir="${outputDirectory}"/>
 
-      <util:file name="${input}" var="inputFile" />
-      <x:parse var="doc" xml="${inputFile}"/>
-      <j:set var="stylesheetURI" value="file:${stylesheet}"/>
-      <j:file
-        name="${outputDirectory}/${output}"
+      <doc:jslFile
+        input="${input}"
+        output="${outputDirectory}/${output}"
+        stylesheet="${stylesheet}"
         encoding="${encoding}"
         omitXmlDeclaration="${omitXmlDeclaration}"
         outputMode="${outputMode}"
-        prettyPrint="${prettyPrint}">
-        <j:include uri="${stylesheetURI.toString()}"/>
-      </j:file>
+        prettyPrint="${prettyPrint}"/>
     </define:tag>
 
     <define:tag name="itemLink">