Skip to content

Commit 6018ca1

Browse files
committed
Minor tweaks/grammar/clarification fixes for "Plumbing and Porcelain"
I changed the words "verbs" to "subcommands" since many Git commands don't qualify as verbs -- things like "remote" and "log" and "status".
1 parent d0e48f4 commit 6018ca1

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

book/10-git-internals/sections/plumbing-porcelain.asc

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
[[_plumbing_porcelain]]
22
=== Plumbing and Porcelain
33

4-
This book covers how to use Git with 30 or so verbs such as `checkout`, `branch`, `remote`, and so on.
5-
But because Git was initially a toolkit for a VCS rather than a full user-friendly VCS, it has a bunch of verbs that do low-level work and were designed to be chained together UNIX-style or called from scripts.
6-
These commands are generally referred to as ``plumbing'' commands, and the more user-friendly commands are called ``porcelain'' commands.
4+
This book covers primarily how to use Git with 30 or so subcommands such as `checkout`, `branch`, `remote`, and so on.
5+
But because Git was initially a toolkit for a version control system rather than a full user-friendly VCS, it has a number of subcommands that do low-level work and were designed to be chained together UNIX-style or called from scripts.
6+
These commands are generally referred to as Git's ``plumbing'' commands, while the more user-friendly commands are called ``porcelain'' commands.
77

8-
The book's first nine chapters deal almost exclusively with porcelain commands.
8+
As you will have have noticed by now, this book's first nine chapters deal almost exclusively with porcelain commands.
99
But in this chapter, you'll be dealing mostly with the lower-level plumbing commands, because they give you access to the inner workings of Git, and help demonstrate how and why Git does what it does.
1010
Many of these commands aren't meant to be used manually on the command line, but rather to be used as building blocks for new tools and custom scripts.
1111

1212
When you run `git init` in a new or existing directory, Git creates the `.git` directory, which is where almost everything that Git stores and manipulates is located.
1313
If you want to back up or clone your repository, copying this single directory elsewhere gives you nearly everything you need.
14-
This entire chapter basically deals with the stuff in this directory.
15-
Here's what it looks like:
14+
This entire chapter basically deals with what you can see in this directory.
15+
Here's what a newly-initialized `.git` directory typically looks like:
1616

1717
[source,console]
1818
----
@@ -26,7 +26,7 @@ objects/
2626
refs/
2727
----
2828

29-
You may see some other files in there, but this is a fresh `git init` repository it's what you see by default.
29+
Depending on your version of Git, you may see some additional content there, but this is a fresh `git init` repository -- it's what you see by default.
3030
The `description` file is used only by the GitWeb program, so don't worry about it.
3131
The `config` file contains your project-specific configuration options, and the `info` directory keeps a global exclude file (((excludes))) for ignored patterns that you don't want to track in a `.gitignore` file.
3232
The `hooks` directory contains your client- or server-side hook scripts, which are discussed in detail in <<_git_hooks>>.

0 commit comments

Comments
 (0)