From 4ef441f9ca19a15980ba69bdb6638fa6d4f793d5 Mon Sep 17 00:00:00 2001
From: Arvid Norberg <arvid@libtorrent.org>
Date: Tue, 27 Mar 2012 03:22:30 +0000
Subject: [PATCH] fixed typos in documentation

---
 docs/manual.html | 369 +++++++----------------------------------------
 docs/manual.rst  |  47 +++---
 2 files changed, 80 insertions(+), 336 deletions(-)

diff --git a/docs/manual.html b/docs/manual.html
index 79eabf609..9829d802b 100644
--- a/docs/manual.html
+++ b/docs/manual.html
@@ -58,292 +58,36 @@
 <li><a class="reference internal" href="#overview" id="id13">overview</a></li>
 <li><a class="reference internal" href="#things-to-keep-in-mind" id="id14">things to keep in mind</a></li>
 <li><a class="reference internal" href="#network-primitives" id="id15">network primitives</a></li>
-<li><a class="reference internal" href="#session" id="id16">session</a><ul>
-<li><a class="reference internal" href="#id1" id="id17">session()</a></li>
-<li><a class="reference internal" href="#id2" id="id18">~session()</a></li>
-<li><a class="reference internal" href="#load-state-save-state" id="id19">load_state() save_state()</a></li>
-<li><a class="reference internal" href="#pause-resume-is-paused" id="id20">pause() resume() is_paused()</a></li>
-<li><a class="reference internal" href="#abort" id="id21">abort()</a></li>
-<li><a class="reference internal" href="#async-add-torrent-add-torrent" id="id22">async_add_torrent() add_torrent()</a></li>
-<li><a class="reference internal" href="#remove-torrent" id="id23">remove_torrent()</a></li>
-<li><a class="reference internal" href="#find-torrent-get-torrents" id="id24">find_torrent() get_torrents()</a></li>
-<li><a class="reference internal" href="#get-torrent-status-refresh-torrent-status" id="id25">get_torrent_status() refresh_torrent_status()</a></li>
-<li><a class="reference internal" href="#post-torrent-updates" id="id26">post_torrent_updates()</a></li>
-<li><a class="reference internal" href="#load-asnum-db-load-country-db-as-for-ip" id="id27">load_asnum_db() load_country_db() as_for_ip()</a></li>
-<li><a class="reference internal" href="#set-ip-filter" id="id28">set_ip_filter()</a></li>
-<li><a class="reference internal" href="#get-ip-filter" id="id29">get_ip_filter()</a></li>
-<li><a class="reference internal" href="#status" id="id30">status()</a></li>
-<li><a class="reference internal" href="#get-cache-status" id="id31">get_cache_status()</a></li>
-<li><a class="reference internal" href="#get-cache-info" id="id32">get_cache_info()</a></li>
-<li><a class="reference internal" href="#is-listening-listen-port-listen-on" id="id33">is_listening() listen_port() listen_on()</a></li>
-<li><a class="reference internal" href="#set-alert-mask" id="id34">set_alert_mask()</a></li>
-<li><a class="reference internal" href="#pop-alerts-pop-alert-wait-for-alert" id="id35">pop_alerts() pop_alert() wait_for_alert()</a></li>
-<li><a class="reference internal" href="#add-feed" id="id36">add_feed()</a></li>
-<li><a class="reference internal" href="#remove-feed" id="id37">remove_feed()</a></li>
-<li><a class="reference internal" href="#get-feeds" id="id38">get_feeds()</a></li>
-<li><a class="reference internal" href="#add-extension" id="id39">add_extension()</a></li>
-<li><a class="reference internal" href="#set-settings-set-pe-settings" id="id40">set_settings() set_pe_settings()</a></li>
-<li><a class="reference internal" href="#set-proxy-proxy" id="id41">set_proxy() proxy()</a></li>
-<li><a class="reference internal" href="#set-i2p-proxy-i2p-proxy" id="id42">set_i2p_proxy() i2p_proxy()</a></li>
-<li><a class="reference internal" href="#start-dht-stop-dht-HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Connection: close
Transfer-Encoding: chunked
Cache-Control: max-age=0, private, must-revalidate, no-transform
Set-Cookie: i_like_gitea=cf3d9b28ac8a4769; Path=/; HttpOnly; Secure; SameSite=Lax
Set-Cookie: _csrf=7egWvGqvgEnsFnmbv68ouOl7UQQ6MTc1MzI2OTI0NzQyMDUwNzY2NA; Path=/; Max-Age=86400; HttpOnly; Secure; SameSite=Lax
X-Frame-Options: SAMEORIGIN
Date: Wed, 23 Jul 2025 11:14:07 GMT
X-Cache-Status: HIT
X-Cache-Age: 0

