[EXAMPLES] Github links for examples
- One can then easily find them without
requiring to clone the repository
- Mention explaining they could easily be
launched from within an IDE
- Also, I added the new `Parsing` example.
diff --git a/src/site/xdoc/samples.xml b/src/site/xdoc/samples.xml
index ebf1371..fcbb68d 100755
--- a/src/site/xdoc/samples.xml
+++ b/src/site/xdoc/samples.xml
@@ -1,23 +1,23 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-/****************************************************************
- * Licensed to the Apache Software Foundation (ASF) under one *
- * or more contributor license agreements. See the NOTICE file *
- * distributed with this work for additional information *
- * regarding copyright ownership. The ASF licenses this file *
- * to you 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. *
- ****************************************************************/
+/****************************************************************
+ * Licensed to the Apache Software Foundation (ASF) under one *
+ * or more contributor license agreements. See the NOTICE file *
+ * distributed with this work for additional information *
+ * regarding copyright ownership. The ASF licenses this file *
+ * to you 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>
@@ -27,12 +27,13 @@
<body>
<section name="Samples">
<p>
- The Mime4j distribution includes samples
+ The Mime4j distribution includes <a href="https://github.com/apache/james-mime4j/tree/master/examples">examples</a>
which demonstrate how the library could be used. This section
gives you a short review of those samples. For more information
you should download the distribution and study the sample sources.
The samples are in the <code>examples/</code> sub-directory.
</p>
+ <p>Each one of these examples can be run easily from an IDE.</p>
<table>
<tr>
<th>Sample</th>
@@ -41,6 +42,7 @@
<tr>
<td>
<code>org.apache.james.mime4j.samples.tree.MessageTree</code>
+ <a href="https://github.com/apache/james-mime4j/tree/master/examples/src/main/java/org/apache/james/mime4j/samples/tree.MessageTree.java">org.apache.james.mime4j.samples.tree.MessageTree</a>
</td>
<td>Displays a tree of the contents of a
Mime4j <code>Message</code> object in a Swing GUI.
@@ -54,7 +56,7 @@
</tr>
<tr>
<td>
- <code>org.apache.james.mime4j.samples.transform.TransformMessage</code>
+ <a href="https://github.com/apache/james-mime4j/tree/master/examples/src/main/java/org/apache/james/mime4j/samples/transform/TransformMessage.java">org.apache.james.mime4j.samples.transform.TransformMessage</a>
</td>
<td>Illustrate how to transform a message into another message without
modifying the original.
@@ -62,7 +64,7 @@
</tr>
<tr>
<td>
- <code>org.apache.james.mime4j.samples.dom.TextPlainMessage</code>
+ <a href="https://github.com/apache/james-mime4j/tree/master/examples/src/main/java/org/apache/james/mime4j/samples/dom/TextPlainMessage.java">org.apache.james.mime4j.samples.dom.TextPlainMessage</a>
</td>
<td>Illustrate the use of Mime4j DOM API. This example generates a message
very similar to the one from
@@ -72,7 +74,7 @@
</tr>
<tr>
<td>
- <code>org.apache.james.mime4j.samples.dom.MultipartMessage</code>
+ <a href="https://github.com/apache/james-mime4j/tree/master/examples/src/main/java/org/apache/james/mime4j/samples/dom/MultipartMessage.java">org.apache.james.mime4j.samples.dom.MultipartMessage</a>
</td>
<td>Illustrate the use of Mime4j DOM API. This example creates a
multipart/mixed message that consists of a text/plain and an image/png
@@ -80,18 +82,12 @@
to create PDF or XML attachments, for example.
</td>
</tr>
- <!-- <tr>
- <td>
- <code>org.apache.james.mime4j.samples.sax.Mime2Sax</code>
- </td>
- <td></td>
- </tr>
<tr>
<td>
- <code>org.apache.james.mime4j.samples.pgp.PGPSignatureVerifier</code>
+ <a href="https://github.com/apache/james-mime4j/tree/master/examples/src/main/java/org/apache/james/mime4j/samples/dom/ParsingMessage.java">org.apache.james.mime4j.samples.dom.ParsingMessage</a>
</td>
- <td></td>
- </tr> -->
+ <td>Illustrate the use of Mime4j DOM API in order to parse messages.</td>
+ </tr>
</table>
</section>
</body>