.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.4. .TH BISON "1" "سپتامبر 2021" "GNU Bison 3.8.2" "دستورات کاربر" .SH "نام (NAME)" bison \- مولد تجزیه‌کننده پروژه گنو (جایگزین yacc) .SH "خلاصه دستور (SYNOPSIS)" .B bison [\fI\,گزینه\/\fR]... \fI\,فایل\/\fR .SH "توضیحات (DESCRIPTION)" .I Bison یک مولد تجزیه‌کننده (parser generator) به سبک .IR yacc (1) است. این ابزار باید با فایل‌های ورودی طراحی‌شده برای .IR yacc سازگاری رو به بالا (upward compatible) داشته باشد. .PP فایل‌های ورودی باید از قرارداد .I yacc پیروی کرده و به پسوند .B .y ختم شوند. برخلاف .IR yacc ، فایل‌های تولیدشده نام ثابتی ندارند، بلکه از پیشوند فایل ورودی استفاده می‌کنند. علاوه بر این، اگر نیاز دارید کدهای .I C++ را در فایل ورودی قرار دهید، می‌توانید انتهای نام آن را با یک پسوند شبیه به C++ مانند (.ypp یا .y++) مشخص کنید؛ در این صورت، bison از پسوند شما برای نام‌گذاری فایل خروجی (.cpp یا .c++) پیروی خواهد کرد. برای نمونه، یک فایل توصیف گرامر با نام .B parse.yxx تجزیه‌کننده تولیدشده را در فایلی به نام .B parse.tab.cxx تولید می‌کند، به جای .B y.tab.c در .I yacc یا .B parse.tab.c در نسخه‌های قدیمی‌تر .BR Bison . .PP این توصیف از گزینه‌هایی که می‌توان به .I bison داد، از گره .B Invocation در کتابچه راهنمای .B bison.texi اقتباس شده است که باید به‌عنوان مرجع اصلی در نظر گرفته شود. .PP .I Bison هم از گزینه‌های سنتی تک‌حرفی و هم از نام‌های طولانی و معنی‌دار (mnemonic) برای گزینه‌ها پشتیبانی می‌کند. نام‌های طولانی گزینه‌ها به جای .BR \- ، با .B \-\- مشخص می‌شوند. تا زمانی که مخفف‌ها یکتا باشند، استفاده از مخفف نام گزینه‌ها مجاز است. هنگامی که یک گزینه طولانی آرگومانی می‌پذیرد، مانند .BR \-\-file-prefix ، نام گزینه و آرگومان را با .B = به یکدیگر متصل کنید. .PP تولید یک تجزیه‌کننده قطعی LR یا تعمیم‌یافته (GLR) با به‌کارگیری جدول‌های تجزیه LALR(1)، IELR(1) یا متعارف LR(1). .PP آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند. این قاعده برای آرگومان‌های اختیاری نیز صادق است. .SS "حالت‌های عملیاتی (Operation Modes):" .TP \fB\-h\fR, \fB\-\-help\fR نمایش این راهنما و خروج .TP \fB\-V\fR, \fB\-\-version\fR نمایش اطلاعات نسخه و خروج .TP \fB\-\-print\-localedir\fR نمایش دایرکتوری حاوی داده‌های وابسته به محلی‌سازی (locale) و خروج .TP \fB\-\-print\-datadir\fR نمایش دایرکتوری حاوی اسکلت‌ها و XSLT و خروج .TP \fB\-u\fR, \fB\-\-update\fR اعمال اصلاحات بر روی فایل گرامر منبع و خروج .TP \fB\-f\fR, \fB\-\-feature\fR[=\fI\,FEATURES\/\fR] فعال‌سازی ویژگی‌های گوناگون .SS "مقدار FEATURES فهرستی از واژگان جداشده با ویرگول است که می‌تواند شامل موارد زیر باشد:" .TP caret, diagnostics\-show\-caret نمایش خطاها با علامت‌های هشتک (caret) .TP fixit, diagnostics\-parseable\-fixits نمایش اصلاحات قابل‌خواندن توسط ماشین .TP syntax\-only هیچ فایلی تولید نشود .TP all تمام موارد بالا .TP none غیرفعال‌سازی تمام موارد بالا .SS "عیب‌یابی (Diagnostics):" .TP \fB\-W\fR, \fB\-\-warnings\fR[=\fI\,CATEGORY\/\fR] گزارش هشدارهای مربوط به دسته CATEGORY .TP \fB\-\-color\fR[=\fI\,WHEN\/\fR] تعیین وضعیت رنگی‌سازی پیام‌های عیب‌یابی .TP \fB\-\-style\fR=\fI\,FILE\/\fR مشخص کردن فایل CSS برای رنگ‌بندی پیام‌های عیب‌یابی .SS "دسته‌های هشدار عبارتند از (Warning categories):" .TP conflicts\-sr تداخل‌های جابجایی/کاهش (S/R) (به‌طور پیش‌فرض فعال است) .TP conflicts\-rr تداخل‌های کاهش/کاهش (R/R) (به‌طور پیش‌فرض فعال است) .TP counterexamples, cex تولید مثال‌های نقض تداخل .TP dangling\-alias نام‌های مستعار رشته‌ای که به هیچ نمادی متصل نشده‌اند .TP deprecated ساختارهای منسوخ‌شده .TP empty\-rule قوانین خالی بدون %empty .TP midrule\-values مقادیر قانونی میانی (midrule) تنظیم‌نشده یا استفاده‌نشده .TP precedence اولویت و شرکت‌پذیری بی‌استفاده .TP yacc ناسازگاری‌ها با POSIX Yacc .TP other سایر هشدارها (به‌طور پیش‌فرض فعال است) .TP all همه هشدارها به جز 'counterexamples'، 'dangling\-alias' و 'yacc' .TP no\-CATEGORY غیرفعال‌سازی هشدارها در دسته CATEGORY .TP none غیرفعال‌سازی تمام هشدارها .TP error[=CATEGORY] تلقی کردن هشدارها به عنوان خطا .SS "مقدار WHEN می‌تواند یکی از موارد زیر باشد:" .TP always, yes رنگی کردن خروجی .TP never, no رنگی نکردن خروجی .TP auto, tty رنگی کردن در صورتی که دستگاه خروجی یک tty باشد .SS "تنظیم و سفارشی‌سازی تجزیه‌کننده (Tuning the Parser):" .TP \fB\-L\fR, \fB\-\-language\fR=\fI\,LANGUAGE\/\fR مشخص کردن زبان برنامه‌نویسی خروجی .TP \fB\-S\fR, \fB\-\-skeleton\fR=\fI\,FILE\/\fR مشخص کردن اسکلت (قالب) مورد استفاده .TP \fB\-t\fR, \fB\-\-debug\fR آماده‌سازی تجزیه‌کننده برای ردیابی؛ مشابه با '\-Dparse.trace' .TP \fB\-\-locations\fR فعال‌سازی پشتیبانی از موقعیت مکانی .TP \fB\-D\fR, \fB\-\-define=NAME\fR[=\fI\,VALUE\/\fR] مشابه با '%define NAME VALUE' .TP \fB\-F\fR, \fB\-\-force\-define=NAME\fR[=\fI\,VALUE\/\fR] بازنویسی و لغو '%define NAME VALUE' .TP \fB\-p\fR, \fB\-\-name\-prefix\fR=\fI\,PREFIX\/\fR افزودن PREFIX به ابتدای نمادهای خارجی؛ منسوخ‌شده با '\-Dapi.prefix={PREFIX}' .TP \fB\-l\fR, \fB\-\-no\-lines\fR دستورالعمل‌های '#line' تولید نشوند .TP \fB\-k\fR, \fB\-\-token\-table\fR شامل جدول نام‌های نشانه‌ها (توکن‌ها) .TP \fB\-y\fR, \fB\-\-yacc\fR شبیه‌سازی POSIX Yacc .SS "فایل‌های خروجی (Output Files):" .TP \fB\-H\fR, \fB\-\-header\fR=\fI\,[FILE]\/\fR همچنین یک فایل سرآیند (header) ایجاد کند .TP \fB\-d\fR مشابه مورد قبل، اما امکان تعیین FILE وجود ندارد (برای POSIX Yacc) .TP \fB\-r\fR, \fB\-\-report\fR=\fI\,THINGS\/\fR همچنین جزئیات مربوط به ماشین خودکار (اتوماتون) را تولید کند .TP \fB\-\-report\-file\fR=\fI\,FILE\/\fR نوشتن گزارش در FILE .TP \fB\-v\fR, \fB\-\-verbose\fR مشابه با '\-\-report=state' .TP \fB\-b\fR, \fB\-\-file\-prefix\fR=\fI\,PREFIX\/\fR تعیین یک پیشوند PREFIX برای فایل‌های خروجی .TP \fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR قرار دادن خروجی در FILE .TP \fB\-g\fR, \fB\-\-graph\fR[=\fI\,FILE\/\fR] همچنین خروجی گراف از اتوماتون تولید کند .TP \fB\-\-html\fR[=\fI\,FILE\/\fR] همچنین یک گزارش HTML از اتوماتون تولید کند .TP \fB\-x\fR, \fB\-\-xml\fR[=\fI\,FILE\/\fR] همچنین یک گزارش XML از اتوماتون تولید کند .TP \fB\-M\fR, \fB\-\-file\-prefix\-map\fR=\fI\,OLD=NEW\/\fR جایگزین کردن پیشوند OLD با NEW هنگام نوشتن مسیرهای فایل در فایل‌های خروجی .SS "مقدار THINGS فهرستی از واژگان جداشده با ویرگول است که می‌تواند شامل موارد زیر باشد:" .TP states توصیف وضعیت‌ها (states) .TP itemsets تکمیل مجموعه‌آیتم‌های اصلی با بستار (closure) آن‌ها .TP lookaheads انتساب صریح نشانه‌های پیش‌نگاه (lookahead) به آیتم‌ها .TP solved توصیف حل تداخل‌های جابجایی/کاهش (shift/reduce) .TP counterexamples, cex تولید مثال‌های نقض تداخل .TP all شامل تمام اطلاعات بالا .TP none غیرفعال‌سازی گزارش .SH "نویسندگان (AUTHORS)" نوشته‌شده توسط Robert Corbett و Richard Stallman. .SH "گزارش باگ‌ها (REPORTING BUGS)" گزارش باگ‌ها به . .br صفحه اصلی گنو بایسون: .br راهنمای عمومی استفاده از نرم‌افزارهای گنو: .br برای دریافت مستندات کامل، دستور زیر را اجرا کنید: info bison. .SH "کپی‌رایت (COPYRIGHT)" حق نشر \(co 2021 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.). .br این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری به کد منبع مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص. .SH "همچنین ببینید (SEE ALSO)" .BR lex (1), .BR flex (1), .BR yacc (1). .PP مستندات کامل برای .B bison به‌صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های .B info و .B bison به‌درستی بر روی سیستم شما نصب شده باشند، دستور .IP .B info bison .PP دسترسی شما را به کتابچه راهنمای کامل فراهم خواهد کرد.