8000
From 4ef441f9ca19a15980ba69bdb6638fa6d4f793d5 Mon Sep 17 00:00:00 2001
From: Arvid Norberg <arvid@libtorrent.org>
Date: Tue, 27 Mar 2012 03:22:30 +0000
Subject: [PATCH] fixed typos in documentation

---
 docs/manual.html | 369 +++++++----------------------------------------
 docs/manual.rst  |  47 +++---
 2 files changed, 80 insertions(+), 336 deletions(-)

diff --git a/docs/manual.html b/docs/manual.html
index 79eabf609..9829d802b 100644
--- a/docs/manual.html
+++ b/docs/manual.html
@@ -58,292 +58,36 @@
 <li><a class="reference internal" href="#overview" id="id13">overview</a></li>
 <li><a class="reference internal" href="#things-to-keep-in-mind" id="id14">things to keep in mind</a></li>
 <li><a class="reference internal" href="#network-primitives" id="id15">network primitives</a></li>
-<li><a class="reference internal" href="#session" id="id16">session</a><ul>
-<li><a class="reference internal" href="#id1" id="id17">session()</a></li>
-<li><a class="reference internal" href="#id2" id="id18">~session()</a></li>
-<li><a class="reference internal" href="#load-state-save-state" id="id19">load_state() save_state()</a></li>
-<li><a class="reference internal" href="#pause-resume-is-paused" id="id20">pause() resume() is_paused()</a></li>
-<li><a class="reference internal" href="#abort" id="id21">abort()</a></li>
-<li><a class="reference internal" href="#async-add-torrent-add-torrent" id="id22">async_add_torrent() add_torrent()</a></li>
-<li><a class="reference internal" href="#remove-torrent" id="id23">remove_torrent()</a></li>
-<li><a class="reference internal" href="#find-torrent-get-torrents" id="id24">find_torrent() get_torrents()</a></li>
-<li><a class="reference internal" href="#get-torrent-status-refresh-torrent-status" id="id25">get_torrent_status() refresh_torrent_status()</a></li>
-<li><a class="reference internal" href="#post-torrent-updates" id="id26">post_torrent_updates()</a></li>
-<li><a class="reference internal" href="#load-asnum-db-load-country-db-as-for-ip" id="id27">load_asnum_db() load_country_db() as_for_ip()</a></li>
-<li><a class="reference internal" href="#set-ip-filter" id="id28">set_ip_filter()</a></li>
-<li><a class="reference internal" href="#get-ip-filter" id="id29">get_ip_filter()</a></li>
-<li><a class="reference internal" href="#status" id="id30">status()</a></li>
-<li><a class="reference internal" href="#get-cache-status" id="id31">get_cache_status()</a></li>
-<li><a class="reference internal" href="#get-cache-info" id="id32">get_cache_info()</a></li>
-<li><a class="reference internal" href="#is-listening-listen-port-listen-on" id="id33">is_listening() listen_port() listen_on()</a></li>
-<li><a class="reference internal" href="#set-alert-mask" id="id34">set_alert_mask()</a></li>
-<li><a class="reference internal" href="#pop-alerts-pop-alert-wait-for-alert" id="id35">pop_alerts() pop_alert() wait_for_alert()</a></li>
-<li><a class="reference internal" href="#add-feed" id="id36">add_feed()</a></li>
-<li><a class="reference internal" href="#remove-feed" id="id37">remove_feed()</a></li>
-<li><a class="reference internal" href="#get-feeds" id="id38">get_feeds()</a></li>
-<li><a class="reference internal" href="#add-extension" id="id39">add_extension()</a></li>
-<li><a class="reference internal" href="#set-settings-set-pe-settings" id="id40">set_settings() set_pe_settings()</a></li>
-<li><a class="reference internal" href="#set-proxy-proxy" id="id41">set_proxy() proxy()</a></li>
-<li><a class="reference internal" href="#set-i2p-proxy-i2p-proxy" id="id42">set_i2p_proxy() i2p_proxy()</a></li>
-<li><a class="reference internal" href="#start-dht-stop-dht-
1000
e::binary);
         out.unsetf(std::ios_base::skipws);
         bencode(std::ostream_iterator&lt;char&gt;(out), *rd-&gt;resume_data);
         --outstanding_resume_data;
