All of lore.kernel.org
 help / color / mirror / Atom feed
* Aw: Re: [PATCH 1/2] Change old system name 'GIT' to 'Git'
@ 2013-01-20 20:16 Thomas Ackermann
  2013-01-20 21:08 ` Junio C Hamano
                   ` (11 more replies)
  0 siblings, 12 replies; 51+ messages in thread
From: Thomas Ackermann @ 2013-01-20 20:16 UTC (permalink / raw)
  To: gitster, davvid; +Cc: th.acker, git

> 
> If I were to decide today to change the spellings, with an explicit
> purpose of making things more consistent across documentation, it
> may make sense to use even a simpler rule that is less error-prone
> for people who write new sentences that has to have the word.  How
> about treating it just like any other ordinary word?  That is, we
> say "git" (without double-quotes, of course), unless it comes at the
> beginning of a sentence?
> 

The widely used books on Git by Scott Chacon or Jon Loeliger (and
many others) are using 'Git' instead of 'git' when talking about the 
whole system. So IMHO it would not be wise to change our internal 
documentation from using 'GIT'/'Git' to using 'git'. The internal 
documentation should be a natural continuation of these books 
by content and style.

- Just my thoughts.


---
Thomas

^ permalink raw reply	[flat|nested] 51+ messages in thread
* Re: [PATCH 1/2] Change old system name 'GIT' to 'Git'
  2013-01-19  9:59   ` [PATCH 1/2] Change old system name 'GIT' to 'Git' Thomas Ackermann
@ 2013-01-19 10:39 David Aguilar
  2013-01-19  9:57 ` [PATCH 0/2] GIT, Git, git Thomas Ackermann
  0 siblings, 1 reply; 51+ messages in thread
From: David Aguilar @ 2013-01-19 10:39 UTC (permalink / raw)
  To: Thomas Ackermann; +Cc: git

On Sat, Jan 19, 2013 at 1:59 AM, Thomas Ackermann <th.acker@arcor.de> wrote:
> @@ -55,7 +55,7 @@ History Viewers
>
>     - *gitweb* (shipped with git-core)
>
> -   GITweb provides full-fledged web interface for GIT repositories.
> +   GITweb provides full-fledged web interface for Git repositories.

What about GITweb?

> diff --git a/Documentation/git-update-ref.txt b/Documentation/git-update-ref.txt
> index d377a35..0df13ff 100644
> --- a/Documentation/git-update-ref.txt
> +++ b/Documentation/git-update-ref.txt
> @@ -73,7 +73,7 @@ in ref value.  Log lines are formatted as:
>  Where "oldsha1" is the 40 character hexadecimal value previously
>  stored in <ref>, "newsha1" is the 40 character hexadecimal value of
>  <newvalue> and "committer" is the committer's name, email address
> -and date in the standard GIT committer ident format.
> +and date in the standard Git committer ident format.

IMO some of these look nicer when everything is lowercase.
e.g. "standard git committer ident format".

> diff --git a/Documentation/gitweb.txt b/Documentation/gitweb.txt
> index 168e8bf..d364c3a 100644
> --- a/Documentation/gitweb.txt
> +++ b/Documentation/gitweb.txt
> @@ -504,7 +504,7 @@ repositories, you can configure Apache like this:
>
>  The above configuration expects your public repositories to live under
>  '/pub/git' and will serve them as `http://git.domain.org/dir-under-pub-git`,
> -both as cloneable GIT URL and as browseable gitweb interface.  If you then
> +both as cloneable Git URL and as browseable gitweb interface.  If you then
>  start your linkgit:git-daemon[1] with `--base-path=/pub/git --export-all`
>  then you can even use the `git://` URL with exactly the same path.

Git but not Gitweb?  IMO it reads nicer as "cloneable git URL",
which also avoids this mismatch, but like I said that's my opinion.

$ git grep 'git repositor' | wc -l
226

These changes touch, for example, git-clone.txt to make it
say: "Make a 'bare' Git repository".  Why not lowercase?

In that same file it has "git repository", in lowercase,
in a later paragraph.  I'm not sure which way is preferred,
but I think they should be consistent.

Anyways, just some small notes.
cheers,
-- 
David

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

end of thread, other threads:[~2013-02-01 20:25 UTC | newest]

