You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by vs...@apache.org on 2009/06/30 15:27:15 UTC
svn commit: r789717 - in /maven/site/trunk/src/site/apt: developers/release/
guides/development/ guides/getting-started/ guides/introduction/
guides/mini/ guides/plugin/ plugins/
Author: vsiveton
Date: Tue Jun 30 13:27:15 2009
New Revision: 789717
URL: http://svn.apache.org/viewvc?rev=789717&view=rev
Log:
o fixed ambiguous links
Modified:
maven/site/trunk/src/site/apt/developers/release/releasing.apt
maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt
maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt
maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-lifecycle.apt
maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt
maven/site/trunk/src/site/apt/guides/mini/guide-archive-configuration.apt
maven/site/trunk/src/site/apt/guides/mini/guide-central-repository-upload.apt
maven/site/trunk/src/site/apt/guides/mini/guide-configuring-maven.apt
maven/site/trunk/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt
maven/site/trunk/src/site/apt/guides/mini/guide-maven-evangelism.apt
maven/site/trunk/src/site/apt/guides/mini/guide-proxies.apt
maven/site/trunk/src/site/apt/guides/mini/guide-site.apt
maven/site/trunk/src/site/apt/guides/plugin/guide-java-plugin-development.apt
maven/site/trunk/src/site/apt/plugins/index.apt
Modified: maven/site/trunk/src/site/apt/developers/release/releasing.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/developers/release/releasing.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/developers/release/releasing.apt (original)
+++ maven/site/trunk/src/site/apt/developers/release/releasing.apt Tue Jun 30 13:27:15 2009
@@ -35,18 +35,18 @@
* you have all Maven servers defined in your settings.xml. For more information, please refer to
{{{../committer-settings.html}Committer settings}}.
- * you have created your GPG keys. For more information, please refer to {{{pmc-gpg-keys.html}Making GPG Keys}}.
-
+ * you have created your GPG keys. For more information, please refer to {{{./pmc-gpg-keys.html}Making GPG Keys}}.
+
* you have a GPG client installed and on your shell's path. See {{{http://www.gnupg.org/}http://www.gnupg.org/}}.
-
+
* you have a Subversion 1.5+ client installed and on your shell's path. See {{{http://subversion.tigris.org/}http://subversion.tigris.org/}}.
-
+
* you have a Java 1.4.2 JDK installed and on your shell's path. See {{{http://java.sun.com/j2se/1.4.2/download.html}http://java.sun.com/j2se/1.4.2/download.html}}.
-
- * you have set the environment variable MAVEN_OPTS=-Xmx512m
-
+
+ * you have set the environment variable MAVEN_OPTS=-Xmx512m
+
* you are using Maven 2.0.x (or 2.2.x), as Maven 2.1.x is known to produce wrong gpg pom signatures (see {{{http://jira.codehaus.org/browse/MGPG-14}MGPG-14}}).
-
+
[]
Formerly, a <<<release>>> profile was required in the <<<$\{user.home\}/.m2/settings.xml>>> to define the staging
@@ -346,7 +346,7 @@
If this is a shared component release, update the version number for the
component on the <src/site/apt/shared/index.apt> page.
-
+
Commit your changes.
[[14]] Update JIRA
@@ -417,7 +417,7 @@
<<Note:>> If you don't have access to edit this page email <<<"Jason van Zyl" <ja...@maven.org>>>>
[[18]] Celebrate :o)
-
+
Trouble Shooting
* mvn release:prepare "commit failed" during <<<Prepare the release>>>
@@ -434,7 +434,7 @@
+-----+
Then the resolution is to use a Subversion client 1.6+ and to run <<<svn update>>>.
-
+
* mvn release:prepare "commit failed" during <<<Prepare the release>>>
If you get an error message similar to:
@@ -449,5 +449,4 @@
svn: Path 'https://svn.apache.org/repos/asf/maven/plugins/tags/maven-eclipse-plugin-2.7' already exists
+-----+
- Then the resolution is to delete the tag using <<<svn del -m "re-releasing build" <svn path>>>>
-
\ No newline at end of file
+ Then the resolution is to delete the tag using <<<svn del -m "re-releasing build" <svn path>>>>
Modified: maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt (original)
+++ maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt Tue Jun 30 13:27:15 2009
@@ -31,7 +31,7 @@
Developing Maven 2
This document describes how to get started into developing Maven 2 itself. There is a separate page describing how
- to {{{guide-building-m2.html}building Maven 2}}.
+ to {{{./guide-building-m2.html}building Maven 2}}.
* Finding some work to do
Modified: maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt (original)
+++ maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt Tue Jun 30 13:27:15 2009
@@ -224,5 +224,5 @@
We hope this quick overview has piqued your interest in the versitility of Maven. Note that this is a very
truncated quick-start guide. Now you are ready for more comprehensive details concerning
- the actions you have just performed. Check out the {{{index.html}Maven Getting Started Guide}}.
+ the actions you have just performed. Check out the {{{./index.html}Maven Getting Started Guide}}.
Modified: maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-lifecycle.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-lifecycle.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-lifecycle.apt (original)
+++ maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-lifecycle.apt Tue Jun 30 13:27:15 2009
@@ -47,7 +47,7 @@
and distributing a particular artifact (project) is clearly defined.
For the person building a project, this means that it is only necessary to learn a small set of commands to build any
- Maven project, and the {{{introduction-to-the-pom.html}POM}} will ensure they get the results they desired.
+ Maven project, and the {{{./introduction-to-the-pom.html}POM}} will ensure they get the results they desired.
There are three built-in build lifecycles: default, clean and site. The default lifecycle handles your project
deployment, the clean lifecycle handles project cleaning, while the site lifecycle handles the creation of your
@@ -113,7 +113,7 @@
This command will traverse into all of the subprojects and run <<<clean>>>, then <<<install>>> (including all of
the prior steps).
- <{{{introduction-to-the-lifecycle.html}[top]}}.>
+ <{{{./introduction-to-the-lifecycle.html}[top]}}.>
** {A Build Phase is Made Up of Goals}
@@ -142,7 +142,7 @@
POM, however multiple instances of the same plugin are not supported. Multiple instances of the same plugin are grouped to execute together and ordered in
Maven 2.0.11 and above>).
- <{{{introduction-to-the-lifecycle.html}[top]}}.>
+ <{{{./introduction-to-the-lifecycle.html}[top]}}.>
* {Setting Up Your Project to Use the Build Lifecycle}
@@ -185,7 +185,7 @@
<<<\<build\>>>> section of your POM (as described in the next section). One example of a plugin that requires this is the
Plexus plugin, which provides a <<<plexus-application>>> and <<<plexus-service>>> packaging.
- <{{{introduction-to-the-lifecycle.html}[top]}}.>
+ <{{{./introduction-to-the-lifecycle.html}[top]}}.>
** {Plugins}
@@ -260,7 +260,7 @@
...
----
- <{{{introduction-to-the-lifecycle.html}[top]}}.>
+ <{{{./introduction-to-the-lifecycle.html}[top]}}.>
* {Lifecycle Reference}
@@ -339,7 +339,7 @@
| site-deploy | deploys the generated site documentation to the specified web server
*-------------------------------+--------------------------------------------------------------------------------------+
- <{{{introduction-to-the-lifecycle.html}[top]}}.>
+ <{{{./introduction-to-the-lifecycle.html}[top]}}.>
* {Built-in Lifecycle Bindings}
@@ -432,4 +432,4 @@
{{{http://svn.apache.org/repos/asf/maven/components/branches/maven-2.0.x/maven-core/src/main/resources/META-INF/plexus/components.xml}Maven 2.0.x}}
and {{{http://svn.apache.org/repos/asf/maven/components/trunk/maven-core/src/main/resources/META-INF/plexus/components.xml}Maven 3.0.x}}.
- <{{{introduction-to-the-lifecycle.html}[top]}}.>
+ <{{{./introduction-to-the-lifecycle.html}[top]}}.>
Modified: maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt (original)
+++ maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt Tue Jun 30 13:27:15 2009
@@ -62,7 +62,7 @@
can be executed, the build profiles, and so on. Other information such as the project version, description, developers,
mailing lists and such can also be specified.
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
* {Super POM}
@@ -75,7 +75,7 @@
%{snippet|id=superpom|url=http://svn.apache.org/repos/asf/maven/components/tags/maven-2.1.0/maven-project/src/main/resources/org/apache/maven/project/pom-4.0.0.xml}
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
* {Minimal POM}
@@ -117,7 +117,7 @@
the minimal POM, it would know that these dependencies will be downloaded from <<<http://repo1.maven.org/maven2>>> which was specified
in the Super POM.
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
* {Project Inheritance}
@@ -212,7 +212,7 @@
This allows the module to inherit the groupId and / or the version of its parent POM.
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
** {Example 2}
@@ -264,7 +264,7 @@
[]
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
** {Example 3}
@@ -330,7 +330,7 @@
com.mycompany.app:my-module:1 as well. Furthermore, some commands (goals specifically) handle project aggregation
differently.
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
** {Example 4}
@@ -388,7 +388,7 @@
[]
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
** {Example 5}
@@ -465,7 +465,7 @@
<<NOTE:>> Profile inheritance the same inheritance strategy as used for the POM itself.
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
* {Project Interpolation} and Variables
@@ -542,5 +542,5 @@
</project>
+----+
- {{{introduction-to-the-pom.html}[top]}}
+ {{{./introduction-to-the-pom.html}[top]}}
Modified: maven/site/trunk/src/site/apt/guides/mini/guide-archive-configuration.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-archive-configuration.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-archive-configuration.apt (original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-archive-configuration.apt Tue Jun 30 13:27:15 2009
@@ -45,7 +45,7 @@
* Configuring the Manifest
- The archive configuration also accepts manifest configuration. See {{{guide-manifest.html}Guide to Working with Manifests}} for more information.
+ The archive configuration also accepts manifest configuration. See {{{./guide-manifest.html}Guide to Working with Manifests}} for more information.
Modified: maven/site/trunk/src/site/apt/guides/mini/guide-central-repository-upload.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-central-repository-upload.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-central-repository-upload.apt (original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-central-repository-upload.apt Tue Jun 30 13:27:15 2009
@@ -60,7 +60,7 @@
Look at {{{http://java.sun.com/docs/books/jls/third_edition/html/packages.html#7.7}
More information about package names}}. Check also the guide about
- {{{guide-naming-conventions.html}Maven naming conventions}}.
+ {{{./guide-naming-conventions.html}Maven naming conventions}}.
Examples:
@@ -154,7 +154,7 @@
{{{http://sf.net/}Sourceforge}} that provide you {{{http://sourceforge.net/docman/display_doc.php?docid=4297&group_id=1#shell}ssh server access}}.
Or you can {{{http://vafer.org/blog/20081026142413}setup your own server}}.
- After you are able to deploy to your remote repository <<make sure you only deploy releases>>.
+ After you are able to deploy to your remote repository <<make sure you only deploy releases>>.
Then you need to provide us the following information in a comma delimited format
* groupId, eg. <<<org.apache.maven>>>
@@ -186,7 +186,7 @@
Open an issue in {{{http://jira.codehaus.org/secure/CreateIssue.jspa?pid=10367&issuetype=5}JIRA}} with the information (in the comma delimited format), and we'll add it to the
list of automatically synced repositories.
- Make sure you <<provide proof of owning the domain>> that matches the <<<groupId>>> (see <<<groupId>>> considerations above). Proof means either the server to sync from has a name
+ Make sure you <<provide proof of owning the domain>> that matches the <<<groupId>>> (see <<<groupId>>> considerations above). Proof means either the server to sync from has a name
under that domain, your name shows up in a prominent place in the domain or you provide a link to a whois database where your name shows up as the domain owner.
If you are using ssh in your own server you need to add the {{{http://www.ibiblio.org/maven/id_dsa.pub}maven public key}} to the authorized ones to allow us to log
Modified: maven/site/trunk/src/site/apt/guides/mini/guide-configuring-maven.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-configuring-maven.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-configuring-maven.apt (original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-configuring-maven.apt Tue Jun 30 13:27:15 2009
@@ -49,7 +49,7 @@
Proxy configuration can also be specified in the settings file.
- For more information, see the {{{guide-proxies.html} Guide to using a Proxy}}.
+ For more information, see the {{{./guide-proxies.html} Guide to using a Proxy}}.
* Configuring Parallel Artifact Resolution
Modified: maven/site/trunk/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt (original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-coping-with-sun-jars.apt Tue Jun 30 13:27:15 2009
@@ -67,7 +67,7 @@
location and retrieval information.
Once you have downloaded a particular Sun JAR to your system you can install the JAR
- in your local repository. Please refer to our {{{guide-3rd-party-jars-local.html}Guide to installing 3rd party JARs}}
+ in your local repository. Please refer to our {{{./guide-3rd-party-jars-local.html}Guide to installing 3rd party JARs}}
for instructions on how to accomplish this.
<<Note>>: Java.net provides a {{{http://download.java.net/maven/2/}Maven 2 repository}}. You could specify it directly in your POM or
Modified: maven/site/trunk/src/site/apt/guides/mini/guide-maven-evangelism.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-maven-evangelism.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-maven-evangelism.apt (original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-maven-evangelism.apt Tue Jun 30 13:27:15 2009
@@ -18,7 +18,7 @@
An alternative is to create a new version with the fixes. If the broken project is org.foo/bar/1.0 you can
provide a fixed POM,JAR,... under org.foo/bar/1.0-1 (add a comment to the POM explaining what is being fixed
- and why). See {{{guide-central-repository-upload.html}Maven Respository Upload}} for the instructions to
+ and why). See {{{./guide-central-repository-upload.html}Maven Respository Upload}} for the instructions to
get this new version in the repository.
You need to contact the original publisher of the metadata to make sure in next versions it will
Modified: maven/site/trunk/src/site/apt/guides/mini/guide-proxies.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-proxies.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-proxies.apt (original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-proxies.apt Tue Jun 30 13:27:15 2009
@@ -45,4 +45,4 @@
[[1]] {{{../../maven-settings/settings.html}Settings descriptor documentation}}
- [[2]] {{{guide-configuring-maven.html}Configuring Maven}}
+ [[2]] {{{./guide-configuring-maven.html}Configuring Maven}}
Modified: maven/site/trunk/src/site/apt/guides/mini/guide-site.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/mini/guide-site.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/mini/guide-site.apt (original)
+++ maven/site/trunk/src/site/apt/guides/mini/guide-site.apt Tue Jun 30 13:27:15 2009
@@ -38,7 +38,7 @@
has been replaced by the site descriptor (see below).
The APT format, "Almost Plain Text", is a wiki-like format that allows you to write simple, structured documents (like this one)
- very quickly. A full reference of the {{{guide-apt-format.html} APT Format}} is available.
+ very quickly. A full reference of the {{{./guide-apt-format.html} APT Format}} is available.
The FML format is the FAQ format, also used in Maven 1.x.
Modified: maven/site/trunk/src/site/apt/guides/plugin/guide-java-plugin-development.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/plugin/guide-java-plugin-development.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/plugin/guide-java-plugin-development.apt (original)
+++ maven/site/trunk/src/site/apt/guides/plugin/guide-java-plugin-development.apt Tue Jun 30 13:27:15 2009
@@ -200,24 +200,6 @@
*** Shortening the Command Line
-~~ [jdcasey; 10-Jan-2006]
-~~
-~~ I'm commenting this out, since it's obsolete. The plugin version
-~~ manager now checks LATEST metadata before it checks RELEASE metadata.
-~~ Since LATEST metadata is _always_ published for plugins, nothing
-~~ special needs to be done for the prefix matching to work.
-~~
-~~ It is possible to shorten the amount of typing needed on the command
-~~ line. To do this, you need to install the plugin with the
-~~ <<<updateReleaseInfo>>> option set to true; for example:
-~~
-~~ +----+
-~~ mvn -DupdateReleaseInfo=true install
-~~ +----+
-~~
-~~ You also need to add your plugin's group ID to the list of group IDs
-
-
There are several ways to reduce the amount of required typing:
* If you need to run the latest version of a plugin installed in your local
Modified: maven/site/trunk/src/site/apt/plugins/index.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/plugins/index.apt?rev=789717&r1=789716&r2=789717&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/plugins/index.apt (original)
+++ maven/site/trunk/src/site/apt/plugins/index.apt Tue Jun 30 13:27:15 2009
@@ -41,10 +41,10 @@
~~ TODO: the repository manager should be able to produce a page like this. Ensure all descriptions are in the POM of these plugins.
-~~ -----------------------------------------------------------------------------
+~~ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
~~ The release dates in this table must follow the ISO-8601 standard: yyyy-MM-dd
~~ See http://maven.apache.org/guides/development/guide-documentation-style.html
-~~ -----------------------------------------------------------------------------
+~~ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
*-----------------------------------------------------------+--------------+------------+------------------+------------------------+--------------------+