You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by gg...@apache.org on 2018/05/13 16:31:35 UTC
commons-build-plugin git commit: [COMMONSSITE-109] [build-plugin]
Target for creating all items for pre-release. First cut. Tested with Commons
Collection git master. Using XInclude would avoid a lot of duplication.
Repository: commons-build-plugin
Updated Branches:
refs/heads/master 287c2d456 -> e11f51d3b
[COMMONSSITE-109] [build-plugin] Target for creating all items for
pre-release. First cut. Tested with Commons Collection git master. Using
XInclude would avoid a lot of duplication.
Project: http://git-wip-us.apache.org/repos/asf/commons-build-plugin/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-build-plugin/commit/e11f51d3
Tree: http://git-wip-us.apache.org/repos/asf/commons-build-plugin/tree/e11f51d3
Diff: http://git-wip-us.apache.org/repos/asf/commons-build-plugin/diff/e11f51d3
Branch: refs/heads/master
Commit: e11f51d3b814b88045a54b327485beeb860242e1
Parents: 287c2d4
Author: Gary Gregory <ga...@gmail.com>
Authored: Sun May 13 10:31:33 2018 -0600
Committer: Gary Gregory <ga...@gmail.com>
Committed: Sun May 13 10:31:33 2018 -0600
----------------------------------------------------------------------
src/main/scripts/generate-xdocs.build.xml | 5 +
src/main/scripts/generate-xdocs.mojos.xml | 246 +++++++++++++++++++++++++
src/site/site.xml | 3 +
src/site/xdoc/all-mojo.xml | 44 +++++
src/site/xdoc/all.xml | 57 ++++++
src/site/xdoc/index.xml | 1 +
6 files changed, 356 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-build-plugin/blob/e11f51d3/src/main/scripts/generate-xdocs.build.xml
----------------------------------------------------------------------
diff --git a/src/main/scripts/generate-xdocs.build.xml b/src/main/scripts/generate-xdocs.build.xml
index 174f6ce..2275f33 100644
--- a/src/main/scripts/generate-xdocs.build.xml
+++ b/src/main/scripts/generate-xdocs.build.xml
@@ -24,6 +24,11 @@
<property name="commonsMojoTempDir" value="target/commons-generated-xdocs" />
<property name="level" value="info" />
+ <!-- ========== Generate All Pages ================================ -->
+
+ <target name="all" description="Generate all pages" depends="contributing-md, download-page, jira-page, mail-page, readme-md" />
+ <target name="all-sandbox" description="Generate all pages" depends="contributing-md, download-page, sandbox-jira-page, mail-page, readme-md" />
+
<!-- ========== Generate Mailing List Page ================================ -->
<target name="mail-page" description="Generate Mailing List page">
http://git-wip-us.apache.org/repos/asf/commons-build-plugin/blob/e11f51d3/src/main/scripts/generate-xdocs.mojos.xml
----------------------------------------------------------------------
diff --git a/src/main/scripts/generate-xdocs.mojos.xml b/src/main/scripts/generate-xdocs.mojos.xml
index f756963..a39766d 100644
--- a/src/main/scripts/generate-xdocs.mojos.xml
+++ b/src/main/scripts/generate-xdocs.mojos.xml
@@ -20,8 +20,254 @@
Mojo metadata for "Commons Build: Standard XDOC Pages Generation".
-->
<pluginMetadata>
+<!-- Using XInclude would help here. -->
<mojos>
<mojo>
+ <goal>all</goal>
+ <call>all</call>
+ <description>Apache Commons Build Mojo: Generate Mailing List page.</description>
+ <requiresProject>true</requiresProject>
+ <parameters>
+ <parameter>
+ <name>project.name</name>
+ <property>project.name</property>
+ <required>true</required>
+ <readonly>true</readonly>
+ <defaultValue>${project.name}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The name of the project currently being built.</description>
+ </parameter>
+ <parameter>
+ <name>project.groupId</name>
+ <property>project.groupId</property>
+ <required>true</required>
+ <readonly>true</readonly>
+ <defaultValue>${project.groupId}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The groupId of the project currently being built.</description>
+ </parameter>
+ <parameter>
+ <name>project.artifactId</name>
+ <property>project.artifactId</property>
+ <required>true</required>
+ <readonly>true</readonly>
+ <defaultValue>${project.artifactId}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The artifactId of the project currently being built.</description>
+ </parameter>
+ <parameter>
+ <name>commons.jira.id</name>
+ <property>commons.jira.id</property>
+ <required>true</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.jira.id}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The external JIRA id for the project (alphabetic, upper case.)</description>
+ </parameter>
+ <parameter>
+ <name>commons.componentid</name>
+ <property>commons.componentid</property>
+ <required>true</required>
+ <readonly>true</readonly>
+ <defaultValue>${commons.componentid}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The commons component id.</description>
+ </parameter>
+ <parameter>
+ <name>commons.jira.pid</name>
+ <property>commons.jira.pid</property>
+ <required>true</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.jira.pid}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The internal JIRA id for the project (numeric.)</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.version</name>
+ <property>commons.release.version</property>
+ <required>true</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.version}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The version of the latest release of the project.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.name</name>
+ <property>commons.release.name</property>
+ <required>true</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.name}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The name of the latest release of the project.</description>
+ </parameter>
+ <parameter>
+ <name>commons.binary.suffix</name>
+ <property>commons.binary.suffix</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.binary.suffix}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The suffix for the binary distribution.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.desc</name>
+ <property>commons.release.desc</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.desc}</defaultValue>
+ <type>java.lang.String</type>
+ <description>Release Title or Description.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.subdir</name>
+ <property>commons.release.subdir</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.subdir}</defaultValue>
+ <type>java.lang.String</type>
+ <description>Subdirectory (instead of source/binaries.)</description>
+ </parameter>
+ <!-- commons.release.2.* -->
+ <parameter>
+ <name>commons.release.2.version</name>
+ <property>commons.release.2.version</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.2.version}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The version of an alternative release of the project.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.2.name</name>
+ <property>commons.release.2.name</property>
+ <required>true</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.2.name}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The name of the alternative release of the project.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.2.desc</name>
+ <property>commons.release.2.desc</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.2.desc}</defaultValue>
+ <type>java.lang.String</type>
+ <description>Alternative Release Title or Description.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.2.binary.suffix</name>
+ <property>commons.release.2.binary.suffix</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.2.binary.suffix}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The suffix for the alternative release binary distribution.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.2.subdir</name>
+ <property>commons.release.2.subdir</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.2.subdir}</defaultValue>
+ <type>java.lang.String</type>
+ <description>Subdirectory (instead of source/binaries.)</description>
+ </parameter>
+ <!-- commons.release.3.* -->
+ <parameter>
+ <name>commons.release.3.version</name>
+ <property>commons.release.3.version</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.3.version}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The version of an alternative release of the project.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.3.name</name>
+ <property>commons.release.3.name</property>
+ <required>true</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.3.name}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The name of the alternative release of the project.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.3.desc</name>
+ <property>commons.release.3.desc</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.3.desc}</defaultValue>
+ <type>java.lang.String</type>
+ <description>Alternative Release Title or Description.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.3.binary.suffix</name>
+ <property>commons.release.3.binary.suffix</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.3.binary.suffix}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The suffix for the alternative release binary distribution.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.3.subdir</name>
+ <property>commons.release.3.subdir</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.3.subdir}</defaultValue>
+ <type>java.lang.String</type>
+ <description>Subdirectory (instead of source/binaries.)</description>
+ </parameter>
+ <!-- commons.release.4.* -->
+ <parameter>
+ <name>commons.release.4.version</name>
+ <property>commons.release.4.version</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.4.version}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The version of an alternative release of the project.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.4.name</name>
+ <property>commons.release.4.name</property>
+ <required>true</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.4.name}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The name of the alternative release of the project.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.4.desc</name>
+ <property>commons.release.4.desc</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.4.desc}</defaultValue>
+ <type>java.lang.String</type>
+ <description>Alternative Release Title or Description.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.4.binary.suffix</name>
+ <property>commons.release.4.binary.suffix</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.4.binary.suffix}</defaultValue>
+ <type>java.lang.String</type>
+ <description>The suffix for the alternative release binary distribution.</description>
+ </parameter>
+ <parameter>
+ <name>commons.release.4.subdir</name>
+ <property>commons.release.4.subdir</property>
+ <required>false</required>
+ <readonly>false</readonly>
+ <defaultValue>${commons.release.4.subdir}</defaultValue>
+ <type>java.lang.String</type>
+ <description>Subdirectory (instead of source/binaries.)</description>
+ </parameter>
+ </parameters>
+ </mojo>
+ <mojo>
<goal>mail-page</goal>
<call>mail-page</call>
<description>Apache Commons Build Mojo: Generate Mailing List page.</description>
http://git-wip-us.apache.org/repos/asf/commons-build-plugin/blob/e11f51d3/src/site/site.xml
----------------------------------------------------------------------
diff --git a/src/site/site.xml b/src/site/site.xml
index 5edf68e..7e58a0f 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -21,6 +21,9 @@
<menu name="Build Plugin">
<item name="Overview" href="/index.html"/>
<item name="Goals">
+ <item name="all" href="/all.html">
+ <item name="properties" href="/all-mojo.html"/>
+ </item>
<item name="download-page" href="/download-page.html">
<item name="properties" href="/download-page-mojo.html"/>
</item>
http://git-wip-us.apache.org/repos/asf/commons-build-plugin/blob/e11f51d3/src/site/xdoc/all-mojo.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/all-mojo.xml b/src/site/xdoc/all-mojo.xml
new file mode 100644
index 0000000..1192481
--- /dev/null
+++ b/src/site/xdoc/all-mojo.xml
@@ -0,0 +1,44 @@
+<?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.
+-->
+<document>
+ <properties>
+ <title>commons:all</title>
+ </properties>
+ <body>
+ <section name="commons:all">
+ <p><strong>Full name</strong>:</p>
+ <p>org.apache.commons:commons-build-plugin:1.9:all</p>
+ <p><strong>Description</strong>:</p>
+ <div>Apache Commons Build Mojo: Generate all pages</div>
+ <p><strong>Attributes</strong>:</p>
+ <ul>
+ <li>Requires a Maven 2.0 project to be executed.</li>
+ <li>Is NOT inherited by default in multi-project builds.</li>
+ </ul>
+ <subsection name="Required Parameters">
+ <p>This is the union of all parameters for all goals in this plugin.</p>
+ </subsection>
+ <subsection name="Optional Parameters">
+ <p>This is the union of all parameters for all goals in this plugin.</p>
+ </subsection>
+ <subsection name="Parameter Details">
+ <p>This is the union of all parameters for all goals in this plugin.</p>
+ </subsection>
+ </section>
+ </body>
+</document>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/commons-build-plugin/blob/e11f51d3/src/site/xdoc/all.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/all.xml b/src/site/xdoc/all.xml
new file mode 100644
index 0000000..96275ad
--- /dev/null
+++ b/src/site/xdoc/all.xml
@@ -0,0 +1,57 @@
+<?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.
+-->
+<document>
+
+ <properties>
+ <title>Generating All Pages</title>
+ <author email="dev@commons.apache.org">Apache Commons Documentation Team</author>
+ </properties>
+
+ <body>
+
+
+ <section name="commons:all" href="all">
+
+ <subsection name="Overview">
+ <p>
+ The <code>commons:all</code> goal generates all pages for a <strong>Proper</strong> component
+ (for <strong>Sandbox</strong> components use the <a href="sandbox-all.html">commons:sandbox-all</a> goal).
+ Execute the goal using the following command: <source>mvn commons:all</source>
+ </p>
+ <p>
+ This goal uses the following:
+ <ul>
+ <li>The goal is mapped to the ant script/target using the <code>all</code> Mojo defintion in the
+ <a href="http://svn.apache.org/repos/asf/commons/proper/commons-build-plugin/trunk/src/main/scripts/generate-xdocs.mojos.xml">generate-xdocs.mojos.xml</a> mapping document</li>
+ <li>Executes the <code>all</code> target in
+ <a href="http://svn.apache.org/repos/asf/commons/proper/commons-build-plugin/trunk/src/main/scripts/generate-xdocs.build.xml">generate-xdocs.build.xml</a>
+ ant script</li>
+ </ul>
+ </p>
+ </subsection>
+
+ <subsection name="Configuration">
+ <p>
+ To generate all pages, the union of other goal's properties are configured in the component's <code>pom.xml</code>
+ </p>
+ </subsection>
+
+ </section>
+
+ </body>
+</document>
http://git-wip-us.apache.org/repos/asf/commons-build-plugin/blob/e11f51d3/src/site/xdoc/index.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml
index 8415330..4284490 100644
--- a/src/site/xdoc/index.xml
+++ b/src/site/xdoc/index.xml
@@ -40,6 +40,7 @@
<p>
Available Goals:
<ul>
+ <li><a href="all.html">commons:all</a> - Generate all pages for the component's latest release</li>
<li><a href="download-page.html">commons:download-page</a> - Generate a Download page for the component's latest release</li>
<li><a href="mail-page.html">commons:mail-page</a> - Generate a custom <i>Mailing List</i> page for a component</li>
<li><a href="jira-page.html">commons:jira-page</a> - Generate a custom <i>JIRA Issue Tracking</i> page for a component</li>