ПунктЗначение
ИмяSPEC-VERSION (BIND документа спецификации SPEC-VERSION)
TAG ID0x1C5L
Codec ID0x00001C50
Документ спецификации0x00000000/codecs/0x00001C50/ (цель DECLARE 1C50)
Раздел14 1110 (Meta), смещение в разделе C = 5
KindMeta · класс: объявление
TAG WORD0001 1100 0101 LLLL (000K KKKC CCCC LLLL)
Описание в индексеВерсия спецификации GEUL, которой следуют. Payload — это само unsigned целое наименьшей ширины. v1 — 0x0001 (запись 0x1C51 0x0001)
Сторона Hugometa/declaration/spec-version.md

Поля (документ спецификации)

Порядок FIELD в документе — это порядок полей Payload (Документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1version#2остаток, простое значение (0xFFFF)

Объявляет версию спецификации GEUL, которой следует документ. Как читать остальные записи, определяет это значение.

Раскладка

TAG WORD          0001 1100 0101 LLLL      Codec 0x1C5L
[Length — расширяющий TAG]
Payload           версия спецификации. v1 = 0x0001
  • Codec: Meta 0x1C5L, класс объявления
  • Payload: простое значение (unsigned целое наименьшей ширины)
  • Количество: не более одного

Интерпретация и валидность

  • Не опирается на коды Value. Чтобы декодер любой версии мог её прочитать, ставится просто целое число, без встроенного Value.
  • Если версия неизвестна, декодер отвергает документ или предупреждает.
  • Если записи нет, декодер читает документ по известной ему версии. Опубликованные документы её указывают.

Пример

  • 0x1C51 0x0001: GEUL v1

Открытые проблемы

Исходный текст документа спецификации

Документ спецификации 0x00000000/codecs/0x00001C50/latest.geul, прочитанный командой geul show (16-ричные значения в верхнем регистре).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001C5000000000
BODY
#1 DECLARE 0x1C50
#2 FIELD #1 rest
#3 BIND #1 "SPEC-VERSION"
#4 BIND #2 "version"