docs: add documentation about 'exhaust' parameter

docs/notebooks/api_user_guide/7_download.ipynb

@@ -630,7 +630,11 @@
     "* `outputs_prefix` (`str`): absolute path to a folder where the products should be saved\n",
     "* `extract` (`bool`): whether to automatically extract or not the downloaded product archive\n",
     "* `dl_url_params` (`dict`): additional parameters to pass over to the download url as an url parameter\n",
-    "* `delete_archive` (`bool`): whether to delete the downloaded archives"
+    "* `delete_archive` (`bool`): whether to delete the downloaded archives\n",
+    "\n",
+    "An additionnal kwarg is accepted with the [download_all()](../../api_reference/core.rst#eodag.api.core.EODataAccessGateway.download_all) method:\n",
+    "\n",
+    "* `exhaust` (`bool`): whether to download products from all pages of the search request used to get the results in arguments."
    ]
   },
   {
@@ -979,6 +983,13 @@
     "dag.download_all(products_to_download)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If the [SearchResult](../../api_reference/searchresult.rst#eodag.api.search_result.SearchResult) argument does not come from the [search_all()](../../api_reference/core.rst#eodag.api.core.EODataAccessGateway.search_all) method, the `exhaust` argument can be set to `True` (default to `False`) to download products from all pages of the search request used to get the results in arguments by doing a new search on their provider with their search kwargs."
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},