Author: vsiveton
Date: Sun Aug 2 12:33:13 2009
New Revision: 800046
URL: http://svn.apache.org/viewvc?rev=800046&view=rev
Log:
o using latest maven-site-plugin
o fixed links found by linkcheck report using maven-site-plugin:2.1-SNAP
o added license header
Modified:
maven/site/trunk/pom.xml
maven/site/trunk/src/site/apt/download.apt.vm
maven/site/trunk/src/site/apt/examples/index.apt
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
maven/site/trunk/src/site/apt/guides/mini/guide-building-jdk14-on-jdk15.apt
maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt
Modified: maven/site/trunk/pom.xml
URL:
http://svn.apache.org/viewvc/maven/site/trunk/pom.xml?rev=800046&r1=800045&r2=800046&view=diff
==============================================================================
--- maven/site/trunk/pom.xml (original)
+++ maven/site/trunk/pom.xml Sun Aug 2 12:33:13 2009
@@ -277,6 +277,12 @@
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-site-plugin</artifactId>
+ <version>2.0.1</version>
+ <!-- <version>2.1-SNAPSHOT</version> -->
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-pdf-plugin</artifactId>
<version>1.0</version>
</plugin>
Modified: maven/site/trunk/src/site/apt/download.apt.vm
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/download.apt.vm?rev=800046&r1=800045&r2=800046&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/download.apt.vm (original)
+++ maven/site/trunk/src/site/apt/download.apt.vm Sun Aug 2 12:33:13 2009
@@ -58,7 +58,7 @@
*-------------------------+---------+----------+-----------+
You could also download the current documentation, i.e. this website, as a
{{{./maven-site-1.0-site.jar}single jar}} file.
-
+
* {Maven ${current21xVersion}}
*-------------------------+---------+----------+-----------+
@@ -202,7 +202,7 @@
* other configuration properties
- For information on this file, see the {{{settings.html} Settings reference}}
+ For information on this file, see the {{{./settings.html} Settings
reference}}
*** Security
Modified: maven/site/trunk/src/site/apt/examples/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/examples/index.apt?rev=800046&r1=800045&r2=800046&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/examples/index.apt (original)
+++ maven/site/trunk/src/site/apt/examples/index.apt Sun Aug 2 12:33:13 2009
@@ -3,13 +3,33 @@
---
John Casey
---
- 20-Apr-2006
- ---
+ 2009-08-02
+ ------
+
+~~ 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.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/doxia/references/apt-format.html
Examples
* <<<settings.xml>>> Configuration
- * {{{injecting-properties-via-settings.html}Injecting POM Properties via
settings.xml}}
+ * {{{./injecting-properties-via-settings.html}Injecting POM Properties via
settings.xml}}
[]
Modified:
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt?rev=800046&r1=800045&r2=800046&view=diff
==============================================================================
---
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
(original)
+++
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
Sun Aug 2 12:33:13 2009
@@ -3,9 +3,29 @@
------
Brett Porter
------
- 24 November 2005
+ 2009-08-02
------
+~~ 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.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/doxia/references/apt-format.html
+
Guide to Testing Development Versions of Plugins
* Why would I want to do this?
@@ -80,11 +100,11 @@
* Using Settings without Modifying the Project
If you are using the goals from the command line on a number of projects,
you should include this in your
- <<<settings.xml>>> file instead.
+ <<<settings.xml>>> file instead.
You need to modify your <<<~/.m2/settings.xml>>> file to include two new
profiles
and then when you need access to the plugin snapshots use <<<-Papache>>>.
- The profile only needs to be enabled once so that the plugins can be
downloaded into you local repository. Once
+ The profile only needs to be enabled once so that the plugins can be
downloaded into you local repository. Once
in your local repository Maven can succesfully resolve the dependencies and
the profile no longer needs to be activated.
@@ -122,9 +142,9 @@
* Using a Repository Manager
In addition to the above you may want to use a repository manager so that
you can retain the builds you have been using.
- For information on this technique, see the {{{guide-testing-releases.html}
Guide to Testing Staged Releases}}.
+ For information on this technique, see the {{{./guide-testing-releases.html}
Guide to Testing Staged Releases}}.
* How do I make changes to the source and test development versions of the
plugins?
- For information on this, see the {{{guide-m2-development.html}Guide to Maven
2.0 Development}}.
-
+ For information on this, see the {{{./guide-m2-development.html}Guide to
Maven 2.0 Development}}.
+
Modified:
maven/site/trunk/src/site/apt/guides/mini/guide-building-jdk14-on-jdk15.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-building-jdk14-on-jdk15.apt?rev=800046&r1=800045&r2=800046&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-building-jdk14-on-jdk15.apt
(original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-building-jdk14-on-jdk15.apt
Sun Aug 2 12:33:13 2009
@@ -3,38 +3,58 @@
------
John Casey
------
- 9 June 2009
+ 2009-08-02
------
+~~ 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.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/doxia/references/apt-format.html
+
Guide to Building JDK 1.4 Projects Using JDK 1.5
- Since Maven 2.2.0 requires Java 1.5 to execute, users who still require
their projects to run on Java 1.4 or older
- will need to make some adjustments.
-
+ Since Maven 2.2.0 requires Java 1.5 to execute, users who still require
their projects to run on Java 1.4 or older
+ will need to make some adjustments.
+
Ideally, you could solve this problem by using JDK 1.4 to compile and test
your project, by providing the appropriate
- {{{guide-using-toolchains.html}toolchains}} configuration. However, the
current release of the {{{/plugins/maven-compiler-plugin}compiler plugin}}
+ {{{./guide-using-toolchains.html}toolchains}} configuration. However, the
current release of the {{{/plugins/maven-compiler-plugin}compiler plugin}}
(2.0.2) isn't toolchains-capable yet, so constructing a bullet-proof build
using Maven 2.2.0 to target a Java platform older than 1.5
requires some more exotic configuration.
-
+
*First Step: <<<Source>>> and <<<Target>>> Configurations
The first step to supporting JDKs older than 1.5 in your build is already
done for you: setting the <<<source>>> and <<<target>>> API versions
in the configuration for the compiler plugin. Since JDK 1.5+ can still
generate class files that are compliant with older JDKs, using this
default compiler-plugin setting will render project artifacts that are
technically compatible with JVMs older than 1.5.
-
- This is great, until someone sneaks a <<<String.contains( "foo" )>>> into
the codebase. If that happens, your project will still build
- successfully, and generate 1.4-compatible binaries. But try to execute your
code in a 1.4 JVM, and you'll understand why the compiler
+
+ This is great, until someone sneaks a <<<String.contains( "foo" )>>> into
the codebase. If that happens, your project will still build
+ successfully, and generate 1.4-compatible binaries. But try to execute your
code in a 1.4 JVM, and you'll understand why the compiler
configuration alone isn't enough. To construct a build process targeting JVM
1.4 when the build tool requires JVM 1.5+, while still ensuring
the result of that build is safe to run on the 1.4 JVM, we need to use a
tool that can verify the compatibility of our project code
against a given Java API specification version.
-
+
*Enter the Animal Sniffer
- Fortunately, there is a project at dev.java.net called
{{{https://animal-sniffer.dev.java.net/signature-checker.html}Animal Sniffer}}
- that does exactly what we need. This project can verify the compatibility of
a codebase against a whole range of Java APIs. Even better,
- it provides a Maven 2.x plugin to give users an easy way to integrate these
checks into their build. To verify that your
+ Fortunately, there is a project at dev.java.net called
{{{https://animal-sniffer.dev.java.net/signature-checker.html}Animal Sniffer}}
+ that does exactly what we need. This project can verify the compatibility of
a codebase against a whole range of Java APIs. Even better,
+ it provides a Maven 2.x plugin to give users an easy way to integrate these
checks into their build. To verify that your
codebase complies with JDK 1.4 API, you simply tell the animal sniffer
plugin to use:
-
+
+---+
<signature>
<groupId>org.jvnet.animal-sniffer</groupId>
@@ -46,7 +66,7 @@
*Sample Configuration
Putting it all together, the following example shows how you can be certain
your project will run on the 1.4 JVM:
-
+
+---+
<build>
<pluginManagement>
@@ -61,7 +81,7 @@
</plugin>
</plugins>
</pluginManagement>
-
+
<plugins>
<plugin>
<groupId>org.jvnet</groupId>
Modified: maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt?rev=800046&r1=800045&r2=800046&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt
(original)
+++ maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt Sun Aug
2 12:33:13 2009
@@ -4,8 +4,28 @@
Brett Porter
Vincent Siveton
-----
- January 2008
- -----
+ 2009-08-02
+ ------
+
+~~ 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.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/doxia/references/apt-format.html
Maven Plugins Cookbook
@@ -16,13 +36,13 @@
* How To/Recipes
- * {{{add-build-time-to-manifest.html}How to add build time to a JAR
manifest?}}
+ * {{{./add-build-time-to-manifest.html}How to add build time to a JAR
manifest?}}
- * {{{add-svn-revision-to-manifest.html}How to add SVN revision to a JAR
manifest?}}
+ * {{{./add-svn-revision-to-manifest.html}How to add SVN revision to a JAR
manifest?}}
- * {{{attach-source-javadoc-artifacts.html}How to attach source and javadoc
artifacts?}}
+ * {{{./attach-source-javadoc-artifacts.html}How to attach source and javadoc
artifacts?}}
- * {{{generate-assembly.html}How to generate assembly?}}
+ * {{{./generate-assembly.html}How to generate assembly?}}
[]
