several changes and reorganisation

mrw namespace docu

mrw/mrw.hpp.in

@@ -1,13 +1,16 @@
 /** @mainpage
 
-    $Date$
-
     @section intro Introduction
 
     @verbinclude README
     
     For details, see the <a href="modules.html">"Modules"</a> page.
 
+    @section news News
+
+    New in this release (more information on changes in @ref changes):
+    @verbinclude NEWS
+    
     @section download Download
 
     Download this version from here:
@@ -41,8 +44,6 @@
     For the @ref AutoTools "unexpected handler" you need to link with
     @c -lmrwexcstderr or @c -lmrwexclog4cxx.
 
-    @section moreinfo Additional Information
-
     @section threads Thread Safety
 
     All classes are not thread safe, that means they should either
@@ -51,6 +52,51 @@
     me an email and ask me for it (you find the adress in the package
     or on my personal homepage: http://marc.waeckerlin.org).
 
+    @section libversion Library Versioning
+
+    The library and the package have the same version number. This
+    means, if you for example install the package versioned
+    mrw-c++-2.6.4.tar.gz, then it builds a shared library of the same
+    version, named libmrw.so.2.6.4. The naming is
+    version=MAJOR.MINOR.LEAST. What do the numbers mean:
+
+    <dl>
+      <dt>MAJOR</dt>
+      
+      <dd>If the major number is increased, then the backwards
+      compatibility was broken. Either there was an incompatible
+      change in the implementation, or in the interface, e.g. a change
+      in method parameters, or even parts of the library have been
+      removed.</dd>
+
+      <dt>MINOR</dt>
+
+      <dd>If the minor number changes, then it remains backward
+      compatible. Either there was a minor change in the
+      implementation or behavior of some features, a bigger bugfix, or
+      new feature were added. A program linked to a previous library
+      with smaller minor number still works, but a program linked to
+      newer library with a higher minor number may not work with a
+      library that has a lower minor number. This is a one way,
+      backwards only compatibility.</dd>
+
+      <dt>LEAST</dt>
+
+      <dd>The least number is increased for small changes, bugfixes,
+      changes in the documentation and so on. Except the bugs, changes
+      in the least number are fully forward and backward
+      compatible.</dd>
+    </dl>
+
+    This means, programs linked to mrw-c++ version 2.6.4 will work
+    with library version 2.6.3, also with version 2.6.5, or with
+    version 2.7.1, but it won't work with version 2.5.4 nor with 1.1.3
+    nor with 3.1.4.
+
+    You can see the version of the library by issuing the command @c what.
+
+    @section moreinfo Additional Information
+
     See the <a href="pages.html">"Related Pages"</a>.
     
      - @ref license "License Information (LGPL)"
@@ -73,3 +119,14 @@
 
 /** @page changes Change Log
     @verbinclude ChangeLog */
+
+/** @brief the namespace for this library
+
+    All classes and all functions (except global operators) are placed
+    in this namespace.
+
+    For an overview, better see the <a
+    href="modules.html">"Modules"</a> page.
+*/
+namespace mrw {
+}