.\"
.\" دیدگاه‌ها و یادداشت‌های صفحه راهنما برای
.\"
.\"     Chet Ramey
.\"     Case Western Reserve University
.\"     chet@po.cwru.edu
.\"
.\"     آخرین تغییر: یکشنبه ۲ اوت ۲۰۲۰
.\"
.TH BASHBUG 1 "2020 August 1" "GNU Bash 5.1" "دستورات کاربر"
.SH "نام (NAME)"
bashbug \- گزارش اشکال در نرم‌افزار bash به نگهدارندگان آن
.SH "خلاصه دستور (SYNOPSIS)"
.B bashbug
[\fB\-\-version\fR] [\fB\-\-help\fR] [\fIemail\-address\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
.B bashbug
یک اسکریپت پوسته است که به کاربر کمک می‌کند تا گزارش‌های اشکال مربوط به
.B bash
را در قالبی استاندارد تنظیم کرده و با ایمیل ارسال نماید.
.PP
دستور
.B bashbug
ویرایشگر تعیین‌شده توسط متغیر محیطی
.SM
.B EDITOR
را روی یک نسخه موقت از الگوی گزارش اشکال باز می‌کند. کاربر باید بخش‌های مناسب را تکمیل کرده و از ویرایشگر خارج شود.
.PP
سپس
.B bashbug
گزارش تکمیل‌شده را به
.I bug-bash@gnu.org
یا
.I email\-address
مشخص‌شده ارسال می‌کند. در صورتی که گزارش قابل ارسال نباشد، در فایلی به نام
.I dead.bashbug
در دایرکتوری خانگی کاربر اجراکننده ذخیره خواهد شد.
.PP
الگوی فرمت گزارش اشکال از چندین بخش تشکیل شده است:
.PP
بخش نخست اطلاعاتی پیرامون رایانه، سیستم‌عامل، نسخه
.B bash
و محیط کامپایل ارائه می‌دهد. بخش دوم باید با شرحی از اشکال پیش‌آمده پر شود. بخش سوم باید شامل توضیحی درباره نحوه بازتولید اشکال باشد. بخش چهارم اختیاری بوده و به راه‌حل پیشنهادی برای رفع اشکال اختصاص دارد. ارائه راه‌حل‌های پیشنهادی برای رفع اشکال تشویق می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-help
نمایش پیام کوتاه راهنما و خروج.
.TP
.B \-\-version
نمایش اطلاعات نسخه و خروج.
.SH "محیط (ENVIRONMENT)"
دستور
.B bashbug
در صورت وجود، از متغیرهای محیطی زیر استفاده خواهد کرد:
.TP
.B DEFEDITOR
ویرایشگر پیش‌فرض جهت ویرایش گزارش اشکال (در صورت عدم تنظیم
.SM
.B EDITOR
توسط کاربر).
.TP
.B EDITOR
ویرایشگر ترجیحی کاربر را مشخص می‌کند. اگر
.SM
.B EDITOR
تنظیم نشده باشد،
.B bashbug
تلاش می‌کند ویرایشگری که توسط
.B DEFEDITOR
مشخص شده یا تعدادی از ویرایشگرهای جایگزین از جمله
.BR emacs
را بیابد. اگر
.B bashbug
نتواند هیچ‌یک از ویرایشگرهای جایگزین را پیدا کند، تلاش می‌کند
.B vi
را اجرا کند.
.TP
.B HOME
دایرکتوری خانگی کاربر که در صورت ناموفق بودن ارسال ایمیل، گزارش ارسال‌نشده در آن ذخیره می‌شود.
.TP
.B TMPDIR
دایرکتوری مورد استفاده برای ایجاد فایل‌ها و دایرکتوری‌های موقت.
.SH "فایل‌ها (FILES)"
.TP
.I ~/dead.bashbug
فایلی در دایرکتوری خانگی کاربر که در صورت عدم موفقیت در ارسال ایمیل، پیش‌نویس گزارش اشکال در آن ذخیره می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR bash (1)
.SH "نویسندگان (AUTHORS)"
Brian Fox, Free Software Foundation
.br
bfox@gnu.org
.PP
Chet Ramey, Case Western Reserve University
.br
chet@po.cwru.edu