Should "git help" respect the 'pager' setting?

2013-05-30 Thread Michael Campbell
I have my global git config pager set to 'cat', but when I do a "git help ", it still uses a pager. This is especially irksome in emacs shell buffers, where I am most of the time. I know I can do a M-x man -> git-, but wondered if this was a bug or user error. ("gi

Re: [PATCH V3 1/5] Show help: -a and -g option, and 'git help ' usage.

2013-04-02 Thread Junio C Hamano
Philip Oakley writes: > Prepare for the addition of the -g --guides option to git help > and show that help is available for both concept guides, and commands. > > Signed-off-by: Philip Oakley > --- This should come at the end after you taught the "-g" option, I think

[PATCH V3 1/5] Show help: -a and -g option, and 'git help ' usage.

2013-04-02 Thread Philip Oakley
Prepare for the addition of the -g --guides option to git help and show that help is available for both concept guides, and commands. Signed-off-by: Philip Oakley --- git.c | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/git.c b/git.c index 39ba6b1..2f8aa41 100644 --- a

[PATCH V3 0/5] Git help option to list user guides

2013-04-02 Thread Philip Oakley
n, as they overide any remaining arguments. The list of guides is spaced out in the same manner as the common command list. Philip Oakley (5): Show help: -a and -g option, and 'git help ' usage. Help.c use OPT_BOOL and refactor logic Help.c add --guide option Help.c: add list_common_gu

Re: [PATCH] git help config: s/insn/instruction/

2013-03-28 Thread Junio C Hamano
Matthias Krüger writes: > On 03/28/2013 06:59 AM, Junio C Hamano wrote: >> Matthias Krüger writes: >> >>> "insn" appears to be an in-code abbreviation and should not appear in >>> manual/help pages. >>> --- >> Thanks; sign-off? > Oops, sorry. > > Signed-off-by: Matthias Krüger > > (Is this suf

Re: [PATCH] git help config: s/insn/instruction/

2013-03-28 Thread Matthias Krüger
On 03/28/2013 06:59 AM, Junio C Hamano wrote: Matthias Krüger writes: "insn" appears to be an in-code abbreviation and should not appear in manual/help pages. --- Thanks; sign-off? Oops, sorry. Signed-off-by: Matthias Krüger (Is this sufficient or do I have to re-send the patch with the

Re: [PATCH] git help config: s/insn/instruction/

2013-03-27 Thread Junio C Hamano
Matthias Krüger writes: > "insn" appears to be an in-code abbreviation and should not appear in > manual/help pages. > --- Thanks; sign-off? -- 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://vge

[PATCH] git help config: s/insn/instruction/

2013-03-27 Thread Matthias Krüger
"insn" appears to be an in-code abbreviation and should not appear in manual/help pages. --- Documentation/config.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/config.txt b/Documentation/config.txt index c1f435f..f79184c 100644 --- a/Documentation/config.tx

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-06 Thread Junio C Hamano
Michael J Gruber writes: > Well, even in the simple case one has to wonder: Why does the user > invoke help for "co"? There are two very likely cases: > > A) User does not remember what "co" is aliased to. > B) User wants to see the man page. > > If A is not the case then it's easy for the user t

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-06 Thread Michael J Gruber
Jeff King venit, vidit, dixit 05.03.2013 18:38: > On Tue, Mar 05, 2013 at 02:44:41PM +, Ævar Arnfjörð Bjarmason wrote: > >> Change the semantics of "git --help" to show the help for the >> command is aliased to, instead of just saying: >> >> `

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-05 Thread Jeff King
On Tue, Mar 05, 2013 at 02:44:41PM +, Ævar Arnfjörð Bjarmason wrote: > Change the semantics of "git --help" to show the help for the > command is aliased to, instead of just saying: > > `git ' is aliased to `' > > E.g. if you have &q

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-05 Thread Matthieu Moy
"H.Merijn Brand" writes: > A single word that is (already) known to git as being a valid command > to do --help with. I which case I fully agree. Just to insist on "that is known to git as being a valid command". Compare: $ git foo --help `git foo' is aliased to `bar' with $ git foo --help N

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-05 Thread Junio C Hamano
Ævar Arnfjörð Bjarmason writes: > No objection to the patch in principle though? I.e. not showing you > what the alias points to. I am not interested enough to even strongly object to such a change, because it is not reasonable to react with a "I know!" to the output of "git co --help", i.e. "'g

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-05 Thread Ævar Arnfjörð Bjarmason
On Tue, Mar 5, 2013 at 5:16 PM, Junio C Hamano wrote: > Ævar Arnfjörð Bjarmason writes: > >> Change the semantics of "git --help" to show the help for the >> command is aliased to, instead of just saying: >> >> `git ' is aliased to `' >

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-05 Thread Junio C Hamano
Ævar Arnfjörð Bjarmason writes: > Change the semantics of "git --help" to show the help for the > command is aliased to, instead of just saying: > > `git ' is aliased to `' > > E.g. if you have "checkout" aliased to "co" you won&#

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-05 Thread H.Merijn Brand
On Tue, 05 Mar 2013 16:42:52 +0100, Johannes Sixt wrote: > Am 3/5/2013 15:44, schrieb Ævar Arnfjörð Bjarmason: > > Change the semantics of "git --help" to show the help for the > > command is aliased to, instead of just saying: > > > > `git '

Re: [PATCH] help: show manpage for aliased command on git --help

2013-03-05 Thread Johannes Sixt
Am 3/5/2013 15:44, schrieb Ævar Arnfjörð Bjarmason: > Change the semantics of "git --help" to show the help for the > command is aliased to, instead of just saying: > > `git ' is aliased to `' > > E.g. if you have "checkout" aliased

[PATCH] help: show manpage for aliased command on git --help

2013-03-05 Thread Ævar Arnfjörð Bjarmason
Change the semantics of "git --help" to show the help for the command is aliased to, instead of just saying: `git ' is aliased to `' E.g. if you have "checkout" aliased to "co" you won't get: $ git co --help `git co' is aliased t

[PATCH v2 1/5] Show 'git help ' usage, with examples

2013-03-03 Thread Philip Oakley
The git(1) man page must be accessed via 'git help git' on Git for Windows as it has no 'man' command. And it prompts users to read the git(1) page, rather than hoping they follow a subsidiary link within another documentation page. The 'tutorial' is an obvious gu

[PATCH v2 0/5] [RESEND with Cc:] Git help option to list user guides

2013-03-03 Thread Philip Oakley
This is the much truncated (was 0/13] and updated series for noting that 'git help' can display the existing guides that are formatted as man pages, and providing a 'git help' option to list a few of the most useful guides. The series is rebased on top of V1.8.2-rc1 Differ

Re: [PATCH v2 1/5] Show 'git help ' usage, with examples

2013-03-03 Thread Junio C Hamano
Philip Oakley writes: > The git(1) man page must be accessed via 'git help git' on Git for Windows > as it has no 'man' command. And it prompts users to read the git(1) page, > rather than hoping they follow a subsidiary link within another > documentation pa

[PATCH v2 1/5] Show 'git help ' usage, with examples

2013-03-03 Thread Philip Oakley
The git(1) man page must be accessed via 'git help git' on Git for Windows as it has no 'man' command. And it prompts users to read the git(1) page, rather than hoping they follow a subsidiary link within another documentation page. The 'tutorial' is an obvious gu

[PATCH v2 0/5] Git help option to list user guides

2013-03-03 Thread Philip Oakley
This is the much truncated (was 0/13] and updated series for noting that 'git help' can display the existing guides that are formatted as man pages, and providing a 'git help' option to list a few of the most useful guides. The series is rebased on top of V1.8.2-rc1 Differ

Re: [git] [PATCH 02/13] Show 'git help ' usage, with examples

2013-02-24 Thread Philip Oakley
On 24/02/13 14:39, W. Trevor King wrote: On Sat, Feb 23, 2013 at 11:05:50PM +, Philip Oakley wrote: + "Examples: 'git help git', 'git help branch', 'git help tutorial'.."); This sentence should end in '.', not '..'.

Re: [git] [PATCH 02/13] Show 'git help ' usage, with examples

2013-02-24 Thread W. Trevor King
On Sat, Feb 23, 2013 at 11:05:50PM +, Philip Oakley wrote: > +"Examples: 'git help git', 'git help branch', 'git help > tutorial'.."); This sentence should end in '.', not '..'. Cheers, Trevor -- This email may

[PATCH 02/13] Show 'git help ' usage, with examples

2013-02-23 Thread Philip Oakley
The git(1) man page must be accessed via 'git help git' on Git for Windows as it has no 'man' command. And it prompts users to read the git(1) page, rather than hoping they follow a subsidiary link within another documentation page. The 'tutorial' is an obvious gu

[PATCH 00/13] Git help option to list user guides

2013-02-23 Thread Philip Oakley
The git help system will list common commands, and all commands if asked. However it is difficult for newer users to discover the guides that are available. This series seeks to add such an option to 'git help', and allow the user-manual and [git]everyday to be accessed in the same way

Re: Improve 'git help' with basic user guide linkss

2013-02-12 Thread Philip Oakley
From: "John Keeping" Sent: Tuesday, February 12, 2013 11:37 AM On Tue, Feb 12, 2013 at 11:11:17AM -, Philip Oakley wrote: Obviously (?) this is generated from the command-list.txt file, though I don't see a shell script that would generate the 'cmds-mainporcelain.txt' (etc.) files (//githu

Re: Improve 'git help' with basic user guide linkss

2013-02-12 Thread John Keeping
On Tue, Feb 12, 2013 at 11:11:17AM -, Philip Oakley wrote: > Obviously (?) this is generated from the command-list.txt file, though I > don't see a shell script that would generate the > 'cmds-mainporcelain.txt' (etc.) files > (//github.com/gitster/git-htmldocs). They are also part of the ms

Re: Improve 'git help' with basic user guide linkss

2013-02-12 Thread Philip Oakley
From: "Philip Oakley" Sent: Friday, February 08, 2013 11:16 PM From: "Junio C Hamano" Sent: Friday, February 08, 2013 10:54 PM "Philip Oakley" writes: My initial https://github.com/PhilipOakley/git/commit/e6217d simply updates - N_("See 'git h

Wishlist: git help bisect should mention "stop" keyword

2013-02-09 Thread Andreas Mohr
Hi, the man page (git version 1.7.10.4) is a bit non-symmetric since git bisect has the start param, but when searching for "stop" (nothing more obvious than that, right?), one comes up empty --> usability issue. The appropriate action complementary to start appears to be git bisect reset, thus i

Re: Improve 'git help' with basic user guide linkss

2013-02-08 Thread Philip Oakley
From: "Junio C Hamano" Sent: Friday, February 08, 2013 10:54 PM "Philip Oakley" writes: My initial https://github.com/PhilipOakley/git/commit/e6217d simply updates - N_("See 'git help ' for more information on a specific command."); + N_("See &

Re: Improve 'git help' with basic user guide linkss

2013-02-08 Thread Junio C Hamano
"Philip Oakley" writes: > My initial https://github.com/PhilipOakley/git/commit/e6217d simply > updates > - N_("See 'git help ' for more information on a specific > command."); > + N_("See 'git help ' for more information on a speci

Re: Improve 'git help' with basic user guide linkss

2013-02-08 Thread Philip Oakley
From: "Junio C Hamano" Sent: Friday, February 08, 2013 8:53 PM "Philip Oakley" writes: I'm looking at extending the 'git help' to include some information for the basic user who isn't ready for the extensive man page documentation for the various comma

Re: Improve 'git help' with basic user guide linkss

2013-02-08 Thread Junio C Hamano
"Philip Oakley" writes: > I'm looking at extending the 'git help' to include some information > for the basic user who isn't ready for the extensive man page > documentation for the various commands. We have pointers at the beginning of "git(1)

Improve 'git help' with basic user guide linkss

2013-02-08 Thread Philip Oakley
I'm looking at extending the 'git help' to include some information for the basic user who isn't ready for the extensive man page documentation for the various commands. If the user doesn't yet know which is the relevant command then they should also be offered a c

[PATCH 7/4] check-docs: drop git-help special-case

2012-08-08 Thread Jeff King
The check-docs target special-cases git-help to avoid mentioning it as "documented but removed". This dates back to the early implementation of git-help, when its code was simply included inside git.c. These days it is a full-fledged builtin (in builtin/help.c) and does not need spec

Re: [PATCH] Add help details to git help command. (This time with Perl)

2005-04-21 Thread David Greaves
We've decided to go for the individual scripts directly. :-) Just to clarify - individual scripts or $0 name handling? I kinda like one big script - also means we don't need to 'install' it to get access to Cogito.pm... Unfortunately, you didn't send the attachments inline, so I can't comment on

Re: [PATCH] Add help details to git help command. (This time with Perl)

2005-04-20 Thread Petr Baudis
Dear diary, on Tue, Apr 19, 2005 at 09:04:16PM CEST, I got a letter where David Greaves <[EMAIL PROTECTED]> told me that... > I don't love the 'require gitadd.pl' but it's a gradual start... I hate it, for one. ;-) > Cogito.pm seems to be a good place for the library stuff. Sounds sensible. > g

Re: [PATCH] Add help details to git help command. (This time with Perl)

2005-04-19 Thread David Greaves
Steven Cole wrote: Speaking of "I think", the name "cogito" was suggested for the SCM layer, but IIRC Linus suggested staying with just plain git. Petr suggested tig, perhaps because it looks at git from another point of view. I haven't read _all_ the mails - I thought cogito was kinda selected and

Re: [PATCH] Add help details to git help command. (This time with Perl)

2005-04-19 Thread Steven Cole
David Greaves wrote: Petr Baudis wrote: Dear diary, on Tue, Apr 19, 2005 at 07:35:15PM CEST, I got a letter where Steven Cole <[EMAIL PROTECTED]> told me that... I've been working on git.pl and getting help working nicely things to try: git.pl help git.pl add git.pl add --help git.pl add --man git.

Re: [PATCH] Add help details to git help command. (This time with Perl)

2005-04-19 Thread David Greaves
Petr Baudis wrote: Dear diary, on Tue, Apr 19, 2005 at 07:35:15PM CEST, I got a letter where Steven Cole <[EMAIL PROTECTED]> told me that... I've been working on git.pl and getting help working nicely things to try: git.pl help git.pl add git.pl add --help git.pl add --man git.pl help add The main

Re: [PATCH] Add help details to git help command. (This time with Perl)

2005-04-19 Thread Petr Baudis
Dear diary, on Tue, Apr 19, 2005 at 07:35:15PM CEST, I got a letter where Steven Cole <[EMAIL PROTECTED]> told me that... > Example: ..snip a perfect-looking example.. > - > Speaking of 'git diff', I ran that before applying the following patch, > and got a diff starting thusly: > > --- /

Re: [PATCH] Add help details to git help command. (This time with Perl)

2005-04-19 Thread Steven Cole
s the right thing for git help ci. Example: [EMAIL PROTECTED] git-pasky-testing]$ ./git help diff Make a diff between two GIT trees. By default compares the current working tree to the state at the last commit. You can specify -r rev1:rev2 or -r rev1 -r rev2 to tell it to make a diff between the specif

Re: [RFC] Another way to provide help details. (was Re: [PATCH] Add help details to git help command.)

2005-04-19 Thread Petr Baudis
Dear diary, on Tue, Apr 19, 2005 at 04:41:34PM CEST, I got a letter where David Greaves <[EMAIL PROTECTED]> told me that... > If Petr wants the top comment to be extracted by help then maybe a > bottom comment block could contain the more complete text? > I *really* think that the user docs should

Re: [RFC] Another way to provide help details. (was Re: [PATCH] Add help details to git help command.)

2005-04-19 Thread Steven Cole
David Greaves wrote: Petr Baudis wrote: Dear diary, on Tue, Apr 19, 2005 at 03:40:54AM CEST, I got a letter where Steven Cole <[EMAIL PROTECTED]> told me that... Here is perhaps a better way to provide detailed help for each git command. A command.help file for each command can be written in the s

Re: [RFC] Another way to provide help details. (was Re: [PATCH] Add help details to git help command.)

2005-04-19 Thread David Greaves
Petr Baudis wrote: Dear diary, on Tue, Apr 19, 2005 at 03:40:54AM CEST, I got a letter where Steven Cole <[EMAIL PROTECTED]> told me that... Here is perhaps a better way to provide detailed help for each git command. A command.help file for each command can be written in the style of a man page.

Re: [RFC] Another way to provide help details. (was Re: [PATCH] Add help details to git help command.)

2005-04-18 Thread Petr Baudis
Dear diary, on Tue, Apr 19, 2005 at 03:40:54AM CEST, I got a letter where Steven Cole <[EMAIL PROTECTED]> told me that... > Here is perhaps a better way to provide detailed help for each > git command. A command.help file for each command can be > written in the style of a man page. I don't like

[RFC] Another way to provide help details. (was Re: [PATCH] Add help details to git help command.)

2005-04-18 Thread Steven Cole
opyright notices. Here is perhaps a better way to provide detailed help for each git command. A command.help file for each command can be written in the style of a man page. The modfication to the main git script will be trivial. Here are the two commands I've done so far. What do folks t

Re: [PATCH] Add help details to git help command.

2005-04-18 Thread Steven Cole
atch myself... ;-) Also, you don't want to print the first newline and the Copyright notices. Fixed extra vertical whitespace, Copyright notice problems, and issue with git help ci. Here's a better version. Didn't fix the more interesting bugs, as I'm pressed for time (aren't we al

Re: [PATCH] Add help details to git help command.

2005-04-18 Thread Petr Baudis
Dear diary, on Mon, Apr 18, 2005 at 06:42:26AM CEST, I got a letter where Steven Cole <[EMAIL PROTECTED]> told me that... > There's a patch at the bottom of this, so please look at that first before > my reading my whining immediately below. > > I'm having some troubles with git pull, so this is j

[PATCH] Add help details to git help command.

2005-04-17 Thread Steven Cole
he above. Here is a patch which provides the comment lines in the associated script files when the git help command is invoked with an argument thusly: [EMAIL PROTECTED] git-pasky-new]$ ./git help merge Merge a branch to the current tree. Copyright (c) Petr Baudis, 2005 Takes a parameter ident

<    1   2