Author: brett
Date: Fri Sep 16 09:57:41 2005
New Revision: 289610
URL: http://svn.apache.org/viewcvs?rev=289610&view=rev
Log:
remove tech preview references
Modified:
maven/components/trunk/maven-site/src/site/fml/about.fml
maven/components/trunk/maven-site/src/site/fml/maven1.fml
maven/components/trunk/maven-site/src/site/xdoc/developers/developing-plugins-with-marmalade.xml
maven/components/trunk/maven-site/src/site/xdoc/download.xml
maven/components/trunk/maven-site/src/site/xdoc/roadmap.xml
Modified: maven/components/trunk/maven-site/src/site/fml/about.fml
URL:
http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/fml/about.fml?rev=289610&r1=289609&r2=289610&view=diff
==============================================================================
--- maven/components/trunk/maven-site/src/site/fml/about.fml (original)
+++ maven/components/trunk/maven-site/src/site/fml/about.fml Fri Sep 16
09:57:41 2005
@@ -83,15 +83,19 @@
</faq>
<faq id="tech-review">
- <question>What does Technology Preview mean?</question>
+ <question>What does beta release mean?</question>
<answer>
<p>
- While Maven 2.0 is quite useful as is, it does not yet have all of
the features of it's predecessor, and has
- some limitations that may impede it's use on a day-to-day basis in
your projects.
+ Maven 2.0 is now in beta testing. We believe it is equally
functional to Maven 1.0, however there are still
+ some bugs and usabilities issues including documentation to be
resolved.
</p>
<p>
- This release is being made available so that people who are
interested in the future of Maven can take a
- sneak peek, while those interested in becoming early adopters can
get involved in the development and
+ While some minor features may be added, the key goal is to retain
backwards compatibility so this will be
+ limited.
+ </p>
+ <p>
+ This release is being made available so that people who are
interested in using Maven 2 when it is released
+ can test and provide feedback, and those interested can get involved
in the development and
direction of the project.
</p>
<p>
@@ -106,11 +110,11 @@
<question>How often will Maven 2.0 be released?</question>
<answer>
<p>
- We are working to a 4-5 week release cycle, meaning that there will
be at least one release per month.
+ We are working to a fortnightly release cycle until the final
release.
</p>
<p>
- The first releases such as the technology preview will be designated
"alpha" releases, indicating that
- they are not yet feature complete and there are outstanding bugs.
Following that, "beta" releases will be
+ The first releases such as the technology preview were designated
"alpha" releases, indicating that
+ they were not yet feature complete and there were outstanding bugs.
Following that, "beta" releases are being
made available where introduction of new features will be restricted
and the focus on improving usability and
stability. Finally, one or more release candidates will be
distributed for testing that are genuinely believed
to be final, with the expectation that a final release would be
available shortly afterwards.
@@ -208,10 +212,6 @@
in the
<i>Channel</i>
box).
- </p>
- <p>
- Please remember that it is a preview release, so please be patient
with features that are not yet implemented,
- and be prepared to do some research and to help out yourself
wherever possible.
</p>
</answer>
</faq>
Modified: maven/components/trunk/maven-site/src/site/fml/maven1.fml
URL:
http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/fml/maven1.fml?rev=289610&r1=289609&r2=289610&view=diff
==============================================================================
--- maven/components/trunk/maven-site/src/site/fml/maven1.fml (original)
+++ maven/components/trunk/maven-site/src/site/fml/maven1.fml Fri Sep 16
09:57:41 2005
@@ -11,48 +11,66 @@
</p>
<ul>
<li>
- <i>Faster and smaller</i> - The Maven core no longer uses Ant,
Jelly or Xerces making it much smaller, has
+ <i>Faster and smaller</i>
+ - The Maven core no longer uses Ant, Jelly or Xerces making it
much smaller, has
fewer dependencies and is perfect for embedding in other tools.
</li>
<li>
- <i>Defined build lifecycle</i> - No more
- <code>prereqs</code>,
- <code>preGoals</code> and
- <code>postGoals</code>.
+ <i>Defined build lifecycle</i>
+ - No more
+ <code>prereqs</code>
+ ,
+ <code>preGoals</code>
+ and
+ <code>postGoals</code>
+ .
The build is a series of well defined phases. This also means that
the normal goal names are not used -
- <code>compile</code>,
- <code>test</code> and
- <code>install</code> work for any project type.
+ <code>compile</code>
+ ,
+ <code>test</code>
+ and
+ <code>install</code>
+ work for any project type.
</li>
<li>
- <i>Built-in multiple project handling</i> - Use the same goals on
a set of projects, and aggregate the
+ <i>Built-in multiple project handling</i>
+ - Use the same goals on a set of projects, and aggregate the
results.
</li>
<li>
<i>Improved
- <code>SNAPSHOT</code> handling
- </i> - Snapshots are now checked for updates only once per day by
+ <code>SNAPSHOT</code>
+ handling
+ </i>
+ - Snapshots are now checked for updates only once per day by
default - though can be configured to be once per build, on a
particular interval, or never. A command line
option can force a check - making it more like updating from an
SCM.
</li>
<li>
- <i>No more properties files</i> - All plugins are now configured
from the POM (which is now called
- <code>pom.xml</code>).
+ <i>No more properties files</i>
+ - All plugins are now configured from the POM (which is now called
+ <code>pom.xml</code>
+ ).
</li>
<li>
<i>No more
<code>maven.xml</code>
- </i> - Plugins are now easier to build and integrate, and are the
only way
- to script your builds. (Note that additions may later be made to
the POM to allow simple things that scripting
+ </i>
+ - Plugins are now easier to build and integrate, and are the only
way
+ to script your builds. (Note that additions may later be made to
the POM to allow simple things that
+ scripting
was used for, such as goal aliasing).
</li>
<li>
- <i>No more Jelly</i> - Plugins are primarily written in Java,
though there are providers for other scripting languages.
- This release includes support for Marmalade, a scripting framework
that supports an XML syntax similar to Jelly
+ <i>No more Jelly</i>
+ - Plugins are primarily written in Java, though there are
providers for other scripting languages.
+ This release includes support for Marmalade, a scripting framework
that supports an XML syntax similar to
+ Jelly
which can be used to integrate Ant tasks and has a Jelly
compatibility layer.
</li>
<li>
- <i>Improved repository layout</i> - Maven 2.0 supports both the
existing layout, and an improved repository
+ <i>Improved repository layout</i>
+ - Maven 2.0 supports both the existing layout, and an improved
repository
layout that has deeper, partitioned structure making it easier to
browse.
</li>
</ul>
@@ -65,19 +83,22 @@
The answer depends very much on on your circumstances, and in
particular whether you are new to Maven or not.
</p>
<p>
- The simple answer is that we hope you'll try Maven 2.0, and use it
if it works for you. However, it is a preview
- release, so you can expect some features to be missing at this point
and there may be unexpected bugs.
- We'd hate for your first experience with Maven 2.0 to be a bad one -
so if you are embarking on a big, complicated
+ The simple answer is that we hope you'll try Maven 2.0, and use it
if it works for you. However, it is a beta
+ release, so you can expect some unexpected bugs.
+ We'd hate for your first experience with Maven 2.0 to be a bad one -
so if you are embarking on a big,
+ complicated
or mission critical project - we still recommend Maven 1.0.2 as the
latest stable release.
</p>
<p>
- If you are already using Maven 1.0 - feel free to try out Maven 2.0,
but it may be better to remain on an existing
+ If you are already using Maven 1.0 - feel free to try out Maven 2.0,
but it may be better to remain on an
+ existing
version that is working for you until you need the new features and
it covers all of your needs.
</p>
<p>
If you do use Maven 1.0, and would like to upgrade in the future,
you should carefully consider following some
of the
- <a href="http://maven.apache.org/using/bestpractices.html">Best
Practices</a> listed. These will make
+ <a href="http://maven.apache.org/using/bestpractices.html">Best
Practices</a>
+ listed. These will make
your project a lot easier to migrate in the future.
</p>
<p>
@@ -85,14 +106,16 @@
</p>
<ul>
<li>
- <i>Error handling</i> - there are occasions where Maven 2.0 will
drop out with a long stack trace
+ <i>Error handling</i>
+ - there are occasions where Maven 2.0 will drop out with a long
stack trace
when an error has occurred. If a specific trace is not providing
enough information to find out what went
wrong, please post the message to JIRA.
</li>
<li>
- <i>Availability of other plugins</i> - While most of the core
Maven 1.x plugins have been converted,
- there are still some not available, or not with the same level
of features or documentation. In
- addition, several 3rd party plugins may not be available. Maven
2.0 cannot execute Maven 1.0 plugins.
+ <i>Availability of other plugins</i>
+ - While most of the core Maven 1.x plugins have been converted,
+ there are still some not available, or not with the same level of
features or documentation. In
+ addition, several 3rd party plugins may not be available. Maven
2.0 cannot execute Maven 1.0 plugins.
</li>
</ul>
</answer>
@@ -125,29 +148,35 @@
</answer>
</faq>
<faq id="m1-maven-xml">
- <question>How do I write custom scripts without a <code>maven.xml</code>
file?</question>
+ <question>How do I write custom scripts without a
+ <code>maven.xml</code>
+ file?
+ </question>
<answer>
- <p>Taken from <a
href="http://mail-archives.apache.org/mod_mbox/maven-users/200504.mbox/[EMAIL
PROTECTED]">this post to the Maven User's List</a>:
+ <p>Taken from
+ <a
href="http://mail-archives.apache.org/mod_mbox/maven-users/200504.mbox/[EMAIL
PROTECTED]">
+ this post to the Maven User's List</a>
+ :
</p>
<blockquote>
-Everything in m2 is a plugin so for doing any sort of custom work like
-that you will need to make a plugin. This 1) greatly reduces the
-complexity within m2 because we only deal with proper plugins. The
-maven.xml file in m1 was a psuedo plugin essentially and greatly
-complicated the internals and 2) it promotes the sharing of your work
-right from the get go. To start with you'll probably write a plugin that
-is only applicable to your specific requirements, or your team's work,
-but you'll see people asking for some functionality and you'll go "hey,
-I have something like that!" and hopefully people who have concrete
-solutions will generalize their solutions so they can be shared with
-others. That's what we're trying to encourage.
+ Everything in m2 is a plugin so for doing any sort of custom work
like
+ that you will need to make a plugin. This 1) greatly reduces the
+ complexity within m2 because we only deal with proper plugins. The
+ maven.xml file in m1 was a psuedo plugin essentially and greatly
+ complicated the internals and 2) it promotes the sharing of your work
+ right from the get go. To start with you'll probably write a plugin
that
+ is only applicable to your specific requirements, or your team's
work,
+ but you'll see people asking for some functionality and you'll go
"hey,
+ I have something like that!" and hopefully people who have concrete
+ solutions will generalize their solutions so they can be shared with
+ others. That's what we're trying to encourage.
</blockquote>
<blockquote>
-We estimate that there's a lot of work bound up in project's maven.xml
-that is not being shared and we'd like to try and change that. We plan
-to make it dead simple to share plugins and hopefully people can use
-other project's plugins as a start for a plugin that they may need
-themselves.
+ We estimate that there's a lot of work bound up in project's
maven.xml
+ that is not being shared and we'd like to try and change that. We
plan
+ to make it dead simple to share plugins and hopefully people can use
+ other project's plugins as a start for a plugin that they may need
+ themselves.
</blockquote>
</answer>
</faq>
Modified:
maven/components/trunk/maven-site/src/site/xdoc/developers/developing-plugins-with-marmalade.xml
URL:
http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/xdoc/developers/developing-plugins-with-marmalade.xml?rev=289610&r1=289609&r2=289610&view=diff
==============================================================================
---
maven/components/trunk/maven-site/src/site/xdoc/developers/developing-plugins-with-marmalade.xml
(original)
+++
maven/components/trunk/maven-site/src/site/xdoc/developers/developing-plugins-with-marmalade.xml
Fri Sep 16 09:57:41 2005
@@ -27,10 +27,11 @@
<body>
<section name="Developing Plugins with Marmalade">
<p>
- NOTE: Compare this tutorial to
+ NOTE: Compare this tutorial to
<a
href="http://maven.apache.org/using/developing-plugins.html">Developing
- Plugins</a> from the Maven 1.0 website. Marmalade is meant to be
quite similar to Jelly in its
- syntax, so this process should be very familiar to Maven 1.0 plugin
developers.
+ Plugins</a>
+ from the Maven 1.0 website. Marmalade is meant to be quite similar to
Jelly in its
+ syntax, so this process should be very familiar to Maven 1.0 plugin
developers.
</p>
<!-- TODO
<p>
@@ -41,9 +42,8 @@
<subsection name="Graduating from Jelly: Plugins in Marmalade">
<p>
- Beginning in Maven 2.0, plugins can be implemented in various
languages. While our initial
- technology preview will only offer support for these Marmalade and
Java, we will eventually add
- support for additional languages, possibly including
Beanshell/Janino, Javascript, and more.
+ Beginning in Maven 2.0, plugins can be implemented in various
languages, including Marmalade, Java and
+ Beanshell.
</p>
<p>
@@ -67,7 +67,7 @@
</p>
<p>
- For those Maven 1.x users who have implemented their own plugins
using Jelly, Marmalade can be
+ For those Maven 1.x users who have implemented their own plugins
using Jelly, Marmalade can be
an extremely powerful language for porting to Maven 2.0.
</p>
@@ -88,25 +88,29 @@
<ul>
<li>One or more implementations of MarmaladeTag</li>
<li>An implementation of
- <code>MarmaladeTagLibrary</code>, the constructor of which
registers
- each MarmaladeTag implementation to a tag name (for use in
scripts)
+ <code>MarmaladeTagLibrary</code>
+ , the constructor of which registers
+ each MarmaladeTag implementation to a tag name (for use in
scripts)
</li>
</ul>
</li>
<li>
[Required] A
- <code>pom.xml</code> for building the plugin, which contains a
script source directory
+ <code>pom.xml</code>
+ for building the plugin, which contains a script source directory
resembling
<code><![CDATA[<scriptSourceDirectory>src/main/scripts</scriptSourceDirectory>]]></code>
</li>
- <li>[Optional] Plugin resources to be used from within the
plugin's scripts (available on the classpath)</li>
+ <li>[Optional] Plugin resources to be used from within the
plugin's scripts (available on the
+ classpath)</li>
<li>[Optional] Other Java sources, which can be accessed from the
plugin's scripts</li>
</ul>
</p>
<p>
Each
- <code>.mmld</code> script file must provide the same basic
structural elements, which define it
+ <code>.mmld</code>
+ script file must provide the same basic structural elements, which
define it
as a Maven 2.0 plugin, and provide essential metadata. This metadata
is used to:
<ul>
<li>Inject project and environmental information into the plugin
(parameters)</li>
@@ -156,7 +160,8 @@
</p>
<p>
In a new directory, create a
- <code>pom.xml</code> file like so:
+ <code>pom.xml</code>
+ file like so:
</p>
<source><![CDATA[<project>
<modelVersion>4.0.0</modelVersion>
@@ -206,7 +211,8 @@
Since this is in fact a Hello World plugin, your script will simply
output
<code>Hello, World</code>
to the screen. Create a script in
- <code>src/main/scripts/hello.mmld</code> with the following contents:
+ <code>src/main/scripts/hello.mmld</code>
+ with the following contents:
</p>
<source><![CDATA[
<mojo xmlns="marmalade:mojo">
@@ -238,11 +244,12 @@
<subsection name="Using Plugin Parameters">
<p>
While you can always reference the POM information in a script using
mojo parameters with expressions
- that reference project elements, a plugin will often need to create
new parameters so that it can be customised.
+ that reference project elements, a plugin will often need to create
new parameters so that it can be
+ customised.
</p>
<p>
- The creation of these parameters simply involves defining them in
the metadata section of the script,
+ The creation of these parameters simply involves defining them in
the metadata section of the script,
and optionally providing a default value for use in the event the
user doesn't need to customize the plugin.
</p>
<p>
@@ -270,14 +277,17 @@
]]></source>
<p>
Note the additional element in this parameter declaration:
- <code>default</code> specified a default
+ <code>default</code>
+ specified a default
salutation in case the user doesn't need or want to customize the
plugin.
</p>
<p>
Now, to make use of the new parameter. Inside the
- <code><![CDATA[<c:out/>]]></code> action, simply
+ <code><![CDATA[<c:out/>]]></code>
+ action, simply
write out the customizable salutation instead of the stock phrase
- <code>Hello</code>:
+ <code>Hello</code>
+ :
</p>
<source><![CDATA[
<c:out xmlns:c="marmalade:core">${salutation}, World.</c:out>
@@ -286,9 +296,9 @@
Install the new plugin and run it, to verify your changes:
</p>
<source>m2 install
-m2 hello:hello</source>
+ m2 hello:hello</source>
<p>
- Notice that the output still has the same old salutation (which is
the default value of the parameter).
+ Notice that the output still has the same old salutation (which is
the default value of the parameter).
Now, to customize it:
</p>
<source>m2 -Dsalutation=Hiya hello:hello</source>
Modified: maven/components/trunk/maven-site/src/site/xdoc/download.xml
URL:
http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/xdoc/download.xml?rev=289610&r1=289609&r2=289610&view=diff
==============================================================================
--- maven/components/trunk/maven-site/src/site/xdoc/download.xml (original)
+++ maven/components/trunk/maven-site/src/site/xdoc/download.xml Fri Sep 16
09:57:41 2005
@@ -91,11 +91,6 @@
<a href="http://maven.apache.org/license.html">Apache License, version
2.0</a>
.
</p>
- <p>
- The Ant tasks contain the JCraft Jsch library for deployment via SSH.
For more information, see their
- <a href="http://www.jcraft.com/jsch/LICENSE.txt">License and Copyright
notice</a>
- .
- </p>
<a name="requirements"/>
<subsection name="System Requirements">
<table>
Modified: maven/components/trunk/maven-site/src/site/xdoc/roadmap.xml
URL:
http://svn.apache.org/viewcvs/maven/components/trunk/maven-site/src/site/xdoc/roadmap.xml?rev=289610&r1=289609&r2=289610&view=diff
==============================================================================
--- maven/components/trunk/maven-site/src/site/xdoc/roadmap.xml (original)
+++ maven/components/trunk/maven-site/src/site/xdoc/roadmap.xml Fri Sep 16
09:57:41 2005
@@ -9,27 +9,18 @@
This document discusses the release plans and current roadmap for
Maven 2.0.
</p>
<p>
- We are working to a 4-5 week release cycle, meaning that there will be
at least one release per month.
- </p>
- <p>
- The first releases such as the technology preview will be designated
"alpha" releases, indicating that
- they are not yet feature complete and there are outstanding bugs.
Following that, "beta" releases will be
- made available where introduction of new features will be restricted
and the focus on improving usability and
- stability. Finally, one or more release candidates will be distributed
for testing that are genuinely believed
- to be final, with the expectation that a final release would be
available shortly afterwards.
- </p>
- <p>
- We will continue with the successful technique from Maven 1.0 of
making plugins available on a separate
+ Note that we will continue with the successful technique from Maven
1.0 of making plugins available on a
+ separate
release schedule so that new features can be obtained as they are
ready and tested.
</p>
<subsection name="Maven 2.0 beta 1">
<p>
- <i>Expected Release:</i>
- mid-August 2005
+ <i>Released:</i>
+ 16th September 2005
</p>
<p>
<i>Aims and features:</i>
- This will be feature complete and stable. There are expected to be
+ This is feature complete and stable. There are expected to be
bug fixes and cosmetic changes, but no new major features after this
release.
</p>
<ul>
@@ -43,7 +34,21 @@
<subsection name="Maven 2.0 beta 2">
<p>
<i>Expected Release:</i>
- late-August 2005
+ late-September 2005
+ </p>
+ <p>
+ <i>Aims and features:</i>
+ Completion of all major work on the core engine.
+ </p>
+ <ul>
+ <li>Bugfixes</li>
+ <li>Cosmetic enhancements</li>
+ </ul>
+ </subsection>
+ <subsection name="Maven 2.0 beta 3">
+ <p>
+ <i>Expected Release:</i>
+ early-October 2005
</p>
<p>
<i>Aims and features:</i>
@@ -58,7 +63,7 @@
<subsection name="Maven 2.0 Final">
<p>
<i>Expected Release:</i>
- September 2005, following a release candidate
+ October 2005, following a release candidate
</p>
<p>
<i>Aims and features:</i>
@@ -81,8 +86,7 @@
<subsection name="Maven 2.1">
<p>
<i>Aims and features:</i>
- Features to be added after the July freeze on Maven 2.0 will be
slated for a 2.1
- release later in 2005.
+ Features to be added after the freeze on Maven 2.0 will be slated
for a 2.1 release in 2006.
</p>
</subsection>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]