commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From scolebou...@apache.org
Subject svn commit: r388751 - in /jakarta/commons/proper/email/trunk: ./ xdocs/
Date Sat, 25 Mar 2006 13:24:51 GMT
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&amp;component=Email&amp;version=1.0">Submit
a bug report</a></li>
- <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Commons&amp;component=Email&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;cmdtype=doit&amp;newqueryname=&amp;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&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Commons&amp;component=Email&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;cmdtype=doit&amp;newqueryname=&amp;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&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;product=Commons&amp;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&amp;component=Email&amp;version=1.0%20Final&amp;short_desc=%5Bemail%5D%20%22Your%20subject%20heading%20here%22&amp;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&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;product=Commons&amp;component=Email">All
Open Email bugs</a></li>
+  <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;product=Commons&amp;component=Email">All
Closed Email bugs</a></li>
+  <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;product=Commons&amp;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&#xA0;Email">
-  <title>Commons&#xA0;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&#xA0;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


Mime
View raw message