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>[EMAIL PROTECTED]</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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]