نام (NAME)

cvsbug - ارسال گزارش اشکال در مورد سامانه CVS به GNATS

خلاصه دستور (SYNOPSIS)

cvsbug [ site ] [ -f problem-report ] [ -t mail-address ]

[ -P ] [ -L ] [ --request-id ] [ -v ]

توضیحات (DESCRIPTION)

دستور cvsbug ابزاری است که برای ارسال گزارش‌های اشکال (PRها) به یک پایگاه پشتیبانی مرکزی به کار می‌رود. در بیشتر موارد، مقدار پیش‌فرض، site صحیح خواهد بود. این آرگومان مشخص‌کننده پایگاه پشتیبانی مسئولی است که به دسته‌بندی مشکل مورد نظر رسیدگی می‌کند. برخی پایگاه‌ها ممکن است از یک آدرس محلی به عنوان پیش‌فرض استفاده کنند. مقادیر site با استفاده از aliases(5) تعریف می‌شوند.

دستور cvsbug یک ویرایشگر متن را روی قالب گزارش اشکال باز می‌کند (پس از تلاش برای پر کردن برخی فیلدها با مقادیر پیش‌فرض معقول). هنگامی که از ویرایشگر خارج می‌شوید، cvsbug فرم تکمیل‌شده را به سامانه مدیریت گزارش اشکال (GNATS) در یک پایگاه پشتیبانی مرکزی ارسال می‌کند. در پایگاه پشتیبانی، به هر PR یک شماره یکتا اختصاص داده می‌شود و در پایگاه‌داده GNATS بر اساس دسته‌بندی و شناسه فرستنده (submitter-id) ذخیره می‌گردد. GNATS به صورت خودکار پاسخی مبنی بر دریافت گزارش ارسال کرده و در آن به دسته‌بندی و شماره PR اشاره می‌کند.

