summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTW <tw@waldmann-edv.de>2024-11-17 01:20:43 +0100
committerGitHub <noreply@github.com>2024-11-17 01:20:43 +0100
commit055115032239712d056be28bcdd091947ebdebac (patch)
tree13e90abdf1b02ec06d02fcaeddbe88af8fc39aaf
parent10c25414f45e47260acdfd2619b1677edb1c3a89 (diff)
parent37077a55e717fef8bac18473edc125036099488a (diff)
Merge pull request #8547 from ThomasWaldmann/rel200b14HEADmaster
Release 2.0.0 beta 14
-rw-r--r--docs/changes.rst2
-rw-r--r--docs/man/borg-analyze.12
-rw-r--r--docs/man/borg-benchmark-cpu.12
-rw-r--r--docs/man/borg-benchmark-crud.12
-rw-r--r--docs/man/borg-benchmark.12
-rw-r--r--docs/man/borg-break-lock.12
-rw-r--r--docs/man/borg-check.135
-rw-r--r--docs/man/borg-common.12
-rw-r--r--docs/man/borg-compact.139
-rw-r--r--docs/man/borg-compression.15
-rw-r--r--docs/man/borg-create.12
-rw-r--r--docs/man/borg-delete.113
-rw-r--r--docs/man/borg-diff.12
-rw-r--r--docs/man/borg-export-tar.12
-rw-r--r--docs/man/borg-extract.12
-rw-r--r--docs/man/borg-import-tar.12
-rw-r--r--docs/man/borg-info.12
-rw-r--r--docs/man/borg-key-change-location.12
-rw-r--r--docs/man/borg-key-change-passphrase.12
-rw-r--r--docs/man/borg-key-export.12
-rw-r--r--docs/man/borg-key-import.12
-rw-r--r--docs/man/borg-key.12
-rw-r--r--docs/man/borg-list.12
-rw-r--r--docs/man/borg-match-archives.12
-rw-r--r--docs/man/borg-mount.16
-rw-r--r--docs/man/borg-patterns.12
-rw-r--r--docs/man/borg-placeholders.12
-rw-r--r--docs/man/borg-prune.116
-rw-r--r--docs/man/borg-recreate.12
-rw-r--r--docs/man/borg-rename.12
-rw-r--r--docs/man/borg-repo-compress.12
-rw-r--r--docs/man/borg-repo-create.12
-rw-r--r--docs/man/borg-repo-delete.12
-rw-r--r--docs/man/borg-repo-info.12
-rw-r--r--docs/man/borg-repo-list.15
-rw-r--r--docs/man/borg-repo-space.12
-rw-r--r--docs/man/borg-serve.12
-rw-r--r--docs/man/borg-tag.12
-rw-r--r--docs/man/borg-transfer.12
-rw-r--r--docs/man/borg-umount.12
-rw-r--r--docs/man/borg-undelete.1101
-rw-r--r--docs/man/borg-version.12
-rw-r--r--docs/man/borg-with-lock.12
-rw-r--r--docs/man/borg.12
-rw-r--r--docs/man/borgfs.12
-rw-r--r--docs/usage/check.rst.inc33
-rw-r--r--docs/usage/compact.rst.inc34
-rw-r--r--docs/usage/delete.rst.inc10
-rw-r--r--docs/usage/help.rst.inc3
-rw-r--r--docs/usage/mount.rst.inc4
-rw-r--r--docs/usage/prune.rst.inc11
-rw-r--r--docs/usage/repo-list.rst.inc3
-rw-r--r--docs/usage/undelete.rst1
-rw-r--r--docs/usage/undelete.rst.inc96
54 files changed, 393 insertions, 96 deletions
diff --git a/docs/changes.rst b/docs/changes.rst
index a9958e180..abe33af5a 100644
--- a/docs/changes.rst
+++ b/docs/changes.rst
@@ -144,7 +144,7 @@ Compatibility notes:
Change Log 2.x
==============
-Version 2.0.0b14 (2024-11-xx)
+Version 2.0.0b14 (2024-11-17)
-----------------------------
Please note:
diff --git a/docs/man/borg-analyze.1 b/docs/man/borg-analyze.1
index b9ced8dbf..6a389893b 100644
--- a/docs/man/borg-analyze.1
+++ b/docs/man/borg-analyze.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-ANALYZE" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-ANALYZE" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-analyze \- Analyze archives
.SH SYNOPSIS
diff --git a/docs/man/borg-benchmark-cpu.1 b/docs/man/borg-benchmark-cpu.1
index 7b6e39ebf..d1efc1dc8 100644
--- a/docs/man/borg-benchmark-cpu.1
+++ b/docs/man/borg-benchmark-cpu.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-BENCHMARK-CPU" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-BENCHMARK-CPU" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-benchmark-cpu \- Benchmark CPU bound operations.
.SH SYNOPSIS
diff --git a/docs/man/borg-benchmark-crud.1 b/docs/man/borg-benchmark-crud.1
index 6556c4970..7d5b8fd24 100644
--- a/docs/man/borg-benchmark-crud.1
+++ b/docs/man/borg-benchmark-crud.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-BENCHMARK-CRUD" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-BENCHMARK-CRUD" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-benchmark-crud \- Benchmark Create, Read, Update, Delete for archives.
.SH SYNOPSIS
diff --git a/docs/man/borg-benchmark.1 b/docs/man/borg-benchmark.1
index 1345b1cfb..be672da71 100644
--- a/docs/man/borg-benchmark.1
+++ b/docs/man/borg-benchmark.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-BENCHMARK" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-BENCHMARK" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-benchmark \- benchmark command
.SH SYNOPSIS
diff --git a/docs/man/borg-break-lock.1 b/docs/man/borg-break-lock.1
index 2e8f29eae..b7457dd2f 100644
--- a/docs/man/borg-break-lock.1
+++ b/docs/man/borg-break-lock.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-BREAK-LOCK" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-BREAK-LOCK" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-break-lock \- Break the repository lock (e.g. in case it was left by a dead borg.
.SH SYNOPSIS
diff --git a/docs/man/borg-check.1 b/docs/man/borg-check.1
index 57c1fb479..24d763ea7 100644
--- a/docs/man/borg-check.1
+++ b/docs/man/borg-check.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-CHECK" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-CHECK" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-check \- Check repository consistency
.SH SYNOPSIS
@@ -51,12 +51,14 @@ Checking consistency and correctness of the archive metadata and optionally
archive data (requires \fB\-\-verify\-data\fP). This includes ensuring that the
repository manifest exists, the archive metadata chunk is present, and that
all chunks referencing files (items) in the archive exist. This requires
-reading archive and file metadata, but not data. To cryptographically verify
-the file (content) data integrity pass \fB\-\-verify\-data\fP, but keep in mind
-that this requires reading all data and is hence very time consuming. When
-checking archives of a remote repository, archive checks run on the client
-machine because they require decrypting data and therefore the encryption
-key.
+reading archive and file metadata, but not data. To scan for archives whose
+entries were lost from the archive directory, pass \fB\-\-find\-lost\-archives\fP\&.
+It requires reading all data and is hence very time consuming.
+To additionally cryptographically verify the file (content) data integrity,
+pass \fB\-\-verify\-data\fP, which is even more time consuming.
+.sp
+When checking archives of a remote repository, archive checks run on the client
+machine because they require decrypting data and therefore the encryption key.
.UNINDENT
.sp
Both steps can also be run independently. Pass \fB\-\-repository\-only\fP to run the
@@ -88,6 +90,15 @@ cryptographic verification and hence very time consuming, but will detect any
accidental and malicious corruption. Tamper\-resistance is only guaranteed for
encrypted repositories against attackers without access to the keys. You can
not use \fB\-\-verify\-data\fP with \fB\-\-repository\-only\fP\&.
+.sp
+The \fB\-\-find\-lost\-archives\fP option will also scan the whole repository, but
+tells Borg to search for lost archive metadata. If Borg encounters any archive
+metadata that doesn\(aqt match with an archive directory entry (including
+soft\-deleted archives), it means that an entry was lost.
+Unless \fBborg compact\fP is called, these archives can be fully restored with
+\fB\-\-repair\fP\&. Please note that \fB\-\-find\-lost\-archives\fP must read a lot of
+data from the repository and is thus very time consuming. You can not use
+\fB\-\-find\-lost\-archives\fP with \fB\-\-repository\-only\fP\&.
.SS About repair mode
.sp
The check command is a readonly task by default. If any corruption is found,
@@ -150,10 +161,8 @@ chunks of a \(dqzero\-patched\(dq file reappear, this effectively \(dqheals\(dq
Consequently, if lost chunks were repaired earlier, it is advised to run
\fB\-\-repair\fP a second time after creating some new backups.
.sp
-If \fB\-\-repair \-\-undelete\-archives\fP is given, Borg will scan the repository
-for archive metadata and if it finds some where no corresponding archives
-directory entry exists, it will create the entries. This is basically undoing
-\fBborg delete archive\fP or \fBborg prune ...\fP commands and only possible before
+If \fB\-\-repair \-\-find\-lost\-archives\fP is given, previously lost entries will
+be recreated in the archive directory. This is only possible before
\fBborg compact\fP would remove the archives\(aq data completely.
.SH OPTIONS
.sp
@@ -173,8 +182,8 @@ perform cryptographic archive data integrity verification (conflicts with \fB\-\
.B \-\-repair
attempt to repair any inconsistencies found
.TP
-.B \-\-undelete\-archives
-attempt to undelete archives (use with \-\-repair)
+.B \-\-find\-lost\-archives
+attempt to find lost archives
.TP
.BI \-\-max\-duration \ SECONDS
do only a partial repo check for max. SECONDS seconds (Default: unlimited)
diff --git a/docs/man/borg-common.1 b/docs/man/borg-common.1
index a6d41f363..4d00a2b3e 100644
--- a/docs/man/borg-common.1
+++ b/docs/man/borg-common.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-COMMON" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-COMMON" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-common \- Common options of Borg commands
.SH SYNOPSIS
diff --git a/docs/man/borg-compact.1 b/docs/man/borg-compact.1
index 553388de5..47f84d5f7 100644
--- a/docs/man/borg-compact.1
+++ b/docs/man/borg-compact.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-COMPACT" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-COMPACT" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-compact \- Collect garbage in repository
.SH SYNOPSIS
@@ -37,12 +37,39 @@ borg [common options] compact [options]
.sp
Free repository space by deleting unused chunks.
.sp
-borg compact analyzes all existing archives to find out which chunks are
-actually used. There might be unused chunks resulting from borg delete or prune,
-which can be removed to free space in the repository.
+borg compact analyzes all existing archives to find out which repository
+objects are actually used (referenced). It then deletes all unused objects
+from the repository to free space.
.sp
-Differently than borg 1.x, borg2\(aqs compact needs the borg key if the repo is
-encrypted.
+Unused objects may result from:
+.INDENT 0.0
+.IP \(bu 2
+borg delete or prune usage
+.IP \(bu 2
+interrupted backups (maybe retry the backup first before running compact)
+.IP \(bu 2
+backup of source files that had an I/O error in the middle of their contents
+and that were skipped due to this
+.IP \(bu 2
+corruption of the repository (e.g. the archives directory having lost
+entries, see notes below)
+.UNINDENT
+.sp
+You usually don\(aqt want to run \fBborg compact\fP after every write operation, but
+either regularly (e.g. once a month, possibly together with \fBborg check\fP) or
+when disk space needs to be freed.
+.sp
+\fBImportant:\fP
+.sp
+After compacting it is no longer possible to use \fBborg undelete\fP to recover
+previously soft\-deleted archives.
+.sp
+\fBborg compact\fP might also delete data from archives that were \(dqlost\(dq due to
+archives directory corruption. Such archives could potentially be restored with
+\fBborg check \-\-find\-lost\-archives [\-\-repair]\fP, which is slow. You therefore
+might not want to do that unless there are signs of lost archives (e.g. when
+seeing fatal errors when creating backups or when archives are missing in
+\fBborg repo\-list\fP).
.SH OPTIONS
.sp
See \fIborg\-common(1)\fP for common options of Borg commands.
diff --git a/docs/man/borg-compression.1 b/docs/man/borg-compression.1
index 7d028bc70..a8e161362 100644
--- a/docs/man/borg-compression.1
+++ b/docs/man/borg-compression.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-COMPRESSION" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-COMPRESSION" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-compression \- Details regarding compression
.SH DESCRIPTION
@@ -77,7 +77,8 @@ Use a built\-in heuristic to decide per chunk whether to compress or not.
The heuristic tries with lz4 whether the data is compressible.
For incompressible data, it will not use compression (uses \(dqnone\(dq).
For compressible data, it uses the given C[,L] compression \- with C[,L]
-being any valid compression specifier.
+being any valid compression specifier. This can be helpful for media files
+which often cannot be compressed much more.
.TP
.B obfuscate,SPEC,C[,L]
Use compressed\-size obfuscation to make fingerprinting attacks based on
diff --git a/docs/man/borg-create.1 b/docs/man/borg-create.1
index c546f5ddf..0186ad09f 100644
--- a/docs/man/borg-create.1
+++ b/docs/man/borg-create.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-CREATE" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-CREATE" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-create \- Create new archive
.SH SYNOPSIS
diff --git a/docs/man/borg-delete.1 b/docs/man/borg-delete.1
index bcde371f5..6a2127e9e 100644
--- a/docs/man/borg-delete.1
+++ b/docs/man/borg-delete.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-DELETE" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-DELETE" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-delete \- Delete archives
.SH SYNOPSIS
@@ -35,10 +35,17 @@ borg-delete \- Delete archives
borg [common options] delete [options] [NAME]
.SH DESCRIPTION
.sp
-This command deletes archives from the repository.
+This command soft\-deletes archives from the repository.
.sp
-Important: When deleting archives, repository disk space is \fBnot\fP freed until
+Important:
+.INDENT 0.0
+.IP \(bu 2
+The delete command will only mark archives for deletion (\(dqsoft\-deletion\(dq),
+repository disk space is \fBnot\fP freed until you run \fBborg compact\fP\&.
+.IP \(bu 2
+You can use \fBborg undelete\fP to undelete archives, but only until
you run \fBborg compact\fP\&.
+.UNINDENT
.sp
When in doubt, use \fB\-\-dry\-run \-\-list\fP to see what would be deleted.
.sp
diff --git a/docs/man/borg-diff.1 b/docs/man/borg-diff.1
index 429a4421b..87daea01c 100644
--- a/docs/man/borg-diff.1
+++ b/docs/man/borg-diff.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-DIFF" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-DIFF" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-diff \- Diff contents of two archives
.SH SYNOPSIS
diff --git a/docs/man/borg-export-tar.1 b/docs/man/borg-export-tar.1
index 0dc9436b0..776f18c93 100644
--- a/docs/man/borg-export-tar.1
+++ b/docs/man/borg-export-tar.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-EXPORT-TAR" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-EXPORT-TAR" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-export-tar \- Export archive contents as a tarball
.SH SYNOPSIS
diff --git a/docs/man/borg-extract.1 b/docs/man/borg-extract.1
index 1082bfb52..3e8c17766 100644
--- a/docs/man/borg-extract.1
+++ b/docs/man/borg-extract.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-EXTRACT" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-EXTRACT" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-extract \- Extract archive contents
.SH SYNOPSIS
diff --git a/docs/man/borg-import-tar.1 b/docs/man/borg-import-tar.1
index 56b3958b8..c2d21ce9d 100644
--- a/docs/man/borg-import-tar.1
+++ b/docs/man/borg-import-tar.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-IMPORT-TAR" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-IMPORT-TAR" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-import-tar \- Create a backup archive from a tarball
.SH SYNOPSIS
diff --git a/docs/man/borg-info.1 b/docs/man/borg-info.1
index 6c147ea55..358d2ef6c 100644
--- a/docs/man/borg-info.1
+++ b/docs/man/borg-info.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-INFO" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-INFO" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-info \- Show archive details such as disk space used
.SH SYNOPSIS
diff --git a/docs/man/borg-key-change-location.1 b/docs/man/borg-key-change-location.1
index 113d7f9ba..7aa8a86b8 100644
--- a/docs/man/borg-key-change-location.1
+++ b/docs/man/borg-key-change-location.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-KEY-CHANGE-LOCATION" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-KEY-CHANGE-LOCATION" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-key-change-location \- Change repository key location
.SH SYNOPSIS
diff --git a/docs/man/borg-key-change-passphrase.1 b/docs/man/borg-key-change-passphrase.1
index e9b38c427..7c2033e48 100644
--- a/docs/man/borg-key-change-passphrase.1
+++ b/docs/man/borg-key-change-passphrase.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-KEY-CHANGE-PASSPHRASE" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-KEY-CHANGE-PASSPHRASE" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-key-change-passphrase \- Change repository key file passphrase
.SH SYNOPSIS
diff --git a/docs/man/borg-key-export.1 b/docs/man/borg-key-export.1
index 1c34ec6a7..85b5e1e7c 100644
--- a/docs/man/borg-key-export.1
+++ b/docs/man/borg-key-export.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-KEY-EXPORT" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-KEY-EXPORT" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-key-export \- Export the repository key for backup
.SH SYNOPSIS
diff --git a/docs/man/borg-key-import.1 b/docs/man/borg-key-import.1
index bdefc1b76..df9b652ab 100644
--- a/docs/man/borg-key-import.1
+++ b/docs/man/borg-key-import.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-KEY-IMPORT" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-KEY-IMPORT" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-key-import \- Import the repository key from backup
.SH SYNOPSIS
diff --git a/docs/man/borg-key.1 b/docs/man/borg-key.1
index 07e46cdfc..1737e216a 100644
--- a/docs/man/borg-key.1
+++ b/docs/man/borg-key.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-KEY" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-KEY" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-key \- Manage a keyfile or repokey of a repository
.SH SYNOPSIS
diff --git a/docs/man/borg-list.1 b/docs/man/borg-list.1
index d191eb041..5c25fc82c 100644
--- a/docs/man/borg-list.1
+++ b/docs/man/borg-list.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-LIST" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-LIST" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-list \- List archive contents
.SH SYNOPSIS
diff --git a/docs/man/borg-match-archives.1 b/docs/man/borg-match-archives.1
index 88f2fe4b8..744bd0b3d 100644
--- a/docs/man/borg-match-archives.1
+++ b/docs/man/borg-match-archives.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-MATCH-ARCHIVES" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-MATCH-ARCHIVES" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-match-archives \- Details regarding match-archives
.SH DESCRIPTION
diff --git a/docs/man/borg-mount.1 b/docs/man/borg-mount.1
index f796a2d68..9296ddf1e 100644
--- a/docs/man/borg-mount.1
+++ b/docs/man/borg-mount.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-MOUNT" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-MOUNT" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-mount \- Mount archive or an entire repository as a FUSE filesystem
.SH SYNOPSIS
@@ -109,8 +109,8 @@ When the daemonized process receives a signal or crashes, it does not unmount.
Unmounting in these cases could cause an active rsync or similar process
to delete data unintentionally.
.sp
-When running in the foreground ^C/SIGINT unmounts cleanly, but other
-signals or crashes do not.
+When running in the foreground, ^C/SIGINT cleanly unmounts the filesystem,
+but other signals or crashes do not.
.SH OPTIONS
.sp
See \fIborg\-common(1)\fP for common options of Borg commands.
diff --git a/docs/man/borg-patterns.1 b/docs/man/borg-patterns.1
index 77887761c..e99bf8021 100644
--- a/docs/man/borg-patterns.1
+++ b/docs/man/borg-patterns.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-PATTERNS" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-PATTERNS" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-patterns \- Details regarding patterns
.SH DESCRIPTION
diff --git a/docs/man/borg-placeholders.1 b/docs/man/borg-placeholders.1
index aa5331b93..2c1b15505 100644
--- a/docs/man/borg-placeholders.1
+++ b/docs/man/borg-placeholders.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-PLACEHOLDERS" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-PLACEHOLDERS" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-placeholders \- Details regarding placeholders
.SH DESCRIPTION
diff --git a/docs/man/borg-prune.1 b/docs/man/borg-prune.1
index 4a56af6f6..76883876a 100644
--- a/docs/man/borg-prune.1
+++ b/docs/man/borg-prune.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
-.TH "BORG-PRUNE" 1 "2024-10-31" "" "borg backup tool"
+.TH "BORG-PRUNE" 1 "2024-11-16" "" "borg backup tool"
.SH NAME
borg-prune \- Prune repository archives according