<div class="content">\r
<pre><tt>$ man git-diff</tt></pre>\r
</div></div>\r
+<p>It is a good idea to introduce yourself to git before doing any\r
+operation. The easiest way to do so is:</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>$ cat >~/.gitconfig <<\EOF\r
+[user]\r
+ name = Your Name Comes Here\r
+ email = you@yourdomain.example.com\r
+EOF</tt></pre>\r
+</div></div>\r
</div>\r
</div>\r
<h2>Importing a new project</h2>\r
</div></div>\r
<p>You've now initialized the working directory—you may notice a new\r
directory created, named ".git". Tell git that you want it to track\r
-every file under the current directory with</p>\r
+every file under the current directory with (notice the dot <em>.</em>\r
+that means the current directory):</p>\r
<div class="listingblock">\r
<div class="content">\r
<pre><tt>$ git add .</tt></pre>\r
<p>Finally,</p>\r
<div class="listingblock">\r
<div class="content">\r
-<pre><tt>$ git commit -a</tt></pre>\r
+<pre><tt>$ git commit</tt></pre>\r
</div></div>\r
<p>will prompt you for a commit message, then record the current state\r
of all the files to the repository.</p>\r
<p>to review your changes. When you're done,</p>\r
<div class="listingblock">\r
<div class="content">\r
-<pre><tt>$ git commit -a</tt></pre>\r
+<pre><tt>$ git commit file1 file2...</tt></pre>\r
</div></div>\r
<p>will again prompt your for a message describing the change, and then\r
-record the new versions of the modified files.</p>\r
+record the new versions of the files you listed. It is cumbersome\r
+to list all files and you can say <tt>-a</tt> (which stands for <em>all</em>)\r
+instead.</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>$ git commit -a</tt></pre>\r
+</div></div>\r
<p>A note on commit messages: Though not required, it's a good idea to\r
begin the commit message with a single short (less than 50 character)\r
line summarizing the change, followed by a blank line and then a more\r
<pre><tt>$ git add path/to/new/file</tt></pre>\r
</div></div>\r
<p>then commit as usual. No special command is required when removing a\r
-file; just remove it, then commit.</p>\r
+file; just remove it, then tell <tt>commit</tt> about the file as usual.</p>\r
<p>At any point you can view the history of your changes using</p>\r
<div class="listingblock">\r
<div class="content">\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 26-Nov-2006 07:28:21 UTC\r
+Last updated 29-Nov-2006 20:40:00 UTC\r
</div>\r
</div>\r
</body>\r
$ man git-diff
------------------------------------------------
+It is a good idea to introduce yourself to git before doing any
+operation. The easiest way to do so is:
+
+------------------------------------------------
+$ cat >~/.gitconfig <<\EOF
+[user]
+ name = Your Name Comes Here
+ email = you@yourdomain.example.com
+EOF
+------------------------------------------------
+
+
Importing a new project
-----------------------
You've now initialized the working directory--you may notice a new
directory created, named ".git". Tell git that you want it to track
-every file under the current directory with
+every file under the current directory with (notice the dot '.'
+that means the current directory):
------------------------------------------------
$ git add .
Finally,
------------------------------------------------
-$ git commit -a
+$ git commit
------------------------------------------------
will prompt you for a commit message, then record the current state
to review your changes. When you're done,
------------------------------------------------
-$ git commit -a
+$ git commit file1 file2...
------------------------------------------------
will again prompt your for a message describing the change, and then
-record the new versions of the modified files.
+record the new versions of the files you listed. It is cumbersome
+to list all files and you can say `-a` (which stands for 'all')
+instead.
+
+------------------------------------------------
+$ git commit -a
+------------------------------------------------
A note on commit messages: Though not required, it's a good idea to
begin the commit message with a single short (less than 50 character)
------------------------------------------------
then commit as usual. No special command is required when removing a
-file; just remove it, then commit.
+file; just remove it, then tell `commit` about the file as usual.
At any point you can view the history of your changes using