Merge branch 'jc/branch-force-doc-readability-fix'
authorJunio C Hamano <gitster@pobox.com>
Thu, 19 Oct 2017 05:45:45 +0000 (14:45 +0900)
committerJunio C Hamano <gitster@pobox.com>
Thu, 19 Oct 2017 05:45:45 +0000 (14:45 +0900)
Doc update.

* jc/branch-force-doc-readability-fix:
branch doc: sprinkle a few commas for readability

1  2 
Documentation/git-branch.txt
index fe029ac6fc1a2280893c8ad7c36582c3f891a79e,3672195b3ac4ab6b716142cbf45d8c3e50d14b8d..d6587c5e96f4dbcdb4176d9dd5f6a992c0e83f3b
@@@ -18,7 -18,6 +18,7 @@@ SYNOPSI
  'git branch' (--set-upstream-to=<upstream> | -u <upstream>) [<branchname>]
  'git branch' --unset-upstream [<branchname>]
  'git branch' (-m | -M) [<oldbranch>] <newbranch>
 +'git branch' (-c | -C) [<oldbranch>] <newbranch>
  'git branch' (-d | -D) [-r] <branchname>...
  'git branch' --edit-description [<branchname>]
  
@@@ -65,10 -64,6 +65,10 @@@ If <oldbranch> had a corresponding refl
  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.
 +
  With a `-d` or `-D` option, `<branchname>` will be deleted.  You may
  specify more than one branch for deletion.  If the branch currently
  has a reflog then the reflog will also be deleted.
@@@ -97,19 -92,19 +97,19 @@@ OPTION
        all changes made to the branch ref, enabling use of date
        based sha1 expressions such as "<branchname>@\{yesterday}".
        Note that in non-bare repositories, reflogs are usually
 -      enabled by default by the `core.logallrefupdates` config option.
 +      enabled by default by the `core.logAllRefUpdates` config option.
        The negated form `--no-create-reflog` only overrides an earlier
        `--create-reflog`, but currently does not negate the setting of
 -      `core.logallrefupdates`.
 +      `core.logAllRefUpdates`.
  
  -f::
  --force::
-       Reset <branchname> to <startpoint> if <branchname> exists
-       already. Without `-f` 'git branch' refuses to change an existing branch.
+       Reset <branchname> to <startpoint>, even if <branchname> exists
+       already. Without `-f`, 'git branch' refuses to change an existing branch.
        In combination with `-d` (or `--delete`), allow deleting the
        branch irrespective of its merged status. In combination with
        `-m` (or `--move`), allow renaming the branch even if the new
 -      branch name already exists.
 +      branch name already exists, the same applies for `-c` (or `--copy`).
  
  -m::
  --move::
  -M::
        Shortcut for `--move --force`.
  
 +-c::
 +--copy::
 +      Copy a branch and the corresponding reflog.
 +
 +-C::
 +      Shortcut for `--copy --force`.
 +
  --color[=<when>]::
        Color branches to highlight current, local, and
        remote-tracking branches.
@@@ -207,8 -195,10 +207,8 @@@ start-point is either a local or remote
        branch.autoSetupMerge configuration variable is true.
  
  --set-upstream::
 -      If specified branch does not exist yet or if `--force` has been
 -      given, acts exactly like `--track`. Otherwise sets up configuration
 -      like `--track` would when creating the branch, except that where
 -      branch points to is not changed.
 +      As this option had confusing syntax, it is no longer supported.
 +      Please use `--track` or `--set-upstream-to` instead.
  
  -u <upstream>::
  --set-upstream-to=<upstream>::