.\" -*- nroff -*-
.\" ---------------------------------------------------------------------------
.\"    man page for send-pr (by Heinz G. Seidl, hgs@cygnus.com)
.\"    updated Feb 1993 for GNATS 3.00 by Jeffrey Osier, jeffrey@cygnus.com
.\"
.\"    This file is part of the Problem Report Management System (GNATS)
.\"    Copyright 1992 Cygnus Support
.\"
.\"    This program is free software; you can redistribute it and/or
.\"    modify it under the terms of the GNU General Public
.\"    License as published by the Free Software Foundation; either
.\"    version 2 of the License, or (at your option) any later version.
.\"
.\"    This program is distributed in the hope that it will be useful,
.\"    but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\"    General Public License for more details.
.\"
.\" ---------------------------------------------------------------------------
.nh
.TH CVSBUG 8 xVERSIONx "February 1993"
.SH "نام (NAME)"
cvsbug \- ارسال گزارش اشکال در مورد سامانه CVS به GNATS
.SH "خلاصه دستور (SYNOPSIS)"
.B cvsbug
[
.I site
]
[
.B \-f
.I problem-report
]
[
.B \-t
.I mail-address
]
.br
.in +0.8i
[
.B \-P
]
[
.B \-L
]
[
.B \-\-request-id
]
[
.B \-v
]
.SH "توضیحات (DESCRIPTION)"
دستور
.B cvsbug
ابزاری است که برای ارسال
.I "گزارش‌های اشکال"
(PRها) به یک پایگاه پشتیبانی مرکزی به کار می‌رود. در بیشتر موارد، مقدار پیش‌فرض،
.I site
صحیح خواهد بود. این آرگومان مشخص‌کننده پایگاه پشتیبانی مسئولی است که به دسته‌بندی مشکل مورد نظر رسیدگی می‌کند. برخی پایگاه‌ها ممکن است از یک آدرس محلی به عنوان پیش‌فرض استفاده کنند. مقادیر
.I site
با استفاده از
.BR aliases (5)
تعریف می‌شوند.
.LP
دستور
.B cvsbug
یک ویرایشگر متن را روی قالب گزارش اشکال باز می‌کند (پس از تلاش برای پر کردن برخی فیلدها با مقادیر پیش‌فرض معقول). هنگامی که از ویرایشگر خارج می‌شوید،
.B cvsbug
فرم تکمیل‌شده را به
.I "سامانه مدیریت گزارش اشکال"
(\fBGNATS\fR)
در یک پایگاه پشتیبانی مرکزی ارسال می‌کند. در پایگاه پشتیبانی، به هر PR یک شماره یکتا اختصاص داده می‌شود و در پایگاه‌داده
.B GNATS
بر اساس دسته‌بندی و شناسه فرستنده (submitter-id) ذخیره می‌گردد.
.B GNATS
به صورت خودکار پاسخی مبنی بر دریافت گزارش ارسال کرده و در آن به دسته‌بندی و شماره PR اشاره می‌کند.
.LP
برای اطمینان از رسیدگی سریع به یک PR، گزارش باید شامل
.I submitter-id
(یکتای) شما و یکی از
.I categories
موجود جهت تعیین حوزه مشکل باشد. (از
.B `cvsbug -L'
برای مشاهده فهرست دسته‌بندی‌ها استفاده کنید.)
.LP
قالب
.B cvsbug
در پایگاه شما باید از پیش با شناسه فرستنده (submitter-id) شما سفارشی‌سازی شده باشد (اجرای دستور `\|\fBinstall-sid\fP \fIsubmitter-id\fP\|' برای انجام این کار، بخشی از مراحل نصب
.B cvsbug
است). اگر این کار انجام نشده است، برای دریافت submitter-id خود به مدیر سیستم مراجعه کنید، یا با فراخوانی
.B `cvsbug \-\-request\-id'
درخواستی به پایگاه پشتیبانی خود ارسال نمایید. اگر پایگاه شما تمایزی بین پایگاه‌های کاربری مختلف قائل نمی‌شود، یا اگر به پایگاه پشتیبانی وابسته نیستید، مقدار
.B `net'
را برای این فیلد به کار ببرید.
.LP
هر چه توضیحات مشکل دقیق‌تر و اطلاعات کامل‌تر باشد، تیم پشتیبانی سریع‌تر می‌تواند مشکلات را حل کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-f " problem-report"
مشخص کردن فایلی
(\fIproblem-report\fR)
که از قبل حاوی یک گزارش اشکال کامل است.
.B cvsbug
محتوای فایل را بدون باز کردن ویرایشگر ارسال می‌کند. اگر مقدار
.I problem-report
برابر با
.B `\|\-\|'
باشد، آن‌گاه
.B cvsbug
از ورودی استاندارد می‌خواند.
.TP
.BI \-t " mail-address"
تغییر آدرس ایمیل در پایگاه پشتیبانی برای گزارش‌های اشکال. آدرس ایمیل
(\fImail-address\fR)
پیش‌فرض، همان آدرس مورد استفاده برای
.I site
پیش‌فرض است. تقریباً در تمامی موارد، به جای این گزینه از آرگومان
.I site
استفاده کنید.
.TP
.B \-P
چاپ فرم مشخص‌شده توسط متغیر محیطی
.B PR_FORM
در خروجی استاندارد. اگر
.B PR_FORM
تنظیم نشده باشد، قالب خام استاندارد PR چاپ می‌شود. هیچ ایمیلی ارسال نمی‌گردد.
.TP
.B -L
چاپ فهرست دسته‌بندی‌های موجود. هیچ ایمیلی ارسال نمی‌گردد.
.TP
.B \-\-request\-id
ارسال ایمیل به پایگاه پشتیبانی پیش‌فرض، یا
.I site
در صورت مشخص شدن، به همراه درخواست برای
.I submitter-id
شما. اگر به
.I site
وابسته نیستید، از مقدار
.B `net'
برای
.I submitter-id
استفاده کنید.
.TP
.B \-v
نمایش شماره نسخه
.BR cvsbug .
.LP
نکته: برای ارسال گزارش‌های اشکال به جای ارسال مستقیم ایمیل، از
.B cvsbug
استفاده کنید. استفاده هم‌زمان از قالب و خود
.B cvsbug
به تضمین رسیدن تمام اطلاعات لازم به پایگاه پشتیبانی کمک می‌کند.
.SH "محیط (ENVIRONMENT)"
متغیر محیطی
.B EDITOR
ویرایشگر مورد استفاده برای باز کردن قالب را تعیین می‌کند.
.br
پیش‌فرض:
.B vi
.sp
اگر متغیر محیطی
.B PR_FORM
تنظیم شده باشد، مقدار آن به عنوان نام فایل قالب در نشست ویرایش گزارش اشکال استفاده می‌شود. از این قابلیت می‌توانید برای شروع کار با یک فرم نیمه‌تکمیل (به عنوان مثال، فرمی که فیلدهای شناسایی آن از قبل پر شده‌اند) استفاده کنید.
.SH "نحوه تکمیل گزارش اشکال (HOW TO FILL OUT A PROBLEM REPORT)"
گزارش‌های اشکال باید در قالب مشخصی باشند تا برنامه بتواند آن‌ها را به راحتی مدیریت کند. لطفاً رهنمودهای زیر را به خاطر داشته باشید:
.IP \(bu 3m
در هر گزارش فقط
.B یک مشکل
را توصیف کنید.
.IP \(bu 3m
برای ایمیل‌های پیگیری، از همان خط عنوان موجود در پیام تایید دریافت خودکار استفاده کنید. این عنوان شامل دسته‌بندی، شماره PR و خط خلاصه اولیه است. این امر به پایگاه پشتیبانی اجازه می‌دهد چندین پیام ایمیل را به یک PR خاص مرتبط ساخته و آن‌ها را به صورت خودکار ثبت کند.
.IP \(bu 3m
لطفاً سعی کنید در خط عنوان یا خط خلاصه تا حد امکان دقیق باشید.
.IP \(bu 3m
خط عنوان و خط خلاصه محرمانه نیستند؛ زیرا فهرست اشکالات باز از روی آن‌ها تدوین می‌شود. از قرار دادن اطلاعات محرمانه در آن‌ها خودداری کنید.
.LP
برای کسب اطلاعات دقیق درباره گزارش مشکلات، به فایل
.B cvsbug.info
در سامانه GNU
.B Info
یا سند \fIReporting Problems With cvsbug\fR مراجعه کنید.
.SH "نحوه ارسال نمونه‌های آزمایشی، کد و غیره (HOW TO SUBMIT TEST CASES, CODE, ETC.)"
نمونه کدهای کوچک را همراه با PR ارسال کنید. برای دریافت دستورالعمل‌های مربوط به ارسال نمونه‌های آزمایشی بزرگ‌تر و کدهای منبع مشکل‌دار، با پایگاه پشتیبانی تماس بگیرید.
.SH "فایل‌ها (FILES)"
.ta \w'/tmp/pbad$$  'u
/tmp/p$$	نسخه کپی‌شده از PR مورد استفاده در نشست ویرایش
.br
/tmp/pf$$	نسخه کپی‌شده از فرم خالی PR، برای مقاصد آزمایشی
.br
/tmp/pbad$$	فایل مربوط به PRهای ردشده
.SH "نصب و پیکربندی (INSTALLATION AND CONFIGURATION)"
برای دریافت دستورالعمل‌های نصب به
.B INSTALL
مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR gnats (l),
.BR query-pr (1),
.BR edit-pr (1),
.BR gnats (8),
.BR queue-pr (8),
.BR at-pr (8),
.BR mkcat (8),
.BR mkdist (8).
.SH "نویسندگان (AUTHORS)"
Jeffrey Osier, Brendan Kehoe, Jason Merrill, Heinz G. Seidl (Cygnus
Support)
.SH "حق نشر (COPYING)"
حق نشر \(co 1992, 1993 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)
.PP
مجوز تهیه و توزیع نسخه‌های عین متن این راهنما اعطا می‌شود، مشروط بر این‌که یادداشت حق نشر و این یادداشت مجوز در تمام نسخه‌ها حفظ شوند.
.PP
مجوز تکثیر و توزیع نسخه‌های تغییریافته این راهنما تحت شرایط مربوط به نسخه‌های عین متن اعطا می‌شود، مشروط بر این‌که کل اثر اشتقاقی حاصل، تحت شرایط یادداشت مجوزی همسان با این یادداشت توزیع شود.
.PP
مجوز تکثیر و توزیع ترجمه‌های این راهنما به زبانی دیگر، تحت شرایط فوق برای نسخه‌های تغییریافته اعطا می‌شود؛ به جز این‌که این یادداشت مجوز می‌تواند به جای انگلیسی اصلی، در ترجمه‌های مورد تایید بنیاد نرم‌افزارهای آزاد درج شود.