From 00de6766fda553d80ecdc2642087c906954c233f Mon Sep 17 00:00:00 2001 From: aawsome <37850842+aawsome@users.noreply.github.com> Date: Sat, 14 Feb 2026 22:19:45 +0100 Subject: [PATCH 1/2] Update rewrite.md --- src/commands/misc/rewrite.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/src/commands/misc/rewrite.md b/src/commands/misc/rewrite.md index de966cd..7be3fda 100644 --- a/src/commands/misc/rewrite.md +++ b/src/commands/misc/rewrite.md @@ -185,8 +185,10 @@ total: 3 snapshot(s) ``` Interestingly, the new snapshots replaced the old ones but were not tagged. The -options `--forget` and `--tags-rewritten ''` prevent the command from adding the -`rewrite` tag. +option `--forget` prevent the command from adding the `rewrite` tag. To be more +precise, there is the option `--tags-rewritten` which specifies which tags to +add to rewritten snapshots. It defaults to `rewrite` if no `--forget` is given +and to `''` (i.e. no tag) if `--forget` is used. ### The very short way @@ -240,9 +242,12 @@ with the data packs. It has two consequences: ## Rewriting tags -The `rustic rewrite` command allows you to manipulate the snapshots' tags. +The `rustic rewrite` command also allows you to manipulate the snapshots' tags. +Note that there is the special `rustic tag` command which only allows to modify +tags, this is basically a shortcut for the respective options of +`rustic rewrite --force`. -For example, you can use `rewrite --set-tags ...` to set a new tag list to a +You can use `rewrite --set-tags ...` to set a new tag list to a snapshot: ```console @@ -307,9 +312,6 @@ snapshots for (host [kasimir], label [], paths [Project]) total: 2 snapshot(s) ``` -**Note:** `rustic tag --remove ...` is an alias for -`rustic rewrite --forget --remove-tags ...` - ```console # Replace the tag list $ rustic rewrite --forget --set-tags origin 3f1560c5 From 2da5bbd4a2d6a80aa923bc91fdea0587276c9585 Mon Sep 17 00:00:00 2001 From: aawsome <37850842+aawsome@users.noreply.github.com> Date: Sat, 14 Feb 2026 22:24:15 +0100 Subject: [PATCH 2/2] Update rewrite.md --- src/commands/misc/rewrite.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/src/commands/misc/rewrite.md b/src/commands/misc/rewrite.md index 7be3fda..f81fe36 100644 --- a/src/commands/misc/rewrite.md +++ b/src/commands/misc/rewrite.md @@ -185,9 +185,9 @@ total: 3 snapshot(s) ``` Interestingly, the new snapshots replaced the old ones but were not tagged. The -option `--forget` prevent the command from adding the `rewrite` tag. To be more +option `--forget` prevent the command from adding the `rewrite` tag. To be more precise, there is the option `--tags-rewritten` which specifies which tags to -add to rewritten snapshots. It defaults to `rewrite` if no `--forget` is given +add to rewritten snapshots. It defaults to `rewrite` if no `--forget` is given and to `''` (i.e. no tag) if `--forget` is used. ### The very short way @@ -244,11 +244,10 @@ with the data packs. It has two consequences: The `rustic rewrite` command also allows you to manipulate the snapshots' tags. Note that there is the special `rustic tag` command which only allows to modify -tags, this is basically a shortcut for the respective options of +tags, this is basically a shortcut for the respective options of `rustic rewrite --force`. -You can use `rewrite --set-tags ...` to set a new tag list to a -snapshot: +You can use `rewrite --set-tags ...` to set a new tag list to a snapshot: ```console $ rustic snapshots --all --filter-paths Project