ÉlémentValeur
NomGENERATED-BY (BIND GENERATED-BY du document de spécification)
TAG ID0x1D3L
Codec ID0x00001D30
Document de spécification0x00000000/codecs/0x00001D30/ (cible du DECLARE 1D30)
Section14 1110 (Meta), décalage C dans la section = 19
KindMeta · classe : lignée
TAG WORD0001 1101 0011 LLLL (000K KKKC CCCC LLLL)
Description d’indexEntité génératrice. Personne, modèle, moteur de règles
Côté Hugometa/lineage/generated-by.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
1agent#2enregistrementN’importe quel enregistrement (hors marqueur d’emplacement)
2version#5enregistrement0720 UTF8-TEXT-EVEN, 0730 UTF8-TEXT-ODD, 0000 ABSENT (champ facultatif)

Indique l’entité qui a produit le document. Il peut s’agir d’une personne, d’un modèle ou d’un moteur de règles.

Disposition

TAG WORD          0001 1101 0011 LLLL      Codec 0x1D3L
[TAG d'extension Length]
Entité génératrice  Reference (personne, modèle, moteur de règles)
Version             Value UTF8-TEXT, ou marqueur d'omission 0x0000 (champ facultatif)
  • Codec : Meta 0x1D3L, classe lignée
  • Payload : Reference intégrée + texte de version (facultatif)
  • Nombre : plusieurs possibles

Interprétation et validité

  • S’il s’agit d’un modèle, on indique aussi la version du modèle.
  • Si la version est inconnue ou non indiquée, on omet cet emplacement et l’on met ABSENT (0x0000) (champ facultatif de CODEC). La spécification 0x1D30 de geul.org est faite de deux champs d’enregistrement : agent (sans CODEC) et version (0720, 0730, 0000).
  • Pour la version source (commit) d’un programme, le format de TRANSFORMED-BY (condensat, obligatoire) est plus exact. La version de GENERATED-BY sert à écrire en texte ce qui n’est pas un ID de commit, comme le nom et la version d’un modèle.
  • Dans les documents publiés sur geul.org, on ne place pas de Reference désignant une personne physique (Issuer et publication). On désigne une organisation ou un Issuer. À titre d’exception, désigner une personne physique par WIKIDATA-QID est admis.

Texte du document de spécification

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001D3000000000
BODY
#1 DECLARE 0x1D30
#2 FIELD #1 record
#3 BIND #1 "GENERATED-BY"
#4 BIND #2 "agent"
#5 FIELD #1 record
#6 BIND #5 "version"
#7 CODEC #5 0x0720
#8 CODEC #5 0x0730
#9 CODEC #5 0x0000