Changes between Version 60 and Version 61 of WorkingWithGit

Timestamp:

Oct 30, 2016, 1:49:35 AM (8 years ago)

Author:

larryv (Lawrence Velázquez)

Comment:

revise setup section

WorkingWithGit

@@ -1 +1 @@
 = Working with Git =
 
-This document contains information about working with the [https://git-scm.com Git] version control system, tailored to developers familiar with [https://subversion.apache.org Subversion].
+This document is a guide to working with the [https://git-scm.com Git] version control system, tailored to developers familiar with [https://subversion.apache.org Subversion].
 
 [[PageOutline]]
 
-== Initial setup == #Initialsetup
-Git commits contain your name and email address. You should set them in your git configuration using the following commands:
-{{{
-git config --global user.name "Your Name"
-git config --global user.email YOUR_MACPORTS_HANDLE@macports.org
-}}}
-If you work on multiple Git projects and do not want to modify your email address for those, these commands can also be run without `--global` in a clone of MacPorts' repositories to only change the option for these repositories. If you are not a MacPorts committer, use any email address.
-
-
-
+
+== Basic setup == #setup
+
+Git commits identify authors and committers by name and email address. You will likely use the same name for all your Git projects, so you can set it in your `$HOME/.gitconfig` file with:
+{{{
+$ git config --global user.name 'Foo Barbaz'
+}}}
+
+On the other hand, you may want to reserve your MacPorts email address for MacPorts use. After cloning one of our repositories, you can set your email in `/path/to/MacPorts/repo/.git/config` with:
+{{{
+$ cd /path/to/MacPorts/repo
+$ git config user.email foobarbaz@macports.org
+}}}
+
+If you are not a MacPorts committer, feel free to use any email address.
 
 
 == Common `git` tasks & notes about MacPorts' Subversion export ==
-
 
 === Getting a working copy ===