You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@james.apache.org by rc...@apache.org on 2023/09/14 06:34:05 UTC

[james-project] branch master updated (ab911eaf83 -> 40c1fe820f)

This is an automated email from the ASF dual-hosted git repository.

rcordier pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git


    from ab911eaf83 [DOCUMENTATION] Update site - remove Mailing Lists in Mailet section
     new 6b8227dcde [DOCUMENTATION] Clean some documents how to for some James features
     new 40c1fe820f [EXAMPLE] Make pom finalName for example module

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 README.adoc                                     |  1 +
 docs/modules/community/pages/download.adoc      |  2 +-
 docs/modules/concepts/pages/protocols/jmap.adoc | 27 +++++++-
 docs/modules/servers/pages/test.adoc            |  3 +-
 examples/custom-healthcheck/README.md           |  9 +--
 examples/custom-healthcheck/pom.xml             |  1 +
 examples/custom-listeners/pom.xml               |  1 +
 examples/custom-mailets/pom.xml                 |  1 +
 examples/custom-smtp-command/README.md          |  9 +--
 examples/custom-smtp-command/pom.xml            |  1 +
 examples/custom-smtp-hooks/README.md            |  9 +--
 examples/custom-smtp-hooks/pom.xml              |  1 +
 examples/custom-webadmin-route/README.md        |  9 +--
 examples/custom-webadmin-route/pom.xml          |  1 +
 src/homepage/about.md                           |  2 +-
 src/homepage/howTo/custom-healthchecks.html     |  7 +--
 src/homepage/howTo/custom-listeners.html        | 84 ++++---------------------
 src/homepage/howTo/custom-smtp-commands.html    |  7 +--
 src/homepage/howTo/custom-smtp-hooks.html       |  7 +--
 src/homepage/howTo/custom-webadmin-routes.html  |  7 +--
 src/homepage/howTo/deleted-messages-vault.html  |  6 +-
 src/homepage/howTo/imap-server.html             |  2 +-
 src/homepage/howTo/mail-processing.html         | 14 ++---
 src/homepage/index.html                         |  4 +-
 24 files changed, 70 insertions(+), 145 deletions(-)


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org


[james-project] 01/02: [DOCUMENTATION] Clean some documents how to for some James features

Posted by rc...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

rcordier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git

commit 6b8227dcdebbadd2b5717050a62b48f25da17fb3
Author: Tung Tran <vt...@linagora.com>
AuthorDate: Wed Sep 13 08:04:27 2023 +0700

    [DOCUMENTATION] Clean some documents how to for some James features
---
 README.adoc                                     |  1 +
 docs/modules/community/pages/download.adoc      |  2 +-
 docs/modules/concepts/pages/protocols/jmap.adoc | 27 +++++++-
 docs/modules/servers/pages/test.adoc            |  3 +-
 examples/custom-healthcheck/README.md           |  9 +--
 examples/custom-smtp-command/README.md          |  9 +--
 examples/custom-smtp-hooks/README.md            |  9 +--
 examples/custom-webadmin-route/README.md        |  9 +--
 src/homepage/about.md                           |  2 +-
 src/homepage/howTo/custom-healthchecks.html     |  7 +--
 src/homepage/howTo/custom-listeners.html        | 84 ++++---------------------
 src/homepage/howTo/custom-smtp-commands.html    |  7 +--
 src/homepage/howTo/custom-smtp-hooks.html       |  7 +--
 src/homepage/howTo/custom-webadmin-routes.html  |  7 +--
 src/homepage/howTo/deleted-messages-vault.html  |  6 +-
 src/homepage/howTo/imap-server.html             |  2 +-
 src/homepage/howTo/mail-processing.html         | 14 ++---
 src/homepage/index.html                         |  4 +-
 18 files changed, 64 insertions(+), 145 deletions(-)

