diff --git a/docs/building.html b/docs/building.html
index 0e82a8147..544a0e9db 100644
--- a/docs/building.html
+++ b/docs/building.html
@@ -276,10 +276,11 @@ libraries.</li>
 </tr>
 <tr><td><tt class="docutils literal">logging</tt></td>
 <td><ul class="first last simple">
-<li><tt class="docutils literal">none</tt> - no logging.</li>
-<li><tt class="docutils literal">default</tt> - basic session logging.</li>
-<li><tt class="docutils literal">verbose</tt> - verbose peer wire logging.</li>
-<li><tt class="docutils literal">errors</tt> - like verbose, but limited to errors.</li>
+<li><tt class="docutils literal">off</tt> - default. logging disabled.</li>
+<li><tt class="docutils literal">on</tt> - logging alerts available, still need to
+be enabled by the alert mask. The reason logging
+is disabled by default is to keep the binary
+size down.</li>
 </ul>
 </td>
 </tr>
@@ -643,14 +644,10 @@ compilation units having different views of
 structs and class layouts and sizes.</td>
 </tr>
 <tr><td><tt class="docutils literal">TORRENT_LOGGING</tt></td>
-<td>This macro will enable logging of the session
-events, such as tracker announces and incoming
-connections (as well as blocked connections).</td>
-</tr>
-<tr><td><tt class="docutils literal">TORRENT_VERBOSE_LOGGING</tt></td>
-<td>If you define this macro, every peer connection
-will log its traffic to a log file as well as
-the session log.</td>
+<td>This macro will enable support for logging
+alerts, like log_alert, torrent_log_alert and
+peer_log_alert. Without this build flag, you
+cannot enable those alerts.</td>
 </tr>
 <tr><td><tt class="docutils literal">TORRENT_STORAGE_DEBUG</tt></td>
 <td>This will enable extra expensive invariant
diff --git a/docs/reference-Session.html b/docs/reference-Session.html
index 2de0f8279..6aa499ea7 100644
--- a/docs/reference-Session.html
+++ b/docs/reference-Session.html
@@ -513,18 +513,16 @@ class session: public boost::noncopyable
    <strong>session</strong> (fingerprint const&amp; print = fingerprint(&quot;LT&quot;
       , LIBTORRENT_VERSION_MAJOR, LIBTORRENT_VERSION_MINOR, 0, 0)
       , int flags = start_default_features | add_default_plugins
-      , boost::uint32_t alert_mask = alert::error_notification
-      TORRENT_LOGPATH_ARG_DEFAULT);
-   <strong>session</strong> (settings_pack const&amp; pack
-      , fingerprint const&amp; print = fingerprint(&quot;LT&quot;
-      , LIBTORRENT_VERSION_MAJOR, LIBTORRENT_VERSION_MINOR, 0, 0)
-      , int flags = start_default_features | add_default_plugins);
+      , boost::uint32_t alert_mask = alert::error_notification);
    <strong>session</strong> (fingerprint const&amp; print
       , std::pair&lt;int, int&gt; listen_port_range
       , char const* listen_interface = &quot;0.0.0.0&quot;
       , int flags = start_default_features | add_default_plugins
-      , int alert_mask = alert::error_notification
-      TORRENT_LOGPATH_ARG_DEFAULT);
+      , int alert_mask = alert::error_notification);
+   <strong>session</strong> (settings_pack const&amp; pack
+      , fingerprint const&amp; print = fingerprint(&quot;LT&quot;
+      , LIBTORRENT_VERSION_MAJOR, LIBTORRENT_VERSION_MINOR, 0, 0)
+      , int flags = start_default_features | add_default_plugins);
    <strong>~session</strong> ();
    void <strong>load_state</strong> (lazy_entry const&amp; e);
    void <strong>save_state</strong> (entry&amp; e, boost::uint32_t flags = 0xffffffff) const;
@@ -623,18 +621,16 @@ class session: public boost::noncopyable
 <strong>session</strong> (fingerprint const&amp; print = fingerprint(&quot;LT&quot;
       , LIBTORRENT_VERSION_MAJOR, LIBTORRENT_VERSION_MINOR, 0, 0)
       , int flags = start_default_features | add_default_plugins
-      , boost::uint32_t alert_mask = alert::error_notification
-      TORRENT_LOGPATH_ARG_DEFAULT);
-<strong>session</strong> (settings_pack const&amp; pack
-      , fingerprint const&amp; print = fingerprint(&quot;LT&quot;
-      , LIBTORRENT_VERSION_MAJOR, LIBTORRENT_VERSION_MINOR, 0, 0)
-      , int flags = start_default_features | add_default_plugins);
+      , boost::uint32_t alert_mask = alert::error_notification);
 <strong>session</strong> (fingerprint const&amp; print
       , std::pair&lt;int, int&gt; listen_port_range
       , char const* listen_interface = &quot;0.0.0.0&quot;
       , int flags = start_default_features | add_default_plugins
-      , int alert_mask = alert::error_notification
-      TORRENT_LOGPATH_ARG_DEFAULT);
+      , int alert_mask = alert::error_notification);
+<strong>session</strong> (settings_pack const&amp; pack
+      , fingerprint const&amp; print = fingerprint(&quot;LT&quot;
+      , LIBTORRENT_VERSION_MAJOR, LIBTORRENT_VERSION_MINOR, 0, 0)
+      , int flags = start_default_features | add_default_plugins);
 </pre>
 <p>TODO: 3 could the fingerprint be a setting as well? And should the
 <a class="reference external" href="reference-Settings.html#settings_pack">settings_pack</a> be optional?</p>