| פריט | ערך |
|---|---|
| שם | DOC-ID (BIND של מסמך מפרט: DOC-ID) |
| TAG ID | 0x1C7L |
| Codec ID | 0x00001C70 |
| מסמך מפרט | 0x00000000/codecs/0x00001C70/ (יעד DECLARE: 1C70) |
| קטע | 14 1110 (Meta), היסט C בתוך הקטע = 7 |
| Kind | Meta · מחלקה: הצהרה |
| TAG WORD | 0001 1100 0111 LLLL (000K KKKC CCCC LLLL) |
| תיאור באינדקס | המזהה של המסמך הזה. Reference מובנה DOC-POINTER (Issuer, מזהה מסמך, גרסה 0). במסמך Codec: CODEC-POINTER (Issuer, Codec ID, גרסה 0) |
| בצד Hugo | meta/declaration/doc-id.md |
שדות (מסמך מפרט)
סדר ה-FIELD בתוך המסמך הוא סדר שדות ה-Payload (מסמך מפרט של Codec).
| סדר | שדה (BIND) | FIELD | רוחב | פורמט מקבל (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | doc | #2 | רשומה | 0410 DOC-POINTER, 0420 CODEC-POINTER |
מצהיר על המזהה של המסמך הזה. הוא נחוץ כדי שמסמכים אחרים יוכלו להצביע על המסמך הזה ועל הפריטים שבתוכו.
פריסה
TAG WORD 0001 1100 0111 LLLL Codec 0x1C7L
[TAG הרחבה של Length]
מסמך רשומת Reference מסוג DOC-POINTER. (Issuer, מזהה מסמך, גרסה 0). במסמך Codec: CODEC-POINTER
- Codec: Meta
0x1C7L, מחלקת הצהרה - Payload: Reference מובנה אחד DOC-POINTER (Issuer, מזהה מסמך, גרסה 0)
- מספר: לכל היותר אחד. במסמכי הגרסה שתחת
docs/<מזהה מסמך>/ו-codecs/<Codec ID>/הוא חובה
פירוש ותוקף
- ה-Payload הוא רשומת Reference אחת בדיוק מסוג
DOC-POINTER(Issuer, מזהה מסמך, גרסה0). משתמשים רק במזהה גרסה0. את הגרסה מקצה רשימת הגרסאות, לא המסמך. במסמך Codec משתמשים ב-CODEC-POINTER(Issuer, Codec ID, גרסה0) (CODEC-POINTER). - לכן הסימון שמצביע על “המסמך הזה” זהה ב-DOC-ID, ברשומת PUBLICATION ברשימת הגרסאות ובציטוט ממסמך אחר.
- אותו מסמך, בלי קשר לגרסה, הוא אותו
DOC-ID. מזהה הגרסה ו-hash התוכן אינם נרשמים במסמך (גרסה). - אין כתובת לפי שם מסמך (כתובת פרסום ורשימת גרסאות). את הכותרת שאדם קורא נושא LABEL של היגד.
- אם אין, זה מסמך בלי שם, שאפשר להצביע עליו רק ב-hash התוכן. הוא נחוץ כדי שמסמך אחר יוכל להצביע ב-Reference מצביע על LOCAL של המסמך הזה.
- הצד שמביא את המסמך מוודא שה-
DOC-IDשל המסמך שהתקבל שווה ל-Issuer ולמזהה המסמך שנתבקשו. - מזהה מסמך
0x0000000000000000הוא מסמך אינדקס הגדרות המונחים של ה-Issuer (Issuer). גם הוא מסמך גרסה תחתdocs/<מזהה מסמך>/, ולכן יש בו DOC-ID (DOC-POINTER(Issuer,0,0)). ה-Issuer עצמו מיוצג על ידי ISSUER-POINTER. - במסמכי הגרסה
<מזהה גרסה>.geul(כולל מסמכי מפרט) שב-<Issuer>/docs/<מזהה מסמך>/וב-<Issuer>/codecs/<Codec ID>/תחת.well-known/geul/,DOC-IDהוא חובה. - מסמכי רשימה הם היוצא מן הכלל ואין בהם
DOC-ID: רשימת הגרסאותversions.geul(PUBLICATION) והגרסה<מזהה גרסה>.geulשל רשימת ה-Issuerissuers/(כתובת פרסום ורשימת גרסאות). על מה הרשימה אומר ה-DOC-POINTER ברשומה. את הגרסה של מסמך רשימה מציינת רשומת PUBLICATION ב-versions.geulשלו, ב-DOC-POINTER (0x00000000, מזהה מסמך שמור, מזהה גרסה). כתובת hash התוכן<Issuer>/hashes/היא עותק של המסמכים שלמעלה, ולכן הולכים אחרי המקור. - מזהה מסמך
0xFFFFFFFFFFFFFFFFשמור בכל ה-Issuer (וכך גם0x0000000000000000), ומשמש ברשימת ה-Issuer של Issuer0x00000000. Issuer אחרים אינם משתמשים בו. במסמכי רשימה איןDOC-ID, ולכן הערך הזה מופיע רק ב-DOC-POINTER של רשומותissuers/versions.geul. - מסמך המפרט של Codec הוא מסמך Codec של Issuer GEUL
0x00000000. אין לו מזהה מסמך, וב-DOC-IDמציבים CODEC-POINTER (0x00000000, Codec ID,0). Codec ID הוא TAG WORD של Kind·Codec כתוב ב-32 ביט (0x0B80→0x00000B80) (מסמך מפרט).
דוגמה
- Issuer
0x00000002, מסמך0x…0005:1C79 0418 0000 0002 0000 0000 0000 0005 0000 0000(TAG של Meta 1 + TAG של Reference 1 + Issuer 2 + מזהה מסמך 4 + גרסה 2 = 10 WORD)
הנוסח המקורי של מסמך המפרט
כך נראה מסמך המפרט 0x00000000/codecs/0x00001C70/latest.geul כשקוראים אותו ב-geul show (ספרות הקסדצימליות באותיות גדולות).
SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001C7000000000
BODY
#1 DECLARE 0x1C70
#2 FIELD #1 record
#5 CODEC #2 0x0410
#3 BIND #1 "DOC-ID"
#4 BIND #2 "doc"
#6 CODEC #2 0x0420