All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] doc: A few minor copy edits.
@ 2012-07-14 22:20 Štěpán Němec
  2012-07-15  5:32 ` Junio C Hamano
  0 siblings, 1 reply; 4+ messages in thread
From: Štěpán Němec @ 2012-07-14 22:20 UTC (permalink / raw)
  To: gitster; +Cc: git

- (glossary) the quotes around the Wikipedia URL prevented its
  linkification in frontends that support it; remove them

- (manual) newer version (SHA-1) == following, older == preceding, not
  the other way around

- trivial typo and wording fixes

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
---
 Documentation/git-merge.txt        |    2 +-
 Documentation/git-rebase.txt       |    2 +-
 Documentation/glossary-content.txt |    2 +-
 Documentation/rev-list-options.txt |    2 +-
 Documentation/user-manual.txt      |   12 ++++++------
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/Documentation/git-merge.txt b/Documentation/git-merge.txt
index 3ceefb8..20f9228 100644
--- a/Documentation/git-merge.txt
+++ b/Documentation/git-merge.txt
@@ -181,7 +181,7 @@ final result verbatim.  When both sides made changes to the same area,
 however, git cannot randomly pick one side over the other, and asks you to
 resolve it by leaving what both sides did to that area.
 
-By default, git uses the same style as that is used by "merge" program
+By default, git uses the same style as the one used by the "merge" program
 from the RCS suite to present such a conflicted hunk, like this:
 
 ------------
diff --git a/Documentation/git-rebase.txt b/Documentation/git-rebase.txt
index 2d71e4b..2cab7e2 100644
--- a/Documentation/git-rebase.txt
+++ b/Documentation/git-rebase.txt
@@ -273,7 +273,7 @@ which makes little sense.
 	Pass the <strategy-option> through to the merge strategy.
 	This implies `--merge` and, if no strategy has been
 	specified, `-s recursive`.  Note the reversal of 'ours' and
-	'theirs' as noted in above for the `-m` option.
+	'theirs' as noted above for the `-m` option.
 
 -q::
 --quiet::
diff --git a/Documentation/glossary-content.txt b/Documentation/glossary-content.txt
index 3595b58..f928b57 100644
--- a/Documentation/glossary-content.txt
+++ b/Documentation/glossary-content.txt
@@ -117,7 +117,7 @@ to point at the new commit.
 
 [[def_ent]]ent::
 	Favorite synonym to "<<def_tree-ish,tree-ish>>" by some total geeks. See
-	`http://en.wikipedia.org/wiki/Ent_(Middle-earth)` for an in-depth
+	http://en.wikipedia.org/wiki/Ent_(Middle-earth) for an in-depth
 	explanation. Avoid this term, not to confuse people.
 
 [[def_evil_merge]]evil merge::
diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt
index 84e34b1..d9b2b5b 100644
--- a/Documentation/rev-list-options.txt
+++ b/Documentation/rev-list-options.txt
@@ -760,7 +760,7 @@ options may be given. See linkgit:git-diff-files[1] for more options.
 
 --cc::
 
-	This flag implies the '-c' options and further compresses the
+	This flag implies the '-c' option and further compresses the
 	patch output by omitting uninteresting hunks whose contents in
 	the parents have only two variants and the merge result picks
 	one of them without modification.
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index 02ed566..03d95dc 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -2870,7 +2870,7 @@ $ git fetch example
 You can also add a "+" to force the update each time:
 
 -------------------------------------------------
-$ git config remote.example.fetch +master:ref/remotes/example/master
+$ git config remote.example.fetch +master:refs/remotes/example/master
 -------------------------------------------------
 
 Don't do this unless you're sure you won't mind "git fetch" possibly
@@ -2966,7 +2966,7 @@ As you can see, a commit is defined by:
 
 - a tree: The SHA-1 name of a tree object (as defined below), representing
   the contents of a directory at a certain point in time.
-- parent(s): The SHA-1 name of some number of commits which represent the
+- parent(s): The SHA-1 name(s) of some number of commits which represent the
   immediately previous step(s) in the history of the project.  The
   example above has one parent; merge commits may have more than
   one.  A commit with no parents is called a "root" commit, and
@@ -3363,8 +3363,8 @@ Date:
 :100644 100644 oldsha... 4b9458b... M somedirectory/myfile
 ------------------------------------------------
 
-This tells you that the immediately preceding version of the file was
-"newsha", and that the immediately following version was "oldsha".
+This tells you that the immediately following version of the file was
+"newsha", and that the immediately preceding version was "oldsha".
 You also know the commit messages that went with the change from oldsha
 to 4b9458b and with the change from 4b9458b to newsha.
 
@@ -4035,8 +4035,8 @@ $ git ls-files --unmerged
 Each line of the `git ls-files --unmerged` output begins with
 the blob mode bits, blob SHA-1, 'stage number', and the
 filename.  The 'stage number' is git's way to say which tree it
