]> git.ipfire.org Git - thirdparty/git.git/commit
Documentation/glossary: define root refs as refs
authorPatrick Steinhardt <ps@pks.im>
Wed, 15 May 2024 06:50:37 +0000 (08:50 +0200)
committerJunio C Hamano <gitster@pobox.com>
Wed, 15 May 2024 14:30:51 +0000 (07:30 -0700)
commit74b50a5881d3a43bc2bd466c01fa6e08849dc1d2
tree851c78878d029ccef68e87efe78d0cb76de857aa
parent29be36a2ea4a7d681f8318090a22b937756b89d0
Documentation/glossary: define root refs as refs

Except for the pseudorefs MERGE_HEAD and FETCH_HEAD, all refs that live
in the root of the ref hierarchy behave the exact same as normal refs.
They can be symbolic refs or direct refs and can be read, iterated over
and written via normal tooling. All of these refs are stored in the ref
backends, which further demonstrates that they are just normal refs.

Extend the definition of "ref" to also cover such root refs. The only
additional restriction for root refs is that they must conform to a
specific naming schema.

Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/glossary-content.txt