@@ -4264,9 +4008,9 @@ available settings, see <a class="reference internal" href="#add-feed">add_feed(
 </div>
 <div class="section" id="feed-item">
 <h1>feed_item</h1>
-<dl class="docutils">
-<dt>The <tt class="docutils literal"><span class="pre">feed_item</span></tt> struct is defined in <tt class="docutils literal"><span class="pre">&lt;libtorrent/rss.hpp&gt;</span></tt>.</dt>
-<dd><pre class="first last literal-block">
+<p>The <tt class="docutils literal"><span class="pre">feed_item</span></tt> struct is defined in <tt class="docutils literal"><span class="pre">&lt;libtorrent/rss.hpp&gt;</span></tt>.</p>
+<blockquote>
+<pre class="literal-block">
 struct feed_item
 {
         feed_item();
@@ -4281,8 +4025,7 @@ struct feed_item
         sha1_hash info_hash;
 };
 </pre>
-</dd>
-</dl>
+</blockquote>
 <p><tt class="docutils literal"><span class="pre">size</span></tt> is the total size of the content the torrent refers to, or -1
 if no size was specified by the feed.</p>
 <p><tt class="docutils literal"><span class="pre">handle</span></tt> is the handle to the torrent, if the session is already downloading
@@ -7202,7 +6945,7 @@ struct libtorrent_exception: std::exception
 <div class="section" id="error-code">
 <h1>error_code</h1>
 <p>libtorrent uses boost.system's <tt class="docutils literal"><span class="pre">error_code</span></tt> class to represent errors. libtorrent has
-its own error category (<tt class="docutils literal"><span class="pre">libtorrent::libtorrent_category</span></tt>) whith the following error
+its own error category (<tt class="docutils literal"><span class="pre">libtorrent::get_libtorrent_category()</span></tt>) whith the following error
 codes:</p>
 <table border="1" class="docutils">
 <colgroup>
@@ -8072,7 +7815,7 @@ the <tt class="docutils literal"><span class="pre">libtorrent::errors</span></tt
 for system errors. That is, errors that belong to the generic or system category.</p>
 <p>Errors that belong to the libtorrent error category are not localized however, they
 are only available in english. In order to translate libtorrent errors, compare the
-error category of the <tt class="docutils literal"><span class="pre">error_code</span></tt> object against <tt class="docutils literal"><span class="pre">libtorrent::libtorrent_category</span></tt>,
+error category of the <tt class="docutils literal"><span class="pre">error_code</span></tt> object against <tt class="docutils literal"><span class="pre">libtorrent::get_libtorrent_category()</span></tt>,
 and if matches, you know the error code refers to the list above. You can provide
 your own mapping from error code to string, which is localized. In this case, you
 cannot rely on <tt class="docutils literal"><span class="pre">error_code::message()</span></tt> to generate your strings.</p>
@@ -8082,7 +7825,7 @@ new error codes may be appended at the end.</p>
 <pre class="literal-block">
 std::string error_code_to_string(boost::system::error_code const&amp; ec)
 {
-        if (ec.category() != libtorrent::libtorrent_category)
+        if (ec.category() != libtorrent::get_libtorrent_category())
         {
                 return ec.message();
         }
@@ -8161,7 +7904,7 @@ struct storage_interface
         // non virtual functions
 
         disk_buffer_pool* disk_pool();
-        void set_error(boost::filesystem::path const&amp; file, error_code const&amp; ec) const;
+        void set_error(std::string const&amp; file, error_code const&amp; ec) const;
         error_code const&amp; error() const;
         std::string const&amp; error_file() const;
         void clear_error();
@@ -8803,11 +8546,11 @@ download has all its pieces in the correct place). So, the main drawbacks are:</
 <p>The benefits though, are:</p>
 <blockquote>
 <ul class="simple">
-<li>No startup delay, since the files doesn't need allocating.</li>
+<li>No startup delay, since the files don't need allocating.</li>
 
1bfb
<li>The download will not use unnecessary disk space.</li>
 <li>Disk caches perform much better than in full allocation and raises the download
 speed limit imposed by the disk.</li>
-<li>Works well on filesystems that doesn't support sparse files.</li>
+<li>Works well on filesystems that don't support sparse files.</li>
 </ul>
 </blockquote>
 <p>The algorithm that is used when allocating pieces and slots isn't very complicated.
diff --git a/docs/manual.rst b/docs/manual.rst
index 908cb30cf..c87499d6a 100644
--- a/docs/manual.rst
+++ b/docs/manual.rst
@@ -6,7 +6,7 @@ libtorrent API Documentation
 :Version: 0.16.0
 
 .. contents:: Table of contents
-  :depth: 2
+  :depth: 1
   :backlinks: none
 
 overview
@@ -1679,8 +1679,8 @@ The ``torrent_info`` has the following synopsis::
 		torrent_info(sha1_hash const& info_hash, int flags = 0);
 		torrent_info(lazy_entry const& torrent_file, int flags = 0);
 		torrent_info(char const* buffer, int size, int flags = 0);
-		torrent_info(boost::filesystem::path const& filename, int flags = 0);
-		torrent_info(boost::filesystem::wpath const& filename, int flags = 0);
+		torrent_info(std::string const& filename, int flags = 0);
+		torrent_info(std::wstring const& filename, int flags = 0);
 
 		// these constructors sets the error code on error
 		torrent_info(sha1_hash const& info_hash, error_code& ec, int flags = 0);
@@ -1754,8 +1754,8 @@ torrent_info()
 		torrent_info(sha1_hash const& info_hash, int flags = 0);
 		torrent_info(lazy_entry const& torrent_file, int flags = 0);
 		torrent_info(char const* buffer, int size, int flags = 0);
-		torrent_info(boost::filesystem::path const& filename, int flags = 0);
-		torrent_info(boost::filesystem::wpath const& filename, int flags = 0);
+		torrent_info(std::string const& filename, int flags = 0);
+		torrent_info(std::wstring const& filename, int flags = 0);
 
 		torrent_info(sha1_hash const& info_hash, error_code& ec, int flags = 0);
 		torrent_info(lazy_entry const& torrent_file, error_code& ec, int flags = 0);
@@ -2360,11 +2360,11 @@ Its declaration looks like this::
 
 		bool set_metadata(char const* buf, int size) const;
 
-		boost::filesystem::path save_path() const;
-		void move_storage(boost::filesystem::path const& save_path) const;
-		void move_storage(boost::filesystem::wpath const& save_path) const;
-		void rename_file(int index, boost::filesystem::path) const;
-		void rename_file(int index, boost::filesystem::wpath) const;
+		std::string save_path() const;
+		void move_storage(std::string const& save_path) const;
+		void move_storage(std::wstring const& save_path) const;
+		void rename_file(int index, std::string) const;
+		void rename_file(int index, std::wstring) const;
 		storage_interface* get_storage_impl() const;
 
 		void super_seeding(bool on) const;
@@ -2543,7 +2543,7 @@ save_path()
 
 	::
 
-		boost::filesystem::path save_path() const;
+		std::string save_path() const;
 
 ``save_path()`` returns the path that was given to `async_add_torrent() add_torrent()`_ when this torrent
 was started.
@@ -2553,8 +2553,8 @@ move_storage()
 
 	::
 
-		void move_storage(boost::filesystem::path const& save_path) const;
-		void move_storage(boost::filesystem::wpath const& save_path) const;
+		void move_storage(std::string const& save_path) const;
+		void move_storage(std::wstring const& save_path) const;
 
 Moves the file(s) that this torrent are currently seeding from or downloading to. If
 the given ``save_path`` is not located on the same drive as the original save path,
@@ -2572,8 +2572,8 @@ rename_file()
 
 	::
 
-		void rename_file(int index, boost::filesystem::path) const;
-		void rename_file(int index, boost::filesystem::wpath) const;
+		void rename_file(int index, std::string) const;
+		void rename_file(int index, std::wstring) const;
 
 Renames the file with the given index asynchronously. The rename operation is complete
 when either a ``file_renamed_alert`` or ``file_rename_failed_alert`` is posted.
@@ -3175,8 +3175,8 @@ Example code to pause and save resume data for all torrents and wait for the ale
 		}
 		
 		torrent_handle h = rd->handle;
