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