Thread overview: 51+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2013-01-20 20:16 Aw: Re: [PATCH 1/2] Change old system name 'GIT' to 'Git' Thomas Ackermann
2013-01-20 21:08 ` Junio C Hamano
2013-01-21 18:36 ` [PATCH v2 0/6] GIT, Git, git Thomas Ackermann
2013-01-21 19:56   ` Junio C Hamano
2013-01-21 20:01     ` Junio C Hamano
2013-01-21 18:38 ` [PATCH v2 1/6] Change old system name 'GIT' to 'Git' Thomas Ackermann
2013-01-21 18:40 ` [PATCH v2 2/6] Change 'git' to 'Git' whenever the whole system is referred to #1 Thomas Ackermann
2013-01-21 18:51 ` Aw: [PATCH v2 0/6] GIT, Git, git Thomas Ackermann
2013-01-21 19:12 ` [PATCH v3 " Thomas Ackermann
2013-01-21 19:16 ` [PATCH v3 1/6] Change old system name 'GIT' to 'Git' Thomas Ackermann
2013-01-22  0:39   ` Junio C Hamano
2013-01-22  9:44   ` Aw: " Thomas Ackermann
2013-01-22 16:45     ` Junio C Hamano
2013-01-21 19:17 ` [PATCH v3 2/6] Change 'git' to 'Git' whenever the whole system is referred to #1 Thomas Ackermann
2013-01-22  0:41   ` Junio C Hamano
2013-01-22 23:48   ` Junio C Hamano
2013-01-23  0:19     ` Junio C Hamano
2013-01-23  2:24       ` Junio C Hamano
2013-01-23  2:32       ` Junio C Hamano
2013-01-21 19:19 ` [PATCH v3 3/6] Change 'git' to 'Git' whenever the whole system is referred to #2 Thomas Ackermann
2013-01-23  0:53   ` Junio C Hamano
2013-01-23  2:48     ` Junio C Hamano
2013-01-23  3:44   ` David Aguilar
2013-01-23  4:17     ` Junio C Hamano
2013-01-23  8:58     ` Aw: " Thomas Ackermann
2013-02-01  0:46       ` Junio C Hamano
2013-02-01 18:04       ` Aw: " Thomas Ackermann
2013-02-01 18:37         ` Junio C Hamano
2013-02-01 18:06       ` [PATCH 1/6] fixup! fixup! " Thomas Ackermann
2013-02-01 18:07       ` [PATCH 2/6] fixup! fixup! fixup! Change 'git' to 'Git' whenever the whole system is referred to #1 Thomas Ackermann
2013-02-01 19:43         ` Jonathan Nieder
2013-02-01 20:16           ` Junio C Hamano
2013-02-01 18:08       ` [PATCH 3/6] fixup! Documentation: avoid poor-man's small caps Thomas Ackermann
2013-02-01 18:44         ` Junio C Hamano
2013-02-01 18:10       ` [PATCH 4/6] Fix places where 'Git' should be 'git Thomas Ackermann
2013-02-01 18:11       ` [PATCH 5/6] Add a description for 'gitfile' to glossary Thomas Ackermann
2013-02-01 18:41         ` Junio C Hamano
2013-02-01 19:26           ` Junio C Hamano
2013-02-01 19:46             ` Jonathan Nieder
2013-02-01 18:12       ` [PATCH 6/6] Use consistent links for User Manual and Everyday Git; Fix a quoting error Thomas Ackermann
2013-02-01 18:43         ` Junio C Hamano
2013-02-01 19:51         ` Jonathan Nieder
2013-02-01 20:17           ` Junio C Hamano
2013-02-01 20:25         ` Aw: " Thomas Ackermann
2013-01-21 19:21 ` [PATCH v3 4/6] Change 'git' to 'Git' whenever the whole system is referred to #3 Thomas Ackermann
2013-01-23  2:49   ` Junio C Hamano
2013-01-21 19:22 ` [PATCH v3 5/6] Change 'git' to 'Git' whenever the whole system is referred to #4 Thomas Ackermann
2013-01-23  3:16   ` Junio C Hamano
2013-01-21 19:24 ` [PATCH v3 6/6] Add rule for when to use 'git' and when to use 'Git' Thomas Ackermann
  -- strict thread matches above, loose matches on Subject: below --
2013-01-19 10:39 [PATCH 1/2] Change old system name 'GIT' to 'Git' David Aguilar
2013-01-19  9:57 ` [PATCH 0/2] GIT, Git, git Thomas Ackermann
2013-01-19  9:59   ` [PATCH 1/2] Change old system name 'GIT' to 'Git' Thomas Ackermann
2013-01-19 15:01     ` Aw: " Thomas Ackermann
2013-01-20 11:24       ` Matthieu Moy

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.