From 89703334f3c851eab28db7a39136e67c50c83c5f Mon Sep 17 00:00:00 2001 From: lingfish Date: Thu, 26 Feb 2026 08:51:11 +1100 Subject: [PATCH] Add more doco. --- docs/how-to/inspect-your-backups.md | 19 +++++++++++++++++++ docs/reference/command-line/actions/diff.md | 4 ++++ 2 files changed, 23 insertions(+) diff --git a/docs/how-to/inspect-your-backups.md b/docs/how-to/inspect-your-backups.md index 9a651ff0..1a151f90 100644 --- a/docs/how-to/inspect-your-backups.md +++ b/docs/how-to/inspect-your-backups.md @@ -116,3 +116,22 @@ By default, borgmatic only logs to the console. But to enable simultaneous syslog or file logging, see the [logging documentation](https://torsion.org/borgmatic/reference/command-line/logging/) for details. + +## Finding differences between two archives + +New in borgmatic version +2.1.3You can compare differences between two archives. For example: + +```bash +borgmatic diff --archive latest --second-archive host-2023-01-02T04:06:07.080910 +``` + +This shows the differences (file contents, user/group/mode) between the latest +archive and the second one supplied. + +Note that, by default, `borgmatic diff` compares everything in the archives; that +is, patterns are _not_ taken into consideration. If you require this, supply the +`--only-patterns` flag. + +See the [`borgbackup`](https://borgbackup.readthedocs.io/en/stable/usage/diff.html) +documentation for information on output format, what is compared, and more. diff --git a/docs/reference/command-line/actions/diff.md b/docs/reference/command-line/actions/diff.md index d81f453b..e3d8c681 100644 --- a/docs/reference/command-line/actions/diff.md +++ b/docs/reference/command-line/actions/diff.md @@ -10,3 +10,7 @@ eleventyNavigation: ``` {% include borgmatic/command-line/diff.txt %} ``` + +## Related documentation + +* [Finding differences](https://torsion.org/borgmatic/how-to/inspect-your-backups/#finding-differences-between-two-archives)