tweak documentation

doc/accessories.rst

@@ -5,6 +5,8 @@
 Accessories
 ===========
 
+.. _borg space:
+
 Borg-Space
 ----------
 

doc/commands.rst

@@ -260,10 +260,10 @@ Delete one or more archives currently contained in the repository:
 If no archive is specified, the latest is deleted.
 
 The disk space associated with deleted archives is not reclaimed until
-the :ref:`compact <manage_compact_cmd>` command is run.  You can specify that 
-a compaction is performed as part of the deletion by setting 
-:ref:`compact_after_delete`.  If set, the ``--fast`` flag causes the compaction 
-to be skipped.  If not set, the ``--fast`` flag has no effect.
+the :ref:`compact <compact>` command is run.  You can specify that a compaction 
+is performed as part of the deletion by setting :ref:`compact_after_delete`.  If 
+set, the ``--fast`` flag causes the compaction to be skipped.  If not set, the 
+``--fast`` flag has no effect.
 
 Specifying ``--repo`` results in the entire repository being deleted.
 Unlike with *borg* itself, no warning is issued and no additional conformation 
@@ -653,10 +653,10 @@ specified to use :ref:`prune <prune>`:
 
 The *prune* command deletes archives that are no longer needed as determined by 
 the prune rules.  However, the disk space is not reclaimed until the 
-:ref:`compact <manage_compact_cmd>` command is run.  You can specify that 
-a compaction is performed as part of the prune by setting 
-:ref:`compact_after_delete`.  If set, the ``--fast`` flag causes the compaction 
-to be skipped.  If not set, the ``--fast`` flag has no effect.
+:ref:`compact <compact>` command is run.  You can specify that a compaction is 
+performed as part of the prune by setting :ref:`compact_after_delete`.  If set, 
+the ``--fast`` flag causes the compaction to be skipped.  If not set, the 
+``--fast`` flag has no effect.
 
 .. _restore:
 

doc/configuring.rst

@@ -116,11 +116,11 @@ the following:
     # commands to be run before and after backups (run from working directory)
     run_before_first_backup = """
         # remove the detritus before backing up
-        ./clean-home >& {log_dir}/clean-home.log
+        ~/bin/clean-home >& {log_dir}/clean-home.log
     """
     run_after_last_backup = """
-        # rebuild my man pages, they were deleted by clean-home
-        ./rebuild-manpages > /dev/null
+        # rebuild my documentation, it was deleted by clean-home
+        ~/bin/rebuild-documentation > /dev/null
     """
 
     # if set, this file or these files must exist or backups will quit with an error
@@ -1023,6 +1023,16 @@ configuration in a composite configuration with the intent that the commands
 will be run only once regardless whether the configurations are run individually 
 or as a group.
 
+For example, the following runs :ref:`borg space` after each back-up to record 
+the size history of your repository:
+
+.. code-block:: python
+
+    run_after_backup = [
+        'borg-space -r -m "Repository is now {{size:.2}}." {config_name}'
+    ]
+
+
 .. _run_before_backup:
 .. _run_before_first_backup: