mirrors/git
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update tutorial for simplified "git" script.

Browse Source 
Use "git commit" instead of "git-commit-script", and talk about using
"git log" before introducing the more complex "git-whatchanged".

In short, try to make it feel a bit more normal to those poor souls
using CVS.

Do some whitspace edits too, to make the side notes stand out a bit
more.
This commit is contained in:
Linus Torvalds 2005-06-01 09:27:22 -07:00
parent e764b8e8b3
commit 81bb573ed8
1 changed files with 19 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
Documentation/tutorial.txt
View File

@ -346,7 +346,7 @@ script for doing all of the non-initial commits that does all of this
for you, and starts up an editor to let you write your commit message for you, and starts up an editor to let you write your commit message
yourself, so let's just use that: yourself, so let's just use that:
git-commit-script git commit
Write whatever message you want, and all the lines that start with '#' Write whatever message you want, and all the lines that start with '#'
will be pruned out, and the rest will be used as the commit message for will be pruned out, and the rest will be used as the commit message for
@ -398,14 +398,25 @@ changes. A trivial (but very useful) script called "git-whatchanged" is
included with git which does exactly this, and shows a log of recent included with git which does exactly this, and shows a log of recent
activity. activity.
To see the whole history of our pitiful little git-tutorial project, we To see the whole history of our pitiful little git-tutorial project, you
can do can do
git log
which shows just the log messages, or if we want to see the log together
whith the associated patches use the more complex (and much more
powerful)
git-whatchanged -p --root git-whatchanged -p --root
(the "--root" flag is a flag to git-diff-tree to tell it to show the and you will see exactly what has changed in the repository over its
initial aka "root" commit as a diff too), and you will see exactly what short history.
has changed in the repository over its short history.
[ Side note: the "--root" flag is a flag to git-diff-tree to tell it to
show the initial aka "root" commit too. Normally you'd probably not
want to see the initial import diff, but since the tutorial project
was started from scratch and is so small, we use it to make the result
a bit more interesting ]
With that, you should now be having some inkling of what git does, and With that, you should now be having some inkling of what git does, and
can explore on your own. can explore on your own.