From 9ea55d9aa31b82319571f3a88226788d0e643fb4 Mon Sep 17 00:00:00 2001 From: Dan Helfman Date: Thu, 3 Apr 2025 16:38:17 -0700 Subject: [PATCH] Add a documentation note about a limitation: You can't pass flags as values to flags (#303). --- docs/how-to/make-per-application-backups.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/how-to/make-per-application-backups.md b/docs/how-to/make-per-application-backups.md index db3819996..a81cd9432 100644 --- a/docs/how-to/make-per-application-backups.md +++ b/docs/how-to/make-per-application-backups.md @@ -538,6 +538,12 @@ the `--list` flag that's only present on particular actions. Similarly with `progress` and `--progress`, `statistics` and `--stats`, and `match_archives` and `--match-archives`. +Also note that if you want to pass a command-line flag itself as a value to one +of these override flags, that may not work. For instance, specifying +`--extra-borg-options.create --no-cache-sync` results in an error, because +`--no-cache-sync` gets interpreted as a borgmatic option (which in this case +doesn't exist) rather than a Borg option. + An alternate to command-line overrides is passing in your values via [environment variables](https://torsion.org/borgmatic/docs/how-to/provide-your-passwords/).