ItemValue
NameTAG (spec document BIND TAG)
TAG ID0x1DAL
Codec ID0x00001DA0
Spec document0x00000000/codecs/0x00001DA0/ (DECLARE target 1DA0)
Section14 1110 (Meta), offset within section C = 10
KindMeta · class: lineage
TAG WORD0001 1101 1010 LLLL (000K KKKC CCCC LLLL)
Index descriptionAn immutable name given to a version. A TEXT Value and a content hash (git annotated tag)
Hugo sidemeta/lineage/tag.md

Fields (spec document)

The order of FIELDs within the document is the order of Payload fields (Codec spec document).

OrderField (BIND)FIELDWidthAccepted form (CODEC)ENUM
1name#2record0720 UTF8-TEXT-EVEN, 0730 UTF8-TEXT-ODD
2target#7record07C0 SHA-256-DIGEST, 0000 ABSENT (optional field)

Records an immutable name given to a version (git annotated tag).

Layout

TAG WORD          0001 1101 1010 LLLL      Codec 0x1DAL
[Length extension TAG]
Name              UTF8-TEXT-* Value
Target            SHA-256-DIGEST Value, or the omission marker 0x0000 (optional field). If omitted, this version
  • Codec: Meta 0x1DAL, lineage class
  • Payload: embedded Value (text + optional content hash)
  • Count: several allowed

Interpretation and validity

  • The name is UTF8-TEXT and the target is SHA-256-DIGEST.
  • If the target is omitted (ABSENT 0x0000, CODEC optional field), the name is attached to this document itself. A document cannot write its own content hash inside itself. The geul.org spec 0x1DA0 is a two-record-field spec: name (0720, 0730) and target (07C0, 0000).
  • Do not reuse the same name for another version.

Example

  • Name v1, this version: 1DA3 0721 7631 0000

Open issues

  • Whether TAG is needed at all when version IDs (sequence numbers) exist.

Spec document source

The spec document 0x00000000/codecs/0x00001DA0/latest.geul as read with geul show (hex in uppercase).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DA000000000
BODY
#1 DECLARE 0x1DA0
#2 FIELD #1 record
#3 BIND #1 "TAG"
#4 BIND #2 "name"
#5 CODEC #2 0x0720
#6 CODEC #2 0x0730
#7 FIELD #1 record
#8 BIND #7 "target"
#9 CODEC #7 0x07C0
#10 CODEC #7 0x0000