commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject svn commit: r1495345 - in /commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc: ./ download_commons-gpg-plugin.xml index.xml
Date Fri, 21 Jun 2013 09:31:54 GMT
Author: sebb
Date: Fri Jun 21 09:31:54 2013
New Revision: 1495345

URL: http://svn.apache.org/r1495345
Log:
Add basic site

Added:
    commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/
    commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/download_commons-gpg-plugin.xml
  (with props)
    commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/index.xml   (with props)

Added: commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/download_commons-gpg-plugin.xml
URL: http://svn.apache.org/viewvc/commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/download_commons-gpg-plugin.xml?rev=1495345&view=auto
==============================================================================
--- commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/download_commons-gpg-plugin.xml
(added)
+++ commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/download_commons-gpg-plugin.xml
Fri Jun 21 09:31:54 2013
@@ -0,0 +1,138 @@
+<?xml version="1.0"?>
+<!--
+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.
+-->
+<!--
+ +======================================================================+
+ |****                                                              ****|
+ |****      THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN      ****|
+ |****                    DO NOT EDIT DIRECTLY                      ****|
+ |****                                                              ****|
+ +======================================================================+
+ | TEMPLATE FILE: download-page-template.xml                            |
+ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+ +======================================================================+
+ |                                                                      |
+ | 1) Re-generate using: mvn commons:download-page                      |
+ |                                                                      |
+ | 2) Set the following properties in the component's pom:              |
+ |    - commons.componentid (required, alphabetic, lower case)          |
+ |    - commons.release.version (required)                              |
+ |    - commons.binary.suffix (optional)                                |
+ |      (defaults to "-bin", set to "" for pre-maven2 releases)         |
+ |                                                                      |
+ | 3) Example Properties                                                |
+ |                                                                      |
+ |  <properties>                                                        |
+ |    <commons.componentid>math</commons.componentid>                   |
+ |    <commons.release.version>1.2</commons.release.version>            |
+ |  </properties>                                                       |
+ |                                                                      |
+ +======================================================================+
+-->
+<document>
+  <properties>
+    <title>Download commons-build-plugin Maven Mojo</title>
+    <author email="dev@commons.apache.org">Commons Documentation Team</author>
+  </properties>
+  <body>
+    <section name="Download commons-build-plugin Maven Mojo">
+    <subsection name="Using a Mirror">
+      <p>
+        We recommend you use a mirror to download our release
+        builds, but you <strong>must</strong> verify the integrity of
+        the downloaded files using signatures downloaded from our main 
+        distribution directories. Recent releases (48 hours) may not yet
+        be available from the mirrors.
+      </p>
+
+      <p>
+        You are currently using <b>[preferred]</b>.  If you
+        encounter a problem with this mirror, please select another
+        mirror.  If all mirrors are failing, there are <i>backup</i>
+        mirrors (at the end of the mirrors list) that should be
+        available.
+        <br></br>
+        [if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0"></img></a>[end]
+      </p>
+
+      <form action="[location]" method="get" id="SelectMirror">
+        <p>
+          Other mirrors: 
+          <select name="Preferred">
+          [if-any http]
+            [for http]<option value="[http]">[http]</option>[end]
+          [end]
+          [if-any ftp]
+            [for ftp]<option value="[ftp]">[ftp]</option>[end]
+          [end]
+          [if-any backup]
+            [for backup]<option value="[backup]">[backup] (backup)</option>[end]
+          [end]
+          </select>
+          <input type="submit" value="Change"></input>
+        </p>
+      </form>
+
+      <p>
+        The <a href="http://www.apache.org/dist/commons/KEYS">KEYS</a>
+        link links to the code signing keys used to sign the product.
+        The <code>PGP</code> link downloads the OpenPGP compatible signature
from our main site. 
+        The <code>MD5</code> link downloads the checksum from the main site.
+      </p>
+    </subsection>
+    </section>
+    <section name="commons-build-plugin Maven Mojo 1.4 ">
+      <subsection name="Binaries">
+        <table>
+          <tr>
+              <td><a href="[preferred]/commons/commons-build-plugin/binaries/commons-build-plugin-1.4-bin.tar.gz">commons-build-plugin-1.4-bin.tar.gz</a></td>
+              <td><a href="http://www.apache.org/dist/commons/commons-build-plugin/binaries/commons-build-plugin-1.4-bin.tar.gz.md5">md5</a></td>
+              <td><a href="http://www.apache.org/dist/commons/commons-build-plugin/binaries/commons-build-plugin-1.4-bin.tar.gz.asc">pgp</a></td>
+          </tr>
+          <tr>
+              <td><a href="[preferred]/commons/commons-build-plugin/binaries/commons-build-plugin-1.4-bin.zip">commons-build-plugin-1.4-bin.zip</a></td>
+              <td><a href="http://www.apache.org/dist/commons/commons-build-plugin/binaries/commons-build-plugin-1.4-bin.zip.md5">md5</a></td>
+              <td><a href="http://www.apache.org/dist/commons/commons-build-plugin/binaries/commons-build-plugin-1.4-bin.zip.asc">pgp</a></td>
+          </tr>
+        </table>
+      </subsection>
+      <subsection name="Source">
+        <table>
+          <tr>
+              <td><a href="[preferred]/commons/commons-build-plugin/source/commons-build-plugin-1.4-src.tar.gz">commons-build-plugin-1.4-src.tar.gz</a></td>
+              <td><a href="http://www.apache.org/dist/commons/commons-build-plugin/source/commons-build-plugin-1.4-src.tar.gz.md5">md5</a></td>
+              <td><a href="http://www.apache.org/dist/commons/commons-build-plugin/source/commons-build-plugin-1.4-src.tar.gz.asc">pgp</a></td>
+          </tr>
+          <tr>
+              <td><a href="[preferred]/commons/commons-build-plugin/source/commons-build-plugin-1.4-src.zip">commons-build-plugin-1.4-src.zip</a></td>
+              <td><a href="http://www.apache.org/dist/commons/commons-build-plugin/source/commons-build-plugin-1.4-src.zip.md5">md5</a></td>
+              <td><a href="http://www.apache.org/dist/commons/commons-build-plugin/source/commons-build-plugin-1.4-src.zip.asc">pgp</a></td>
+          </tr>
+        </table>
+      </subsection>
+    </section>
+    <section name="Archives">
+        <p>
+          Older releases can be obtained from the archives.
+        </p>
+        <ul>
+          <li class="download"><a href="[preferred]/commons/commons-build-plugin/">browse
download area</a></li>
+          <li><a href="http://archive.apache.org/dist/commons/commons-build-plugin/">archives...</a></li>
+        </ul>
+    </section>
+  </body>
+</document>

Propchange: commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/download_commons-gpg-plugin.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/index.xml?rev=1495345&view=auto
==============================================================================
--- commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/index.xml (added)
+++ commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/index.xml Fri Jun 21 09:31:54
2013
@@ -0,0 +1,100 @@
+<?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.
+-->
+<!--
+   $HeadURL: https://svn.apache.org/repos/asf/commons/proper/commons-build-plugin/trunk/src/site/xdoc/index.xml
$
+   $Revision: 1296463 $ $Date: 2012-03-02 21:08:10 +0000 (Fri, 02 Mar 2012) $
+ -->
+<document>
+
+    <properties>
+        <title>Commons Gpg Plugin: Overview</title>
+        <author email="dev@commons.apache.org">Apache Commons Documentation Team</author>
+    </properties>
+
+    <body>
+
+        <section name="Apache Commons Gpg Plugin">
+
+            <p>
+            This is a <a href="http://maven.apache.org/">Maven 2.x</a> Plugin
which is designed
+            to be used in release profiles for packages such as source and binary archives.
+            It is an extension of the standard 
+            <a href=""http://maven.apache.org/plugins/maven-gpg-plugin/">Maven Gpg
Plugin</a> that can generate signatures for
+            any specified files (not just ones that are attached to the project).
+            It is hoped that the functionality will eventually be added to the Maven plugin,
+            at which point this plugin will become redundant.
+            Note: the signing is done using the same code as Maven Gpg Plugin 1.4; the same
properties
+            and configuration items are supported. In addition, this plugin supports includes/excludes,
+            see below.
+            As with the Maven Gpg Plugin, it is assumed that the user has installed and configured
GnuPG or GnuPG2
+            on their system.
+            </p>
+
+        </section>
+
+        <section name="Plugin Goals">
+            <p>
+            Available Goals:
+            <ul>
+                <li>commons-gpg:signfiles - generate gpg signatures of specified files</li>
+                <li>commons-gpg:help - display the plugin help as per help:describe</li>
+            </ul>
+            </p>
+        </section>
+
+        <section name="Trying out the plugin">
+            <p>
+            Configure the plugin in the <code>&lt;build&gt;</code> section
of the <code>pom.xml</code>
+<source><![CDATA[
+<plugin>
+  <groupId>org.apache.commons</groupId>
+  <artifactId>commons-gpg-plugin</artifactId>
+  <version>1.0</version>
+  <configuration>
+    <includes>
+      <include>target/releases/*.zip</include>
+      <include>target/releases/*.tar.gz</include>
+    </includes>
+    <excludes> <!-- Optional -->
+      <exclude>target/release/README*</exclude>
+    </excludes>
+  </configuration>
+  <executions>
+    <execution>
+      <goals>
+        <goal>signfiles</goal>
+      </goals>
+      <!-- must run after assembly and before deploy -->
+      <phase>verify</phase>
+    </execution>
+  </executions>
+</plugin>
+]]></source>
+            </p>
+            <p>
+            The list of files to process can also be specified on the command line:
+<pre>
+mvn commons-gpg:signfiles -Dgpg.files={comma-separated list of files}
+</pre>
+            Note that the configuration items (apart from includes/excludes) are also supported
as
+            properties with the prefix "gpg.".
+            </p>
+        </section>
+
+    </body>
+</document>

Propchange: commons/proper/commons-gpg-plugin/trunk/src/main/site/xdoc/index.xml
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message