Several changes:

 - Merges from master:
   - add documentation and improved implementation for issue #5308
   - fix WWebwidget::setId related issues #5684
 - Wt 4 specific:
   - Adding h to to include file in doxygen

Author: RockinRoel

doc/main

@@ -558,10 +558,30 @@ appRoot=C:\Program Files\MyApplications\AppRoot
 
     <dd>Every session is mapped a dedicated process, allowing maximal
       session isolation, but at an increased session cost. This is
-	  not supported by the ISAPI connector. Note: when using the
-	  <tt>wthttp</tt> adapter, this will create a listening socket
-	  on the loopback interface (<tt>127.0.0.1</tt>) for every session,
-	  with the parent process acting as a proxy.</dd>
+      not supported by the ISAPI connector. Note: when using the
+      <tt>wthttp</tt> adapter, this will create a listening socket
+      on the loopback interface (<tt>127.0.0.1</tt>) for every session,
+      with the parent process acting as a proxy. The following options
+      can be put in the <b>&lt;dedicated-process&gt;</b> subsection.
+      <dl>
+
+        <dt><strong>max-num-sessions</strong></dt>
+        <dd>
+        Limits the amount of session processes.
+        </dd>
+
+        <dt><strong>num-session-threads</strong></dt>
+        <dd>
+        Usually the dedicated session processes uses the same amount
+        of threads as the parent process. This option changes the
+        amount of threads the session processes use independently of
+        the parent process. When this option is set the
+        <strong>num-threads</strong> configuration option and the <strong>-t</strong>
+        command line argument will only affect the parent process.
+        </dd>
+
+      </dl>
+    </dd>
 
     <dt><strong>shared-process</strong></dt>
 
@@ -639,6 +659,12 @@ appRoot=C:\Program Files\MyApplications\AppRoot
       request will result in a WApplication::requestTooLarge() signal.
       </dd>
 
+    <dt><strong>num-threads</strong></dt>
+
+    <dd>Sets the number of threads to be used to handle %Wt traffic.
+      Depending on your application, you may want to increase the
+      default size of 10 threads. </dd>
+
     <dt><strong>session-id-length</strong></dt>
 
     <dd>The length (in number of characters) for the unique session ID.</dd>
@@ -918,14 +944,6 @@ Settings may be set in the configuration file /etc/wt/wthttpd
   are specified inside a <b>&lt;connector-isapi&gt;</b> subsection.
 
   <dl>
-    <dt><strong>num-threads</strong></dt>
-
-    <dd>Sets the number of threads to be used to handle %Wt traffic. The
-    connector will never use IIS threads to do any processing, but will
-    forward the requests to a thread pool of the size given in this variable.
-    Depending on your application, you may want to increase the default size
-    of 10 threads.</dd>
-
     <dt><strong>max-memory-request-size</strong></dt>
 
     <dd>Every HTTP request whose size is smaller than this parameter will

src/Wt/Auth/AbstractPasswordService

@@ -30,7 +30,7 @@ enum class PasswordResult {
   PasswordValid    //!< The password is valid
 };
 
