documentation fixes (#1274)

bindings/python/src/session.cpp

@@ -50,7 +50,6 @@ namespace
         if (ec) throw libtorrent_exception(ec);
 #endif
     }
-#endif
 
     void outgoing_ports(lt::session& s, int _min, int _max)
     {
@@ -61,6 +60,8 @@ namespace
         s.apply_settings(p);
         return;
     }
+#endif // TORRENT_NO_DEPRECATE
+
 #ifndef TORRENT_DISABLE_DHT
     void add_dht_node(lt::session& s, tuple n)
     {
@@ -770,10 +771,10 @@ void bind_session()
                 , arg("flags")=lt::session::start_default_features | lt::session::add_default_plugins
                 , arg("alert_mask")=int(alert::error_notification)))
         )
+        .def("outgoing_ports", &outgoing_ports)
 #endif
         .def("post_torrent_updates", allow_threads(&lt::session::post_torrent_updates), arg("flags") = 0xffffffff)
         .def("post_session_stats", allow_threads(&lt::session::post_session_stats))
-        .def("outgoing_ports", &outgoing_ports)
         .def("is_listening", allow_threads(&lt::session::is_listening))
         .def("listen_port", allow_threads(&lt::session::listen_port))
 #ifndef TORRENT_DISABLE_DHT

include/libtorrent/session_handle.hpp

@@ -613,8 +613,8 @@ namespace libtorrent
 		// listen_failed_alert with port 0 even if you didn't ask to listen on
 		// it.
 		//
-		// It is possible to prevent libtorrent from binding to port 0 by passing
-		// in the flag ``session::no_system_port`` in the ``flags`` argument.
+		// It is possible to prevent libtorrent from falling back to binding to
+		// port 0 by clearing the ``listen_system_port_fallback`` settings.
 		//
 		// The interface parameter can also be a hostname that will resolve to
 		// the device you want to listen on. If you don't specify an interface,
@@ -622,12 +622,6 @@ namespace libtorrent
 		// 0.0.0.0 and ::). This means that if your IPv6 interface doesn't work,
 		// you may still see a listen_failed_alert, even though the IPv4 port
 		// succeeded.
-		//
-		// The ``flags`` parameter can either be 0 or
-		// ``session::listen_reuse_address``, which will set the reuse address
-		// socket option on the listen socket(s). By default, the listen socket
-		// does not use reuse address. If you're running a service that needs to
-		// run on a specific port no matter if it's in use, set this flag.
 		unsigned short listen_port() const;
 		unsigned short ssl_listen_port() const;
 		bool is_listening() const;

include/libtorrent/settings_pack.hpp

@@ -1383,7 +1383,7 @@ namespace libtorrent
 			// normal client. If this is a high performance server which expects
 			// to receive a lot of connections, or used in a simulator or test, it
 			// might make sense to raise this number. It will not take affect
-			// until listen_on() is called again (or for the first time).
+			// until the ``listen_interfaces`` settings is updated.
 			listen_queue_size,
 
 			// ``torrent_connect_boost`` is the number of peers to try to connect