ÉlémentValeur
NomTAG (BIND TAG du document de spécification)
TAG ID0x1DAL
Codec ID0x00001DA0
Document de spécification0x00000000/codecs/0x00001DA0/ (cible du DECLARE 1DA0)
Section14 1110 (Meta), décalage C dans la section = 26
KindMeta · classe : lignée
TAG WORD0001 1101 1010 LLLL (000K KKKC CCCC LLLL)
Description d’indexNom immuable attribué à une version. Value TEXT et hachage du contenu (git annotated tag)
Côté Hugometa/lineage/tag.md

Champs (document de spécification)

L’ordre des FIELD dans le document est l’ordre des champs du Payload (document de spécification de Codec).

OrdreChamp (BIND)FIELDLargeurFormat reçu (CODEC)ENUM
1name#2enregistrement0720 UTF8-TEXT-EVEN, 0730 UTF8-TEXT-ODD
2target#7enregistrement07C0 SHA-256-DIGEST, 0000 ABSENT (champ facultatif)

Indique le nom immuable attribué à une version (git annotated tag).

Disposition

TAG WORD          0001 1101 1010 LLLL      Codec 0x1DAL
[TAG d'extension Length]
Nom               Value UTF8-TEXT-*
Cible             Value SHA-256-DIGEST, ou marqueur d'omission 0x0000 (champ facultatif). En cas d'omission, cette version
  • Codec : Meta 0x1DAL, classe lignée
  • Payload : Value intégrée (texte + hachage du contenu facultatif)
  • Nombre : plusieurs possibles

Interprétation et validité

  • Le nom est un UTF8-TEXT, la cible un SHA-256-DIGEST.
  • Si l’on omet la cible (ABSENT 0x0000, champ facultatif de CODEC), le nom est attribué à ce document lui-même. Son propre hachage du contenu ne peut pas être écrit en lui-même. La spécification 0x1DA0 de geul.org est faite de deux champs d’enregistrement : name (0720, 0730) et target (07C0, 0000).
  • On ne réemploie pas le même nom pour une autre version.

Exemple

  • Nom v1, cette version : 1DA3 0721 7631 0000

Problèmes ouverts

  • Le TAG est-il nécessaire alors qu’il existe un ID de version (numéro d’ordre) ?

Texte du document de spécification

Voici le document de spécification 0x00000000/codecs/0x00001DA0/latest.geul tel que lu par geul show (hexadécimal en majuscules).

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