Radish alpha
h
heartwood
rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5
Radicle Heartwood Protocol & Stack
Radicle
Git
.. framework git workflow jj-config.md jj-init-bare.md jj-init-colocate.md rad-auth-errors.md rad-auth.md rad-block.md rad-checkout-repo-config-linux.md rad-checkout-repo-config-macos.md rad-checkout.md rad-clean.md rad-clone-all.md rad-clone-bare.md rad-clone-connect.md rad-clone-directory.md rad-clone-partial-fail.md rad-clone-scope.md rad-clone-unknown.md rad-clone.md rad-cob-log.md rad-cob-migrate.md rad-cob-multiset rad-cob-multiset.md rad-cob-operations.md rad-cob-show.md rad-cob-update-identity.md rad-cob-update.md rad-config.md rad-diff.md rad-fetch.md rad-fork.md rad-help.md rad-id-collaboration.md rad-id-conflict.md rad-id-multi-delegate.md rad-id-private.md rad-id-threshold-soft-fork.md rad-id-threshold.md rad-id-unauthorized-delegate.md rad-id-unknown-field.md rad-id-update-delete-field.md rad-id.md rad-inbox.md rad-init-detached-head.md rad-init-existing-bare.md rad-init-existing.md rad-init-no-git.md rad-init-no-seed.md rad-init-private-clone-seed.md rad-init-private-clone.md rad-init-private-no-seed.md rad-init-private-seed.md rad-init-private.md rad-init-sync-not-connected.md rad-init-sync-preferred.md rad-init-sync-timeout.md rad-init-sync.md rad-init-with-existing-remote.md rad-init.md rad-inspect-noauth.md rad-inspect.md rad-issue-list.md rad-issue.md rad-key-mismatch.md rad-merge-after-update.md rad-merge-no-ff.md rad-merge-via-push.md rad-node.md rad-patch-ahead-behind.md rad-patch-change-base.md rad-patch-checkout-force.md rad-patch-checkout-revision.md rad-patch-checkout.md rad-patch-delete.md rad-patch-detached-head.md rad-patch-diff.md rad-patch-draft.md rad-patch-edit.md rad-patch-fetch-1.md rad-patch-fetch-2.md rad-patch-jj.md rad-patch-merge-draft.md rad-patch-open-explore.md rad-patch-pull-update.md rad-patch-revert-merge.md rad-patch-update.md rad-patch-via-push.md rad-patch.md rad-publish.md rad-push-and-pull-patches.md rad-remote.md rad-review-by-hunk.md rad-seed-and-follow.md rad-seed-many.md rad-seed-policy-allow-no-scope.md rad-seed-scope.md rad-self.md rad-sync-without-node.md rad-sync.md rad-unseed-many.md rad-unseed.md rad-warn-old-nodes.md rad-watch.md
heartwood › crates › radicle-cli › examples › rad-patch-edit.md

If you ever want to change the title and descriptions associated with a patch and its revisions, we can always use the rad patch edit command.

First off, we’ll have to set up a patch and an updated revision:

$ git checkout -b changes
$ touch README.md
$ git add README.md
$ git commit --message "Add README, just for the fun"
[changes 03c02af] Add README, just for the fun
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 README.md

$ git push rad -o patch.message="Add README, just for the fun" HEAD:refs/patches
✓ Patch 89f7afb1511b976482b21f6b2f39aef7f4fb88a2 opened
To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi
 * [new reference]   HEAD -> refs/patches

$ touch LICENSE
$ git add LICENSE
$ git commit -v -m "Define the LICENSE"
[changes 8945f61] Define the LICENSE
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 LICENSE

$ git push -f -o patch.message="Add License"
✓ Patch 89f7afb updated to revision 5d78dd5376453e25df5988ec86951c99cb73742c
To compare against your previous revision 89f7afb, run:

   git range-diff f2de534[..] 03c02af[..] 8945f61[..]

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi
   03c02af..8945f61  changes -> patches/89f7afb1511b976482b21f6b2f39aef7f4fb88a2

Let’s look at the patch, to see what it looks like before editing it:

