From 7b8acc925f847b1e5ba2720a3eca57f5f1088386 Mon Sep 17 00:00:00 2001
From: Thomas Waldmann <tw@waldmann-edv.de>
Date: Sun, 30 Jun 2024 17:28:23 +0200
Subject: [PATCH] docs: add examples using :: positional argument, fixes #8255

Simply omitting the first positional argument (REPO) does
not work because borg then gets confused.
---
 docs/usage/mount.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/usage/mount.rst b/docs/usage/mount.rst
index c4bce0b47d..aed7a05a41 100644
--- a/docs/usage/mount.rst
+++ b/docs/usage/mount.rst
@@ -41,6 +41,13 @@ Examples
     $ borg mount /path/to/repo /tmp/mymountpoint only/that/path
     $ borg mount --exclude '...' /path/to/repo /tmp/mymountpoint
 
+    # When using BORG_REPO env var, use :: as positional argument:
+    export BORG_REPO=/path/to/repo
+    # Mount the whole repo:
+    borg mount :: /tmp/mymountpoint
+    # Mount some specific archive:
+    borg mount ::root-2016-02-15 /tmp/mymountpoint
+
 
 borgfs
 ++++++