[MacPorts] WorkingWithGit modified

[MacPorts]

Page "WorkingWithGit" was changed by larryv
Diff URL: <https://trac.macports.org/wiki/WorkingWithGit?action=diff&version=61>
Revision 61
Comment: revise setup section
Changes:
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: WorkingWithGit
=========================================================================
--- WorkingWithGit (version: 60)
+++ WorkingWithGit (version: 61)
@@ -1,23 +1,27 @@
 = 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 at 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 at 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 ===
 To start working with git, you need a copy of the sources. Follow the sections for [#cloneports getting the ports tree] or [#clone MacPorts base], depending on where you want to make changes, then continue with the next section.
-------8<------8<------8<------8<------8<------8<------8<------8<--------

--
Page URL: <https://trac.macports.org/wiki/WorkingWithGit>
MacPorts <https://www.macports.org/>
Ports system for OS X

This is an automated message. Someone added your email address to be
notified of changes on 'WorkingWithGit' page.
If it was not you, please report to admin at macports.org.