Andrew's git
/
gitweb.git
/ diff
summary
|
log
|
commit
| diff |
tree
commit
grep
author
committer
pickaxe
?
re
Fix minor typos/grammar in user-manual.txt
author
Michael Coleman
<tutufan@gmail.com>
Wed, 28 Feb 2007 04:13:09 +0000
(22:13 -0600)
committer
Junio C Hamano
<junkio@cox.net>
Wed, 28 Feb 2007 05:24:56 +0000
(21:24 -0800)
Signed-off-by: Junio C Hamano <junkio@cox.net>
Documentation/user-manual.txt
patch
|
blob
|
history
raw
|
patch
|
inline
| side by side (parent:
0a43acb
)
diff --git
a/Documentation/user-manual.txt
b/Documentation/user-manual.txt
index c5e9ea8a428415940b04224b3ff902c609c9fc09..7b6dc22e7bad8bfc3d6f018e47e2025f2a1508ee 100644
(file)
--- a/
Documentation/user-manual.txt
+++ b/
Documentation/user-manual.txt
@@
-2,7
+2,7
@@
Git User's Manual
_________________
This manual is designed to be readable by someone with basic unix
_________________
This manual is designed to be readable by someone with basic unix
-commandline skills, but no previous knowledge of git.
+command
-
line skills, but no previous knowledge of git.
Chapter 1 gives a brief overview of git commands, without any
explanation; you may prefer to skip to chapter 2 on a first reading.
Chapter 1 gives a brief overview of git commands, without any
explanation; you may prefer to skip to chapter 2 on a first reading.
@@
-1196,7
+1196,7
@@
will be HEAD, the tip of the current branch; the other will be the
tip of the other branch, which is stored temporarily in MERGE_HEAD.
The diff above shows the differences between the working-tree version
tip of the other branch, which is stored temporarily in MERGE_HEAD.
The diff above shows the differences between the working-tree version
-of file.txt and two previous version: one version from HEAD, and one
+of file.txt and two previous version
s
: one version from HEAD, and one
from MERGE_HEAD. So instead of preceding each line by a single "+"
or "-", it now uses two columns: the first column is used for
differences between the first parent and the working directory copy,
from MERGE_HEAD. So instead of preceding each line by a single "+"
or "-", it now uses two columns: the first column is used for
differences between the first parent and the working directory copy,
@@
-1479,7
+1479,7
@@
Examining dangling objects
In some situations the reflog may not be able to save you. For
example, suppose you delete a branch, then realize you need the history
In some situations the reflog may not be able to save you. For
example, suppose you delete a branch, then realize you need the history
-it
pointed you
. The reflog is also deleted; however, if you have not
+it
contained
. The reflog is also deleted; however, if you have not
yet pruned the repository, then you may still be able to find
the lost commits; run git-fsck and watch for output that mentions
"dangling commits":
yet pruned the repository, then you may still be able to find
the lost commits; run git-fsck and watch for output that mentions
"dangling commits":
@@
-1505,7
+1505,7
@@
history that is described by all your existing branches and tags. Thus
you get exactly the history reachable from that commit that is lost.
(And notice that it might not be just one commit: we only report the
"tip of the line" as being dangling, but there might be a whole deep
you get exactly the history reachable from that commit that is lost.
(And notice that it might not be just one commit: we only report the
"tip of the line" as being dangling, but there might be a whole deep
-and complex commit history that was
gotten
dropped.)
+and complex commit history that was dropped.)
If you decide you want the history back, you can always create a new
reference pointing to it, for example, a new branch:
If you decide you want the history back, you can always create a new
reference pointing to it, for example, a new branch:
@@
-1561,7
+1561,7
@@
repository that you pulled from.
(But note that no such commit will be created in the case of a
<<fast-forwards,fast forward>>; instead, your branch will just be
(But note that no such commit will be created in the case of a
<<fast-forwards,fast forward>>; instead, your branch will just be
-updated to point to the latest commit from the upstream branch
).
+updated to point to the latest commit from the upstream branch
.)
The git-pull command can also be given "." as the "remote" repository,
in which case it just merges in a branch from the current repository; so
The git-pull command can also be given "." as the "remote" repository,
in which case it just merges in a branch from the current repository; so
@@
-1638,8
+1638,8
@@
updates with git pull>>".
If you and maintainer both have accounts on the same machine, then
then you can just pull changes from each other's repositories
If you and maintainer both have accounts on the same machine, then
then you can just pull changes from each other's repositories
-directly; note that all of the command (gitlink:git-clone[1],
-git-fetch[1], git-pull[1], etc.)
which
accept a URL as an argument
+directly; note that all of the command
s
(gitlink:git-clone[1],
+git-fetch[1], git-pull[1], etc.)
that
accept a URL as an argument
will also accept a local file patch; so, for example, you can
use
will also accept a local file patch; so, for example, you can
use
@@
-1832,7
+1832,7
@@
that makes it easy for them to read your changes, verify that they are
correct, and understand why you made each change.
If you present all of your changes as a single patch (or commit), they
correct, and understand why you made each change.
If you present all of your changes as a single patch (or commit), they
-may find it is too much to digest all at once.
+may find
that
it is too much to digest all at once.
If you present them with the entire history of your work, complete with
mistakes, corrections, and dead ends, they may be overwhelmed.
If you present them with the entire history of your work, complete with
mistakes, corrections, and dead ends, they may be overwhelmed.
@@
-1858,11
+1858,8
@@
you are rewriting history.
Keeping a patch series up to date using git-rebase
--------------------------------------------------
Keeping a patch series up to date using git-rebase
--------------------------------------------------
-Suppose you have a series of commits in a branch "mywork", which
-originally branched off from "origin".
-
-Suppose you create a branch "mywork" on a remote-tracking branch
-"origin", and created some commits on top of it:
+Suppose that you create a branch "mywork" on a remote-tracking branch
+"origin", and create some commits on top of it:
-------------------------------------------------
$ git checkout -b mywork origin
-------------------------------------------------
$ git checkout -b mywork origin
@@
-1966,7
+1963,7
@@
Other tools
-----------
There are numerous other tools, such as stgit, which exist for the
-----------
There are numerous other tools, such as stgit, which exist for the
-purpose of maintaining a patch series. These are out of the scope of
+purpose of maintaining a patch series. These are out
side
of the scope of
this manual.
Problems with rewriting history
this manual.
Problems with rewriting history
@@
-2088,7
+2085,7
@@
descendant of the old head, you may force the update with:
$ git fetch git://example.com/proj.git +master:refs/remotes/example/master
-------------------------------------------------
$ git fetch git://example.com/proj.git +master:refs/remotes/example/master
-------------------------------------------------
-Note the addition of the "+" sign. Be aware that commits
which
the
+Note the addition of the "+" sign. Be aware that commits
that
the
old version of example/master pointed at may be lost, as we saw in
the previous section.
old version of example/master pointed at may be lost, as we saw in
the previous section.
@@
-2096,7
+2093,7
@@
Configuring remote branches
---------------------------
We saw above that "origin" is just a shortcut to refer to the
---------------------------
We saw above that "origin" is just a shortcut to refer to the
-repository
which
you originally cloned from. This information is
+repository
that
you originally cloned from. This information is
stored in git configuration variables, which you can see using
gitlink:git-config[1]:
stored in git configuration variables, which you can see using
gitlink:git-config[1]:
@@
-2407,7
+2404,7
@@
conflicts between different tree objects, allowing each pathname to be
associated with sufficient information about the trees involved that
you can create a three-way merge between them.'
associated with sufficient information about the trees involved that
you can create a three-way merge between them.'
-Those are the
three ONLY
things that the directory cache does. It's a
+Those are the
ONLY three
things that the directory cache does. It's a
cache, and the normal operation is to re-generate it completely from a
known tree object, or update/compare it with a live tree that is being
developed. If you blow the directory cache away entirely, you generally
cache, and the normal operation is to re-generate it completely from a
known tree object, or update/compare it with a live tree that is being
developed. If you blow the directory cache away entirely, you generally