diff --git a/README.adoc b/README.adoc
index d479162f01..ce3123309e 100644
--- a/README.adoc
+++ b/README.adoc
@@ -92,6 +92,7 @@ Useful options includes:
 
  - `-DskipTests` to skip the long to execute resource consuming test suite that requires a docker daemon.
  - `-T 4` to parallelize the build on several CPUs.
+ - `-Dmaven.javadoc.skip=true` to skip the javadoc generation.
 ====
 
 == How to run James in Docker
diff --git a/docs/modules/community/pages/download.adoc b/docs/modules/community/pages/download.adoc
index 61300ac89c..d673199d79 100644
--- a/docs/modules/community/pages/download.adoc
+++ b/docs/modules/community/pages/download.adoc
@@ -1,4 +1,4 @@
 = Download Apache James releases
 :navtitle: Download releases
 
-(TODO)
+https://james.apache.org/download[Download Apache James releases]
diff --git a/docs/modules/concepts/pages/protocols/jmap.adoc b/docs/modules/concepts/pages/protocols/jmap.adoc
index 91d29a782e..a64d3a2f31 100644
--- a/docs/modules/concepts/pages/protocols/jmap.adoc
+++ b/docs/modules/concepts/pages/protocols/jmap.adoc
@@ -1,4 +1,29 @@
 = JSON Meta Application Protocol (JMAP)
 :navtitle: JMAP
 
-(TODO)
+== Overview
+
+https://jmap.io/[JSON Meta Application Protocol] ("JMAP")
+is
+
+From <<RFC8620>>:
+
+   The JSON Meta Application Protocol (JMAP) is used for synchronising
+   data, such as mail, calendars, or contacts, between a client and a
+   server.  It is optimised for mobile and web environments and aims to
+   provide a consistent interface to different data types.
+
+   This specification is for the generic mechanism of data
+   synchronisation.  Further specifications define the data models for
+   different data types that may be synchronised via JMAP.
+
+
+== Specifications
+
+=== RFC8620
+
+https://tools.ietf.org/html/rfc8620[RFC8620] ("The JSON Meta Application Protocol (JMAP)")
+
+== Related Concepts
+
+
diff --git a/docs/modules/servers/pages/test.adoc b/docs/modules/servers/pages/test.adoc
index a6820d8bf4..c27a740924 100644
--- a/docs/modules/servers/pages/test.adoc
+++ b/docs/modules/servers/pages/test.adoc
@@ -1,5 +1,6 @@
 = James Test Server
 :navtitle: Test 
 
-(TODO)
+https://github.com/apache/james-project/tree/master/server/apps/memory-app[Apache James Memory App]
+is a memory-only implementation of Apache James. It is useful for testing and development purposes.
 
diff --git a/examples/custom-healthcheck/README.md b/examples/custom-healthcheck/README.md
index b9ce307c88..455c37f596 100644
--- a/examples/custom-healthcheck/README.md
+++ b/examples/custom-healthcheck/README.md
@@ -34,21 +34,14 @@ Then embed your healthcheck into a James server. First configure your custom hea
 additional.healthchecks=org.apache.james.examples.HealthCheckA
 ```
 
-Create a keystore (default password being `james72laBalle`):
-
-```
-keytool -genkey -alias james -keyalg RSA -keystore keystore
-```
-
 Then start a James server with your JAR and the configuration:
 
 ```
 $ docker run -d \
    -v $PWD/healthcheck.properties:/root/conf/healthcheck.properties \
    -v $PWD/healthcheck-extension.jar:/root/extensions-jars \
-   -v $PWD/keystore:/root/conf/keystore \
    -p 25:25 \
-   apache/james:memory-latest
+   apache/james:memory-latest --generate-keystore
 ```
 
 You can use `curl` command to get your healthcheck status:
diff --git a/examples/custom-smtp-command/README.md b/examples/custom-smtp-command/README.md
index 648eee133e..18487312fc 100644
--- a/examples/custom-smtp-command/README.md
+++ b/examples/custom-smtp-command/README.md
@@ -118,21 +118,14 @@ Write a configuration file telling James to use your `HandlerPackage`:
 </smtpservers>
 ```
 
