From: Junio C Hamano <gitster@pobox.com>
To: dave@krondo.com
Cc: git@vger.kernel.org
Subject: Re: [PATCH] Documentation: fix and clarify grammar in git-merge docs.
Date: Wed, 16 Jan 2008 11:07:29 -0800 [thread overview]
Message-ID: <7vd4s1r3m6.fsf@gitster.siamese.dyndns.org> (raw)
In-Reply-To: <1200460565-16797-1-git-send-email-dave@krondo.com> (dave@krondo.com's message of "Tue, 15 Jan 2008 21:16:05 -0800")
dave@krondo.com writes:
> From: Dave Peticolas <dave@krondo.com>
>
>
> Signed-off-by: Dave Peticolas <dave@krondo.com>
> ---
> Documentation/git-merge.txt | 25 ++++++++++++-------------
> 1 files changed, 12 insertions(+), 13 deletions(-)
>
> diff --git a/Documentation/git-merge.txt b/Documentation/git-merge.txt
> index ed3a924..abf63fe 100644
> --- a/Documentation/git-merge.txt
> +++ b/Documentation/git-merge.txt
> @@ -74,19 +74,18 @@ it happens. In other words, `git-diff --cached HEAD` must
> report no changes.
>
> [NOTE]
> -This is a bit of lie. In certain special cases, your index are
> -allowed to be different from the tree of `HEAD` commit. The most
> -notable case is when your `HEAD` commit is already ahead of what
> -is being merged, in which case your index can have arbitrary
> -difference from your `HEAD` commit. Otherwise, your index entries
> -are allowed have differences from your `HEAD` commit that match
> -the result of trivial merge (e.g. you received the same patch
> -from external source to produce the same result as what you are
> -merging). For example, if a path did not exist in the common
> -ancestor and your head commit but exists in the tree you are
> -merging into your repository, and if you already happen to have
> -that path exactly in your index, the merge does not have to
> -fail.
> +This is a bit of a lie. In certain special cases, your index is
> +allowed to be different from the tree of the `HEAD` commit. The
> +most notable case is when your `HEAD` commit is already ahead of
> +what is being merged, in which case your index can have arbitrary
> +differences from your `HEAD` commit. Also, your index entries may
> +have differences from your `HEAD` commit that match the result of
> +a trivial merge (e.g., you received the same patch from an external
> +source to produce the same result as what you are merging). For example,
> +if a path did not exist in the common ancestor and your head commit
> +but exists in the tree you are merging into your repository, and if
> +you already happen to have that path exactly in your index, the merge
> +does not have to fail.
While checking and fixing the grammatical errors is very much
appreciated, line re-wrapping is not. It makes it unnecessarily
cumbersome to see what got really changed.
Thanks anyway. The changes look good.
next prev parent reply other threads:[~2008-01-16 19:08 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-01-16 5:16 [PATCH] Documentation: fix and clarify grammar in git-merge docs dave
2008-01-16 19:07 ` Junio C Hamano [this message]
-- strict thread matches above, loose matches on Subject: below --
2008-01-17 2:58 dave
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=7vd4s1r3m6.fsf@gitster.siamese.dyndns.org \
--to=gitster@pobox.com \
--cc=dave@krondo.com \
--cc=git@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).