ПунктЗначение
ИмяDOC-POINTER (BIND DOC-POINTER в документе спецификации)
TAG ID0x041L
Codec ID0x00000410
Документ спецификации0x00000000/codecs/0x00000410/ (цель DECLARE 0410)
Раздел2 0010 (Reference прочее), смещение внутри раздела C = 1
KindReference · классификация: указание-объявление
TAG WORD0000 0100 0001 LLLL (000K KKKC CCCC LLLL)
Сторона Hugoreference/doc-pointer.md

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

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

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

DOC-POINTER — указывающе-объявляющий Reference, указывающий на одну версию документа, опубликованного Issuer. Он становится целью публикации, deprecate и удаления документа, цитируемой редакции и высказываний о документе.

Раскладка

TAG WORD          0000 0100 0001 LLLL      Codec 0x041L
[расширяющий TAG Length]
Issuer            2/4/16 WORD
ID документа      4 WORD
ID версии         2 WORD

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

  • Ширина Issuer — остаток Payload после вычитания ID документа и ID версии (6 WORD). Codec ширину не делит. Если ширина не 2, 4, 16 WORD или значение Issuer помещается в более узкую ширину, это invalid (каноническая форма Issuer).
  • ID версии не опускают. Если разрешить опускание, ширину Issuer нельзя будет определить по одной длине Payload (Issuer 4 WORD без версии и Issuer 2 WORD с версией дают одинаковые 8 WORD).
  • ID версии 0 — последняя версия. Он привязывается к действующей версии на момент интерпретации. Остальные значения фиксируются на этой версии (PUBLICATION).
  • Документ с ID 0 — индексный документ определений терминов Issuer. На сам Issuer указывают через ISSUER-POINTER.
  • Каждый Issuer резервирует ID документа 0x0000000000000000 и 0xFFFFFFFFFFFFFFFF (Issuer и публикация). 0xFFFFFFFFFFFFFFFF используется для списка Issuer issuers/ у Issuer 0x00000000, другие Issuer его не используют. PUBLICATION, DEPRECATION и TOMBSTONE в issuers/versions.geul указывают этим значением на версии списка (адреса публикации и список версий).
  • Это одна ячейка Codec 0x041L. Квантификации нет (Identified).
  • Форма для указания на документ Issuer — только DOC-POINTER. Указывать на документ через EXTERNAL-ISSUER-* (Issuer, ID документа, ID цели 0) или EXTERNAL-POINTER-* (IMPORT ID, ID цели 0) — invalid.
  • Где используется: Meta DOC-ID и IMPORT-DOC, PUBLICATION, DEPRECATION и TOMBSTONE в списке версий.
  • У документа кодека нет ID документа. На документ кодека и его версию указывают через CODEC-POINTER.

Пример

Документ 0xFFFF000000000001 Issuer GEUL 0x00000000.

ВерсияWORD sequence
10418 0000 0000 FFFF 0000 0000 0001 0000 0001
последняя (0)0418 0000 0000 FFFF 0000 0000 0001 0000 0000
  • TAG 1 + Issuer 2 + ID документа 4 + ID версии 2 = 9 WORD, LLLL=1000. TAG — 0000 0100 0001 1000 = 0418.

Связанные страницы

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

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000041000000000
BODY
#1 DECLARE 0x0410
#2 FIELD #1 rest
#3 FIELD #1 0x0004
#4 FIELD #1 0x0002
#5 BIND #1 "DOC-POINTER"
#6 BIND #2 "issuer"
#7 BIND #3 "doc"
#8 BIND #4 "version"