-/*! \class AbstractPasswordService Wt/Auth/AbstractPasswordService
+/*! \class AbstractPasswordService Wt/Auth/AbstractPasswordService.h
  *  \brief Abstract password authentication service
  *
  * This abstract class defines the interface for password authentication.

src/Wt/Auth/AbstractUserDatabase

@@ -21,7 +21,7 @@ namespace Wt {
 class IssuedToken;
 class OAuthClient;
 
-/*! \class AbstractUserDatabase Wt/Auth/AbstractUserDatabase
+/*! \class AbstractUserDatabase Wt/Auth/AbstractUserDatabase.h
  *  \brief Abstract interface for an authentication user database
  *
  * This class defines the interface for managing user data related to

src/Wt/Auth/AuthModel

@@ -20,7 +20,7 @@ class AbstractUserDatabase;
 class Login;
 class OAuthService;
 
-/*! \class AuthModel Wt/Auth/AuthModel
+/*! \class AuthModel Wt/Auth/AuthModel.h
  *  \brief Model for implementing an authentication view.
  *
  * This model implements the logic for authenticating a user (the

src/Wt/Auth/AuthService

@@ -109,7 +109,7 @@ enum class AuthTokenState {
   Valid    //!< The presented auth token was invalid
 };
 
-/*! \class EmailTokenResult Wt/Auth/AuthService Wt/Auth/AuthService
+/*! \class EmailTokenResult Wt/Auth/AuthService.h Wt/Auth/AuthService.h
  *  \brief The result of processing an email-sent token.
  *
  * An email token can be used for two purposes:
@@ -154,7 +154,7 @@ private:
   User user_;
 };
 
-/*! \class AuthTokenResult Wt/Auth/AuthService Wt/Auth/AuthService
+/*! \class AuthTokenResult Wt/Auth/AuthService.h Wt/Auth/AuthService.h
  *  \brief The result of processing an authentication token.
  *
  * An authentication token is usually taken from a browser cookie, and
@@ -214,7 +214,7 @@ private:
   int newTokenValidity_;
 };
 
-/*! \class AuthService Wt/Auth/AuthService Wt/Auth/AuthService
+/*! \class AuthService Wt/Auth/AuthService.h Wt/Auth/AuthService.h
  *  \brief Basic authentication service
  *
  * This class presents an basic authentication service, which offers

src/Wt/Auth/AuthWidget

@@ -22,7 +22,7 @@ class AuthModel;
 class Login;
 class User;
 
-/*! \class AuthWidget Wt/Auth/AuthWidget
+/*! \class AuthWidget Wt/Auth/AuthWidget.h
  *  \brief An authentication widget.
  *
  * The authentication widget is a widget that provides a login or

src/Wt/Auth/Dbo/AuthInfo

@@ -24,7 +24,7 @@ namespace Wt {
 template <class AuthInfoType> class AuthToken;
 template <class AuthIdentityType> class AuthIdentity;
 
-/*! \class AuthInfo Wt/Auth/Dbo/AuthInfo
+/*! \class AuthInfo Wt/Auth/Dbo/AuthInfo.h
  *  \brief A default implementation for authentication data in %Wt::%Dbo
  * 
  * This class implements the requirements for use as a data type in
@@ -286,7 +286,7 @@ private:
   AuthIdentities authIdentities_;
 };
 
-/*! \class AuthToken Wt/Auth/Dbo/AuthInfo
+/*! \class AuthToken Wt/Auth/Dbo/AuthInfo.h
  *  \brief A default implementation for an authentication token in %Wt::%Dbo
  * 
  * This class is used by AuthInfo, and stores authentication tokens.
@@ -340,7 +340,7 @@ private:
   Wt::WDateTime expires_;
 };
 
-/*! \class AuthIdentity Wt/Auth/Dbo/AuthInfo
+/*! \class AuthIdentity Wt/Auth/Dbo/AuthInfo.h
  *  \brief A default implementation for a authentication identity in %Wt::%Dbo
  * 
  * This class is used by AuthInfo, and stores identities.

src/Wt/Auth/Dbo/UserDatabase

@@ -16,7 +16,7 @@ namespace Wt {
   namespace Auth {
     namespace Dbo {
 
-/*! \class UserDatabase Wt/Auth/Dbo/UserDatabase
+/*! \class UserDatabase Wt/Auth/Dbo/UserDatabase.h
  *  \brief A default implementation for an authentication user database.
  * 
  * This is a template class, and needs as parameter the Dbo type which

src/Wt/Auth/FormBaseModel

@@ -17,7 +17,7 @@ class AbstractPasswordService;
 class AbstractUserDatabase;
 class OAuthService;
 
-/*! \class FormBaseModel Wt/Auth/FormBaseModel
+/*! \class FormBaseModel Wt/Auth/FormBaseModel.h
  *  \brief A base model class for authentication-related forms
  *
  * This class manages the the auth services and the user database which

src/Wt/Auth/HashFunction

@@ -13,7 +13,7 @@
 namespace Wt {
   namespace Auth {
 
-/*! \class HashFunction Wt/Auth/HashFunction
+/*! \class HashFunction Wt/Auth/HashFunction.h
  *  \brief An abstract cryptographic hash function interface.
  *
  * A cryptographic hash function computes a hash value from a message,
@@ -70,7 +70,7 @@ public:
 		      const std::string& hash) const;
 };
 
-/*! \class MD5HashFunction Wt/Auth/HashFunction
+/*! \class MD5HashFunction Wt/Auth/HashFunction.h
  *  \brief A cryptograhpic hash function implemented using MD5.
  *
  * This hash function is useful for creating token hashes, but
@@ -92,7 +92,7 @@ public:
 };
 
 #ifndef WT_TARGET_JAVA
-/*! \class SHA1HashFunction Wt/Auth/HashFunction
+/*! \class SHA1HashFunction Wt/Auth/HashFunction.h
  *  \brief A cryptographic hash function implemented using SHA1.
  *
  * This hash function is only available if %Wt was compiled with
@@ -117,7 +117,7 @@ public:
 };
 #endif
 
-/*! \class BCryptHashFunction Wt/Auth/HashFunction
+/*! \class BCryptHashFunction Wt/Auth/HashFunction.h
  *  \brief An cryptographic hash function that implements bcrypt.
  *
  * This hashing function is intended for password hashes. In addition