You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by ep...@apache.org on 2004/07/24 19:03:48 UTC
cvs commit: maven/xdocs navigation.xml navigation-pdf.xml
epugh 2004/07/24 10:03:48
Modified: xdocs/reference user-guide.xml
xdocs/reference/developers releasing-plugins.xml
xdocs/ant-guide/qna speed.xml hooks.xml help.xml
antfarming.xml
xdocs navigation.xml navigation-pdf.xml
Log:
MAVEN-1386 Remainder of doc fixes by Dennis Lundberg
Revision Changes Path
1.71 +5 -4 maven/xdocs/reference/user-guide.xml
Index: user-guide.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/reference/user-guide.xml,v
retrieving revision 1.70
retrieving revision 1.71
diff -u -r1.70 -r1.71
--- user-guide.xml 23 Jul 2004 04:52:09 -0000 1.70
+++ user-guide.xml 24 Jul 2004 17:03:48 -0000 1.71
@@ -168,9 +168,9 @@
<project>
<pomVersion>3</pomVersion>
- <groupId>maven</groupId>
<artifactId>maven</artifactId>
<name>Maven</name>
+ <groupId>maven</groupId>
<currentVersion>1.0-b5-dev</currentVersion>
<organization>
<name>Apache Software Foundation</name>
@@ -201,9 +201,9 @@
<project>
<extend>parent-project.xml</extend>
- <groupId>super-extendo</groupId>
<artifactId>super-extendo</artifactId>
<name>Super Extendo</name>
+ <groupId>super-extendo</groupId>
<build>
<unitTest>
@@ -234,9 +234,9 @@
<source><![CDATA[
<project>
<pomVersion>3</pomVersion>
- <groupId>commons</groupId>
<artifactId>commons-master</artifactId>
<name>Commons Master Maven POM</name>
+ <groupId>commons</groupId>
<organization>
<name>Apache Software Foundation</name>
@@ -269,9 +269,10 @@
<source><![CDATA[
<project>
- <groupId>commons-betwixt</groupId>
+ <extend>master-project.xml</extend>
<artifactId>commons-betwixt</artifactId>
<name>Betwixt</name>
+ <groupId>commons-betwixt</groupId>
...
</project>
]]></source>
1.9 +2 -3 maven/xdocs/reference/developers/releasing-plugins.xml
Index: releasing-plugins.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/reference/developers/releasing-plugins.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- releasing-plugins.xml 23 Jul 2004 04:40:08 -0000 1.8
+++ releasing-plugins.xml 24 Jul 2004 17:03:48 -0000 1.9
@@ -74,7 +74,7 @@
</li>
<li>
<p>
- Go the <a href="http://jira.codehaus.org/secure/project/ViewProjects.jspa">JIRA administration page</a>
+ Go to the <a href="http://jira.codehaus.org/secure/project/ViewProjects.jspa">JIRA administration page</a>
for the Maven plugin you have just released (Note that you need to be a JIRA administrator for this project) and
<strong>release</strong> the version. Also make sure to <strong>add</strong> a new version for the following
development version. This is required so that issue creators/plugin developers can assign a "fix for" version
@@ -107,7 +107,6 @@
These versions can go beyond 10: eg <code>1.13</code>.
A third version increment is optional and signifies minor updates. These may also be deployed as
snapshots or users may just be asked to build out of CVS to acquire these fixes.
- eg. <code>1.0.1</code> - use less whitespace in output HTML.
</p>
</li>
<li>
@@ -119,7 +118,7 @@
</p>
</li>
<li>
- <p> Q: Why would I want to given all the pain it will take?</p>
+ <p> Q: Why would I want to, given all the pain it will take?</p>
<p> A: Several possible answers... :-) Pick yours: </p>
<ol>
<li><p> Because, making a release is honorific and you'll be thanked for it! </p></li>
1.4 +1 -1 maven/xdocs/ant-guide/qna/speed.xml
Index: speed.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/ant-guide/qna/speed.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- speed.xml 23 Jul 2004 04:40:07 -0000 1.3
+++ speed.xml 24 Jul 2004 17:03:48 -0000 1.4
@@ -44,7 +44,7 @@
<p>
Part of the misconception comes from claims that building the site or building 30 projects
takes a lot of CPU and memory. Well, this would happen in Ant too if it were attempted!
- This area is also a focus for future development so generating these types of parts of the build
+ This area is also a focus for future development so that generating these parts of the build
are much faster.
</p>
</subsection>
1.3 +4 -2 maven/xdocs/ant-guide/qna/hooks.xml
Index: hooks.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/ant-guide/qna/hooks.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- hooks.xml 23 Jul 2004 04:40:07 -0000 1.2
+++ hooks.xml 24 Jul 2004 17:03:48 -0000 1.3
@@ -41,7 +41,8 @@
So, here is a sample <code>maven.xml</code> file that demonstrates how this would be achieved:
</p>
<source><![CDATA[<project xmlns:ant="jelly:ant">
- <!-- The java:jar-resources goal copies resources into target/classes so that they are included in the JAR at / -->
+ <!-- The java:jar-resources goal copies resources into target/classes -->
+ <!-- so that they are included in the JAR at / -->
<postGoal name="java:jar-resources">
<attainGoal name="generate-dynamic-resources" />
<!-- maven.build.dest is the location where resources are put -->
@@ -52,7 +53,8 @@
<!-- Here is the goal you've defined to generate the resources in some fashion -->
<goal name="generate-dynamic-resources">
- <!-- Place them into ${maven.build.dir}/generated-resources according to the fragment above -->
+ <!-- Place them into ${maven.build.dir}/generated-resources according to -->
+ <!-- the fragment above -->
...
</goal>
</project>]]></source>
1.3 +5 -5 maven/xdocs/ant-guide/qna/help.xml
Index: help.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/ant-guide/qna/help.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- help.xml 23 Jul 2004 04:40:07 -0000 1.2
+++ help.xml 24 Jul 2004 17:03:48 -0000 1.3
@@ -34,17 +34,17 @@
<subsection name="Help in Ant">
<p>
If you were using Ant, you'd probably run <code>ant -projecthelp</code>, and if that didn't help,
- just run "ant" and hope the defualt goal is what you wanted.
+ just run "ant" and hope the default target is what you wanted.
A build.properties.sample file may have been provided so you'd copy that and edit it to see if that
helped. Then you'd fix individual problems as they came up.
- If everything goes wrong and you can't find the right goal or what property it's expecting, you dig into
+ If everything goes wrong and you can't find the right target or what property it's expecting, you dig into
build.xml and look at what it is attempting.
</p>
<p>
The process for Maven should be simpler unless the project is being really unhelpful.
</p>
</subsection>
- <subsection name="Help for a simple Maven project - no maven.xml">
+ <subsection name="Help for a simple Maven project without a maven.xml file">
<p>
If there is no <code>maven.xml</code> file, then you know the build hasn't been customised so you can rely on
a few things working.
@@ -57,11 +57,11 @@
</p>
<p>
You shouldn't expect to have to define any properties outside what the project has provided and you have
- already defined to get Maven running, as only the standard Mavne plugin properties are being used, and you
+ already defined to get Maven running, as only the standard Maven plugin properties are being used, and you
know how they behave.
</p>
</subsection>
- <subsection name="Help for a Maven project with maven.xml">
+ <subsection name="Help for a Maven project with a maven.xml file">
<p>
If there is a <code>maven.xml</code> file, then the build has been customised. You can still rely on the
above goals doing what they advertise, but they might not be the recommended way of building that
1.3 +2 -2 maven/xdocs/ant-guide/qna/antfarming.xml
Index: antfarming.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/ant-guide/qna/antfarming.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- antfarming.xml 23 Jul 2004 04:40:07 -0000 1.2
+++ antfarming.xml 24 Jul 2004 17:03:48 -0000 1.3
@@ -33,7 +33,7 @@
</p>
<p>
To do anything with Maven, you will still need to set up a
- <a href="/reference/project-descriptor.html">project.xml</a> file with the information you need to do
+ <a href="../../reference/project-descriptor.html">project.xml</a> file with the information you need to do
the Maven tasks you are using.
</p>
<p>
@@ -58,7 +58,7 @@
<source><![CDATA[
<project xmlns:ant="jelly:ant">
<preGoal name="site">
- <!-- Set the property html.dir that your Ant build expected to be able to put the HTML into -->
+ <!-- Set the property html.dir that your Ant build uses to put the HTML into -->
<ant:property name="html.dir" value="${maven.docs.dest}" />
<ant:ant dir="${basedir}" antfile="build.xml" target="generate-html" />
</preGoal>
1.45 +1 -2 maven/xdocs/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/navigation.xml,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -r1.44 -r1.45
--- navigation.xml 23 Jul 2004 04:52:09 -0000 1.44
+++ navigation.xml 24 Jul 2004 17:03:48 -0000 1.45
@@ -63,7 +63,7 @@
<item name="Best Product for Job" href="/ant-guide/where.html"/>
<item name="Practical" href="/ant-guide/practical.html" collapse="false">
<item name="Maven Speed" href="/ant-guide/qna/speed.html"/>
- <item name="Dependencies" href="/ant-guide/qna/hooks.html"/>
+ <item name="Hooks" href="/ant-guide/qna/hooks.html"/>
<item name="Ant Targets" href="/ant-guide/qna/antfarming.html"/>
<item name="Project Help" href="/ant-guide/qna/help.html"/>
<item name="Properties" href="/ant-guide/qna/properties.html"/>
@@ -84,7 +84,6 @@
<item name="Articles" href="/misc/articles.html"/>
<item name="Glossary" href="/misc/glossary.html"/>
<item name="Powered By" href="/misc/powered.html"/>
- <item name="Tasks" href="/misc/tasks.html"/>
</item>
<item name="Apache" href="/apache/index.html" collapse="true">
<item name="Committer FAQ" href="http://www.apache.org/dev/committers.html"/>
1.9 +1 -1 maven/xdocs/navigation-pdf.xml
Index: navigation-pdf.xml
===================================================================
RCS file: /home/cvs/maven/xdocs/navigation-pdf.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- navigation-pdf.xml 23 Jul 2004 04:52:09 -0000 1.8
+++ navigation-pdf.xml 24 Jul 2004 17:03:48 -0000 1.9
@@ -51,7 +51,7 @@
<item name="Best Product for Job" href="/ant-guide/where.html"/>
<item name="Practical" href="/ant-guide/practical.html">
<item name="Maven Speed" href="/ant-guide/qna/speed.html"/>
- <item name="Dependencies" href="/ant-guide/qna/hooks.html"/>
+ <item name="Hooks" href="/ant-guide/qna/hooks.html"/>
<item name="Ant Targets" href="/ant-guide/qna/antfarming.html"/>
<item name="Project Help" href="/ant-guide/qna/help.html"/>
<item name="Properties" href="/ant-guide/qna/properties.html"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org