{"thread":{"id":"61009","subject":"[PATCH] replay: Fix documentation of the --contained flag","startedAt":"2024-02-26T11:32:22Z","lastAt":"2024-02-26T11:32:22Z","messageCount":1,"participants":["Gabriel de Perthuis"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"489370","messageId":"20240226-fix-replay-docs-v1-1-a5f8bf08414a@gmail.com","threadId":"61009","inReplyTo":null,"subject":"[PATCH] replay: Fix documentation of the --contained flag","fromName":"Gabriel de Perthuis","fromEmail":"g2p.code@gmail.com","sentAt":"2024-02-26T11:32:15Z","receivedAt":"2024-02-26T11:32:22Z","isPatch":true,"sender":{"key":"g2p.code@gmail.com","avatar":null},"body":"There was a paragraph describing the behaviour of that flag (which\naffects branches and refs), but referring to it as --onto.\n--contained is used with --onto but it is a more specific flag.\n--onto by itself refers to a commit and does not have the described\neffect on branches.\n\nSigned-off-by: Gabriel de Perthuis <g2p.code@gmail.com>\n---\n Documentation/git-replay.txt | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-replay.txt b/Documentation/git-replay.txt\nindex f6c269c62d..ab28e86a4a 100644\n--- a/Documentation/git-replay.txt\n+++ b/Documentation/git-replay.txt\n@@ -27,12 +27,12 @@ OPTIONS\n \n --onto <newbase>::\n \tStarting point at which to create the new commits.  May be any\n \tvalid commit, and not just an existing branch name.\n +\n-When `--onto` is specified, the update-ref command(s) in the output will\n-update the branch(es) in the revision range to point at the new\n+When `--contained` is specified, the update-ref command(s) in the output will\n+update any branch(es) pointing within the revision range to point at the new\n commits, similar to the way how `git rebase --update-refs` updates\n multiple branches in the affected range.\n \n --advance <branch>::\n \tStarting point at which to create the new commits; must be a\n\n---\nbase-commit: 3c2a3fdc388747b9eaf4a4a4f2035c1c9ddb26d0\nchange-id: 20240226-fix-replay-docs-70a54ea9e3c8\n\nBest regards,\n-- \nGabriel de Perthuis\n\n"}]}