Re: [PATCH] Documentation: Define symref and update HEAD description
On Sat, Nov 18, 2006 at 08:55:37PM CET, Junio C Hamano wrote:
Show 26 quoted lines
> Petr Baudis <pasky@suse.cz> writes:
>
> > HEAD was still described as a symlink instead of a symref.
> >...
> > HEAD::
> > + A symref (see glossary) to the `refs/heads/` namespace
> > + describing the currently active branch. It does not mean
> > + much if the repository is not associated with any working tree
> > (i.e. a 'bare' repository), but a valid git repository
> > + *must* have the HEAD file; some porcelains may use it to
> > + guess the designated "default" branch of the repository
> > + (usually 'master'). It is legal if the named branch
> > + 'name' does not (yet) exist. In some legacy setups, it is
> > + a symbolic link instead of a symref, but this has been
> > + deprecated long ago.
>
> We fully support dealing with repositories with symlinked HEAD,
> and will continue to do so; I do not think we ever talked about
> deprecating it. Public "distribution point" repositories that
> have been established long ago that do not have reason to switch
> HEAD to point at different branch still have symlinked HEAD and
> they should continue to work.
>
> What we _don't_ do these days is to set up new repositories with
> symlinked HEAD, but that does not have anything to do with
> deprecating symlinked HEAD.
That's true, perhaps "obsoleted" is a better word.
--
Petr "Pasky" Baudis
Stuff: http://pasky.or.cz/
The meaning of Stonehenge in Traflamadorian, when viewed from above, is:
"Replacement part being rushed with all possible speed."
Petr Baudis <pasky@suse.cz>