From 52f76d2cd6f2b7ddb6cea90e60a0f9c63a3cd016 Mon Sep 17 00:00:00 2001
From: Marian Beermann <public@enkore.de>
Date: Fri, 30 Jun 2017 10:53:23 +0200
Subject: [PATCH] docs: mount: add repository example

---
 docs/usage/mount.rst | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/docs/usage/mount.rst b/docs/usage/mount.rst
index f5f1b4f5b..a3ab2ea32 100644
--- a/docs/usage/mount.rst
+++ b/docs/usage/mount.rst
@@ -5,26 +5,35 @@
 Examples
 ~~~~~~~~
 
-borg mount
-++++++++++
 ::
 
-    $ borg mount /path/to/repo::root-2016-02-15 /tmp/mymountpoint
+    # Mounting the repository shows all archives.
+    # Archives are loaded lazily, expect some delay when navigating to an archive
+    # for the first time.
+    $ borg mount /path/to/repo /tmp/mymountpoint
     $ ls /tmp/mymountpoint
-    bin  boot  etc	home  lib  lib64  lost+found  media  mnt  opt  root  sbin  srv  tmp  usr  var
+    root-2016-02-14 root-2016-02-15
     $ borg umount /tmp/mymountpoint
 
-::
+    # Mounting a specific archive is possible as well.
+    $ borg mount /path/to/repo::root-2016-02-15 /tmp/mymountpoint
+    $ ls /tmp/mymountpoint
+    bin  boot  etc	home  lib  lib64  lost+found  media  mnt  opt
+    root  sbin  srv  tmp  usr  var
+    $ borg umount /tmp/mymountpoint
 
+    # The experimental versions view merges all archives in the repository
+    # and provides a versioned view on files.
     $ borg mount -o versions /path/to/repo /tmp/mymountpoint
     $ ls -l /tmp/mymountpoint/home/user/doc.txt/
     total 24
     -rw-rw-r-- 1 user group 12357 Aug 26 21:19 doc.txt.cda00bc9
     -rw-rw-r-- 1 user group 12204 Aug 26 21:04 doc.txt.fa760f28
-    $ fusermount -u /tmp/mymountpoint
+    $ borg umount /tmp/mymountpoint
 
 borgfs
 ++++++
+
 ::
 
     $ echo '/mnt/backup /tmp/myrepo fuse.borgfs defaults,noauto 0 0' >> /etc/fstab