-came from: stage 1 corresponds to `$orig` tree, stage 2 `HEAD`
-tree, and stage3 `$target` tree.
+came from: stage 1 corresponds to the `$orig` tree, stage 2 to
+the `HEAD` tree, and stage 3 to the `$target` tree.
 
 Earlier we said that trivial merges are done inside
 `git read-tree -m`.  For example, if the file did not change
-- 
1.7.10.4

^ permalink raw reply related	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: A few minor copy edits.
  2012-07-14 22:20 [PATCH] doc: A few minor copy edits Štěpán Němec
@ 2012-07-15  5:32 ` Junio C Hamano
  2012-07-15  9:43   ` Štěpán Němec
  0 siblings, 1 reply; 4+ messages in thread
From: Junio C Hamano @ 2012-07-15  5:32 UTC (permalink / raw)
  To: Štěpán Němec; +Cc: git

Štěpán Němec <stepnem@gmail.com> writes:

> - (glossary) the quotes around the Wikipedia URL prevented its
>   linkification in frontends that support it; remove them
>
> - (manual) newer version (SHA-1) == following, older == preceding, not
>   the other way around
>
> - trivial typo and wording fixes
>
> Signed-off-by: Štěpán Němec <stepnem@gmail.com>

Thanks.  All looked reasonable, except that I've heard nobody says
"ent" for the past couple of years, and it might be better to drop
the entry altogether.

> diff --git a/Documentation/glossary-content.txt b/Documentation/glossary-content.txt
> index 3595b58..f928b57 100644
> --- a/Documentation/glossary-content.txt
> +++ b/Documentation/glossary-content.txt
> @@ -117,7 +117,7 @@ to point at the new commit.
>  
>  [[def_ent]]ent::
>  	Favorite synonym to "<<def_tree-ish,tree-ish>>" by some total geeks. See
> -	`http://en.wikipedia.org/wiki/Ent_(Middle-earth)` for an in-depth
> +	http://en.wikipedia.org/wiki/Ent_(Middle-earth) for an in-depth
>  	explanation. Avoid this term, not to confuse people.
>  
>  [[def_evil_merge]]evil merge::

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: A few minor copy edits.
  2012-07-15  5:32 ` Junio C Hamano
@ 2012-07-15  9:43   ` Štěpán Němec
  2012-07-16 11:46     ` Zbigniew Jędrzejewski-Szmek
  0 siblings, 1 reply; 4+ messages in thread
From: Štěpán Němec @ 2012-07-15  9:43 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: git

On Sat, 14 Jul 2012 22:32:05 -0700
Junio C. Hamano wrote:

> Thanks.  All looked reasonable, except that I've heard nobody says
> "ent" for the past couple of years, and it might be better to drop
> the entry altogether.

Yeah, I have no real opinion here. I've never been a Tolkien fan, so I
had no idea what "ent" even means, let alone its connection to anything
Git-related (which is why the glossary entry caught my eye in the first
place). I found it amusing and that's all; maybe other Git oldtimers
have some kind of personal attachment to it?

I have to admit that I don't remember seeing the word in any of various
Git-related texts or discussions I've read in past ~3 years, so I agree
its educative value is probably dubious nowadays. OTOH it's just a
couple lines, _and_ amusing... ;-)

I'll resend the patch with the entry removed if no break-through occurs
during the next few days.

>> diff --git a/Documentation/glossary-content.txt b/Documentation/glossary-content.txt
>> index 3595b58..f928b57 100644
>> --- a/Documentation/glossary-content.txt
>> +++ b/Documentation/glossary-content.txt
>> @@ -117,7 +117,7 @@ to point at the new commit.
>>  
>>  [[def_ent]]ent::
>>  	Favorite synonym to "<<def_tree-ish,tree-ish>>" by some total geeks. See
>> -	`http://en.wikipedia.org/wiki/Ent_(Middle-earth)` for an in-depth
>> +	http://en.wikipedia.org/wiki/Ent_(Middle-earth) for an in-depth
>>  	explanation. Avoid this term, not to confuse people.
>>  
>>  [[def_evil_merge]]evil merge::

-- 
Štěpán

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: A few minor copy edits.
  2012-07-15  9:43   ` Štěpán Němec
@ 2012-07-16 11:46     ` Zbigniew Jędrzejewski-Szmek
  0 siblings, 0 replies; 4+ messages in thread
From: Zbigniew Jędrzejewski-Szmek @ 2012-07-16 11:46 UTC (permalink / raw)
  To: Štěpán Němec; +Cc: Junio C Hamano, git

On 07/15/2012 11:43 AM, Štěpán Němec wrote:
> On Sat, 14 Jul 2012 22:32:05 -0700
> Junio C. Hamano wrote:
> 
>> Thanks.  All looked reasonable, except that I've heard nobody says
>> "ent" for the past couple of years, and it might be better to drop
>> the entry altogether.
Please keep it, it's funny.

Zbyszek

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2012-07-16 11:47 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-07-14 22:20 [PATCH] doc: A few minor copy edits Štěpán Němec
2012-07-15  5:32 ` Junio C Hamano
2012-07-15  9:43   ` Štěpán Němec
2012-07-16 11:46     ` Zbigniew Jędrzejewski-Szmek

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.