# [PATCH] git-prompt: Document GIT_PS1_DESCRIBE_STYLE

2 messages from 2012-12-11 to 2012-12-11. Participants: Anders Kaseorg, Junio C Hamano.
Thread: https://gitlist.dev/t/32318

## Anders Kaseorg, 2012-12-11 23:20

Subject: [PATCH] git-prompt: Document GIT_PS1_DESCRIBE_STYLE
Message-ID: <alpine.DEB.2.00.1212111815580.1093@dr-wily.mit.edu>
URL: https://gitlist.dev/e/alpine.DEB.2.00.1212111815580.1093%40dr-wily.mit.edu

```
GIT_PS1_DESCRIBE_STYLE was introduced in v1.6.3.2~35.  Document it in the 
header comments.

Signed-off-by: Anders Kaseorg <andersk@mit.edu>
---
 contrib/completion/git-prompt.sh | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/contrib/completion/git-prompt.sh b/contrib/completion/git-prompt.sh
index bf20491..5ab488c 100644
--- a/contrib/completion/git-prompt.sh
+++ b/contrib/completion/git-prompt.sh
@@ -49,6 +49,15 @@
 # find one, or @{upstream} otherwise.  Once you have set
 # GIT_PS1_SHOWUPSTREAM, you can override it on a per-repository basis by
 # setting the bash.showUpstream config variable.
+#
+# If you would like to see more information about the identity of
+# commits checked out as a detached HEAD, set GIT_PS1_DESCRIBE_STYLE
+# to one of these values:
+#
+#     contains      relative to newer annotated tag (v1.6.3.2~35)
+#     branch        relative to newer tag or branch (master~4)
+#     describe      relative to older annotated tag (v1.6.3.1-13-gdd42c2f)
+#     default       exactly matching tag
 
 # __gitdir accepts 0 or 1 arguments (i.e., location)
 # returns location of .git repo
-- 
1.8.0

```

## Junio C Hamano, 2012-12-11 23:36

Subject: Re: [PATCH] git-prompt: Document GIT_PS1_DESCRIBE_STYLE
Message-ID: <7v38zc6u13.fsf@alter.siamese.dyndns.org>
URL: https://gitlist.dev/e/7v38zc6u13.fsf%40alter.siamese.dyndns.org
In-Reply-To: <alpine.DEB.2.00.1212111815580.1093@dr-wily.mit.edu>

```
Anders Kaseorg <andersk@MIT.EDU> writes:

> GIT_PS1_DESCRIBE_STYLE was introduced in v1.6.3.2~35.  Document it in the 
> header comments.
>
> Signed-off-by: Anders Kaseorg <andersk@mit.edu>
> ---

Thanks.

>  contrib/completion/git-prompt.sh | 9 +++++++++
>  1 file changed, 9 insertions(+)
>
> diff --git a/contrib/completion/git-prompt.sh b/contrib/completion/git-prompt.sh
> index bf20491..5ab488c 100644
> --- a/contrib/completion/git-prompt.sh
> +++ b/contrib/completion/git-prompt.sh
> @@ -49,6 +49,15 @@
>  # find one, or @{upstream} otherwise.  Once you have set
>  # GIT_PS1_SHOWUPSTREAM, you can override it on a per-repository basis by
>  # setting the bash.showUpstream config variable.
> +#
> +# If you would like to see more information about the identity of
> +# commits checked out as a detached HEAD, set GIT_PS1_DESCRIBE_STYLE
> +# to one of these values:
> +#
> +#     contains      relative to newer annotated tag (v1.6.3.2~35)
> +#     branch        relative to newer tag or branch (master~4)
> +#     describe      relative to older annotated tag (v1.6.3.1-13-gdd42c2f)
> +#     default       exactly matching tag
>  
>  # __gitdir accepts 0 or 1 arguments (i.e., location)
>  # returns location of .git repo

```
