gawkworkflow: Configuring git

1 
1 3 Configuring Global Settings For Git
1 *************************************
1 
1 Before starting to use Git, you should configure it with some important
1 settings that won't change as you use Git.  You may configure options
1 both globally, and on a per-repository basis.  Here, we discuss only
1 global configuration settings.
1 
1    You can configure Git using either 'git config', or by editing the
1 relevant files with your favorite text editor.(1)
1 
1    The first things to set are your email address and your real name:
1 
1      $ git config --global user.name "J.P. Developer"     Set full name
1      $ git config --global user.email jpdev@example.com   Set email address
1 
11    Setting these two items are an absolute requirement.  ⇒* No
 aliases are allowed.  If you can't supply your real name, you cannot
1 contribute to the project.  Other options that the 'gawk' maintainer
1 recommends that you use are:
1 
1      $ git config --global push.default=simple    Only push current branch
1      $ git config --global pager.status=true      Use pager for output of git status
1 
1    The global settings are stored in the '.gitconfig' file in your home
1 directory.  The file looks like this:
1 
1      [user]
1              name = J.P. Developer
1              email = jpdev@example.com
1      [push]
1              default = simple
1      [pager]
1              status = true
1 
1    The 'push.default=simple' setting ensures that older versions of Git
1 only push the current branch up to the Savannah repo.  This is the
1 safest way to operate, and is the default in current Git versions.
1 
1    There may be other settings in your configuration file as well.  Use
1 'git config' to see your settings:
1 
1      $ git config --list
1      -| user.name=J.P. Developer
1      -| user.email=jpdev@example.com
1      -| push.default=simple
1 
1    Here are the 'gawk' maintainer's settings:
1 
1      $ git config --global --list
1      -| user.name=Arnold D. Robbins
1      -| user.email=arnold@...
1      -| credential.helper=cache --timeout=3600
1      -| push.default=simple
1      -| color.ui=false
1      -| core.autocrlf=input
1      -| pager.status=true
1      -| log.decorate=auto
1 
1    Additional, per-project ("local") settings are stored in each repo's
1 '.git/config' file.
1 
1    ---------- Footnotes ----------
1 
1    (1) You are required to use either Vim or Emacs, other text editors
1 are not allowed.  Of course, reasonable developers wouldn't want to use
1 any other editor anyway.
1