[PATCH v2 09/15] user-manual: Use 'git config --global user.*' for setup

2013-02-10 Thread W. Trevor King
From: W. Trevor King wk...@tremily.us

A simple command line call is easier than spawning an editor,
especially for folks new to ideas like the command line and text
editors.  This is also the approach suggested by 'git commit' if you
try and commit without having configured user.name or user.email.

Signed-off-by: W. Trevor King wk...@tremily.us
---
 Documentation/user-manual.txt | 18 +-
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index 8bf37b3..e2e0c86 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -991,9 +991,16 @@ Developing with Git
 Telling Git your name
 -
 
-Before creating any commits, you should introduce yourself to Git.  The
-easiest way to do so is to make sure the following lines appear in a
-file named `.gitconfig` in your home directory:
+Before creating any commits, you should introduce yourself to Git.
+The easiest way to do so is to use linkgit:git-config[1]:
+
+
+$ git config --global user.name 'Your Name Comes Here'
+$ git config --global user.email 'y...@yourdomain.example.com'
+
+
+Which will add the following stanza to a file named `.gitconfig` in
+your home directory:
 
 
 [user]
@@ -1001,8 +1008,9 @@ file named `.gitconfig` in your home directory:
email = y...@yourdomain.example.com
 
 
-(See the CONFIGURATION FILE section of linkgit:git-config[1] for
-details on the configuration file.)
+See the CONFIGURATION FILE section of linkgit:git-config[1] for
+details on the configuration file.  The file is plain text, so you can
+also edit it with your favorite editor.
 
 
 [[creating-a-new-repository]]
-- 
1.8.1.336.g94702dd

--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Re: [PATCH v2 09/15] user-manual: Use 'git config --global user.*' for setup

2013-02-10 Thread Junio C Hamano
W. Trevor King wk...@tremily.us writes:

 From: W. Trevor King wk...@tremily.us

 A simple command line call is easier than spawning an editor,
 especially for folks new to ideas like the command line and text
 editors.  This is also the approach suggested by 'git commit' if you
 try and commit without having configured user.name or user.email.

 Signed-off-by: W. Trevor King wk...@tremily.us
 ---
  Documentation/user-manual.txt | 18 +-
  1 file changed, 13 insertions(+), 5 deletions(-)

 diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
 index 8bf37b3..e2e0c86 100644
 --- a/Documentation/user-manual.txt
 +++ b/Documentation/user-manual.txt
 @@ -991,9 +991,16 @@ Developing with Git
  Telling Git your name
  -
  
 -Before creating any commits, you should introduce yourself to Git.  The
 -easiest way to do so is to make sure the following lines appear in a
 -file named `.gitconfig` in your home directory:
 +Before creating any commits, you should introduce yourself to Git.
 +The easiest way to do so is to use linkgit:git-config[1]:
 +
 +
 +$ git config --global user.name 'Your Name Comes Here'
 +$ git config --global user.email 'y...@yourdomain.example.com'
 +
 +
 +Which will add the following stanza to a file named `.gitconfig` in
 +your home directory:

Looks good, even though I do not think we would want/need to confuse
the readers with an unfamiliar word stanza.

 @@ -1001,8 +1008,9 @@ file named `.gitconfig` in your home directory:
   email = y...@yourdomain.example.com
  
  
 -(See the CONFIGURATION FILE section of linkgit:git-config[1] for
 -details on the configuration file.)
 +See the CONFIGURATION FILE section of linkgit:git-config[1] for
 +details on the configuration file.  The file is plain text, so you can
 +also edit it with your favorite editor.
  
  
  [[creating-a-new-repository]]

--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Re: [PATCH v2 09/15] user-manual: Use 'git config --global user.*' for setup

2013-02-10 Thread W. Trevor King
On Sun, Feb 10, 2013 at 02:12:05PM -0800, Junio C Hamano wrote:
  +Which will add the following stanza to a file named `.gitconfig` in
  +your home directory:
 
 Looks good, even though I do not think we would want/need to confuse
 the readers with an unfamiliar word stanza.

Aw.  I suppose section is better?  (It's what Python's ConfigParser
uses anyway).  I saw stanza in another part of the manual and
thought it was quite poetic ;).

-- 
This email may be signed or encrypted with GnuPG (http://www.gnupg.org).
For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy


signature.asc
Description: OpenPGP digital signature


Re: [PATCH v2 09/15] user-manual: Use 'git config --global user.*' for setup

2013-02-10 Thread Junio C Hamano
W. Trevor King wk...@tremily.us writes:

 On Sun, Feb 10, 2013 at 02:12:05PM -0800, Junio C Hamano wrote:
  +Which will add the following stanza to a file named `.gitconfig` in
  +your home directory:
 
 Looks good, even though I do not think we would want/need to confuse
 the readers with an unfamiliar word stanza.

 Aw.  I suppose section is better?  (It's what Python's ConfigParser
 uses anyway).  I saw stanza in another part of the manual and
 thought it was quite poetic ;).

How about not saying anything and say adds the following?
--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html