Document changes

Author: arokettu

.gitignore

@@ -4,6 +4,7 @@
 # dev
 /samples
 /debug
+/venv
 
 # composer
 /vendor

docs/info.rst

@@ -1,6 +1,8 @@
 Info Fields
 ###########
 
+.. highlight:: php
+
 .. versionchanged:: 5.0 A lot of stuff was moved to version specific namespaces, see :ref:`torrent_versions`
 
 Fields of the info dictionary of the torrent file.
@@ -21,7 +23,7 @@ All hashes
 
 Get all available hashes as array.
 
-.. code-block:: php
+::
 
     <?php
     $infoHashes = $torrent->getInfoHashes();
@@ -33,7 +35,7 @@ Metadata
 
 Checks the version of the torrent.
 
-.. code-block:: php
+::
 
     <?php
     $torrent->hasMetadata(MetaVersion::V1); // simple check, does not create v1 Files object
@@ -44,6 +46,25 @@ Checks the version of the torrent.
     // or
     $torrent->v2() !== null; // if you plan to iterate over files too
 
+Metadata Removal
+================
+
+.. versionadded:: 5.1
+
+Methods to "unhybridize" hybrid V1+V2 torrents.
+
+Remove a specific version::
+
+    <?php
+
+    $torrent->removeMetadata(MetaVersion::V1);
+
+or keep a specific version::
+
+    <?php
+
+    $torrent->keepOnlyMetadata(MetaVersion::V1);
+
 Name
 ====
 
@@ -56,7 +77,7 @@ A base name of the encoded file or directory.
 
     However the content of the name field in the parsed file is not guaranteed to exist or be valid.
 
-.. code-block:: php
+::
 
     <?php
     // should be a valid file/dir name
@@ -72,7 +93,7 @@ Private
 
 Get / set / unset the private flag.
 
-.. code-block:: php
+::
 
     <?php
     $isPrivate = $torrent->isPrivate();

docs/saveload.rst

@@ -54,6 +54,7 @@ Create a torrent for existing directory or file
 .. versionadded:: 2.5/3.3/4.1 forceMultifile
 .. versionchanged:: 4.1 MetaVersion::HybridV1V2 is now an array [MetaVersion::V1, MetaVersion::V2]
 .. versionadded:: 5.0.1 $clock
+.. versionadded:: 5.1.0 forceMultifile is true by default
 
 The library can create a torrent file from scratch for a file or a directory.
 
@@ -107,7 +108,7 @@ Available options:
     V1 torrents are created in 'directory' mode even when created for a single file.
     This mode fixes some possible incompatibilities between V1 and V2 data in hybrid torrents.
     Always enabled in hybrid torrents, meaningless for pure V2.
-    Default: ``false``
+    Default: ``true``
 ``clock``
     A parameter to inject a clock component, mostly for debug purposes.
     To set the creation timestamp normally, use `setCreationDate($timestamp)` on the created torrent object.