$ rad patch show 89f7afb
╭──────────────────────────────────────────────────────────╮
│ Title     Add README, just for the fun                   │
│ Patch     89f7afb1511b976482b21f6b2f39aef7f4fb88a2       │
│ Author    alice (you)                                    │
│ Head      8945f6189adf027892c85ac57f7e9341049c2537       │
│ Base      [..                                    ]       │
│ Branches  changes                                        │
│ Commits   ahead 2, behind 0                              │
│ Status    open                                           │
├──────────────────────────────────────────────────────────┤
│ 8945f61 Define the LICENSE                               │
│ 03c02af Add README, just for the fun                     │
├──────────────────────────────────────────────────────────┤
│ ● Revision 89f7afb @ [..   ]..03c02af by alice (you) now │
│ ↑ Revision 5d78dd5 @ [..   ]..8945f61 by alice (you) now │
╰──────────────────────────────────────────────────────────╯

We can change the title and description of the patch itself by using a multi-line message (using two --message options here):

$ rad patch edit 89f7afb --message "Add Metadata" --message "Add README & LICENSE" --no-announce
$ rad patch show 89f7afb
╭──────────────────────────────────────────────────────────╮
│ Title     Add Metadata                                   │
│ Patch     89f7afb1511b976482b21f6b2f39aef7f4fb88a2       │
│ Author    alice (you)                                    │
│ Head      8945f6189adf027892c85ac57f7e9341049c2537       │
│ Base      [..                                    ]       │
│ Branches  changes                                        │
│ Commits   ahead 2, behind 0                              │
│ Status    open                                           │
│                                                          │
│ Add README & LICENSE                                     │
├──────────────────────────────────────────────────────────┤
│ 8945f61 Define the LICENSE                               │
│ 03c02af Add README, just for the fun                     │
├──────────────────────────────────────────────────────────┤
│ ● Revision 89f7afb @ [..   ]..03c02af by alice (you) now │
│ ↑ Revision 5d78dd5 @ [..   ]..8945f61 by alice (you) now │
╰──────────────────────────────────────────────────────────╯

Notice that the Title is now Add Metadata, and the patch now has a description Add README & LICENSE.

If we want to change a specific revision’s description, we can use the --revision option:

$ rad patch edit 89f7afb --revision 5d78dd5 --message "Changes: Adds LICENSE file" --no-announce
$ rad patch show 89f7afb
╭──────────────────────────────────────────────────────────╮
│ Title     Add Metadata                                   │
│ Patch     89f7afb1511b976482b21f6b2f39aef7f4fb88a2       │
│ Author    alice (you)                                    │
│ Head      8945f6189adf027892c85ac57f7e9341049c2537       │
│ Base      [..                                    ]       │
│ Branches  changes                                        │
│ Commits   ahead 2, behind 0                              │
│ Status    open                                           │
│                                                          │
│ Add README & LICENSE                                     │
├──────────────────────────────────────────────────────────┤
│ 8945f61 Define the LICENSE                               │
│ 03c02af Add README, just for the fun                     │
├──────────────────────────────────────────────────────────┤
│ ● Revision 89f7afb @ [..   ]..03c02af by alice (you) now │
│ ↑ Revision 5d78dd5 @ [..   ]..8945f61 by alice (you) now │
╰──────────────────────────────────────────────────────────╯

We can see that this didn’t affect the patch’s description, but currently there’s no way of seeing a revision’s description in the CLI.

If you ever want to change the title and descriptions associated with
a patch and its revisions, we can always use the `rad patch edit`
command.

First off, we'll have to set up a patch and an updated revision:

```
$ git checkout -b changes
$ touch README.md
$ git add README.md
$ git commit --message "Add README, just for the fun"
[changes 03c02af] Add README, just for the fun
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 README.md
```

``` (stderr)
$ git push rad -o patch.message="Add README, just for the fun" HEAD:refs/patches
✓ Patch 89f7afb1511b976482b21f6b2f39aef7f4fb88a2 opened
To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi
 * [new reference]   HEAD -> refs/patches
```

```
$ touch LICENSE
$ git add LICENSE
$ git commit -v -m "Define the LICENSE"
[changes 8945f61] Define the LICENSE
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 LICENSE
```

