mercurial/bundle2.py
changeset 20808 4c9130c7a29f
parent 20805 c5aaeca0cfbf
child 20809 b93bb639451a
--- a/mercurial/bundle2.py	Tue Mar 18 20:10:33 2014 -0500
+++ b/mercurial/bundle2.py	Thu Mar 20 13:18:34 2014 -0700
@@ -48,7 +48,14 @@
 
   Special character in param name are not supported yet.
 
+  Stream parameters use a simple textual format for two main reasons:
 
+  - Stream level parameters should remains simple and we want to discourage any
+    crazy usage.
+  - Textual data allow easy human inspection of a the bundle2 header in case of
+    troubles.
+
+  Any Applicative level options MUST go into a bundle2 part instead.
 
 
 Payload part