الكتاب المرجعي
منقول من الكتاب المرجعي: docs/handbook/README.md · الإيداع 7a52f6c
المصدر الوحيد الموثوق للغة. يصف 0.10.0، وقد صدرت (منشورة على https://meemlang.org): الوسم v0.10.0 (الإيداع
b01b55f)، والحزمة meem 0.10.0+b01b55f (release-0.10.0.md (وثيقة في مستودع المجمّع)). غايتها أن تصدق ميم في ما تعد به
عن الذاكرة: الكاشف افتراضي في التشغيل المباشر، ولا نسخ خفية، وما تضمنه اللغة في memory-safety.md (وثيقة في مستودع المجمّع)؛
والترحيل في الترحيل من 0.9 إلى 0.10. وحقل version في البيان يقول لكل مثال إن كان يعمل بحزمة
الإصدار (0.10.0) أم في شجرة التطوير وحدها. ما أُضيف في 0.8.0 موسوم «منذ 0.8.0» في الصفحات، وما في 0.10.0 «منذ 0.10.0»، وما لم يُنفَّذ
بعد موسوم «مخطط»، ومفصول عن المنجز.
القواعد: كل مثال شيفرة (كتلة ميم تتبعها الناتج أو خطأ) يُشغَّل في tests/test_docs.py ويُقارن ناتجه. ما يُولَّد
من الشيفرة (موسوم «مولَّدة») ينتجه scripts/gen_handbook.py، والاختبار يفشل إن صار قديماً. لا أرقام أداء هنا؛ القياسات
بجداولها ومنهجها في performance.md (وثيقة في مستودع المجمّع).
الخريطة
رابط إلى قسم «الخريطة»| القسم | ما فيه |
|---|---|
| language/ | اللغة: المفردات (مولَّدة)، الأنواع، التعابير، العبارات، الدوال، الهياكل، الوحدات، الذاكرة والمخصصات وخاتمه، الطبقة المنخفضة، FFI، ما يستطيعه البرنامج، التعداد، معالجة الأخطاء. لكل جزء: القاعدة، والأمثلة، والقيود المعروفة، والأخطاء المحتملة |
| المكتبة القياسية | المدمجات والوحدات القياسية (مولَّدة): التوقيع والدلالة والأخطاء ومثال |
| errors/ | فهرس كل رسالة (مولَّد) والأخطاء الشائعة بسببها وإصلاحها |
| tools/ | خيارات سطر الأوامر (مولَّدة) ومخطط --check --json |
| منهج مقترح للمبتدئ | منهج مقترح للمبتدئ |
| الترحيل من 0.6 إلى 0.7 | الترحيل من 0.6 إلى 0.7، وإلى معالجة الأخطاء، ومن 0.7 إلى 0.8، ومن 0.9 إلى 0.10 |
| المصطلحات | المصطلحات العربية والإنجليزية |
manifest.json (وثيقة في مستودع المجمّع) |
كل مثال: المسار والعنوان والموضوع والوسوم والناتج ورمز الخروج والإصدار |
ما في الإصدار وما في التطوير
رابط إلى قسم «ما في الإصدار وما في التطوير»| الحالة | |
|---|---|
| 0.7.0 | صدرت: master بالوسم v0.7.0 (إيداع c919819)، والحزمة meem-0.7.0-linux-x86_64.tar.xz منشورة؛ ومحرر ميم 0.1.0 يعمل بميم 0.7.0، والموقع https://meemlang.org على 0.7.0. وفيها كل ما كان في فرع التطوير: هيكل_سي، نص_سي، مؤشر الدالة، الدوال الرئيسية، دوال ملفات ونظام.التاريخ الجديدة، معالجة الأخطاء (!ن، كاسرة)، التعداد، و--no-system |
| 0.8.0 | صدرت: master بالوسم v0.8.0 (إيداع 36cff0b)، والحزمة meem-0.8.0-linux-x86_64.tar.xz **منشورة على https://meemlang.org**. وفيها: صيغ \r و\xHH و\uHHHH، وإزالة الصيغ المهجورة، ومعرّفات الرسائل الثابتة (E0001)، وتحرير ناتج + غير المسند، وتقرير --debug-mem بالسطر، ورتب_ب ونسق_عدد ونص_التاريخ ونم والوحدة مسارات؛ ولكل على التعداد ومفتاح القاموس منه والتعداد في الوحدات، واستدعاء التعبير (ق0 <small>(وثيقة في مستودع المجمّع)</small>)، والمكتبة القياسية بوضع بلا_افتراضي (الترحيل من 0.7 إلى 0.8) |
| 0.9.0 | صدرت: master بالوسم v0.9.0 (إيداع 0a4bf35)، والحزمة meem-0.9.0-linux-x86_64.tar.xz منشورة على https://meemlang.org. الإصدار التجريبي قبل 1.0: لا ميزة لغة جديدة ولا كسر؛ نص لا تتسع له الذاكرة صار خطأ تشغيل E0427 «نفدت الذاكرة» بدل السقوط، وسلسلة استدعاء أعمق من الحد صارت E0385 بدل «خطأ داخلي». البلاغ في GitHub Issues: https://github.com/mim-programing-lang/meem-feedback (beta-0.9.md (وثيقة في مستودع المجمّع)) |
| 0.9.1 | صدرت (منشورة على https://meemlang.org): master بالوسم v0.9.1 (إيداع 85cd0a7)، والحزمة meem-0.9.1-linux-x86_64.tar.xz. إصدار تصحيحي استثنائي قبل 1.0: رخصة ميم 1.0 (الملفان LICENSE، والعربي هو المرجع، وLICENSE.en) في جذر الحزمة، وتصحيحات الوثائق؛ لا ميزة ولا تغيير في اللغة ولا الأدوات |
| 0.10.0 | صدرت (منشورة على https://meemlang.org): master بالوسم v0.10.0 (إيداع b01b55f)، والحزمة meem-0.10.0-linux-x86_64.tar.xz. الذاكرة: قائمة أو قاموس بعد حرر خطأ تشغيل لا سقوط، ولا نسخ خفية للعروض، والكاشف افتراضي في التشغيل المباشر يرى الاستعمال بعد التحرير (--release يلغيه، وbuild --debug يبنيه)، وmemory-safety.md (وثيقة في مستودع المجمّع)؛ ونموذج الشيفرة الصغير في build، وإصلاحات رسائل (الترحيل من 0.9 إلى 0.10) |
| مخطط | نشر الملعب على خادم: الخدمة منجزة ومختبرة ولم تُنشر، وحدودها في ما يستطيعه برنامج ميم على جهازك (playground.md (وثيقة في مستودع المجمّع))، وكل ما في v1-readiness.md (وثيقة في مستودع المجمّع) |
الأمثلة والصفحات المولَّدة
رابط إلى قسم «الأمثلة والصفحات المولَّدة»- البيان
examples/manifest.jsonيكفي لعرض كل مثال بناتجه دون تشغيل. - الصفحات المولَّدة تتغير مع الشيفرة، فتتغير مع كل إصدار.
الرخصة
رابط إلى قسم «الرخصة»ميم (المجمّع وأدواته ومكتبته القياسية، ومحرر ميم، واللغة ومواصفاتها ووثائقها وأمثلتها، وهذا الكتاب منها) برخصة ميم 1.0:
الملف LICENSE بالعربية، وهو المرجع، وترجمته الإنجليزية الإرشادية LICENSE.en، في جذر مستودع المجمّع وفي جذر الحزمة. البرامج التي
تكتبها بميم وملفاتها المبنية ملكك (المادة 1ب). ورخص ما تضمّه الحزمة من أطراف أخرى في third-party.md (وثيقة في مستودع المجمّع).
البلاغ عن الأخطاء: https://github.com/mim-programing-lang/meem-feedback/issues؛ والتواصل وطلب الأذونات: meemlang@outlook.sa.