diff mercurial/helptext/bundlespec.txt @ 50645:bf7404f2e22d stable

bundles: clarify streaming v2 bundle usage This seems useful to clarify through the documentation (we were still using debugcreatestreamclonebundle, even though 'hg bundle' is already an option...).
author Mathias De Mare <mathias.de_mare@nokia.com>
date Tue, 25 Apr 2023 15:28:40 +0200
parents 23dd636852b8
children
line wrap: on
line diff
--- a/mercurial/helptext/bundlespec.txt	Mon Jun 05 11:07:08 2023 +0200
+++ b/mercurial/helptext/bundlespec.txt	Tue Apr 25 15:28:40 2023 +0200
@@ -67,6 +67,10 @@
 
 .. bundlecompressionmarker
 
+The compression engines can be prepended with ``stream`` to create a streaming bundle.
+These are bundles that are extremely efficient to produce and consume,
+but do not have guaranteed compatibility with older clients.
+
 Available Options
 =================
 
@@ -89,7 +93,6 @@
 revbranchcache
     Include the "tags-fnodes" cache inside the bundle.
 
-
 tagsfnodescache
     Include the "tags-fnodes" cache inside the bundle.
 
@@ -109,3 +112,10 @@
 
 ``zstd-v1``
     This errors because ``zstd`` is not supported for ``v1`` types.
+
+``none-streamv2``
+    Produce a ``v2`` streaming bundle with no compression.
+
+``zstd-v2;obsolescence=true;phases=true``
+    Produce a ``v2`` bundle with zstandard compression which includes
+    obsolescence markers and phases.