برای اطمینان از رسیدگی سریع به یک PR، گزارش باید شامل submitter-id (یکتای) شما و یکی از categories موجود جهت تعیین حوزه مشکل باشد. (از `cvsbug -L' برای مشاهده فهرست دسته‌بندی‌ها استفاده کنید.)

قالب cvsbug در پایگاه شما باید از پیش با شناسه فرستنده (submitter-id) شما سفارشی‌سازی شده باشد (اجرای دستور `install-sid submitter-id' برای انجام این کار، بخشی از مراحل نصب cvsbug است). اگر این کار انجام نشده است، برای دریافت submitter-id خود به مدیر سیستم مراجعه کنید، یا با فراخوانی `cvsbug --request-id' درخواستی به پایگاه پشتیبانی خود ارسال نمایید. اگر پایگاه شما تمایزی بین پایگاه‌های کاربری مختلف قائل نمی‌شود، یا اگر به پایگاه پشتیبانی وابسته نیستید، مقدار `net' را برای این فیلد به کار ببرید.

هر چه توضیحات مشکل دقیق‌تر و اطلاعات کامل‌تر باشد، تیم پشتیبانی سریع‌تر می‌تواند مشکلات را حل کند.

گزینه‌ها (OPTIONS)

-f problem-report: مشخص کردن فایلی (problem-report) که از قبل حاوی یک گزارش اشکال کامل است. cvsbug محتوای فایل را بدون باز کردن ویرایشگر ارسال می‌کند. اگر مقدار problem-report برابر با `-' باشد، آن‌گاه cvsbug از ورودی استاندارد می‌خواند.
-t mail-address: تغییر آدرس ایمیل در پایگاه پشتیبانی برای گزارش‌های اشکال. آدرس ایمیل (mail-address) پیش‌فرض، همان آدرس مورد استفاده برای site پیش‌فرض است. تقریباً در تمامی موارد، به جای این گزینه از آرگومان site استفاده کنید.
-P: چاپ فرم مشخص‌شده توسط متغیر محیطی PR_FORM در خروجی استاندارد. اگر PR_FORM تنظیم نشده باشد، قالب خام استاندارد PR چاپ می‌شود. هیچ ایمیلی ارسال نمی‌گردد.
-L: چاپ فهرست دسته‌بندی‌های موجود. هیچ ایمیلی ارسال نمی‌گردد.
--request-id: ارسال ایمیل به پایگاه پشتیبانی پیش‌فرض، یا site در صورت مشخص شدن، به همراه درخواست برای submitter-id شما. اگر به site وابسته نیستید، از مقدار `net' برای submitter-id استفاده کنید.
-v: نمایش شماره نسخه cvsbug.

نکته: برای ارسال گزارش‌های اشکال به جای ارسال مستقیم ایمیل، از cvsbug استفاده کنید. استفاده هم‌زمان از قالب و خود cvsbug به تضمین رسیدن تمام اطلاعات لازم به پایگاه پشتیبانی کمک می‌کند.

محیط (ENVIRONMENT)

متغیر محیطی EDITOR ویرایشگر مورد استفاده برای باز کردن قالب را تعیین می‌کند.
پیش‌فرض: vi

اگر متغیر محیطی PR_FORM تنظیم شده باشد، مقدار آن به عنوان نام فایل قالب در نشست ویرایش گزارش اشکال استفاده می‌شود. از این قابلیت می‌توانید برای شروع کار با یک فرم نیمه‌تکمیل (به عنوان مثال، فرمی که فیلدهای شناسایی آن از قبل پر شده‌اند) استفاده کنید.

نحوه تکمیل گزارش اشکال (HOW TO FILL OUT A PROBLEM REPORT)

گزارش‌های اشکال باید در قالب مشخصی باشند تا برنامه بتواند آن‌ها را به راحتی مدیریت کند. لطفاً رهنمودهای زیر را به خاطر داشته باشید:

در هر گزارش فقط یک مشکل را توصیف کنید.
برای ایمیل‌های پیگیری، از همان خط عنوان موجود در پیام تایید دریافت خودکار استفاده کنید. این عنوان شامل دسته‌بندی، شماره PR و خط خلاصه اولیه است. این امر به پایگاه پشتیبانی اجازه می‌دهد چندین پیام ایمیل را به یک PR خاص مرتبط ساخته و آن‌ها را به صورت خودکار ثبت کند.
لطفاً سعی کنید در خط عنوان یا خط خلاصه تا حد امکان دقیق باشید.
خط عنوان و خط خلاصه محرمانه نیستند؛ زیرا فهرست اشکالات باز از روی آن‌ها تدوین می‌شود. از قرار دادن اطلاعات محرمانه در آن‌ها خودداری کنید.

برای کسب اطلاعات دقیق درباره گزارش مشکلات، به فایل cvsbug.info در سامانه GNU Info یا سند Reporting Problems With cvsbug مراجعه کنید.

نحوه ارسال نمونه‌های آزمایشی، کد و غیره (HOW TO SUBMIT TEST CASES, CODE, ETC.)

نمونه کدهای کوچک را همراه با PR ارسال کنید. برای دریافت دستورالعمل‌های مربوط به ارسال نمونه‌های آزمایشی بزرگ‌تر و کدهای منبع مشکل‌دار، با پایگاه پشتیبانی تماس بگیرید.

فایل‌ها (FILES)

/tmp/p$$ نسخه کپی‌شده از PR مورد استفاده در نشست ویرایش
/tmp/pf$$ نسخه کپی‌شده از فرم خالی PR، برای مقاصد آزمایشی
/tmp/pbad$$ فایل مربوط به PRهای ردشده

نصب و پیکربندی (INSTALLATION AND CONFIGURATION)

برای دریافت دستورالعمل‌های نصب به INSTALL مراجعه کنید.

همچنین ببینید (SEE ALSO)

gnats(l), query-pr(1), edit-pr(1), gnats(8), queue-pr(8), at-pr(8), mkcat(8), mkdist(8).

نویسندگان (AUTHORS)

Jeffrey Osier, Brendan Kehoe, Jason Merrill, Heinz G. Seidl (Cygnus Support)

حق نشر (COPYING)

مجوز تهیه و توزیع نسخه‌های عین متن این راهنما اعطا می‌شود، مشروط بر این‌که یادداشت حق نشر و این یادداشت مجوز در تمام نسخه‌ها حفظ شوند.

مجوز تکثیر و توزیع نسخه‌های تغییریافته این راهنما تحت شرایط مربوط به نسخه‌های عین متن اعطا می‌شود، مشروط بر این‌که کل اثر اشتقاقی حاصل، تحت شرایط یادداشت مجوزی همسان با این یادداشت توزیع شود.

مجوز تکثیر و توزیع ترجمه‌های این راهنما به زبانی دیگر، تحت شرایط فوق برای نسخه‌های تغییریافته اعطا می‌شود؛ به جز این‌که این یادداشت مجوز می‌تواند به جای انگلیسی اصلی، در ترجمه‌های مورد تایید بنیاد نرم‌افزارهای آزاد درج شود.