Errata for Pragmatic Version Control Using Git
We try to keep our books accurate, but sometimes mistakes creep in. This page lists the errors submitted by our astute readers. If you've found a new error, please submit it.
The latest version of the book is B5.0, released about 1 month ago. If you've bought a PDF of the book and would like to upgrade it to this version (for free), visit your home page.
| Paper | Description | Found in | Fixed in | |
|---|---|---|---|---|
| 2 |
#35303: On the page 2 (about the PDF being a Beta book), the link for errata goes to the errata for "Enterprise Recipes with Ruby and Rails".--Andrew Grimm |
B5.0
16-Oct-08 |
||
| 10 |
#35115: Change "brain child" to "brainchild"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 10 |
#35116: Footnote: change "bail out" to "bailout"
Also, this blurb is a few days out of date! Rather than the "American banking system", the trouble...more...
|
B5.0
11-Oct-08 |
||
| 10 |
#35222: The word "just" feels overused and appears to be a filler word in most instances. Many times the word "just" can be omitted from a statement ...more...
|
B5.0
13-Oct-08 |
||
| 10 |
#35528: "developed to track changes made to the Linux Kernel" Kernel is not a proper noun; it should not be capitalized.--Albert Vernon |
B5.0
29-Oct-08 |
||
| 10 |
#35305: You mention git's ability to communicate with subversion, I couldn't find anywhere in your book a warning that this isn't yet working with msysgit.--Andrew Grimm |
B5.0
16-Oct-08 |
||
| 11 |
#35117: Change "every day tasks" to "everyday tasks"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 11 |
#35529: Change "specific" to "specifics".--Albert Vernon |
B5.0
29-Oct-08 |
||
| 11 |
#35530: "Branching is so key to how Git operates there’s a full chapter explaining what they are and how to use them."
Noun-pronoun disagreement. ...more...
|
B5.0
29-Oct-08 |
||
| 11 |
#35304: "you can skim the Part I for the Git specific and then" seems to lack something after "specific".--Andrew Grimm |
B5.0
16-Oct-08 |
||
| 12 |
#35118: Change "it's killer feature" to "its killer feature"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 12 |
#35119: Change "other developer's repositories" to "other developers' repositories"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 12 |
#35120: Change "you learn about some organizational techniques" to "YOU'LL learn about some organizational techniques"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 12 |
#35121: How about getting rid of 'Then' next to the last bullet point--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 12 |
#35531: It is bad style to follow verbs with colons. Under "Typographic Conventions" you should instead write, "They are the following:"
|
B5.0
29-Oct-08 |
||
| 13 |
#35122: Change "program as whole" to "program as A whole"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 13 |
#35123: Change "the command you run in in the command line" to "the command you run ON the command line"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 13 |
#35124: "jumping off place"
|
B5.0
11-Oct-08 |
||
| 13 |
#35125: "without any further ado"
|
B5.0
11-Oct-08 |
||
| 15 |
#35126: 3rd paragraph: Seems odd to say DVCS are no different, and then say how they're different. Maybe "no different in those respects"?
(also so...more...
|
B5.0
11-Oct-08 |
||
| 16 |
#35127: "The repository is the place that"
How about: "The repository is the place WHERE"
"along with when the change was made"
How about: "along...more...
|
B5.0
11-Oct-08 |
||
| 16 |
#35532: "Most store the current state" Most what? Most version control systems? Most repositories?--Albert Vernon |
B5.0
29-Oct-08 |
||
| 16 |
#35533: "message that explains why they made the change" They who? This pronoun has no antecedent.--Albert Vernon |
B5.0
29-Oct-08 |
||
| 17 |
#35128: "Making a commit doesn't involve connecting to a remote repository, the change is just recorded on your local repository."
How about:
"Mak...more...
|
B5.0
11-Oct-08 |
||
| 17 |
#35129: 3rd paragraph talks about pushing but for some reason not pulling.--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 17 |
#35534: Missing comma after "of course" in "and of course your unit tests."--Albert Vernon |
B5.0
29-Oct-08 |
||
| 17 |
#35535: Ask yourself, "if I didn’t have X "If" should be capitalized.--Albert Vernon |
B5.0
29-Oct-08 |
||
| 18 |
#35082: Stray "s" at the end of: exists “over there” on another server.s --Jonathan Leffler |
B5.0
10-Oct-08 |
||
| 18 |
#35084: At "Well, you start your own project, then tell Git to initialize a repository for it; or you can clone an existing repository."
I think sy...more...
|
B5.0
10-Oct-08 |
||
| 19 |
#35085: At "There’s two steps"; use "There are two steps".--Jonathan Leffler |
B5.0
10-Oct-08 |
||
| 19 |
#35130: Change "There's two steps" to "There are two steps"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 20 |
#35131: "All of your work happens in the working tree, that we talked about earlier."
|
B5.0
11-Oct-08 |
||
| 20 |
#35132: "You can create a new directory in the repository for each project so they all share a common history"
How about:
"You can create a new di...more...
|
B5.0
11-Oct-08 |
||
| 20 |
#35169: "Technically, this has a lot of advantages. It reduces the amount of storage space needed to store the entire history of your repository "
...more...
|
B5.0
12-Oct-08 |
||
| 21 |
#35086: At "Maybe you follow an Agile
|
B5.0
10-Oct-08 |
||
| 23 |
#35133: "Git can merge them together." How about:
|
B5.0
11-Oct-08 |
||
| 24 |
#35134: "Joe and Alice both create clones of the repository they share and starts making changes."
How about:
"Joe and Alice both create clones of...more...
|
B5.0
11-Oct-08 |
||
| 24 |
#35306: "Subversion 1.5.0, which was released in June of 2008,"
Is the "of" in "June of 2008" good English? It feels wrong to me, but maybe it's an...more...
|
B5.0
16-Oct-08 |
||
| 25 |
#35135: "We've taken a 30,000 foot view of the DVCS world the way Git interacts with it."
doesn't sound quite right... maybe "AND the way Git inter...more...
|
B5.0
11-Oct-08 |
||
| 25 |
#35136: "You learned how files are tracked, how repositories stay in sync and got an introduction to tags, branches, and the art of merging."
How a...more...
|
B5.0
11-Oct-08 |
||
| 26 |
#35138: "straight forward" -> "straightforward"--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 27 |
#35139: "they tend to be out of date quite rapidly." How about:
|
B5.0
11-Oct-08 |
||
| 27 |
#36174: Is it possible compile git just running make without running ./configure before? I coudln't.--Andrei Dolganov |
B5.0
29-Nov-08 |
||
| 27 |
#35439: sudo make install install-doc
will cause a recompile, unless you're using the default prefix. It should be:
sudo make prefix=/usr/local ...more...
|
B5.0
25-Oct-08 |
||
| 28 |
#35140: "I advise against using adding doc..." How about:
|
B5.0
11-Oct-08 |
||
| 29 |
#35141: "Git uses SSH (Secure Shell) as the default transfer protocol when it talks to other repositories."
"Git uses SSH (Secure Shell) as the def...more...
|
B5.0
11-Oct-08 |
||
| 30 |
#35678: "This is necessary for Windows to know what to find the git command on your system."
|
B5.0
07-Nov-08 |
||
| 33 |
#35142: "That's all there is to configuring Git--you're ready to start using Git."
How about:
"That's all there is to configuring Git--you're read...more...
|
B5.0
11-Oct-08 |
||
| 34 |
#35143: "view all branches instead just the current one." Change to:
|
B5.0
11-Oct-08 |
||
| 35 |
#35144: "Just replace out <command> with..." How about:
|
B5.0
11-Oct-08 |
||
| 35 |
#35145: "Don't worry you have trouble installing the documentation, you can always access the documentation online at kernel.org..."
How about:
"D...more...
|
B5.0
11-Oct-08 |
||
| 35 |
#35146: "You have Git running, now it's time..." How about:
|
B5.0
11-Oct-08 |
||
| 36 |
#35147: "getting setup" How about "getting set up" or "getting ready" etc--Charlie O'Keefe |
B5.0
11-Oct-08 |
||
| 38 |
#35918: 2nd paragraph after the command snippet.
Each one marks the progression of you code.
should be
Each one marks the progression of YOUR...more...
|
B5.0
15-Nov-08 |
||
| 40 |
#35465: In the "what are SHA-1 hashes" box, the phrase "a unique
hash that has a small probability of ever colliding with another commit" is vague. H...more...
|
B5.0
26-Oct-08 |
||
| 42 |
#35681: 2nd last paragraph:
"That also introduces a new parameter to git log, the -1. You can change the number to limit the output of git log to the...more...
|
B5.0
07-Nov-08 |
||
| 42 |
#35440: Para:
We’ve got the basics—adding new files, modifying existing ones, and
looking at the repository’s history—out of the way; now let’s ge...more...
|
B5.0
25-Oct-08 |
||
| 43 |
#35677: At the bottom of the page it says: "Now you can add start making changes ..". Remove "add".--Magnus Skog |
B5.0
07-Nov-08 |
||
| 43 |
#36208: Last sentence on page says: Next up is a adding a link... Remove 'a' before adding.--Andy |
B5.0
01-Dec-08 |
||
| 45 |
#35919: 2nd to last paragraph Rebasing takes the changes from branch and replays them on top of another branch. should be "from a branch"--Shant Hovsepian |
B5.0
15-Nov-08 |
||
| 46 |
#35254: The word break
|
B5.0
15-Oct-08 |
||
| 48 |
#35441: First para: on—but every one of those in dependent on the tools and methods you use. should change "in" to "is": "those is dependent"--Robert Rainthorpe |
B5.0
25-Oct-08 |
||
| 48 |
#35520: In second paragraph from the end of the page:
It says:
"[...] and the directory where you want *to* repository to live. [...]'
I think it m...more...
|
B5.0
29-Oct-08 |
||
| 51 |
#36127: Near the end of the sentence immediately before the git clone command, "you can always clone the repository to get repository that I built": i...more...
|
B5.0
25-Nov-08 |
||
| 51 |
#35682: "Report erratum" only works on some pages of the pdf document, not all. For example page 50 and 51. I believe this is the same for all "new ch...more...
|
B5.0
07-Nov-08 |
||
| 51 |
#35683: At the bottom of the page it says: " .. either you one you created in the last chapter, or a cloning mine ..". Should probably be: " .. either...more...
|
B5.0
07-Nov-08 |
||
| 51 |
#35213: Change, "either you one you created in the last chapter, or a cloning mine" to "either the one you created in the last chapter, or a cloning of mine"--David M. Syzdek |
B5.0
13-Oct-08 |
||
| 51 |
#35255: "either you one you created in the last chapter, or a cloning mine" : The a is probably a typo.--Asgeir S. Nilsen |
B5.0
15-Oct-08 |
||
| 52 |
#35365: para.1 - change "rolls" to "roles"--russell muetzelfeldt |
B5.0
19-Oct-08 |
||
| 52 |
#35884: In the first paragraph, "git add feels both of these rolls" should read "git add fills both of these roles".--Nick Grimshaw |
B5.0
14-Nov-08 |
||
| 52 |
#35214: Change "git add feels both" to "git add fills both"--David M. Syzdek |
B5.0
13-Oct-08 |
||
| 52 |
#35215: Change, "a place that you can setup commits" to "a place where you can setup commits"--David M. Syzdek |
B5.0
13-Oct-08 |
||
| 52 |
#35221: Maybe change "name of a file or files" to "name of a file or the files"--David M. Syzdek |
B5.0
13-Oct-08 |
||
| 56 |
#35283: The part "Tracking empty directories" begins with this :
Git doesn’t doesn’t track directories.
It must by an error to have doesn't two time...more...
|
B5.0
16-Oct-08 |
||
| 57 |
#35256: "Like the -a> parameter" : Superfluous > character.--Asgeir S. Nilsen |
B5.0
15-Oct-08 |
||
| 64 |
#35758: Third para:
"Since I know that MacVim swap files always begin with a period and end with .swp, I just add .*.swp to the .gitignore and Git ig...more...
|
B5.0
10-Nov-08 |
||
| 65 |
#35759: First para:
"If the answer to that is yes, you need to ignore it by adding the rule the .gitignore file and committing that file to the repos...more...
|
B5.0
10-Nov-08 |
||
| 66 |
#35885: In the sentence "If you’ve skipped ahead, you can clone the repository from it’s GitHub repository" in the last paragraph, that "it's" should ...more...
|
B5.0
14-Nov-08 |
||
| 66 |
#35760: Last para:
|
B5.0
10-Nov-08 |
||
| 70 |
#35775: The first sentence beneath the "Straight Merging" header reads as follows: A straight merge takes one branch and merges it into the another br...more...
|
B5.0
10-Nov-08 |
||
| 71 |
#35100: It would be nice to describe what to do if a checkout or merge gets "fatal: Entry 'foo' not uptodate. Cannot merge."
Maybe there should be ...more...
|
B5.0
11-Oct-08 |
||
| 76 |
#35874: After running the git merge about2 command and explaining the CONFLICT line it reads:
"This is what my list from about.html looks like now:...more...
|
B5.0
13-Nov-08 |
||
| 76 |
#35875: Correction to my previous suggestion. I have just now looked at my about.html file and seen what I was supposed to see. The extract that I tho...more...
|
B5.0
13-Nov-08 |
||
| 78 |
#35101: It would be nice to describe what to do if you get "fatal: cannot do a partial commit during a merge." --Ken Shirriff |
B5.0
11-Oct-08 |
||
| 79 |
#35761: Top of page:
|
B5.0
10-Nov-08 |
||
| 83 |
#35366: in last para "Git has a lot of functionality for that looking through its logs that way", remove extra "that" (or rephrase entirely - it's pre...more...
|
B5.0
19-Oct-08 |
||
| 86 |
#35083: It would be nice to introduce the "tree-ish" concept, since it is used a lot in git documentation.--Ken Shirriff |
B5.0
10-Oct-08 |
||
| 87 |
#35185: [last paragraph]: Here’s the first first two lines
|
B5.0
13-Oct-08 |
||
| 88 |
#35433: In third paragraph starting from the end of the page.
It says:
"Using the -N notation allows you to subtract out that many lines.
You can u...more...
|
B5.0
24-Oct-08 |
||
| 90 |
#35186: Git tries to match at least three lines when it
Change to *detect* |
B5.0
13-Oct-08 |
||
| 91 |
#35452: Para starting: "As you can see, Git displays...", change
"show us when whole files can been copied"
to
"show us when whole files ha...more...
|
B5.0
26-Oct-08 |
||
| 101 |
#35923: In the first paragraph, "lets you share you work with others" should read "lets you share your work with others".--Nick Grimshaw |
B5.0
16-Nov-08 |
||
| 103 |
#35794: The SSH URL shown in Figure 7.1 is missing a colon, and will not work as shown. It should be "git@github.com:/tswicegood/mysite-chp6.git"--Diego Zamboni |
B5.0
11-Nov-08 |
||
| 104 |
#35411: "With the the git protocol," : One the to many.--Asgeir S. Nilsen |
B5.0
23-Oct-08 |
||
| 105 |
#35412: "it’s made simple by a program called Gitosis, which
we’ll cover in the (as yet) unwritten sec.gitosis."
This section is no longer unwritt...more...
|
B5.0
23-Oct-08 |
||
| 105 |
#35413: "Your local copy created by cloning works just like it would if you had created it yourself using git init like we talked about in the (as yet...more...
|
B5.0
23-Oct-08 |
||
| 105 |
#35768: Para three:
|
B5.0
10-Nov-08 |
||
| 106 |
#35793: After checking out mysite-chp6, "the two files we created earlier" should be "the five files we created earlier"--Diego Zamboni |
B5.0
11-Nov-08 |
||
| 107 |
#35914: When you discuss pushing changes to a remote git repository you don't make any mention of the fact that the git push won't update the local fi...more...
|
B5.0
15-Nov-08 |
||
| 107 |
#35924: In the second paragraph of section 7.4, "This is the step you go through to send your commits with another repository" should read "This is th...more...
|
B5.0
16-Nov-08 |
||
| 107 |
#35925: In the final paragraph when referring to the syntax of "git push", the text reads "The syntax the same"; it's missing an "is".--Nick Grimshaw |
B5.0
16-Nov-08 |
||
| 107 |
#35321: s7.4 footnote 1 indicates that pushing to a remote branch is not a common case. You need to do this to create the remote branches on github wh...more...
|
B5.0
17-Oct-08 |
||
| 109 |
#36168: "developer named Erin and you constantly pull changes from their repository" should be "*a* developer named Erin and you constantly pull chang...more...
|
B5.0
28-Nov-08 |
||
| 110 |
#35878: The box on "Adding a Remote Repository Later" is great, and addresses a common need. I believe it could be made better by briefly summarizing...more...
|
B5.0
13-Nov-08 |
||
| 113 |
#36181: the example: git tag contacts/1.1 contacts
doesn't work with the: git clone git://github.com/tswicegood/mysite-chp7.git
taken from the serve...more...
|
B5.0
29-Nov-08 |
||
| 113 |
#35785: Last prompt on the page:
"prompt> git checkout -b another-from-1.0"
Should this not read:
"prompt> git checkout -b another-from-1.0 1.0"?
...more...
|
B5.0
11-Nov-08 |
||
| 118 |
#35786: Last sentence, 5th para:
|
B5.0
11-Nov-08 |
||
| 119 |
#35495: The text reads as:
You can use the command on one line
without the “\.”, those are here to make the command fit on the page.
This shoul...more...
|
B5.0
27-Oct-08 |
||
| 119 |
#35496: The text reads as: You can use the command on one line without the “\.”, those are here to make the command fit on the page.
This should pr...more...
|
B5.0
27-Oct-08 |
||
| 120 |
#35928: There's a typo in the sentence "Now it's time to commit this changes" right before the commit of the submodules; it should read "these changes".--Nick Grimshaw |
B5.0
16-Nov-08 |
||
| 121 |
#35787: The top of the page is pretty much a repetition of the bottom of page 120.
I think you want to show the results of running "git submodule", n...more...
|
B5.0
11-Nov-08 |
||
| 124 |
#35081: I think the book should explain in more detail how git stores data: blob, tree, commit, and tag objects. This would clarify some things that ...more...
|
B5.0
10-Oct-08 |
||
| 125 |
#35789: 4th para:
|
B5.0
11-Nov-08 |
||
| 125 |
#35790: 5th para:
|
B5.0
11-Nov-08 |
||
| 128 |
#35791: 2nd para:
|
B5.0
11-Nov-08 |
||
| 130 |
#35792: 2nd last para:
|
B5.0
11-Nov-08 |
||
| 131 |
#35929: In the second paragraph, the sentence "... on page 66 we talked about how branches are just is a pointer to the latest commit in that line" ha...more...
|
B5.0
16-Nov-08 |
||
| 131 |
#35959: para. 7: "I shortened the commit on line the second line of the output so it would ..." should be "I shortened the commit on the second line o...more...
|
B5.0
17-Nov-08 |
||
| 139 |
#35797: I think the mapping of "svn commit" to "git add; git commit" is incomplete. It should also include "git push", since in svn every commit is se...more...
|
B5.0
11-Nov-08 |
||
| 142 |
#35326: Re Missing SVN/Core.pm : Shouldn't the instructions also mention Windows / Cygwin, perhaps by referring to the installation chapter?--Asgeir Nilsen |
B5.0
18-Oct-08 |
||
| 143 |
#35795: In the git svn clone command, the first option should be --prefix (with two dashes) instead of -prefix.--Diego Zamboni |
B5.0
11-Nov-08 |
||
| 145 |
#35243: "its" should be "it's" in "If its the first thing you do".--Andrew Grimm |
B5.0
14-Oct-08 |
||
| 146 |
#35930: In the second paragraph in the sentence "Also like it’s regular Git counterpart", that "it's" should be "its".--Nick Grimshaw |
B5.0
16-Nov-08 |
||
| 149 |
#35653: "so you have to get your hards a little" should be "so you have to get your hands a little"--Michael Manulis |
B5.0
06-Nov-08 |
||
| 150 |
#35932: In the second paragraph in the sentence "First, you can try to enlist the help of a sysadmin buddy bribing, err... paying him to help your out...more...
|
B5.0
16-Nov-08 |
||
| 156 |
#36178: "Setting this up requires a two steps." => "Setting this up requires two steps." |
B5.0
29-Nov-08 |
||
| 159 |
#35078: The Appendix appears as a subsection of Administration in the pdf structure (i.e. the left-hand tree in Adobe Reader).--Ken Shirriff |
B5.0
10-Oct-08 |
||
| 159 |
#35079: The Appendix appears as a subsection of Administration in the pdf structure (i.e. the left-hand tree in Adobe Reader).--Ken Shirriff |
B5.0
10-Oct-08 |
||
| 160 |
#35069: Shouldn't "git grep" get a mention in the book? It seems like a useful command to describe.--Ken Shirriff |
B5.0
10-Oct-08 |
||
| 165 |
#35796: The git tag command does not support the -r option as shown in "Show all remote tags".
|
B5.0
11-Nov-08 |
||
| 168 |
#35080: "It requires the TLC/TK" - should be "Tcl/Tk" (not all caps); it's Tcl, not TLC; and "the" shouldn't be there.--Ken Shirriff |
B5.0
10-Oct-08 |
||
| 168 |
#35070: "I like my development interfaces to all same font at the same size..." missing a "use the"?--Chris Barnett |
B5.0
10-Oct-08 |
||
| 170 |
#35072: "Eclispe Git Plugin" "Eclispe" -> "Eclipse" |
B5.0
10-Oct-08 |
||
| 171 |
#35102: "Vim, or it’s predecessor vi, are" - should be "its"--Ken Shirriff |
B5.0
11-Oct-08 |
||
| 171 |
#35103: "TicGit let’s you disconnect again" - should be "lets"--Ken Shirriff |
B5.0
11-Oct-08 |
||
| 172 |
#35104: "your current repository and and the branch you’re on" - repeated word--Ken Shirriff |
B5.0
11-Oct-08 |
||
| 172 |
#35105: "those who have setup Gitweb" - should be "set up"; "setup" is a noun--Ken Shirriff |
B5.0
11-Oct-08 |
||
| 172 |
#35106: "It is the hosting provider ...They offer several unique features." - singular/plural inconsistency. Should be "it" or "they" in both places.--Ken Shirriff |
B5.0
11-Oct-08 |
||
| 172 |
#35107: "The source for all thing’s Git" - should be "things"--Ken Shirriff |
B5.0
11-Oct-08 |
||
| 172 |
#35108: "is becoming stronger ever day." - "every day"--Ken Shirriff |
B5.0
11-Oct-08 |
