diff --git a/html/alignwn.html b/html/alignwn.html
index 4edc528b4fd3c9c60cad0f46d35de180d3c0aa5c..ca500a7f28c6a317944837a1670cf99589917791 100644
--- a/html/alignwn.html
+++ b/html/alignwn.html
@@ -1,56 +1,47 @@
 <html>
 <head>
-<title>Using the Alignment API with Wordnet</title>
+<title>Using the Alignment API with WordNet</title>
 <!--style type="text/css">@import url(style.css);</style-->
 <link rel="stylesheet" type="text/css" href="base.css" />
 <link rel="stylesheet" type="text/css" href="style.css" />
 </head>
 <body>
 
-<h1 class="titre">Using the Alignment API with Wordnet</h1>
+<h1 class="titre">Using the Alignment API with WordNet</h1>
 
-<p>We explain how to use the API with wordnet. This is also useful when
-using OLA.</p>
+<p>We explain how to use the API with wordnet.</p>
 
-<h2>Getting the required software</h2>
+<h2>Getting, installing and configuring WordNet</h2>
 
-<p>Different pieces of software are necessary for this integration:
-<dl compact="1">
-<dt><a href="index.html">Alignment API</a></dt>
-<dd>as well as the OWL API are necessary. Its lib directory
-contains the alignwn.jar file.</dd>
-<dt><a href="">Wordnet</a></dt>
-<dd>version 2.0 is used; it seems to work flawlessly with 3.0.</dd>
-<dt>The <a href="">Java WordNet Library (JWNL)</a></dt>
-<dd>whose jar-file should be put in the same directory as alignwn.jar.</dd>
-<dt>Apache <a href="">common-loggings</a></dt>
-<dd>commons-logging.jar should be put there as well.</dd>
-</dl>
+<p>
+This may be skipped if WordNet is already installed on the current platform.
 </p>
-
-<h2>Installing wordnet and configuring</h2>
-
-<p>First Wordnet must be compiled if this is not already done.
+<p>
+First Wordnet must be downloaded from <a href="https://wordnet.princeton.edu/">the WordNet website</a>.
+</p>
+<p>
+Then it has to be compiled.
 This will depend on your distribution and will not be further 
-detailed here.</p>
-
-<p>Once installed, Wordnet usually has a "dict" directory whose path
-  is $WNDIR.
-<!--The file_properties.xml provided with jwnl must be put in the 
-current directory with the "dictionary_path" parameter set to
-the path of this dict directory:
-<pre>
-&lt;param name="dictionary_path" value="$dict$"/&gt;
-</pre-->
+detailed here.
 </p>
 
 <h2>Running</h2>
 
-<p>This usually can be obtained by:
+<p>
+Once installed, Wordnet usually has a "dict" directory whose path is assumed here to be in $WNDIR.
+</p>
+
+<p>A matcher using WordNet can be run by, for instance (from the Alignment API distribution root directory):
 <div class="terminal">
-$ export CWD=`pwd`
-$ java -jar lib/alignwn.jar -Dwndict=$WNDIR file://$CWD/examples/rdf/edu.umbc.ebiquity.publication.owl file://$CWD/examples/rdf/edu.mit.visus.bibtex.owl -i fr.inrialpes.exmo.align.ling.JWNLAlignment -o examples/rdf/JWNL.rdf
+$ java -jar lib/procalign.jar -Dwndict=$WNDIR file:examples/rdf/edu.umbc.ebiquity.publication.owl file:examples/rdf/edu.mit.visus.bibtex.owl -i fr.inrialpes.exmo.align.ling.JWNLAlignment -o examples/rdf/JWNL.rdf
 </div>
+</p>
+
+<p>
+Note that JWNLAlignment is only an example of matcher and nothing very elaborate.
+Its source can be used as inspiration.
+Most of its code relies on the <a href="http://ontosim.gforge.inria.fr">OntoSim library</a>.
+</p>
 
 <address>
 <small>
diff --git a/html/relnotes.html b/html/relnotes.html
index 750eeaa5d9cb8786d091d70d2673e6765d78a596..c3f847317dd1042106dfaa8bf4bc5f3c3bae94ef 100644
--- a/html/relnotes.html
+++ b/html/relnotes.html
@@ -65,6 +65,7 @@ with a warning:
 <li>Fixed a problem with Jade when running a server with no X server running (serv)</li>
 <li>Moved all shell examples from csh to bash (html)</li>
 <li>Clarified EDOAL documentation (html)</li>
+<li>Several documentation fixes --alignwn, rest-- (html)</li>
 <li>Fixed all Javadoc generation warnings (distrib)</li>
 </ul></p>