.\"
.\" دیدگاه‌ها و یادداشت‌های صفحه راهنما برای
.\"
.\"     Arnold Robbins
.\"     bug-gawk@gnu.org
.\"
.TH GAWKBUG 1 "2023 October 18" "GNU Awk 5.3" "دستورات کاربر"
.SH "نام (NAME)"
gawkbug \- گزارش خطا و باگ در gawk
.SH "خلاصه دستور (SYNOPSIS)"
.B gawkbug
[\fB\-\-version\fR] [\fB\-\-help\fR] [\fIemail\-address\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
.B gawkbug
یک اسکریپت شل (پوسته) است که به کاربر کمک می‌کند تا گزارش‌های اشکال و باگ مربوط به
.B gawk
را در قالبی استاندارد تنظیم کرده و با ایمیل ارسال نماید.
.PP
دستور
.B gawkbug
ویرایشگر تعیین‌شده توسط متغیر محیطی
.SM
.B EDITOR
را روی یک نسخه موقت از الگوی ساختار گزارش اشکال فراخوانی می‌کند. کاربر باید بخش‌های مناسب را تکمیل کرده و از ویرایشگر خارج شود.
.PP
سپس
.B gawkbug
گزارش تکمیل‌شده را به
\fIbug-gawk@gnu.org\fP
یا
\fIemail\-address\fP
مشخص‌شده ارسال می‌کند. در صورتی که گزارش قابل ارسال با ایمیل نباشد، در فایلی با نام
.I dead.gawkbug
در دایرکتوری خانگی کاربر اجراکننده ذخیره خواهد شد.
.PP
الگوی ساختار گزارش اشکال از چندین بخش تشکیل شده است: بخش اول اطلاعاتی پیرامون رایانه، سیستم‌عامل، نسخه
.B gawk
و محیط کامپایل ارائه می‌دهد. بخش دوم باید با شرحی از اشکال و باگ تکمیل شود. بخش سوم باید شامل توضیحی درباره نحوه بازتولید اشکال باشد. بخش چهارم اختیاری بوده و به راه‌حل پیشنهادی برای رفع اشکال اختصاص دارد. ارائه راه‌حل‌های پیشنهادی برای رفع اشکال تشویق می‌شود.
.SH "متغیرهای محیطی (ENVIRONMENT)"
دستور
.B gawkbug
در صورت وجود، از متغیرهای محیطی زیر استفاده خواهد کرد:
.TP
.B EDITOR
ویرایشگر ترجیحی کاربر را مشخص می‌کند. اگر
.SM
.B EDITOR
تنظیم نشده باشد،
.B gawkbug
تلاش می‌کند تعدادی از ویرایشگرهای جایگزین از جمله
.BR vim
و در صورت لزوم
.BR emacs
را بیابد. اگر
.B gawkbug
نتواند هیچ‌یک از ویرایشگرهای جایگزین را پیدا کند، تلاش می‌کند
.B vi
را اجرا کند.
.TP
.B HOME
دایرکتوری خانگی کاربر که در صورت عدم موفقیت در ارسال ایمیل، گزارش ارسال‌نشده در آن ذخیره می‌شود.
.TP
.B TMPDIR
دایرکتوری مورد استفاده برای ایجاد فایل‌ها و دایرکتوری‌های موقت.
.SH "فایلها (FILES)"
.TP
.I ~/dead.gawkbug
فایلی در دایرکتوری خانگی کاربر که در صورت ناموفق بودن ارسال ایمیل، پیش‌نویس گزارش اشکال در آن ذخیره می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR gawk (1)
.SH "نویسندگان (AUTHORS)"
Brian Fox, Free Software Foundation
.br
bfox@gnu.org
.PP
Chet Ramey, Case Western Reserve University
.br
chet@po.cwru.edu
.PP
Arnold Robbins
.br
bug-gawk@gnu.org