ItemValue
NameDELTA-REMOVE (spec document BIND DELTA-REMOVE)
TAG ID0x1DCL
Codec ID0x00001DC0
Spec document0x00000000/codecs/0x00001DC0/ (DECLARE target 1DC0)
Section14 1110 (Meta), offset within section C = 12
KindMeta · class: lineage
TAG WORD0001 1101 1100 LLLL (000K KKKC CCCC LLLL)
Index descriptionIn a diff, the list of LOCAL IDs (Edge Ids) to remove from the base BODY
Hugo sidemeta/lineage/delta-remove.md

Fields (spec document)

The order of FIELDs within the document is the order of Payload fields (Codec spec document).

OrderField (BIND)FIELDWidthAccepted form (CODEC)ENUM
1ids#2remaining raw value (0xFFFF)

In a diff (DELTA-BASE), records the LOCAL IDs (Edge Ids) of records to remove from the BODY of the base snapshot (“Article X deleted”).

Layout

TAG WORD          0001 1101 1100 LLLL      Codec 0x1DCL
[Length extension TAG]
LOCAL IDs to remove  LOCAL Reference record × 1 or more
  • Codec: Meta 0x1DCL, lineage class
  • Payload: one or more LOCAL Reference records
  • Count: at most one

Interpretation and validity

  • Place it only in a document that has DELTA-BASE.
  • Each LOCAL ID must be an Edge Id present in the base snapshot BODY. Otherwise it is invalid. Listing the same ID twice is invalid.
  • Placing the same Edge Id again in the BODY of the same diff is invalid (deletion and revision cannot be done together).
  • A deleted LOCAL ID is not reassigned to another target in later versions (revision).
  • A record absent from the diff BODY means “unchanged”. So deletion is expressed only by this Meta.
  • HEAD Edges (the document-wide SOURCE and its QUALIFIER) are not written. The HEAD is replaced wholesale by the diff’s HEAD (diff storage).

Example

Deleting LOCAL #7 and #12:

1DC4 0051 0007 0051 000C
  • TAG 1DC4 (Meta 0x1DCL, LLLL=0100, 5 WORD), LOCAL References 0051 0007, 0051 000C.

Spec document source

The spec document 0x00000000/codecs/0x00001DC0/latest.geul as read with geul show (hex in uppercase).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DC000000000
BODY
#1 DECLARE 0x1DC0
#2 FIELD #1 rest
#3 BIND #1 "DELTA-REMOVE"
#4 BIND #2 "ids"