threads / patch / 4423

patchDocument git aliases support

Subject: [PATCH] Document git aliases support

## tl;dr

3 messages between Jun 7, 2006 and Jun 7, 2006. Diffs are folded; open one to read it.

replies: 2people: 2as markdown or json

Petr Baudis· Jun 7, 2006, 18:43 UTC · lore

This patch ports and modifies appropriately the git aliases documentation from my patch, shall it rest in peace.

Signed-off-by: Petr Baudis <pasky@suse.cz>
---
 Documentation/config.txt |    7 +++++++
 Documentation/git.txt    |    3 +++
 2 files changed, 10 insertions(+), 0 deletions(-)
Show changes to 2 files +10 −0

Documentation/config.txt, Documentation/git.txt

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· Jun 7, 2006, 18:58 UTC · re: Petr Baudis · lore

Re: [PATCH] Document git aliases support

Petr Baudis <pasky@suse.cz> writes:
>  Documentation/config.txt |    7 +++++++
>  Documentation/git.txt    |    3 +++
>  2 files changed, 10 insertions(+), 0 deletions(-)
Thanks.
Show 15 quoted lines
> 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· Jun 7, 2006, 20:11 UTC · re: Junio C Hamano · lore

Dear diary, on Wed, Jun 07, 2006 at 08:58:57PM CEST, I got a letter where Junio C Hamano <junkio@cox.net> said that...

Show 19 quoted lines
> Petr Baudis <pasky@suse.cz> 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 <pasky@suse.cz>
---
 Documentation/config.txt |    8 ++++++++
 Documentation/git.txt    |    3 +++
 2 files changed, 11 insertions(+), 0 deletions(-)
Show changes to 2 files +11 −0

Documentation/config.txt, Documentation/git.txt

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.

← back to recent threads