項目値
名前NEXT-LOCAL-ID (規格ドキュメント BIND NEXT-LOCAL-ID)
TAG ID0x1DDL
Codec ID0x00001DD0
規格ドキュメント0x00000000/codecs/0x00001DD0/ (DECLARE 対象 1DD0)
セクション14 1110 (Meta)、セクション内オフセット C = 29
KindMeta · クラス: 系譜
TAG WORD0001 1101 1101 LLLL (000K KKKC CCCC LLLL)
索引の説明次に割り当てる LOCAL ID (auto increment)。バージョン一覧 versions.geul の HEAD に置く
Hugo 側meta/lineage/next-local-id.md

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

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

順序フィールド(BIND)FIELD幅受ける形式(CODEC)ENUM
1next#2残り生値(0xFFFF)

そのドキュメントの次のバージョンが新しい叙述に割り当てる LOCAL ID を記す(DBMS の auto increment、MySQL AUTO_INCREMENT)。ドキュメントのどのバージョンでも、割り当てた LOCAL ID はすべてこの値より小さい。

レイアウト

TAG WORD          0001 1101 1101 LLLL      Codec 0x1DDL
Payload           次に割り当てる LOCAL ID、最も短い幅の unsigned 整数
  • Codec: Meta 0x1DDL、系譜クラス
  • Payload: 生値(最も短い幅の unsigned 整数)
  • 個数: 多くても 1 つ
  • 置く場所: バージョン一覧ドキュメント versions.geul の HEAD(PUBLICATION)

解釈と有効性

  • LOCAL ID(Edge Id を含む)はバージョンをまたぐ同一性である(改訂)。新しい叙述はこの値を受け取り、値は 1 増える。削除した LOCAL ID は再び使わない。そのため、最大値を持つ叙述が削除されてもこの値は減らない。
  • LOCAL ID 0 は割り当てないので、最初の値は 1 である。まだバージョンがなければこの Meta を置かず、次の番号は 1 である。
  • 公表元がバージョンを公表するとき、新しい一覧ドキュメントに更新して記す。公表したバージョンで使われたどの LOCAL ID よりも大きくなければならない。小さいか等しければ invalid である。
  • 値は増えるだけである。直前の一覧ドキュメント(PARENT)の値より小さければ invalid である。
  • バージョン管理をしないドキュメント(versions.geul のないドキュメント、名前のないドキュメント)にはない。そのようなドキュメントには diff(DELTA-BASE)も置かない。
  • ドキュメント本文(バージョンドキュメント)には置かない。番号の記憶はドキュメントの内容ではなく、ドキュメントを書き継ぐ公表元の状態である(git のコミットではなく refs 側)。

例

次の割り当て番号 524:

1DD1 020C
  • TAG 1DD1(Meta 0x1DDL、LLLL=0001、2 WORD)、Payload 020C。

規格ドキュメント原文

規格ドキュメント 0x00000000/codecs/0x00001DD0/latest.geul を geul show で読んだ様子である(16 進は大文字)。

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DD000000000
BODY
#1 DECLARE 0x1DD0
#2 FIELD #1 rest
#3 BIND #1 "NEXT-LOCAL-ID"
#4 BIND #2 "next"