-Create a keystore (default password being `james72laBalle`):
-
-```
-keytool -genkey -alias james -keyalg RSA -keystore keystore
-```
-
 Then start a James server with your JAR and the configuration:
 
 ```
 docker run -d \
   -v $PWD/smtpserver.xml:/root/conf/smtpserver.xml \
   -v $PWD/exts:/root/extensions-jars \
-  -v $PWD/keystore:/root/conf/keystore \
   -p 25:25 \
-  apache/james:memory-latest
+  apache/james:memory-latest --generate-keystore
 ```
 
 You can play with `telnet` utility with the resulting server:
diff --git a/examples/custom-smtp-hooks/README.md b/examples/custom-smtp-hooks/README.md
index dc2ff09709..37f28d6946 100644
--- a/examples/custom-smtp-hooks/README.md
+++ b/examples/custom-smtp-hooks/README.md
@@ -89,21 +89,14 @@ Then embed your extension into a James server. First configure your hook:
 </smtpservers>
 ```
 
-Create a keystore (default password being `james72laBalle`):
-
-```
-keytool -genkey -alias james -keyalg RSA -keystore keystore
-```
-
 Then start a James server with your JAR and the configuration:
 
 ```
 docker run -d \
   -v $PWD/smtpserver.xml:/root/conf/smtpserver.xml \
   -v $PWD/exts:/root/extensions-jars \
-  -v $PWD/keystore:/root/conf/keystore \
   -p 25:25 \
-  apache/james:memory-latest
+  apache/james:memory-latest --generate-keystore
 ```
 
 You can play with `telnet` utility with the resulting server:
diff --git a/examples/custom-webadmin-route/README.md b/examples/custom-webadmin-route/README.md
index eba5a849d6..1c71b0c731 100644
--- a/examples/custom-webadmin-route/README.md
+++ b/examples/custom-webadmin-route/README.md
@@ -54,21 +54,14 @@ host=localhost
 extensions.routes=org.apache.james.examples.RouteA
 ```
 
-Create a keystore (default password being `james72laBalle`):
-
-```
-keytool -genkey -alias james -keyalg RSA -keystore keystore
-```
-
 Then start a James server with your JAR and the configuration:
 
 ```
 $ docker run -d \
    -v $PWD/webadmin.properties:/root/conf/webadmin.properties \
    -v $PWD/exts:/root/extensions-jars \
-   -v $PWD/keystore:/root/conf/keystore \
    -p 25:25 \
-   apache/james:memory-latest
+   apache/james:memory-latest --generate-keystore
 ```
 
 You can play with `curl` utility with the resulting server:
