# [PATCH] Document git aliases support 3 messages from 2006-06-07 to 2006-06-07. Participants: Petr Baudis, Junio C Hamano. Thread: https://gitlist.dev/t/4423 ## Petr Baudis, 2006-06-07 18:43 Subject: [PATCH] Document git aliases support Message-ID: <20060607184350.31338.46653.stgit@machine.or.cz> URL: https://gitlist.dev/e/20060607184350.31338.46653.stgit%40machine.or.cz ``` This patch ports and modifies appropriately the git aliases documentation from my patch, shall it rest in peace. Signed-off-by: Petr Baudis --- Documentation/config.txt | 7 +++++++ Documentation/git.txt | 3 +++ 2 files changed, 10 insertions(+), 0 deletions(-) diff --git a/Documentation/config.txt b/Documentation/config.txt index c861c6c..ad9ec3e 100644 --- a/Documentation/config.txt +++ b/Documentation/config.txt @@ -91,6 +91,13 @@ core.warnAmbiguousRefs:: If true, git will warn you if the ref name you passed it is ambiguous and might match multiple refs in the .git/refs/ tree. True by default. +alias.*:: + Command aliases for the gitlink:git[1] command wrapper - e.g. + after defining "alias.last = cat-file commit HEAD", the invocation + "git last" is equivalent to "git cat-file commit HEAD". You cannot + override even existing command names with aliases. Arguments are + split by spaces, the usual shell quoting and escaping is supported. + apply.whitespace:: Tells `git-apply` how to handle whitespaces, in the same way as the '--whitespace' option. See gitlink:git-apply[1]. diff --git a/Documentation/git.txt b/Documentation/git.txt index 24ca55d..e474bdf 100644 --- a/Documentation/git.txt +++ b/Documentation/git.txt @@ -21,6 +21,9 @@ link:everyday.html[Everyday Git] for a u "man git-commandname" for documentation of each command. CVS users may also want to read link:cvs-migration.html[CVS migration]. +The COMMAND is either a name of a Git command (see below) or an alias +as defined in the configuration file (see gitlink:git-repo-config[1]). + OPTIONS ------- --version:: ``` ## Junio C Hamano, 2006-06-07 18:58 Subject: Re: [PATCH] Document git aliases support Message-ID: <7vzmgog5ce.fsf@assigned-by-dhcp.cox.net> URL: https://gitlist.dev/e/7vzmgog5ce.fsf%40assigned-by-dhcp.cox.net In-Reply-To: <20060607184350.31338.46653.stgit@machine.or.cz> ``` Petr Baudis writes: > Documentation/config.txt | 7 +++++++ > Documentation/git.txt | 3 +++ > 2 files changed, 10 insertions(+), 0 deletions(-) Thanks. > diff --git a/Documentation/config.txt b/Documentation/config.txt > index c861c6c..ad9ec3e 100644 > --- a/Documentation/config.txt > +++ b/Documentation/config.txt > @@ -91,6 +91,13 @@ core.warnAmbiguousRefs:: > If true, git will warn you if the ref name you passed it is ambiguous > and might match multiple refs in the .git/refs/ tree. True by default. > > +alias.*:: > + Command aliases for the gitlink:git[1] command wrapper - e.g. > + after defining "alias.last = cat-file commit HEAD", the invocation > + "git last" is equivalent to "git cat-file commit HEAD". You cannot > + override even existing command names with aliases. Arguments are > + split by spaces, the usual shell quoting and escaping is supported. > + "even"? How about: "alias that hides existing command names are not used to avoid confusion"? ``` ## Petr Baudis, 2006-06-07 20:11 Subject: [PATCH] Document git aliases support Message-ID: <20060607201134.GC2609@pasky.or.cz> URL: https://gitlist.dev/e/20060607201134.GC2609%40pasky.or.cz In-Reply-To: <7vzmgog5ce.fsf@assigned-by-dhcp.cox.net> ``` Dear diary, on Wed, Jun 07, 2006 at 08:58:57PM CEST, I got a letter where Junio C Hamano said that... > Petr Baudis writes: > > diff --git a/Documentation/config.txt b/Documentation/config.txt > > index c861c6c..ad9ec3e 100644 > > --- a/Documentation/config.txt > > +++ b/Documentation/config.txt > > @@ -91,6 +91,13 @@ core.warnAmbiguousRefs:: > > If true, git will warn you if the ref name you passed it is ambiguous > > and might match multiple refs in the .git/refs/ tree. True by default. > > > > +alias.*:: > > + Command aliases for the gitlink:git[1] command wrapper - e.g. > > + after defining "alias.last = cat-file commit HEAD", the invocation > > + "git last" is equivalent to "git cat-file commit HEAD". You cannot > > + override even existing command names with aliases. Arguments are > > + split by spaces, the usual shell quoting and escaping is supported. > > + > > "even"? How about: "alias that hides existing command names are > not used to avoid confusion"? Oops, that "even" was not meant to be there. I have rephrased it a bit. --- This patch ports and modifies appropriately the git aliases documentation from my patch, shall it rest in peace. Signed-off-by: Petr Baudis --- Documentation/config.txt | 8 ++++++++ Documentation/git.txt | 3 +++ 2 files changed, 11 insertions(+), 0 deletions(-) diff --git a/Documentation/config.txt b/Documentation/config.txt index c861c6c..91615c1 100644 --- a/Documentation/config.txt +++ b/Documentation/config.txt @@ -91,6 +91,14 @@ core.warnAmbiguousRefs:: If true, git will warn you if the ref name you passed it is ambiguous and might match multiple refs in the .git/refs/ tree. True by default. +alias.*:: + Command aliases for the gitlink:git[1] command wrapper - e.g. + after defining "alias.last = cat-file commit HEAD", the invocation + "git last" is equivalent to "git cat-file commit HEAD". It is not + allowed to redefine existing command names using aliases to avoid + confusion and troubles with script usage. Arguments are split by + spaces, the usual shell quoting and escaping is supported. + apply.whitespace:: Tells `git-apply` how to handle whitespaces, in the same way as the '--whitespace' option. See gitlink:git-apply[1]. diff --git a/Documentation/git.txt b/Documentation/git.txt index 24ca55d..e474bdf 100644 --- a/Documentation/git.txt +++ b/Documentation/git.txt @@ -21,6 +21,9 @@ link:everyday.html[Everyday Git] for a u "man git-commandname" for documentation of each command. CVS users may also want to read link:cvs-migration.html[CVS migration]. +The COMMAND is either a name of a Git command (see below) or an alias +as defined in the configuration file (see gitlink:git-repo-config[1]). + OPTIONS ------- --version:: -- Petr "Pasky" Baudis Stuff: http://pasky.or.cz/ A person is just about as big as the things that make them angry. ```