Aw: Re: [PATCH 08/13] Improve section "Manipulating branches"

2013-08-25 Thread Thomas Ackermann
 
> 
> But is this correct?  I somehow thought that we check with the
> current or the upstream.
> 

You are correct. I will add this. Thanks.


---
Thomas
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Re: [PATCH 08/13] Improve section "Manipulating branches"

2013-08-24 Thread Junio C Hamano
Thomas Ackermann  writes:

> Add some missing punctuation.
> Simplify description of "git branch -d/-D".
> ...
>  `git branch -d `::
> - delete the branch ``; if the branch you are deleting
> - points to a commit which is not reachable from the current
> - branch, this command will fail with a warning.
> + delete the branch ``; if the branch is not fully
> + merged in its upstream branch, this command will fail with a warning.

But is this correct?  I somehow thought that we check with the
current or the upstream.

>  `git branch -D `::
> - even if the branch points to a commit not reachable
> - from the current branch, you may know that that commit
> - is still reachable from some other branch or tag.  In that
> - case it is safe to use this command to force Git to delete
> - the branch.
> + delete the branch `` irrespective of its merged status.

This is an OK change.
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[PATCH 08/13] Improve section "Manipulating branches"

2013-08-24 Thread Thomas Ackermann

Add some missing punctuation.
Simplify description of "git branch -d/-D".

Signed-off-by: Thomas Ackermann 
---
 Documentation/user-manual.txt | 19 +++
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index 0656191..d5baf03 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -268,27 +268,22 @@ Creating, deleting, and modifying branches is quick and 
easy; here's
 a summary of the commands:
 
 `git branch`::
-   list all branches
+   list all branches.
 `git branch `::
create a new branch named ``, referencing the same
-   point in history as the current branch
+   point in history as the current branch.
 `git branch  `::
create a new branch named ``, referencing
``, which may be specified any way you like,
-   including using a branch name or a tag name
+   including using a branch name or a tag name.
 `git branch -d `::
-   delete the branch ``; if the branch you are deleting
-   points to a commit which is not reachable from the current
-   branch, this command will fail with a warning.
+   delete the branch ``; if the branch is not fully
+   merged in its upstream branch, this command will fail with a warning.
 `git branch -D `::
-   even if the branch points to a commit not reachable
-   from the current branch, you may know that that commit
-   is still reachable from some other branch or tag.  In that
-   case it is safe to use this command to force Git to delete
-   the branch.
+   delete the branch `` irrespective of its merged status.
 `git checkout `::
make the current branch ``, updating the working
-   directory to reflect the version referenced by ``
+   directory to reflect the version referenced by ``.
 `git checkout -b  `::
create a new branch `` referencing ``, and
check it out.
-- 
1.8.3.msysgit.0


---
Thomas
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html