項目値
名前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)
Hugo 側reference/doc-pointer.md

フィールド (規格ドキュメント)

FIELD のドキュメント内の順序が Payload のフィールド順だ(Codec 規格ドキュメント)。

順序フィールド(BIND)FIELD幅受け取る形式(CODEC)ENUM
1issuer#2残り全部の生値(0xFFFF)
2doc#3生値 4 WORD
3version#4生値 2 WORD

DOC-POINTER は、Issuer が公表したドキュメントの 1 つのバージョンを指す指示宣言 Reference だ。ドキュメントの公表・deprecate・削除、引用版、ドキュメントについての叙述の対象になる。

レイアウト

TAG WORD          0000 0100 0001 LLLL      Codec 0x041L
[Length 拡張 TAG]
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 は省略しない。省略を許すと Payload の長さだけでは Issuer 幅を決められない(Issuer 4 WORD・バージョンなしと Issuer 2 WORD・バージョンありが同じ 8 WORD になる)。
  • バージョン ID 0 は最新バージョンだ。解釈する時点の現行バージョンに結びつく。それ以外の値はそのバージョンに固定される(PUBLICATION)。
  • ドキュメント ID 0 は Issuer の用語定義索引ドキュメントだ。Issuer 自身は ISSUER-POINTER で指す。
  • すべての Issuer は、ドキュメント ID 0x0000000000000000 と 0xFFFFFFFFFFFFFFFF を予約する(Issuer と公表)。0xFFFFFFFFFFFFFFFF は Issuer 0x00000000 の Issuer 一覧 issuers/ に使い、ほかの Issuer は使わない。issuers/versions.geul の PUBLICATION・DEPRECATION・TOMBSTONE がこの値で一覧のバージョンを指す(公表アドレスとバージョン一覧)。
  • Codec 0x041L 1 つだけだ。量化はない(Identified)。
  • Issuer のドキュメントを指す形式は DOC-POINTER 1 つだけだ。EXTERNAL-ISSUER-*(Issuer、ドキュメント ID、対象 ID 0)や EXTERNAL-POINTER-*(IMPORT ID、対象 ID 0)でドキュメントを指すのは invalid だ。
  • 使われる場所: Meta DOC-ID・IMPORT-DOC、バージョン一覧の PUBLICATION・DEPRECATION・TOMBSTONE。
  • Codec ドキュメントにはドキュメント ID がない。Codec ドキュメントとそのバージョンは CODEC-POINTER で指す。

例

GEUL Issuer 0x00000000 のドキュメント 0xFFFF000000000001。

バージョン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 で読んだ様子だ(16進は大文字)。

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"