-		boost::filesystem::ofstream out(h.save_path()
-			/ (h.get_torrent_info().name() + ".fastresume"), std::ios_base::binary);
+		std::ofstream out((h.save_path() + "/" + h.get_torrent_info().name() + ".fastresume").c_str()
+			, std::ios_base::binary);
 		out.unsetf(std::ios_base::skipws);
 		bencode(std::ostream_iterator<char>(out), *rd->resume_data);
 		--outstanding_resume_data;
@@ -4252,6 +4252,7 @@ feed_item
 =========
 
 The ``feed_item`` struct is defined in ``<libtorrent/rss.hpp>``.
+
 	::
 
 		struct feed_item
@@ -7592,7 +7593,7 @@ error_code
 ==========
 
 libtorrent uses boost.system's ``error_code`` class to represent errors. libtorrent has
-its own error category (``libtorrent::libtorrent_category``) whith the following error
+its own error category (``libtorrent::get_libtorrent_category()``) whith the following error
 codes:
 
 ====== ========================================= =================================================================
@@ -8059,7 +8060,7 @@ for system errors. That is, errors that belong to the generic or system category
 
 Errors that belong to the libtorrent error category are not localized however, they
 are only available in english. In order to translate libtorrent errors, compare the
-error category of the ``error_code`` object against ``libtorrent::libtorrent_category``,
+error category of the ``error_code`` object against ``libtorrent::get_libtorrent_category()``,
 and if matches, you know the error code refers to the list above. You can provide
 your own mapping from error code to string, which is localized. In this case, you
 cannot rely on ``error_code::message()`` to generate your strings.
