You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sc...@apache.org on 2006/03/25 14:24:51 UTC
svn commit: r388751 - in /jakarta/commons/proper/email/trunk: ./ xdocs/
Author: scolebourne
Date: Sat Mar 25 05:24:50 2006
New Revision: 388751
URL: http://svn.apache.org/viewcvs?rev=388751&view=rev
Log:
Enhance website and remove commons-build dependency
Added:
jakarta/commons/proper/email/trunk/xdocs/building.xml (with props)
jakarta/commons/proper/email/trunk/xdocs/cvs-usage.xml (with props)
jakarta/commons/proper/email/trunk/xdocs/issue-tracking.xml (with props)
jakarta/commons/proper/email/trunk/xdocs/release_1_0.xml (with props)
jakarta/commons/proper/email/trunk/xdocs/userguide.xml
- copied, changed from r388741, jakarta/commons/proper/email/trunk/xdocs/examples.xml
Removed:
jakarta/commons/proper/email/trunk/xdocs/downloads.xml
jakarta/commons/proper/email/trunk/xdocs/examples.xml
Modified:
jakarta/commons/proper/email/trunk/maven.xml
jakarta/commons/proper/email/trunk/project.properties
jakarta/commons/proper/email/trunk/project.xml
jakarta/commons/proper/email/trunk/xdocs/changes.xml
jakarta/commons/proper/email/trunk/xdocs/index.xml
jakarta/commons/proper/email/trunk/xdocs/navigation.xml
Modified: jakarta/commons/proper/email/trunk/maven.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/maven.xml?rev=388751&r1=388750&r2=388751&view=diff
==============================================================================
--- jakarta/commons/proper/email/trunk/maven.xml (original)
+++ jakarta/commons/proper/email/trunk/maven.xml Sat Mar 25 05:24:50 2006
@@ -21,37 +21,6 @@
xmlns:j="jelly:core"
default="jar:jar">
- <!-- ================================================================== -->
- <!-- START : C O M M O N S - B U I L D -->
- <!-- ================================================================== -->
- <!-- Required: Look and Feel for documentation within distributions -->
- <!-- ================================================================== -->
- <preGoal name="xdoc:init">
- <ant:available type="dir" property="commons.basedir.available" file="${basedir}/../commons-build" />
- <j:if test="${context.getVariable('commons.basedir.available') == null}">
- <fail>
-------------------------------------------------------------------------------
-| if you want to build xdocs or the site, you must
-| check out the 'commons-build' module from
-| http://svn.apache.org/repos/asf/jakarta/commons/proper/commons-build/trunk/
-| and put it in a directory next to commons-email
-------------------------------------------------------------------------------
- </fail>
- </j:if>
- </preGoal>
-
- <postGoal name="xdoc:copy-resources">
- <copy todir="${basedir}/target/docs/style/" failonerror="false">
- <fileset dir="${basedir}/../commons-build/xdocs/style">
- <include name='**/*'/>
- <exclude name='**/CVS/**'/>
- </fileset>
- </copy>
- </postGoal>
- <!-- ================================================================== -->
- <!-- END: C O M M O N S - B U I L D -->
- <!-- ================================================================== -->
-
<!-- Ensures that the conf directory and NOTICE.txt are included in the
source distro.
-->
Modified: jakarta/commons/proper/email/trunk/project.properties
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/project.properties?rev=388751&r1=388750&r2=388751&view=diff
==============================================================================
--- jakarta/commons/proper/email/trunk/project.properties (original)
+++ jakarta/commons/proper/email/trunk/project.properties Sat Mar 25 05:24:50 2006
@@ -46,12 +46,12 @@
maven.checkstyle.header.file=conf/HEADER.txt
# Standard settings
-maven.xdoc.jsl=../commons-build/commons-site.jsl
maven.xdoc.date=left
-maven.xdoc.poweredby.image=maven-feather.png
+maven.xdoc.version=${pom.currentVersion}
maven.xdoc.developmentProcessUrl=http://jakarta.apache.org/commons/charter.html
+maven.xdoc.poweredby.image=maven-feather.png
# used to generate the download page
-maven.xdoc.distributionUrl=http://www.apache.org/dist/java-repository/commons-email/jars
+#maven.xdoc.distributionUrl=http://www.apache.org/dist/java-repository/commons-email/jars
# Compiler settings - we are targetting JDK 1.3 as minimum runtime requirement
maven.compile.source=1.3
Modified: jakarta/commons/proper/email/trunk/project.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/project.xml?rev=388751&r1=388750&r2=388751&view=diff
==============================================================================
--- jakarta/commons/proper/email/trunk/project.xml (original)
+++ jakarta/commons/proper/email/trunk/project.xml Sat Mar 25 05:24:50 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
- Copyright 2001-2005 The Apache Software Foundation
+ Copyright 2001-2006 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -15,7 +15,7 @@
limitations under the License.
-->
<project>
- <pomVersion>1</pomVersion>
+ <pomVersion>3</pomVersion>
<name>Commons Email</name>
<groupId>commons-email</groupId>
<artifactId>commons-email</artifactId>
@@ -59,6 +59,11 @@
<id>1.0</id>
<tag>EMAIL_1_0</tag>
</version>
+ <version>
+ <name>1.1-SNAPSHOT</name>
+ <id>1.1-SNAPSHOT</id>
+ <tag>EMAIL_1_0</tag>
+ </version>
</versions>
<branches/>
<mailingLists>
@@ -147,13 +152,15 @@
</roles>
<timezone>2</timezone>
</developer>
+ <developer>
+ <name>Stephen Colebourne</name>
+ <id>scolebourne</id>
+ <roles/>
+ <timezone>0</timezone>
+ </developer>
</developers>
<contributors>
<contributor>
- <name>Stephen Colebourne</name>
- <roles/>
- </contributor>
- <contributor>
<name>Mark Lowe</name>
<email>mark.lowe@boxstuff.com</email>
<roles/>
@@ -192,10 +199,23 @@
<url>http://java.sun.com/products/javabeans/glasgow/jaf.html</url>
</dependency>
<dependency>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ <version>3.8.1</version>
+ <properties>
+ <scope>test</scope>
+ <comment>Testing only</comment>
+ </properties>
+ </dependency>
+ <dependency>
<groupId>dumbster</groupId>
<artifactId>dumbster</artifactId>
<version>1.6</version>
<url>http://quintanasoft.com/dumbster/</url>
+ <properties>
+ <scope>test</scope>
+ <comment>Testing only</comment>
+ </properties>
</dependency>
<dependency>
<groupId>maven-plugins</groupId>
@@ -203,6 +223,21 @@
<version>0.9.2</version>
<url>http://maven-plugins.sourceforge.net/maven-findbugs-plugin/</url>
<type>plugin</type>
+ <properties>
+ <scope>test</scope>
+ <comment>Website only</comment>
+ </properties>
+ </dependency>
+ <dependency>
+ <groupId>maven-plugins</groupId>
+ <artifactId>maven-cobertura-plugin</artifactId>
+ <version>1.1.1</version>
+ <url>http://maven-plugins.sourceforge.net/maven-cobertura-plugin/</url>
+ <type>plugin</type>
+ <properties>
+ <scope>test</scope>
+ <comment>Website only</comment>
+ </properties>
</dependency>
</dependencies>
<build>
@@ -231,17 +266,17 @@
</resources>
</build>
<reports>
- <report>maven-changelog-plugin</report>
+ <!--report>maven-changelog-plugin</report-->
+ <!--report>maven-developer-activity-plugin</report-->
+ <!--report>maven-file-activity-plugin</report-->
<report>maven-changes-plugin</report>
<report>maven-checkstyle-plugin</report>
- <report>maven-developer-activity-plugin</report>
- <report>maven-file-activity-plugin</report>
<report>maven-javadoc-plugin</report>
<report>maven-junit-report-plugin</report>
<report>maven-jxr-plugin</report>
<report>maven-pmd-plugin</report>
<report>maven-license-plugin</report>
- <report>maven-jcoverage-plugin</report>
+ <report>maven-cobertura-plugin</report>
<report>maven-findbugs-plugin</report>
</reports>
<properties/>
Added: jakarta/commons/proper/email/trunk/xdocs/building.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/xdocs/building.xml?rev=388751&view=auto
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/building.xml (added)
+++ jakarta/commons/proper/email/trunk/xdocs/building.xml Sat Mar 25 05:24:50 2006
@@ -0,0 +1,84 @@
+<?xml version="1.0"?>
+<!--
+Copyright 2006 The Apache Software Foundation.
+
+Licensed 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.
+-->
+<document>
+ <properties>
+ <title>Building</title>
+ <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+<!-- ================================================== -->
+<section name="Overview">
+<p>
+ Commons Email uses <a href="http://maven.apache.org">Maven</a> or
+ <a href="http://ant.apache.org">Ant</a> as a build system.
+</p>
+<p>
+ You may also be interested in the release notes:<br />
+ <a href="release_1_0.html">Release 1.0</a><br />
+</p>
+</section>
+<!-- ================================================== -->
+<section name="Maven Goals">
+ <p>
+ To build a jar file, change into Email's root directory and run "maven jar".
+ The result will be in the "target" subdirectory.
+ </p>
+ <p>
+ To build the Javadocs, run "maven javadoc".
+ The result will be in "target/docs/apidocs".
+ </p>
+ <p>
+ To build the full website, run "maven site".
+ The result will be in "target/docs".
+ You must be online and using JDK 1.4 or higher to successfully complete this target.
+ </p>
+ <p>
+ Commons Email requires two jar files to compile and run - activation-1.0.2.jar and javamail-1.3.3.jar.
+ These are not present in the main maven ibiblio repository due to Sun licensing restrictions.
+ You must manually download these jars and install them in your own local repository.
+ </p>
+ <p>
+ Sun Javamail, available from
+ <a href="http://java.sun.com/products/javamail/">http://java.sun.com/products/javamail/</a><br />
+ Sun Activation Framework, available from
+ <a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">http://java.sun.com/products/javabeans/glasgow/jaf.html</a><br />
+ </p>
+</section>
+<!-- ================================================== -->
+<section name="Ant Goals">
+ <p>
+ A maven generated ant file is provided for ant users.
+ </p>
+</section>
+<!-- ================================================== -->
+<section name="Development">
+ <p>
+ Commons Email may be used on any JRE from 1.3 onwards.
+ </p>
+ <p>
+ Please note that the tests may fail under JDK 1.3 due to the use of
+ <a href="http://sourceforge.net/projects/dumbster">Dumbster</a>
+ which is compiled with JDK 1.4.
+ </p>
+ <p>
+ Also note that on OS X you may need to use Dumbster 1.5, not Dumbster 1.6 to run
+ the unit tests. Just update the project.xml <i>dependency</i> element.
+ </p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>
Propchange: jakarta/commons/proper/email/trunk/xdocs/building.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jakarta/commons/proper/email/trunk/xdocs/changes.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/xdocs/changes.xml?rev=388751&r1=388750&r2=388751&view=diff
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/changes.xml (original)
+++ jakarta/commons/proper/email/trunk/xdocs/changes.xml Sat Mar 25 05:24:50 2006
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2001-2005 The Apache Software Foundation
+ Copyright 2001-2006 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -22,7 +22,10 @@
<body>
<release version="1.1-SNAPSHOT" date="unreleased">
- <action dev="dion" type="fix" issue="38944" due-to="Dave Cherkassky">
+ <action dev="scolebourne" type="fix" >
+ Enhance website
+ </action>
+ <action dev="dion" type="add" issue="38944" due-to="Dave Cherkassky">
Added Email.setReplyTo(Collection)
</action>
<action dev="dion" type="fix" issue="38656" due-to="Piero Ottuzzi">
Added: jakarta/commons/proper/email/trunk/xdocs/cvs-usage.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/xdocs/cvs-usage.xml?rev=388751&view=auto
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/cvs-usage.xml (added)
+++ jakarta/commons/proper/email/trunk/xdocs/cvs-usage.xml Sat Mar 25 05:24:50 2006
@@ -0,0 +1,44 @@
+<?xml version="1.0"?>
+<!--
+Copyright 2006 The Apache Software Foundation.
+
+Licensed 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.
+-->
+<document>
+ <properties>
+ <title>Source repository</title>
+ <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+ <body>
+<!-- ================================================== -->
+<section name="Source repository">
+<p>
+ Jakarta Commons Email is hosted on the Apache
+ <a href="http://subversion.tigris.org/">subversion</a> repository.
+</p>
+<p>
+ The project URL is:<br />
+ <code>http://svn.apache.org/repos/asf/jakarta/commons/proper/email/trunk</code>
+</p>
+<p>
+ The best way to view the repository is via the
+ <a href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/email/trunk/">subversion viewer</a>.
+</p>
+<p>
+ The alternative is to use the
+ <a href="http://svn.apache.org/repos/asf/jakarta/commons/proper/email/trunk/">native subversion</a> display.
+</p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>
Propchange: jakarta/commons/proper/email/trunk/xdocs/cvs-usage.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jakarta/commons/proper/email/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/xdocs/index.xml?rev=388751&r1=388750&r2=388751&view=diff
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/index.xml (original)
+++ jakarta/commons/proper/email/trunk/xdocs/index.xml Sat Mar 25 05:24:50 2006
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2001-2005 The Apache Software Foundation
+ Copyright 2001-2006 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -14,22 +14,17 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
-
<document>
-
<properties>
- <title>Commons Email</title>
+ <title>Home</title>
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
</properties>
-
- <body>
-
+<body>
+<!-- ================================================== -->
<section name="Commons Email">
-
<p>
Commons-Email aims to provide a API for sending email.
It is built on top of the Java Mail API, which it aims to simplify.
-All help is gratefully received.
</p>
<p>
Some of the mail classes that are provided are as follows:
@@ -56,61 +51,53 @@
</li>
</ul>
</p>
-<subsection name="Status">
+</section>
+<!-- ================================================== -->
+<section name="Documentation">
<p>
- <ul>
- <li>Version 1.0 has been released on 2005-09-27.</li>
- </ul>
+A <a href="userguide.html">user guide</a> with lots of example is available,
+as are various <a href="maven-reports.html">project reports</a>.
</p>
-</subsection>
-</section>
-<section name='Releases'>
- <subsection name='Commons Email 1.0'>
- <p>
- Commons Email 1.0 has been released on 2005-09-27.
- </p>
- <p>
- <a href="http://jakarta.apache.org/site/downloads/downloads_commons-email.cgi">Download Binaries and Source</a>.
- </p>
- </subsection>
-</section>
-
-<section name="Bugs">
<p>
-Bugs may be reported via the Bugzilla Management system. The following links may prove useful:
+The JavaDoc API documents are available online:
</p>
<ul>
- <li><a href="http://issues.apache.org/bugzilla/createaccount.cgi">Create a Bugzilla account</a></li>
- <li><a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Commons&component=Email&version=1.0">Submit a bug report</a></li>
- <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Commons&component=Email&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&newqueryname=&order=Reuse+same+sort+as+last+time">All open Email bugs</a></li>
- <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Commons&component=Email&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&newqueryname=&order=Reuse+same+sort+as+last+time">All Email bugs</a></li>
+<li>The <a href="api-release/index.html">current release 1.0</a></li>
+<!--li>The <a href="api-1.1/index.html">previous version 1.1</a></li-->
+<li>The <a href="apidocs/index.html">latest SVN</a></li>
</ul>
-</section>
-
-<section name="Documentation">
<p>
- <ul>
- <li>The <a href="apidocs/index.html">Javadoc</a> of the latest code</li>
- <li>The <a href="cvs-usage.html">Subversion repository</a> can be browsed.</li>
- </ul>
+The <a href="cvs-usage.html">subversion repository</a> can be
+<a href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/email/trunk/">browsed</a>.
</p>
</section>
-
-<section name="Development">
-<p>Commons-Email may be used on any JRE from 1.3 onwards.</p>
+<!-- ================================================== -->
+<section name="Releases">
+<p>
+The latest version is v1.0. -
+<a href="http://jakarta.apache.org/site/downloads/downloads_commons-email.cgi">Download now!</a><br />
+The full <a href="changes-report.html">change log</a> is available,
+as are the <a href="release_1_0.html">v1.0 release notes</a>.
+</p>
+<!--p>
+For previous releases, see the <a href="http://archive.apache.org/dist/jakarta/commons/email/">Apache Archive</a>
+</p-->
+</section>
+<!-- ================================================== -->
+<section name="Support">
<p>
- Please note that the tests may fail under JDK 1.3 due to the use of
- <a href="http://sourceforge.net/projects/dumbster">Dumbster</a> which is compiled
- with JDK 1.4.
+The <a href="mail-lists.html">commons mailing lists</a> act as the main support forum.
+The user list is suitable for most library usage queries.
+The dev list is intended for the development discussion.
+Please remember that the lists are shared between all commons components,
+so prefix your email by [email].
</p>
<p>
- Also note that on OS X you may need to use Dumbster 1.5, not Dumbster 1.6 to run
- the unit tests. Just update the project.xml <i>dependency</i> element.
+Issues may be reported via <a href="issue-tracking.html">ASF Bugzilla</a>.
+Please remember that Bugzilla is shared between all commons components,
+so prefix your issue by [email].
</p>
</section>
-
-
-
+<!-- ================================================== -->
</body>
</document>
-
Added: jakarta/commons/proper/email/trunk/xdocs/issue-tracking.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/xdocs/issue-tracking.xml?rev=388751&view=auto
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/issue-tracking.xml (added)
+++ jakarta/commons/proper/email/trunk/xdocs/issue-tracking.xml Sat Mar 25 05:24:50 2006
@@ -0,0 +1,61 @@
+<?xml version="1.0"?>
+<!--
+Copyright 2006 The Apache Software Foundation.
+
+Licensed 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.
+-->
+<document>
+ <properties>
+ <title>Issue tracking</title>
+ <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+<!-- ================================================== -->
+<section name="Issue tracking">
+<p>
+ Commons Email uses <a href="http://issues.apache.org/bugzilla/">ASF Bugzilla</a> for tracking issues.
+ To use Bugzilla you may need to <a href="http://issues.apache.org/bugzilla/createaccount.cgi">create an account</a>.
+</p>
+<p>
+ If you would like to report a bug, or raise an enhancement request with
+ Commons Email please do the following:
+ <ol>
+ <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO&product=Commons&component=Email">Search existing open bugs</a>.
+ If you find your issue listed then please add a comment with your details.</li>
+ <li><a href="http://mail-archives.apache.org/mod_mbox/jakarta-commons-dev/">Search the mailing list archive</a>.
+ You may find your issue or idea has already been discussed.</li>
+ <li><a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Commons&component=Email&version=1.0%20Final&short_desc=%5Bemail%5D%20%22Your%20subject%20heading%20here%22&comment=Please%20provide%20details%20here.%20Its%20best%20to%20submit%20patches%20that%20alter%0D%0Aexisting%20file%20content%20in%20%22unified%20diff%22%20format.%20%0D%0A%0D%0ASubmissions%20that%20provide%20new%20files%20can%20be%20supplied%20as%20direct%20file%0D%0Aattachments%20or%20archives%20in%20zip%20or%20tar.gz%20format.%20please%20be%20kind%20%0D%0Aenough%20to%20identify%20the%20format%20of%20the%20attached%20archive%20as%20bugzilla%0D%0Atends%20to%20strip%20these%20characterstics%20by%20removing%20the%20files%20extension.">Submit a bug report or enhancement request</a>.
+ Please prefix all new issues with [email] in the summary line.
+ </li>
+ </ol>
+</p>
+<p>
+ Please also remember these points:
+ <ul>
+ <li>the more information you provide, the better we can help you</li>
+ <li>test cases are vital, particularly for any proposed enhancements</li>
+ <li>the developers of Commons Email are all unpaid volunteers</li>
+ </ul>
+</p>
+<p>
+ You may also find these links useful:
+ <ul>
+ <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO&product=Commons&component=Email">All Open Email bugs</a></li>
+ <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&product=Commons&component=Email">All Closed Email bugs</a></li>
+ <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&product=Commons&component=Email">All Email bugs</a></li>
+ </ul>
+</p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>
Propchange: jakarta/commons/proper/email/trunk/xdocs/issue-tracking.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jakarta/commons/proper/email/trunk/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/xdocs/navigation.xml?rev=388751&r1=388750&r2=388751&view=diff
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/navigation.xml (original)
+++ jakarta/commons/proper/email/trunk/xdocs/navigation.xml Sat Mar 25 05:24:50 2006
@@ -1,39 +1,32 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- Copyright 2001-2005 The Apache Software Foundation
+<!DOCTYPE org.apache.commons.menus SYSTEM 'http://jakarta.apache.org/commons/build/maven-build.dtd'>
+<project name="Commons Email">
+
+ <title>Commons Email</title>
- Licensed 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.
--->
-
-<!DOCTYPE project SYSTEM '../../commons-build/menus/menus.dtd'>
-<project name="Commons Email">
- <title>Commons Email</title>
<body>
<links>
- <item name="Jakarta"
- href="http://jakarta.apache.org"/>
- <item name="Jakarta Commons"
- href="http://jakarta.apache.org/commons/"/>
+ <item name="Jakarta Commons" href="http://jakarta.apache.org/commons/"/>
</links>
- <menu name="Commons Email">
+
+ <menu name="Commons Email">
<item name="Overview" href="/index.html"/>
- <item name="Examples" href="/examples.html"/>
- <item name="Javadoc" href="apidocs/index.html"/>
+ <item name="Download" href="http://jakarta.apache.org/site/downloads/downloads_commons-email.cgi"/>
+ <item name="User guide" href="/userguide.html"/>
+ <item name="Javadoc (1.0 release)" href="api-release/index.html"/>
+ </menu>
+
+ <menu name="Development">
+ <item name="Building" href="/building.html"/>
<item name="Mailing lists" href="/mail-lists.html"/>
<item name="Team" href="/team-list.html"/>
- <item name="SVN" href="http://svn.apache.org/repos/asf/jakarta/commons/proper/email/trunk/"/>
- <item name="View SVN" href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/email/trunk/"/>
+ <!--item name="Tasks" href="/tasks.html"/-->
+ <!--item name="Proposal" href="/proposal.html"/-->
+ <item name="SVN repository" href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/email/trunk/"/>
+ <item name="Javadoc (SVN latest)" href="apidocs/index.html"/>
</menu>
- &common-menus;
+
+ &commons;
+
</body>
</project>
Added: jakarta/commons/proper/email/trunk/xdocs/release_1_0.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/xdocs/release_1_0.xml?rev=388751&view=auto
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/release_1_0.xml (added)
+++ jakarta/commons/proper/email/trunk/xdocs/release_1_0.xml Sat Mar 25 05:24:50 2006
@@ -0,0 +1,62 @@
+<?xml version="1.0"?>
+<!--
+Copyright 2006 The Apache Software Foundation.
+
+Licensed 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.
+-->
+<document>
+ <properties>
+ <title>Release notes for 1.0</title>
+ <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+
+<section name="Release notes">
+<p>
+These are the release notes for Commons-Email version 1.0.
+<source>
+INTRODUCTION:
+
+Commons-Email aims to provide a API for sending email. It builds on the JavaMail
+API with the aim of presenting a simplified API which is easy for developers who
+are not mail experts to use. It is a compact component with a small number of
+classes.
+
+This is the first release of Commons Email. However, the codebase is mature and
+stable and so this is no reason not to recommend it for production.
+
+
+REQUIREMENTS:
+
+J2SE environments
+-----------------
+
+Commons-Email requires at least javamail version 1.2 and should run
+with all versions above. Get it http://java.sun.com/products/javamail/
+
+Commons-Email also requires the Java activation framework. Get it from
+http://java.sun.com/products/javabeans/glasgow/jaf.html
+
+Commons-Email has been tested with JDK 1.3.1_16, JDK 1.4.2_09 and JDK 1.5.0_04.
+
+J2EE environments
+-----------------
+
+Commons-Email should be compatible with J2EE 1.3 and 1.4 compliant
+environments and run without additional requirements.
+</source>
+</p>
+</section>
+
+</body>
+</document>
Propchange: jakarta/commons/proper/email/trunk/xdocs/release_1_0.xml
------------------------------------------------------------------------------
svn:eol-style = native
Copied: jakarta/commons/proper/email/trunk/xdocs/userguide.xml (from r388741, jakarta/commons/proper/email/trunk/xdocs/examples.xml)
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/email/trunk/xdocs/userguide.xml?p2=jakarta/commons/proper/email/trunk/xdocs/userguide.xml&p1=jakarta/commons/proper/email/trunk/xdocs/examples.xml&r1=388741&r2=388751&rev=388751&view=diff
==============================================================================
--- jakarta/commons/proper/email/trunk/xdocs/examples.xml (original)
+++ jakarta/commons/proper/email/trunk/xdocs/userguide.xml Sat Mar 25 05:24:50 2006
@@ -37,8 +37,7 @@
email.setSubject("Test message");
email.setMsg("This is a simple test of commons-email");
email.send();
-]]>
- </source>
+]]></source>
<p>
The call to setHostName("mail.myserver.com") sets the address of the
outgoing SMTP server that will be used to send the message. If this is
@@ -83,8 +82,7 @@
// send the email
email.send();
-]]>
- </source>
+]]></source>
<p>
You can also use EmailAttachment to reference any valid URL for files
that you do not have locally. When the message is sent, the file will
@@ -116,8 +114,7 @@
// send the email
email.send();
-]]>
- </source>
+]]></source>
</section>
<section name="Sending HTML formatted email">
<p>
@@ -151,8 +148,7 @@
// send the email
email.send();
-]]>
- </source>
+]]></source>
<p>
First, notice that the call to embed() returns a String. This String
is a randomly generated identifier that must be used to reference
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org