From 5297f72e3fd383edaee6788b31168941241e216f Mon Sep 17 00:00:00 2001
From: Stephan <glaubinix@users.noreply.github.com>
Date: Wed, 17 Nov 2021 18:54:30 +0000
Subject: [PATCH] Docs: add transport options example and differentiate between
 cURL and stream options (#10289)

+ remove Bitbucket mercurial reference
---
 doc/05-repositories.md | 33 +++++++++++++++++++++++++++------
 1 file changed, 27 insertions(+), 6 deletions(-)

diff --git a/doc/05-repositories.md b/doc/05-repositories.md
index d7f5acfa4..a1106557c 100644
--- a/doc/05-repositories.md
+++ b/doc/05-repositories.md
@@ -299,12 +299,33 @@ described [above](#packages).
 These fields are optional. You probably don't need them for your own custom
 repository.
 
-#### stream options
+#### cURL or stream options
 
-The `packages.json` file is loaded using a PHP stream. You can set extra
-options on that stream using the `options` parameter. You can set any valid
-PHP stream context option. See [Context options and
-parameters](https://php.net/manual/en/context.php) for more information.
+The repository is accessed either using cURL (Composer 2 with ext-curl enabled)
+or PHP streams. You can set extra options using the `options` parameter. For
+PHP streams, you can set any valid PHP stream context option. See [Context
+options and parameters](https://php.net/manual/en/context.php) for more
+information. When cURL is used, only a limited set of `http` and `ssl` options
+can be configured.
+
+```json
+{
+    "repositories": [
+        {
+            "type": "composer",
+            "url": "https://example.org",
+            "options": {
+                "http": {
+                    "timeout": 60
+                }
+            }
+        }
+    ],
+    "require": {
+        "acme/package": "^1.0"
+    }
+}
+```
 
 ### VCS
 
@@ -397,7 +418,7 @@ fetch the packages without having to install the version control system. The
 VCS repository provides `dist`s for them that fetch the packages as zips.
 
 * **GitHub:** [github.com](https://github.com) (Git)
-* **BitBucket:** [bitbucket.org](https://bitbucket.org) (Git and Mercurial)
+* **BitBucket:** [bitbucket.org](https://bitbucket.org) (Git)
 
 The VCS driver to be used is detected automatically based on the URL. However,
 should you need to specify one for whatever reason, you can use `bitbucket`,