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 مؤسسة البرمجيات الحرة، المحدودة.
هذا برنامج حر؛ انظر المصدر لشروط النسخ. لا يوجد أي ضمان؛ ولا حتى ضمان قابلية التسويق أو الملاءمة لغرض معين.

انظر أيضًا
lex(1)، flex(1)، yacc(1).

يُصان التوثيق الكامل لـ bison كدليل Texinfo. إذا كانت برامج info و bison مثبتة بشكل صحيح في موقعك، فإن الأمر

    info bison

سيتيح لك الوصول إلى الدليل الكامل.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.