دليل: سحبُ فصل الآلة الافتراضية وإحلالُ فصل الخلفيّة الأصليّة (SIR → ELF64) - #6
Merged
Conversation
…أصليّة سُحب فصلُ الآلة الافتراضية: طبقةُ vm/ حُذفت من شجرة اللغة بالإيداع bcf0a746 («ستُعاد كتابتها من الصفر») — فالفصلُ كان يصف كودًا غيرَ موجود. ولا يُكتب بديلُه قبل أن يُكتب الكود. وحلّ محلَّه src/backend/native.md: الخلفيّةُ الأصليّة SIR → ELF64 بلا LLVM ولا رابطٍ أجنبيّ، مشتقًّا من الكود لا من الذاكرة، ومسجَّلًا في sync/sources.yaml بثمانيةِ مصادرَ تحقَّق وجودُها على dev. وأُصلح الثيمُ وثُبّتت نسخُ البناء: - الجدولُ يُمرَّر أفقيًّا ولا يُسحَق: العلّةُ width:100% (يساوي عرضَ الحاوية دائمًا فلا يقعُ تجاوزٌ ولا يعملُ تمريرُ .table-wrapper)، والإصلاحُ width:auto + min-width:100% وأرضيّةُ عرضٍ للخلايا تحت 760px. - فهرسُ الصفحة (theme/page-toc.js): بلا معالجٍ مسبقٍ ولا تبعيّةِ cargo، مع حارسَي print.html والمرساةِ العربيّةِ الخام. - mdbook-version: latest ⇒ 0.5.4، وmdbook-mermaid ⇒ 0.17.0: خطُّ 0.16.x يستهدف mdbook 0.4.52 ولا يتوافق مع 0.5 أصلًا، و0.17.0 أوّلُ ما يبني على mdbook-preprocessor 0.5. الترقيةُ قرارٌ يُراجَع في PR لا حدثٌ يقع من تلقائه. تنبيه: المصادرُ الثمانيةُ الجديدة غير مسجّلةٍ في sources.lock.json بعد — حارسُ الـPR لا يراها (يشتقّ مفاتيحَه من القفل لا من البيان)، لكنّ الفحصَ الأسبوعيّ سيرصدها added ويفتحُ قضيّةَ انجراف. تُثبَّت بـ--update في PR مخصَّص لا هنا: --update يعيد حسابَ كلّ المصادر فيُقدِّمُ بصماتِ فصولٍ لم تُراجَع. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
لماذا
فصلُ
src/backend/vm.mdكان يصف طبقةً غيرَ موجودةٍ في الشجرة:vm/حُذف بالإيداعbcf0a746(«حذف الآلة الافتراضية (sad_vm + sad_jit) — ستُعاد كتابتها من الصفر»).ووثيقةٌ تصف كودًا محذوفًا أسوأُ من غياب الوثيقة.
وفي المقابل، الخلفيّةُ الأصليّة (SIR → شيفرةُ آلة → ELF64 ساكن بلا LLVM ولا رابطٍ
أجنبيّ) طبقةٌ حيّةٌ مكتملة بلا فصلٍ في الدليل.
ما الذي تغيّر
① سحبُ فصل VM
src/backend/vm.md، وأُزيلت إحالاتُه منSUMMARY.mdوllvm.mdوintroduction.mdو
repo-map.mdوarchitecture/overview.md.status.md: صفُّ VM يصير «🗑️ مُزال فصله»، وبندُ خارطة الطريق يصير «إعادةُ توثيق VM:يُكتب الفصل من الكود عند إعادة كتابة الطبقة، لا قبلها».
sources.yaml/sources.lock.json: أُسقطت مصادرُ VM الثلاثة وtype_bridge.h(محذوفٌهو أيضًا من شجرة اللغة).
② فصلٌ جديد: الخلفيّة الأصليّة
src/backend/native.md— مشتقٌّ من الكود لا من الذاكرة: الطبقات الأربع (جداول SoT ·المرمِّزات · المخفِّضات + LoweringDriver بنمط CRTP · كاتب ELF64)، الأهداف الخمسة بأرقامها
المقيسة من
stats(104/104/7)، نظامُ التشخيص المولَّد من الكتالوج، درجتا القياس(بصمةُ التصريف عبر المنصّات الثلاث · التنفيذُ تحت qemu)، حرّاسُ المُنادي الأربعة، وستّةُ
مزالق مقيسة. مسجَّلٌ في
sources.yamlبثمانيةِ مصادرَ تحقَّق وجودُها علىdev(8/8).③ إصلاحا الثيم
div.table-wrapperولهoverflow-x:autoأصلًا. العلّةُwidth:100%على الجدول:يساوي عرضَ الحاوية دائمًا فلا يقعُ تجاوزٌ ولا يعملُ التمرير. الإصلاحُ
width:auto; min-width:100%+ أرضيّةُ عرضٍ للخلايا تحت 760px.theme/page-toc.js، بلا تبعيّة): يبني قائمةَ h2/h3 بعد عنوان الصفحة.حارسان: يتخطّى
print.html(أكثرُ من h1 ⇒ مراسٍ ملتبسة)، ويستعمل المرساةَ الخامّ لاالمُرمَّزة اتّساقًا مع مُعرِّفات mdBook العربيّة.
④ تثبيتُ نسخ البناء في CI و Deploy
mdbook-version: latest⇒"0.5.4"، وcargo install mdbook-mermaid --locked⇒--version 0.17.0 --locked. ليس احتياطًا مجرّدًا: خطُّ mdbook-mermaid 0.16.x يستهدفmdbook 0.4.52 ولا يتوافق مع 0.5، و0.17.0 أوّلُ نسخةٍ تبني على
mdbook-preprocessor 0.5.ترقيةٌ صامتةٌ عبر
latestكانت ستكسر البناءَ في CI بلا أثرٍ محلّيّ.البراهين (مُشغَّلةٌ محلّيًّا على هذا الفرع)
check_sync.py --validate--guard-lock(محاكاةٌ لما يشغّله CI)mdbook buildbook/backend/vm.htmlلم يعد يُولَّدlychee --offlineأثرٌ معلومٌ خارج بوّابات هذا الـPR
المصادرُ الثمانيةُ الجديدة ليست في
sources.lock.json. حارسُ الـPR لا يراها (يشتقّمفاتيحَه من القفل لا من البيان)، لكنّ
sync-check.ymlالأسبوعيّ سيصنّفهاaddedفيفتحقضيّةَ انجرافٍ آليّة. وهذا مقصود:
--updateهنا كان سيعيد حسابَ كلّ المصادر مقابلdevالحاليّ فيقدّم بصماتِ فصولٍ لم تُراجَع في هذا الفرع، ويُشعِل حارسَ الكتم الصامتنفسَه فيُخفِق الـPR. تُثبَّت البصماتُ في PR تالٍ مخصَّصٍ لتحديث القفل.
🤖 Generated with Claude Code