ItemValor
NomeNEXT-LOCAL-ID (BIND NEXT-LOCAL-ID do documento de especificação)
TAG ID0x1DDL
Codec ID0x00001DD0
Documento de especificação0x00000000/codecs/0x00001DD0/ (alvo do DECLARE 1DD0)
Seção14 1110 (Meta), deslocamento C = 29 na seção
KindMeta · classe: linhagem
TAG WORD0001 1101 1101 LLLL (000K KKKC CCCC LLLL)
Descrição do índicePróximo LOCAL ID a atribuir (auto increment). Fica no HEAD da lista de versões versions.geul
Lado Hugometa/lineage/next-local-id.md

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec).

OrdemCampo (BIND)FIELDLarguraFormato de entrada (CODEC)ENUM
1next#2valor bruto restante(0xFFFF)

Registra o LOCAL ID que a próxima versão do documento atribuirá a um novo enunciado (auto increment de SGBD, AUTO_INCREMENT do MySQL). Todos os LOCAL ID atribuídos em qualquer versão do documento são menores que este valor.

Layout

TAG WORD          0001 1101 1101 LLLL      Codec 0x1DDL
Payload           Próximo LOCAL ID a atribuir, inteiro sem sinal na menor largura
  • Codec: Meta 0x1DDL, classe de linhagem
  • Payload: valor bruto (inteiro sem sinal na menor largura)
  • Quantidade: no máximo um
  • Onde se coloca: no HEAD do documento de lista de versões versions.geul (PUBLICATION)

Interpretação e validade

  • O LOCAL ID (incluindo o Edge Id) é uma identidade que atravessa as versões (revisão). Um novo enunciado recebe este valor e o valor aumenta em 1. Um LOCAL ID excluído não é reutilizado. Por isso, mesmo que o enunciado de valor máximo seja excluído, este valor não diminui.
  • O LOCAL ID 0 não é atribuído, portanto o valor inicial é 1. Se ainda não há versão, este Meta não é colocado e o próximo número é 1.
  • Quem publica atualiza e escreve o valor no novo documento de lista ao publicar uma versão. Deve ser maior que qualquer LOCAL ID usado na versão publicada. Se for menor ou igual, é inválido.
  • O valor só aumenta. Se for menor que o do documento de lista anterior (PARENT), é inválido.
  • Não existe em documentos sem controle de versão (documentos sem versions.geul, documentos sem nome). Tais documentos também não usam diff (DELTA-BASE).
  • Não se coloca no corpo do documento (documento de versão). A memória do número não é conteúdo do documento, e sim estado de quem continua a publicar o documento (do lado das refs do git, não dos commits).

Exemplo

Próximo número a atribuir 524:

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

Texto do documento de especificação

É o documento de especificação 0x00000000/codecs/0x00001DD0/latest.geul lido com geul show (hexadecimal em maiúsculas).

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