| البند | القيمة |
|---|---|
| الاسم | DELTA-BASE (BIND مستند المواصفة DELTA-BASE) |
| TAG ID | 0x1DBL |
| Codec ID | 0x00001DB0 |
| مستند المواصفة | 0x00000000/codecs/0x00001DB0/ (هدف DECLARE 1DB0) |
| القسم | 14 1110 (Meta)، الإزاحة داخل القسم C = 27 |
| Kind | Meta · الفئة: النسب |
| TAG WORD | 0001 1101 1011 LLLL (000K KKKC CCCC LLLL) |
| وصف الفهرس | ملف هذا الإصدار هو diff بالنسبة إلى إصدار أساس من المستند نفسه (معرّف إصدار من 2 WORD) (git packfile delta) |
| جهة Hugo | meta/lineage/delta-base.md |
الحقول (مستند المواصفة)
ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec).
| الترتيب | الحقل (BIND) | FIELD | العرض | الصيغة المستقبِلة (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | version | #2 | قيمة خام 2 WORD | 0620 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(Meta0x1DBL،LLLL=0010، 3 WORD)، ومعرّف الإصدار0000 0003.
مسائل مفتوحة
- الفاصل بين الـ snapshot: كل كم إصدار يوضع snapshot كامل (طول سلسلة الـ diff وكلفة الاستعادة).
- هل يُقيَّد إصدار الأساس بالإصدار السابق مباشرة.
- موضع حفظ ملف الـ 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