From: Junio C Hamano Date: Thu, 19 Jun 2008 00:32:24 GMT Subject: Re: [PATCH 1/4] Split up default "core" config parsing into helper routine Message-ID: <7vzlpiw9gn.fsf@gitster.siamese.dyndns.org> In-Reply-To: Linus Torvalds writes: > On Wed, 18 Jun 2008, Jeff King wrote: >> >> Have you read "man git-config" lately? > > That whole program is there just for scripting. Of _course_ it talks about > the machine format! > > Nobody should ever use "git-config" normally. You should fire up your > editor and just edit the damn file in place. But no, we don't have a > man-page for that. I was asked to proofread a git book somebody is starting to write, and the first thing the book taught was to use "config user.name". I gave a suggestion that we should not teach config as the first thing but instead we should show editing the $HOME/.gitconfig file manually, to give the feeling that what git deals with is approachable, but I realize the suggestion is not convincing when our own Documentation/gittutorial.txt does it fairly early in it, too.