diff mbox series

doc/git-branch: fix awkward wording for "-c"

Message ID YBsQlC03pJgYUHde@coredump.intra.peff.net (mailing list archive)
State Accepted
Commit 27dc071b9a11e953ea7d73bfdf6103940d039215
Headers show
Series doc/git-branch: fix awkward wording for "-c" | expand

Commit Message

Jeff King Feb. 3, 2021, 9:07 p.m. UTC
The description for "-c" is hard to parse. I think the big issue is lack
of commas, but I've also reordered the words to keep the main focus
point of "instead of renaming, copy" together.

Signed-off-by: Jeff King <peff@peff.net>
---
Just happened to be reading this when writing the nearby completion
patch.

 Documentation/git-branch.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

Comments

Taylor Blau Feb. 3, 2021, 9:13 p.m. UTC | #1
On Wed, Feb 03, 2021 at 04:07:32PM -0500, Jeff King wrote:
> The description for "-c" is hard to parse. I think the big issue is lack
> of commas, but I've also reordered the words to keep the main focus
> point of "instead of renaming, copy" together.
>
> Signed-off-by: Jeff King <peff@peff.net>

Much clearer, thanks. I'm only responding to acknowledge that it reads
more clearly to me, too.
Robert Karszniewicz Feb. 4, 2021, 1:21 a.m. UTC | #2
On Wed, Feb 03, 2021 at 04:13:28PM -0500, Taylor Blau wrote:
> On Wed, Feb 03, 2021 at 04:07:32PM -0500, Jeff King wrote:
> > The description for "-c" is hard to parse. I think the big issue is lack
> > of commas, but I've also reordered the words to keep the main focus
> > point of "instead of renaming, copy" together.
> >
> > Signed-off-by: Jeff King <peff@peff.net>
> 
> Much clearer, thanks. I'm only responding to acknowledge that it reads
> more clearly to me, too.

I second that, much better. Thanks.
diff mbox series

Patch

diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt
index adaa1782a8..eb815c2248 100644
--- a/Documentation/git-branch.txt
+++ b/Documentation/git-branch.txt
@@ -78,8 +78,8 @@  renaming. If <newbranch> exists, -M must be used to force the rename
 to happen.
 
 The `-c` and `-C` options have the exact same semantics as `-m` and
-`-M`, except instead of the branch being renamed it along with its
-config and reflog will be copied to a new name.
+`-M`, except instead of the branch being renamed, it will be copied to a
+new name, along with its config and reflog.
 
 With a `-d` or `-D` option, `<branchname>` will be deleted.  You may
 specify more than one branch for deletion.  If the branch currently