@@ -8071,7 +8072,7 @@ Here's a simple example of how to translate error codes::
 
 	std::string error_code_to_string(boost::system::error_code const& ec)
 	{
-		if (ec.category() != libtorrent::libtorrent_category)
+		if (ec.category() != libtorrent::get_libtorrent_category())
 		{
 			return ec.message();
 		}
@@ -8154,7 +8155,7 @@ The interface looks like this::
 		// non virtual functions
 
 		disk_buffer_pool* disk_pool();
-		void set_error(boost::filesystem::path const& file, error_code const& ec) const;
+		void set_error(std::string const& file, error_code const& ec) const;
 		error_code const& error() const;
 		std::string const& error_file() const;
 		void clear_error();
@@ -8804,14 +8805,14 @@ download has all its pieces in the correct place). So, the main drawbacks are:
 
 The benefits though, are:
 
- * No startup delay, since the files doesn't need allocating.
+ * No startup delay, since the files don't need allocating.
 
  * The download will not use unnecessary disk space.
 
  * Disk caches perform much better than in full allocation and raises the download
    speed limit imposed by the disk.
 
- * Works well on filesystems that doesn't support sparse files.
+ * Works well on filesystems that don't support sparse files.
 
 The algorithm that is used when allocating pieces and slots isn't very complicated.
 For the interested, a description follows.

0