البندالقيمة
الاسمDELTA-BASE (BIND مستند المواصفة DELTA-BASE)
TAG ID0x1DBL
Codec ID0x00001DB0
مستند المواصفة0x00000000/codecs/0x00001DB0/ (هدف DECLARE 1DB0)
القسم14 1110 (Meta)، الإزاحة داخل القسم C = 27
KindMeta · الفئة: النسب
TAG WORD0001 1101 1011 LLLL (000K KKKC CCCC LLLL)
وصف الفهرسملف هذا الإصدار هو diff بالنسبة إلى إصدار أساس من المستند نفسه (معرّف إصدار من 2 WORD) (git packfile delta)
جهة Hugometa/lineage/delta-base.md

الحقول (مستند المواصفة)

ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec).

الترتيبالحقل (BIND)FIELDالعرضالصيغة المستقبِلة (CODEC)ENUM
1version#2قيمة خام 2 WORD0620 UNSIGNED-INTEGER

علامة تدل على أن ملف هذا الإصدار ليس snapshot بل diff بالنسبة إلى إصدار أساس من المستند نفسه (delta في git packfile). ويظل الإصدار نفسه معرَّفاً بوصفه snapshot. وتجزئة المحتوى وقائمة الإصدارات والتوقيع كلها على أساس الـ snapshot المستعاد بتطبيق الـ diff (حفظ diff).

التخطيط

TAG WORD          0001 1101 1011 LLLL      Codec 0x1DBL
معرّف الإصدار     2 WORD unsigned (إصدار الأساس من المستند نفسه)
  • Codec: Meta 0x1DBL، فئة النسب
  • Payload: معرّف إصدار من 2 WORD (قيمة خام)
  • العدد: واحد على الأكثر

التفسير والصلاحية

  • لا يُستخدم إلا في مستند فيه DOC-ID. فقائمة الإصدارات versions.geul التي لا يوضع فيها DOC-ID، ومستندات القوائم (إصدارات issuers/)، والمستند بلا اسم، لا يوضع فيها diff.
  • إصدار الأساس هو إصدار منشور بـ DOC-ID نفسه ويسبق هذا الإصدار. و0 (لا إصدار) غير صالح.
  • يجب أن تساوي تجزئة محتوى الـ snapshot المستعاد تجزئةَ هذا الإصدار في قائمة الإصدارات (PUBLICATION). وإذا اختلفت فهذا الـ diff غير صالح. ولذلك لا تُكتب تجزئة النتيجة منفصلةً داخل الـ diff.
  • لا يمكن أن يكون diff إلا لمستند تكون كل سجلات BODY فيه Edge (سجلات لها Edge Id). لأن وحدة الـ diff هي LOCAL ID (Edge Id).
  • قاعدة استعادة الـ snapshot تتبع حفظ diff. والحذف يتولاه DELTA-REMOVE.
  • لا توجد علامة منفصلة للإضافة والتعديل. فإذا كان Edge Id في BODY الخاص بالـ diff موجوداً في الأساس فهو تعديل، وإلا فهو إضافة. وتأخذ الإضافة رقمها بدءاً من NEXT-LOCAL-ID في قائمة الإصدارات. وإعادة استخدام LOCAL ID محذوف غير صالحة (التعديل).

مثال

diff بالنسبة إلى الإصدار الأساس 3:

1DB2 0000 0003
  • TAG 1DB2 (Meta 0x1DBL، LLLL=0010، 3 WORD)، ومعرّف الإصدار 0000 0003.

مسائل مفتوحة

  1. الفاصل بين الـ snapshot: كل كم إصدار يوضع snapshot كامل (طول سلسلة الـ diff وكلفة الاستعادة).
  2. هل يُقيَّد إصدار الأساس بالإصدار السابق مباشرة.
  3. موضع حفظ ملف الـ diff: هل يوضع في موضع ملف الإصدار (<معرّف الإصدار>.geul)، وعلاقته بعنوان تجزئة المحتوى <Issuer>/hashes/ (يُعثر على hashes/ بتجزئة محتوى الـ snapshot).

نص مستند المواصفة

هذه هي صورة مستند المواصفة 0x00000000/codecs/0x00001DB0/latest.geul عند قراءته بـ geul show (الأرقام الستة عشرية بأحرف كبيرة).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DB000000000
BODY
#1 DECLARE 0x1DB0
#2 FIELD #1 0x0002
#3 BIND #1 "DELTA-BASE"
#4 BIND #2 "version"
#5 CODEC #2 0x0620