From: Felipe Contreras Date: Sun, 11 Oct 2009 20:43:05 GMT Subject: [PATCH 1/2] user-manual: add global config section Message-ID: <1255293786-17293-2-git-send-email-felipe.contreras@gmail.com> In-Reply-To: <1255293786-17293-1-git-send-email-felipe.contreras@gmail.com> So that users get to know how to configure git from the get-to with good practical example (color.ui = auto) that most people would probably like anyway. Signed-off-by: Felipe Contreras --- Documentation/user-manual.txt | 27 +++++++++++++++++++++++++++ 1 files changed, 27 insertions(+), 0 deletions(-) diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index 67ebffa..ff2563a 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -40,6 +40,33 @@ without any explanation. Finally, see <> for ways that you can help make this manual more complete. +[[getting-started]] +Getting started +============= + +Git's configuration is distributed among different locations--this manual will +only to deal with 'global' (for the user) and 'repository' variables, where +'repository' variables take precedence over 'global' ones. + +You would probably want to start setting up something useful: +------------------------------------------------ +$ git config --global color.ui auto +------------------------------------------------ + +This will make prettier the output of certain commands such as `git diff`, but +that's not important; what is important here is that `color.ui` has been +stored in the 'global' configuration. + +View and manually modify the configuration by opening `~/.gitconfig`: +------------------------------------------------ +[color] + ui = auto +------------------------------------------------ + +Other locations are `/etc/gitconfig` (system), and `.git/config` (repository). + +More git configurations will be covered in the rest of the manual, if you want +to learn more look at linkgit:git-config[1] for details. [[repositories-and-branches]] Repositories and Branches -- 1.6.5.4.g31fc3