table of contents
| BISON(1) | أوامر المستخدم | BISON(1) |
الاسم¶
bison - مولد محللات مشروع GNU (بديل yacc)
موجز¶
bison [الخيار]... الملف
الوصف¶
Bison هو مولد محللات بأسلوب yacc(1). ويُفترض أن يكون متوافقاً تصاعدياً مع ملفات المدخلات المصممة لـ yacc.
يجب أن تتبع ملفات المدخلات عرف yacc في الانتهاء بـ .y. وبخلاف yacc، لا تمتلك الملفات المولدة أسماءً ثابتة، بل تستخدم بادئة ملف المدخلات بدلاً من ذلك. علاوة على ذلك، إذا احتجت إلى وضع كود C++ في ملف المدخلات، يمكنك إنهاء اسمه بامتداد يشبه C++ (مثل .ypp أو .y++)، وسيتتبع bison امتدادك لتسمية ملف المخرجات (.cpp أو .c++). على سبيل المثال، ملف وصف القواعد المسمى parse.yxx سينتج المحلل المولد في ملف مسمى parse.tab.cxx، بدلاً من y.tab.c الخاص بـ yacc أو parse.tab.c الخاص بإصدارات Bison القديمة.
هذا الوصف للخيارات التي يمكن إعطاؤها لـ bison مقتبس من عقدة Invocation في دليل bison.texi، والذي يجب اعتباره المصدر الرسمي.
يدعم Bison كلاً من خيارات الحرف الواحد التقليدية وأسماء الخيارات الطويلة التذكيرية. تُسبق أسماء الخيارات الطويلة بـ -- بدلاً من -. وتُسمح الاختصارات لأسماء الخيارات طالما كانت فريدة. عندما يأخذ خيار طويل وسيطة، مثل --file-prefix، اربط اسم الخيار بالوسيطة باستخدام العلامة =.
توليد محلل LR حتمي أو LR معمّم (GLR) يوظف جداول تحليل LALR(1)، أو IELR(1)، أو LR(1) القياسية.
الوسيطات الإجبارية للخيارات الطويلة هي إجبارية للخيارات القصيرة أيضاً. وينطبق الشيء نفسه على الوسيطات الاختيارية.
أوضاع التشغيل:¶
- -h، --help
- يعرض هذه المساعدة ويخرج
- -V، --version
- يعرض معلومات الإصدار ويخرج
- --print-localedir
- يعرض المجلد الذي يحتوي على البيانات المعتمدة على المحلة ويخرج
- --print-datadir
- يعرض المجلد الذي يحتوي على الهياكل (skeletons) و XSLT ويخرج
- -u، --update
- يطبق الإصلاحات على ملف القواعد المصدري ويخرج
- -f، --feature[=المزايا]
- تنشيط مزايا متنوعة
المزايا (FEATURES) هي قائمة من الكلمات المفصولة بفاصلة يمكن أن تشمل:¶
- caret، diagnostics-show-caret
- إظهار الأخطاء باستخدام علامات الإقحام (carets)
- fixit، diagnostics-parseable-fixits
- إظهار إصلاحات قابلة للقراءة آلياً
- syntax-only
- عدم توليد أي ملف
- all
- كل ما سبق
- none
- تعطيل كل ما سبق
التشخيصات:¶
- -W، --warnings[=الفئة]
- الإبلاغ عن التحذيرات التي تندرج تحت الفئة
- --color[=متى]
- ما إذا كان سيجري تلوين التشخيصات
- --style=الملف
- تحديد ملف CSS لتلوين التشخيصات
تشمل فئات التحذير ما يلي:¶
- conflicts-sr
- تعارضات إزاحة/اختزال (مفعلة مبدئياً)
- conflicts-rr
- تعارضات اختزال/اختزال (مفعلة مبدئياً)
- counterexamples، cex
- توليد أمثلة مضادة للتعارض
- dangling-alias
- أسماء مستعارة نصية غير مرتبطة برمز
- deprecated
- بنى مهجورة
- empty-rule
- قواعد فارغة بدون استخدام %empty
- midrule-values
- قيم midrule غير محددة أو غير مستخدمة
- precedence
- أسبقية وترابطية عديمة الفائدة
- yacc
- عدم التوافق مع POSIX Yacc
- other
- كل التحذيرات الأخرى (مفعلة مبدئياً)
- all
- كل التحذيرات باستثناء 'counterexamples' و 'dangling-alias' و 'yacc'
- no-CATEGORY
- إيقاف التحذيرات في الفئة (CATEGORY)
- none
- إيقاف كل التحذيرات
- error[=الفئة]
- اعتبار التحذيرات كأخطاء
يمكن أن يكون خيار "متى" (WHEN) أحد ما يلي:¶
- always، yes
- تلوين المخرجات
- never، no
- عدم تلوين المخرجات
- auto، tty
- التلوين إذا كان جهاز المخرجات هو tty
ضبط المحلل:¶
- -L، --language=اللغة
- تحديد لغة البرمجة للمخرجات
- -S، --skeleton=الملف
- تحديد الهيكل (skeleton) المراد استخدامه
- -t، --debug
- تجهيز المحلل للتتبع، تماماً مثل '-Dparse.trace'
- --locations
- تفعيل دعم المواقع
- -D، --define=الاسم[=القيمة]
- مشابه لـ '%define NAME VALUE'
- -F، --force-define=الاسم[=القيمة]
- تجاوز '%define NAME VALUE'
- -p، --name-prefix=البادئة
- إضافة البادئة (PREFIX) قبل الرموز الخارجية؛ مهجور لصالح '-Dapi.prefix={PREFIX}'
- -l، --no-lines
- عدم توليد توجيهات '#line'
- -k، --token-table
- تضمين جدول بأسماء الوحدات (tokens)
- -y، --yacc
- محاكاة POSIX Yacc
ملفات المخرجات:¶
- -H، --header=[الملف]
- إنتاج ملف ترويسة أيضاً
- -d
- بالمثل، ولكن لا يمكن تحديد الملف (لأجل POSIX Yacc)
- -r، --report=الأشياء
- إنتاج تفاصيل حول الأتمتة أيضاً
- --report-file=الملف
- كتابة التقرير في الملف
- -v، --verbose
- مثل '--report=state' تماماً
- -b، --file-prefix=البادئة
- تحديد بادئة (PREFIX) لملفات المخرجات
- -o، --output=FILE
- ترك المخرجات في الملف
- -g، --graph[=الملف]
- إخراج رسم بياني للأتمتة أيضاً
- --html[=الملف]
- إخراج تقرير HTML للأتمتة أيضاً
- -x، --xml[=الملف]
- إخراج تقرير XML للأتمتة أيضاً
- -M، --file-prefix-map=القديم=الجديد استبدال البادئة "القديم" بـ "الجديد" عند كتابة مسارات الملفات
- في ملفات المخرجات
الأشياء (THINGS) هي قائمة من الكلمات المفصولة بفاصلة يمكن أن تشمل:¶
- states
- وصف الحالات
- itemsets
- إكمال مجموعات العناصر الجوهرية بإغلاقها
- lookaheads
- ربط وحدات المعاينة (lookahead tokens) بالعناصر صراحةً
- solved
- وصف حل تعارضات الإزاحة/الاختزال
- counterexamples، cex
- توليد أمثلة مضادة للتعارض
- all
- تضمين كل المعلومات المذكورة أعلاه
- none
- تعطيل التقرير
المؤلف¶
كتبه Robert Corbett و Richard Stallman.
التبليغ عن الأخطاء¶
أبلغ عن
العلل إلى
<bug-bison@gnu.org>.
الصفحة
الرئيسية
لـ GNU Bison: <https://www.gnu.org/software/bison/>.
مساعدة
عامة في
استخدام
برمجيات GNU:
<https://www.gnu.org/gethelp/>.
للحصول على
التوثيق
الكامل،
نفذ: info bison.
حقوق النسخ¶
حقوق
النشر © 2021
مؤسسة
البرمجيات
الحرة،
المحدودة.
هذا برنامج
حر؛ انظر
المصدر
لشروط
النسخ. لا
يوجد أي
ضمان؛ ولا
حتى ضمان
قابلية
التسويق أو
الملاءمة
لغرض معين.
انظر أيضًا¶
يُصان التوثيق الكامل لـ bison كدليل Texinfo. إذا كانت برامج info و bison مثبتة بشكل صحيح في موقعك، فإن الأمر
- info bison
سيتيح لك الوصول إلى الدليل الكامل.
ترجمة¶
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>
هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.
| سبتمبر 2021 | GNU Bison 3.8.2 |