Re: [PATCH v3 2/5] doc: glossary: update per-worktree refs

[Junio C Hamano <gitster@pobox.com>]

Andy Koppe <andy.koppe@gmail.com> writes:

> diff --git a/Documentation/glossary-content.adoc b/Documentation/glossary-content.adoc
> index 668f309a6f..c7ab1c981f 100644
> --- a/Documentation/glossary-content.adoc
> +++ b/Documentation/glossary-content.adoc
> @@ -494,10 +494,23 @@ exclude;;
>  	interface than the <<def_plumbing,plumbing>>.
>  
>  [[def_per_worktree_ref]]per-worktree ref::
> -	Refs that are per-<<def_worktree,worktree>>, rather than
> -	global.  This is presently only <<def_HEAD,HEAD>> and any refs
> -	that start with `refs/bisect/`, but might later include other
> -	unusual refs.
> +	A <<def_ref,ref>> that is specific to a <<def_worktree,worktree>>,
> +	rather than shared between all worktrees. All <<def_root_ref,root refs>>,
> +	for example <<def_HEAD,HEAD>> and `ORIG_HEAD`, are per-worktree, as are
> +	refs with the following prefixes:
> ++
> +--
> + - `refs/bisect/`
> +
> + - `refs/rewritten/`
> +
> + - `refs/worktree/`
> +--

Very nice.  Do we want to mention, like the root refs whose names do
not end with HEAD, that we have no plan to add any new ones (in
other words, new ones are meant to be created under refs/worktree/)?

> +<<def_pseudoref,Pseudorefs>> are also specific to each worktree.

Prefix the last sentence with "Even though they are not refs, ",
perhaps?