diff --git a/src/homepage/about.md b/src/homepage/about.md
index 0740bc8ae3..3948f4665c 100644
--- a/src/homepage/about.md
+++ b/src/homepage/about.md
@@ -53,6 +53,6 @@ tags:
 * ```tags``` attributes can be added to a post. Tags can be specified as a [YAML list](https://en.wikipedia.org/wiki/YAML#Basic_components) or a space-separated string
 
 #### Warning!
-**The value is conditionning the display or not of the post at compilation, so is post date means you must build site with jekyll after it to actually publish it.**
+**The value is conditioning the display or not of the post at compilation, so is post date means you must build site with jekyll after it to actually publish it.**
 
 No Content Management System here who's publish for you the post.
diff --git a/src/homepage/howTo/custom-healthchecks.html b/src/homepage/howTo/custom-healthchecks.html
index c1deb63a0b..2e6da984a3 100644
--- a/src/homepage/howTo/custom-healthchecks.html
+++ b/src/homepage/howTo/custom-healthchecks.html
@@ -67,18 +67,13 @@ layout: howTo
 # Healthchecks need to be located within the classpath or in the ./extensions-jars folder.
 additional.healthchecks=org.apache.james.examples.HealthCheckA</code></pre>
 
-                <p>Create a keystore (default password being <code>james72laBalle</code>):</p>
-
-                <pre><code>keytool -genkey -alias james -keyalg RSA -keystore keystore</code></pre>
-
                 <p>Then start a James server with your JAR and the configuration:</p>
 
                 <pre><code>docker run -d \
    -v $PWD/healthcheck.properties:/root/conf/healthcheck.properties \
    -v $PWD/healthcheck-extension.jar:/root/extensions-jars \
-   -v $PWD/keystore:/root/conf/keystore \
    -p 25:25 \
-   apache/james:memory-latest</code></pre>
+   apache/james:memory-latest --generate-keystore</code></pre>
 
                 <p>You can use <code>curl</code> command to get your healthcheck status:</p>
 
diff --git a/src/homepage/howTo/custom-listeners.html b/src/homepage/howTo/custom-listeners.html
index 38c3b36021..13c45e38b9 100644
--- a/src/homepage/howTo/custom-listeners.html
+++ b/src/homepage/howTo/custom-listeners.html
@@ -96,23 +96,14 @@ layout: howTo
                     <h3><b>Starting James with SetCustomFlagOnBigMessages</b></h3>
                 </header>
 
-                <p>We will take the simplest James product(JPA Guice) for the example</p>
+                <p>You can retrieve the sources of this mini-project on <a href="https://github.com/apache/james-project/tree/master/examples/custom-listeners">GitHub</a></p>
 
-                <p>First, get template JPA product configuration:</p>
-                <pre><code>
-$ git clone https://github.com/apache/james-project
-$ cp -rf james-project/server/apps/jpa-app/sample-configuration conf
-                </code></pre>
 
-                <p>Then create the keystore file in the conf/ directory with the default password <code>james72laBalle</code>
-                <pre><code>
-$ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore
-                </code></pre>
+                <p>We will take the simplest James InMemory version for the example</p>
 
-                <p>
-                    Second, modify listener.xml configuration file in conf/ directory to use only SetCustomFlagOnBigMessages
-                    by specifying its full class name. We only need to use this Listener in our example.
-                </p>
+                <p>First, we will need to compile our project with <code>mvn clean install</code>. A jar will be outputted in the target directory.</p>
+
+                <p>Second, we will write the <code>listeners.xml</code> file expressing the logic we want. In this case, we want to use only the BigMessageListener.</p>
                 <pre><code>
 &lt;listeners&gt;
     &lt;listener&gt;
@@ -121,65 +112,14 @@ $ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore
 &lt;/listeners&gt;
                 </code></pre>
 
-                <p>Finally, starting a James Server by docker compose</p>
-                <p>Getting James docker-compose.yml</p>
-                <pre><code>
-$ wget https://raw.githubusercontent.com/apache/james-project/master/server/apps/jpa-app/docker-compose.yml
-                </code></pre>
-                <p>Using James Guice JPA instead of the default product</p>
-                <pre><code>
-services:
-  james:
-    ...
-    image: apache/james:jpa-latest
-                </code></pre>
-                <p>Add the following volumes for james service:</p>
-                <pre><code>
-volumes:
-  - $PWD/conf:/root/conf/
-                </code></pre>
+                <p>Finally, we will start a James server using that. We will rely on docker default image for simplicity.
+                    We need to be using the <code>listeners.xml</code> configuration that we had been writing and position the jar in the extensions-jars folder (specific to guice).
+                    This can be achieved with the following command:</p>
 
-                <p>
-                    When you are using your listeners, place the jar containing your listeners into "extensions-jars" directory
-                    and add a volume for it.
-                </p>
-                <pre><code>
-volumes:
-  - $PWD/extensions-jars:/root/extensions-jars/
-                </code></pre>
-                <p>
-                    Putting compiled jars into extensions-jars directory
-                </p>
-                <p>
-                    When you write a custom Listener, you have to compile it and place the compiled jar package inside "extensions-jars" directory
-                    to make James load your Listener when it starts up.
-                    In this case, you should compile the James's module <b>examples/custom-listeners</b> and put it to "extensions-jars".
-                    The jar name can be sightly different by the time because its name carries James version, but you can recognize it easily.
-                </p>
-                <pre><code>
-$ mkdir extensions-jars
-$ cd james-project
-$ mvn clean install -DskipTests -f examples/custom-listeners/pom.xml
-$ cd ../
-$ cp james-project/examples/custom-listeners/target/custom-listeners-****.jar extensions-jars/custom-listeners.jar
-                </code></pre>
-                <p>
-                    Check out the docker-compose.yml to get the host name of james service, currently it's <b>james.local</b>.
-                    So you, have to modify James domain list to use this <b>james.local</b> as James default domain:
-                </p>
-                <pre><code>
-&lt;domainlist&gt;
-    &lt;autodetect&gt;true&lt;/autodetect&gt;
-    &lt;autodetectIP&gt;true&lt;/autodetectIP&gt;
-    &lt;defaultDomain&gt;james.local&lt;/defaultDomain&gt;
-&lt;/domainlist&gt;
-                </code></pre>
-                <p>
-                    Now, you are able to start james by docker compose, then wait for all docker containers to be up.
-                </p>
-                <pre><code>
-$ docker-compose up -d
-                </code></pre>
+                <pre><code>docker run -p "25:25" -p "143:143" \
+               -v "$PWD/src/main/resources/listeners.xml:/root/conf/listeners.xml" \
+               -v "$PWD/target/custom-listeners:/root/extensions-jars/custom-listeners" \
+        apache/james:memory-latest --generate-keystore</code></pre>
 
                 <header class="major">
                     <h3><b>Verifying the result of the setup</b></h3>
diff --git a/src/homepage/howTo/custom-smtp-commands.html b/src/homepage/howTo/custom-smtp-commands.html
index 6ccf81b7aa..3fac822129 100644
--- a/src/homepage/howTo/custom-smtp-commands.html
+++ b/src/homepage/howTo/custom-smtp-commands.html
@@ -146,18 +146,13 @@ public class MyCmdHandlerLoader implements HandlersPackage {
     &lt;/smtpserver&gt;
 &lt;/smtpservers&gt;</code></pre>
 
-                <p>Create a keystore (default password being <code>james72laBalle</code>):</p>
-
-                <pre><code>keytool -genkey -alias james -keyalg RSA -keystore keystore</code></pre>
-
                 <p>Then start a James server with your JAR and the configuration:</p>
 
                 <pre><code>docker run -d \
   -v $PWD/smtpserver.xml:/root/conf/smtpserver.xml \
   -v $PWD/exts:/root/extensions-jars \
-  -v $PWD/keystore:/root/conf/keystore \
   -p 25:25 \
-  apache/james:memory-latest
+  apache/james:memory-latest --generate-keystore
                 </code></pre>
 
                 <p>You can play with <code>telnet</code> utility with the resulting server and use the <code>MYNOOP</code> command:</p>
diff --git a/src/homepage/howTo/custom-smtp-hooks.html b/src/homepage/howTo/custom-smtp-hooks.html
index 7f42e2fb43..1b5dcc4549 100644
--- a/src/homepage/howTo/custom-smtp-hooks.html
+++ b/src/homepage/howTo/custom-smtp-hooks.html
@@ -126,18 +126,13 @@ layout: howTo
 &lt;/smtpservers&gt;
                 </code></pre>
 
-                <p>Create a keystore (default password being <code>james72laBalle</code>):</p>
-
-                <pre><code>keytool -genkey -alias james -keyalg RSA -keystore keystore</code></pre>
-
                 <p>Then start a James server with your JAR and the configuration:</p>
 
                 <pre><code>docker run -d \
   -v $PWD/smtpserver.xml:/root/conf/smtpserver.xml \
   -v $PWD/exts:/root/extensions-jars \
-  -v $PWD/keystore:/root/conf/keystore \
   -p 25:25 \
-  apache/james:memory-latest
+  apache/james:memory-latest --generate-keystore
                 </code></pre>
 
                 <p>You can play with <code>telnet</code> utility with the resulting server:</p>
diff --git a/src/homepage/howTo/custom-webadmin-routes.html b/src/homepage/howTo/custom-webadmin-routes.html
index 92e1a50eb9..af5c5b70d3 100644
--- a/src/homepage/howTo/custom-webadmin-routes.html
+++ b/src/homepage/howTo/custom-webadmin-routes.html
@@ -85,18 +85,13 @@ host=localhost
 # within the classpath or in the ./extensions-jars folder.
 extensions.routes=org.apache.james.examples.RouteA</code></pre>
 
-                <p>Create a keystore (default password being <code>james72laBalle</code>):</p>
-
-                <pre><code>keytool -genkey -alias james -keyalg RSA -keystore keystore</code></pre>
-
                 <p>Then start a James server with your JAR and the configuration:</p>
 
                 <pre><code>docker run -d \
    -v $PWD/webadmin.properties:/root/conf/webadmin.properties \
    -v $PWD/exts:/root/extensions-jars \
-   -v $PWD/keystore:/root/conf/keystore \
    -p 25:25 \
-   apache/james:memory-latest</code></pre>
+   apache/james:memory-latest --generate-keystore</code></pre>
 
                 <p>You can play with <code>curl</code> utility with the resulting server:</p>
 
diff --git a/src/homepage/howTo/deleted-messages-vault.html b/src/homepage/howTo/deleted-messages-vault.html
index f34b93595f..14c2368607 100644
--- a/src/homepage/howTo/deleted-messages-vault.html
+++ b/src/homepage/howTo/deleted-messages-vault.html
@@ -271,12 +271,12 @@ $ cp -rf james-project/server/apps/distributed-app/sample-configuration conf
 $ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore
                 </code></pre>
 
-                <p>Second, modify deletedMessageVault.properties configuration file like in the previous example</p>
+                <p>Second, modify <code>deletedMessageVault.properties</code> configuration file like in the previous example</p>
 
-                <p>Third, modify listeners.xml to configure DeletedMessageVaultHook by adding preDeletionHook section at previous paragraph</p>
+                <p>Third, modify <code>listeners.xml</code> to configure DeletedMessageVaultHook by adding preDeletionHook section at previous paragraph</p>
 
                 <p>
-                    Fourth, modify blob.properties file to configure the BlobStore that will be used and the file exporting mechanism, like
+                    Fourth, modify <code>blob.properties</code> file to configure the BlobStore that will be used and the file exporting mechanism, like
                     we saw previously as well.
                 </p>
 
diff --git a/src/homepage/howTo/imap-server.html b/src/homepage/howTo/imap-server.html
index fd87aeda78..44e54c72aa 100644
--- a/src/homepage/howTo/imap-server.html
+++ b/src/homepage/howTo/imap-server.html
@@ -170,7 +170,7 @@ $ mv keystore conf/keystore</code></pre>
 -p "143:143"  -p "993:993" \
 --volume "$PWD/conf:/root/conf/" \
 --volume "$PWD/var:/root/var/" \
-linagora/james-jpa-guice:latest</code></pre>
+apache/james:jpa-latest</code></pre>
 
 
                 <header class="major">
diff --git a/src/homepage/howTo/mail-processing.html b/src/homepage/howTo/mail-processing.html
index 52b90c32d7..0051940d9d 100644
--- a/src/homepage/howTo/mail-processing.html
+++ b/src/homepage/howTo/mail-processing.html
@@ -64,7 +64,7 @@ layout: howTo
           <p>None of the matchers and mailets available in James allows us to implement what we want. We will have to
           write our own mailet and matcher in a separated maven project depending on James Mailet API.</p>
 
-          <p>We will write a <b>IsDelayedForMoreThan</b> matcher with a configurable delay. If the Sent Date of incoming emails is older than specified delay, then the emails
+          <p>We will write a <a href="https://github.com/apache/james-project/blob/master/examples/custom-mailets/src/main/java/org/apache/james/examples/custom/mailets/IsDelayedForMoreThan.java">IsDelayedForMoreThan</a> matcher with a configurable delay. If the Sent Date of incoming emails is older than specified delay, then the emails
           should be matched (return all mail recipients). Otherwise, we just return an empty list of recipients.</p>
 
           <p>To ease our Job, we can rely on the <b>org.apache.james.apache-mailet-base</b> maven project, which provides us a <b>GenericMatcher</b> that we can extend.</p>
@@ -72,8 +72,8 @@ layout: howTo
           <p>Here is the dependency:</p>
 
           <pre><code>&lt;dependency&gt;
-&lt;groupId&gt;org.apache.james&lt;/groupId&gt;
-&lt;artifactId&gt;apache-mailet-base&lt;/artifactId&gt;
+    &lt;groupId&gt;org.apache.james&lt;/groupId&gt;
+    &lt;artifactId&gt;apache-mailet-base&lt;/artifactId&gt;
 &lt;/dependency&gt;</code></pre>
 
           <p>The main method of a matcher is the <b>match</b> method:</p>
@@ -82,7 +82,7 @@ layout: howTo
 
           <p>For us, it becomes, with <b>maxDelay</b> being previously configured:</p>
 
-          <pre><code>    private final Clock clock;
+          <pre><code>private final Clock clock;
 private Duration maxDelay;
 
 @Override
@@ -107,7 +107,7 @@ public void init() {
     maxDelay = Duration.ofMillis(TimeConverter.getMilliSeconds(condition, DEFAULT_UNIT));
 }</code></pre>
 
-          <p>Now, let's take a look at the <b>SendPromotionCode</b> mailet. Of course, we want to write a generic mailet
+          <p>Now, let's take a look at the <a href="https://github.com/apache/james-project/blob/master/examples/custom-mailets/src/main/java/org/apache/james/examples/custom/mailets/SendPromotionCode.java">SendPromotionCode</a> mailet. Of course, we want to write a generic mailet
              with a configurable reason (why are we sending the promotion code). To keep things simple, only one promotion
              code will be used, and will be written in the configuration. We can here also simply extend the
               <b>GenericMailet</b> helper class.</p>
@@ -118,7 +118,7 @@ public void init() {
 
           <p>For us, it becomes, with <b>reason</b> and <b>promotionCode</b> being previously configured:</p>
 
-            <pre><code>    public static final boolean REPLY_TO_SENDER_ONLY = false;
+            <pre><code>public static final boolean REPLY_TO_SENDER_ONLY = false;
 
 private String reason;
 private String promotionCode;
@@ -203,7 +203,7 @@ public void init() throws MessagingException {
         <pre><code>docker run -p "25:25" -p "143:143" \
                -v "$PWD/src/main/resources/mailetcontainer.xml:/root/conf/mailetcontainer.xml" \
                -v "$PWD/target/custom-mailets.jar:/root/extensions-jars/custom-mailets.jar" \
-        apache/james:jpa-latest</code></pre>
+        apache/james:memory-latest --generate-keystore</code></pre>
 
         </div>
           <footer class="major">
diff --git a/src/homepage/index.html b/src/homepage/index.html
index 1bd312021d..ac8c41329f 100644
--- a/src/homepage/index.html
+++ b/src/homepage/index.html
@@ -119,7 +119,7 @@ layout: default
             <ul class="james-ul no-padding">
               <li class="post-template"><span class="long-arrow-right">&#8594;</span><span><b>
 WHAT WILL YOU TRY:</b><br>
-              <span>Here you will try James server v 3.8.0 thanks to an image. This James image has a default configuration
+              <span>Here you will try James server version 3.8.0 thanks to an image. This James image has a default configuration
                 using JPA (hsqldb) and Lucene. It also includes a default domain named james.local and three default users:
                 user01@james.local, user02@james.local, user03@james.local, with their default password being <i>1234</i>.<br>
                 <i>Note: this James server will respond to IMAPS port 993 and SMTPS port 465.</i></span></span>
@@ -440,7 +440,7 @@ WHAT WILL YOU TRY:</b><br>
           <li class="no-padding"><a href="#posts">Last Posts</a></li>
           <li class="no-padding"><a href="#second">Community</a></li>
           <li class="no-padding"><a href="#third">Contribute</a></li>
-          <li class="no-padding"><a href="https://james.apache.org/"><span class="fa fa-external-link"></span> Documentation</a></li>
+          <li class="no-padding"><a href="documentation.html"><span class="fa fa-external-link"></span> Documentation</a></li>
         </ul>
       </section>
       <section>


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org


[james-project] 02/02: [EXAMPLE] Make pom finalName for example module

Posted by rc...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

rcordier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git

commit 40c1fe820f71803587db24af051674e25a8267ad
Author: Tung Tran <vt...@linagora.com>
AuthorDate: Wed Sep 13 08:05:29 2023 +0700

    [EXAMPLE] Make pom finalName for example module
---
 examples/custom-healthcheck/pom.xml    | 1 +
 examples/custom-listeners/pom.xml      | 1 +
 examples/custom-mailets/pom.xml        | 1 +
 examples/custom-smtp-command/pom.xml   | 1 +
 examples/custom-smtp-hooks/pom.xml     | 1 +
 examples/custom-webadmin-route/pom.xml | 1 +
 6 files changed, 6 insertions(+)

diff --git a/examples/custom-healthcheck/pom.xml b/examples/custom-healthcheck/pom.xml
index afb422c4ca..49ff11cf30 100644
--- a/examples/custom-healthcheck/pom.xml
+++ b/examples/custom-healthcheck/pom.xml
@@ -45,6 +45,7 @@
     </dependencies>
 
     <build>
+        <finalName>custom-healthcheck</finalName>
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
diff --git a/examples/custom-listeners/pom.xml b/examples/custom-listeners/pom.xml
index 53140acefd..6fae3e24d2 100644
--- a/examples/custom-listeners/pom.xml
+++ b/examples/custom-listeners/pom.xml
@@ -80,6 +80,7 @@
     </dependency>
   </dependencies>
   <build>
+    <finalName>custom-listeners</finalName>
     <plugins>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
diff --git a/examples/custom-mailets/pom.xml b/examples/custom-mailets/pom.xml
index 06dc460ce9..772b645c90 100644
--- a/examples/custom-mailets/pom.xml
+++ b/examples/custom-mailets/pom.xml
@@ -47,6 +47,7 @@
     </dependency>
   </dependencies>
   <build>
+    <finalName>custom-mailets</finalName>
     <plugins>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
diff --git a/examples/custom-smtp-command/pom.xml b/examples/custom-smtp-command/pom.xml
index 4967e303f0..d337b142de 100644
--- a/examples/custom-smtp-command/pom.xml
+++ b/examples/custom-smtp-command/pom.xml
@@ -40,6 +40,7 @@
     </dependencies>
 
     <build>
+        <finalName>custom-smtp-command</finalName>
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
diff --git a/examples/custom-smtp-hooks/pom.xml b/examples/custom-smtp-hooks/pom.xml
index 03fb0983a2..77f18d2974 100644
--- a/examples/custom-smtp-hooks/pom.xml
+++ b/examples/custom-smtp-hooks/pom.xml
@@ -40,6 +40,7 @@
     </dependencies>
 
     <build>
+        <finalName>custom-smtp-hooks</finalName>
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
diff --git a/examples/custom-webadmin-route/pom.xml b/examples/custom-webadmin-route/pom.xml
index 04c296ce44..126a093528 100644
--- a/examples/custom-webadmin-route/pom.xml
+++ b/examples/custom-webadmin-route/pom.xml
@@ -40,6 +40,7 @@
     </dependencies>
 
     <build>
+        <finalName>custom-webadmin-route</finalName>
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org