git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 6/6] Use consistent links for User Manual and Everyday Git; Fix a quoting error

From
Jonathan Nieder <jrnieder@gmail.com>
Date
Feb 1, 2013, 19:51 UTC
Message-ID
<20130201195140.GE12368@google.com>
In-Reply-To
<549641245.1090170.1359742373184.JavaMail.ngmail@webmail18.arcor-online.net>
Thomas Ackermann wrote:
Show 9 quoted lines
> --- a/Documentation/git.txt
> +++ b/Documentation/git.txt
> @@ -23,7 +23,7 @@ and full access to internals.
>  
>  See linkgit:gittutorial[7] to get started, then see
>  link:everyday.html[Everyday Git] for a useful minimum set of
> -commands.  The link:user-manual.html[Git User's Manual] has a more
> +commands.  The link:user-manual.html[The Git User's Manual] has a more
>  in-depth introduction.
In the rendered version, this looks like:
	The The Git User's Manual[1] has a more in-depth introduction.

Presumably the first "The" should be dropped from either the link or the surrounding text.

[...]
Show 8 quoted lines
> --- a/Documentation/gitcore-tutorial.txt
> +++ b/Documentation/gitcore-tutorial.txt
> @@ -17,7 +17,7 @@ work with a Git repository.
>  
>  If you just need to use Git as a revision control system you may prefer
>  to start with "A Tutorial Introduction to Git" (linkgit:gittutorial[7]) or
> -link:user-manual.html[the Git User Manual].
> +link:user-manual.html[The Git User's Manual].
This comes out as
	... you may prefer to start with "A Tutorial Instruction to Git"
	(gittutorial(7)) or The Git User's Manual[1].

The capital 'T' in "The" looks a bit strange, but a lowercase 't' in the corresponding footnote would also look strange. We can't have everything, I guess.

A possible fix would be to drop the "The" from the link. The way you have it here also seems fine.

[...]
Show 9 quoted lines
> --- a/Documentation/gittutorial-2.txt
> +++ b/Documentation/gittutorial-2.txt
> @@ -406,7 +406,7 @@ pages for any of the git commands; one good place to start would be
>  with the commands mentioned in link:everyday.html[Everyday Git].  You
>  should be able to find any unknown jargon in linkgit:gitglossary[7].
>  
> -The link:user-manual.html[Git User's Manual] provides a more
> +The link:user-manual.html[The Git User's Manual] provides a more
>  comprehensive introduction to Git.
Doubled 'The'.
[...]
Show 8 quoted lines
> --- a/Documentation/gittutorial.txt
> +++ b/Documentation/gittutorial.txt
> @@ -656,7 +656,7 @@ digressions that may be interesting at this point are:
>    * linkgit:gitworkflows[7]: Gives an overview of recommended
>      workflows.
>  
> -  * link:everyday.html[Everyday Git with 20 Commands Or So]
> +  * link:everyday.html[Everyday Git]
Isn't the old title more informative?

Thanks and hope that helps, Jonathan

Previous: Junio C HamanoNext: Junio C Hamano
Message 39 of 49 in “Aw: Re: [PATCH 1/2] Change old system name 'GIT' to 'Git'”
  1. Thomas AckermannJan 20, 2013
  2. Junio C HamanoJan 20, 2013
  3. 0/6 GIT, Git, gitThomas Ackermann, Jan 21, 2013
  4. 1/6 Change old system name 'GIT' to 'Git'Thomas Ackermann, Jan 21, 2013
  5. 2/6 Change 'git' to 'Git' whenever the whole system is referred to #1Thomas Ackermann, Jan 21, 2013
  6. Aw: [PATCH v2 0/6] GIT, Git, gitThomas Ackermann, Jan 21, 2013
  7. 0/6 GIT, Git, gitThomas Ackermann, Jan 21, 2013
  8. 1/6 Change old system name 'GIT' to 'Git'Thomas Ackermann, Jan 21, 2013
  9. Junio C HamanoJan 22, 2013
  10. Aw: Re: [PATCH v3 1/6] Change old system name 'GIT' to 'Git'Thomas Ackermann, Jan 22, 2013
  11. Junio C HamanoJan 22, 2013
  12. 2/6 Change 'git' to 'Git' whenever the whole system is referred to #1Thomas Ackermann, Jan 21, 2013
  13. Junio C HamanoJan 22, 2013
  14. Junio C HamanoJan 22, 2013
  15. Junio C HamanoJan 23, 2013
  16. Junio C HamanoJan 23, 2013
  17. Junio C HamanoJan 23, 2013
  18. 3/6 Change 'git' to 'Git' whenever the whole system is referred to #2Thomas Ackermann, Jan 21, 2013
  19. Junio C HamanoJan 23, 2013
  20. Junio C HamanoJan 23, 2013
  21. David AguilarJan 23, 2013
  22. Junio C HamanoJan 23, 2013
  23. Aw: Re: [PATCH v3 3/6] Change 'git' to 'Git' whenever the whole system is referred to #2Thomas Ackermann, Jan 23, 2013
  24. Junio C HamanoFeb 1, 2013
  25. Aw: Re: Aw: Re: [PATCH v3 3/6] Change 'git' to 'Git' whenever the whole system is referred to #2Thomas Ackermann, Feb 1, 2013
  26. 1/6 fixup! fixup! Change 'git' to 'Git' whenever the whole system is referred to #2Thomas Ackermann, Feb 1, 2013
  27. 2/6 fixup! fixup! fixup! Change 'git' to 'Git' whenever the whole system is referred to #1Thomas Ackermann, Feb 1, 2013
  28. Jonathan NiederFeb 1, 2013
  29. Junio C HamanoFeb 1, 2013
  30. 3/6 fixup! Documentation: avoid poor-man's small capsThomas Ackermann, Feb 1, 2013
  31. Junio C HamanoFeb 1, 2013
  32. 4/6 Fix places where 'Git' should be 'gitThomas Ackermann, Feb 1, 2013
  33. 5/6 Add a description for 'gitfile' to glossaryThomas Ackermann, Feb 1, 2013
  34. Junio C HamanoFeb 1, 2013
  35. Junio C HamanoFeb 1, 2013
  36. Jonathan NiederFeb 1, 2013
  37. 6/6 Use consistent links for User Manual and Everyday Git; Fix a quoting errorThomas Ackermann, Feb 1, 2013
  38. Junio C HamanoFeb 1, 2013
  39. Jonathan NiederFeb 1, 2013
  40. Junio C HamanoFeb 1, 2013
  41. Aw: Re: [PATCH 6/6] Use consistent links for User Manual and Everyday Git; Fix a quoting errorThomas Ackermann, Feb 1, 2013
  42. Junio C HamanoFeb 1, 2013
  43. 4/6 Change 'git' to 'Git' whenever the whole system is referred to #3Thomas Ackermann, Jan 21, 2013
  44. Junio C HamanoJan 23, 2013
  45. 5/6 Change 'git' to 'Git' whenever the whole system is referred to #4Thomas Ackermann, Jan 21, 2013
  46. Junio C HamanoJan 23, 2013
  47. 6/6 Add rule for when to use 'git' and when to use 'Git'Thomas Ackermann, Jan 21, 2013
  48. Junio C HamanoJan 21, 2013
  49. Junio C HamanoJan 21, 2013

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.