``` (stderr)
$ git push -f -o patch.message="Add License"
✓ Patch 89f7afb updated to revision 5d78dd5376453e25df5988ec86951c99cb73742c
To compare against your previous revision 89f7afb, run:

   git range-diff f2de534[..] 03c02af[..] 8945f61[..]

To rad://z42hL2jL4XNk6K8oHQaSWfMgCL7ji/z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi
   03c02af..8945f61  changes -> patches/89f7afb1511b976482b21f6b2f39aef7f4fb88a2
```

Let's look at the patch, to see what it looks like before editing it:

```
$ rad patch show 89f7afb
╭──────────────────────────────────────────────────────────╮
│ Title     Add README, just for the fun                   │
│ Patch     89f7afb1511b976482b21f6b2f39aef7f4fb88a2       │
│ Author    alice (you)                                    │
│ Head      8945f6189adf027892c85ac57f7e9341049c2537       │
│ Base      [..                                    ]       │
│ Branches  changes                                        │
│ Commits   ahead 2, behind 0                              │
│ Status    open                                           │
├──────────────────────────────────────────────────────────┤
│ 8945f61 Define the LICENSE                               │
│ 03c02af Add README, just for the fun                     │
├──────────────────────────────────────────────────────────┤
│ ● Revision 89f7afb @ [..   ]..03c02af by alice (you) now │
│ ↑ Revision 5d78dd5 @ [..   ]..8945f61 by alice (you) now │
╰──────────────────────────────────────────────────────────╯
```

We can change the title and description of the patch itself by using a
multi-line message (using two `--message` options here):

```
$ rad patch edit 89f7afb --message "Add Metadata" --message "Add README & LICENSE" --no-announce
$ rad patch show 89f7afb
╭──────────────────────────────────────────────────────────╮
│ Title     Add Metadata                                   │
│ Patch     89f7afb1511b976482b21f6b2f39aef7f4fb88a2       │
│ Author    alice (you)                                    │
│ Head      8945f6189adf027892c85ac57f7e9341049c2537       │
│ Base      [..                                    ]       │
│ Branches  changes                                        │
│ Commits   ahead 2, behind 0                              │
│ Status    open                                           │
│                                                          │
│ Add README & LICENSE                                     │
├──────────────────────────────────────────────────────────┤
│ 8945f61 Define the LICENSE                               │
│ 03c02af Add README, just for the fun                     │
├──────────────────────────────────────────────────────────┤
│ ● Revision 89f7afb @ [..   ]..03c02af by alice (you) now │
│ ↑ Revision 5d78dd5 @ [..   ]..8945f61 by alice (you) now │
╰──────────────────────────────────────────────────────────╯
```

Notice that the `Title` is now `Add Metadata`, and the patch now has a
description `Add README & LICENSE`.

If we want to change a specific revision's description, we can use the
`--revision` option:

```
$ rad patch edit 89f7afb --revision 5d78dd5 --message "Changes: Adds LICENSE file" --no-announce
$ rad patch show 89f7afb
╭──────────────────────────────────────────────────────────╮
│ Title     Add Metadata                                   │
│ Patch     89f7afb1511b976482b21f6b2f39aef7f4fb88a2       │
│ Author    alice (you)                                    │
│ Head      8945f6189adf027892c85ac57f7e9341049c2537       │
│ Base      [..                                    ]       │
│ Branches  changes                                        │
│ Commits   ahead 2, behind 0                              │
│ Status    open                                           │
│                                                          │
│ Add README & LICENSE                                     │
├──────────────────────────────────────────────────────────┤
│ 8945f61 Define the LICENSE                               │
│ 03c02af Add README, just for the fun                     │
├──────────────────────────────────────────────────────────┤
│ ● Revision 89f7afb @ [..   ]..03c02af by alice (you) now │
│ ↑ Revision 5d78dd5 @ [..   ]..8945f61 by alice (you) now │
╰──────────────────────────────────────────────────────────╯
```

We can see that this didn't affect the patch's description, but
currently there's no way of seeing a revision's description in the
CLI.