نام (NAME)

git-bugreport - جمع‌آوری اطلاعات برای کاربر جهت ارسال گزارش باگ

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

git bugreport [(-o | --output-directory) <path>]
                [(-s | --suffix) <format> | --no-suffix]
                [--diagnose[=<mode>]]

توضیحات (DESCRIPTION)

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

اطلاعات زیر از کاربر درخواست می‌شود:

•مراحل بازتولید مشکل

•رفتار مورد انتظار

•رفتار واقعی مشاهده‌شده

اطلاعات زیر به صورت خودکار ثبت می‌شوند:

•git version --build-options

•رشته‌های uname شامل sysname، انتشار (release)، نسخه (version) و معماری ماشین

•رشته اطلاعات مربوط به کامپایلر

•فهرستی از هوک‌های فعال

•$SHELL

اطلاعات بیشتر را می‌توان با استفاده از گزینه --diagnose در یک بایگانی zip مجزا گردآوری کرد و برای ارائه زمینه و اطلاعات تکمیلی به خوانندگان، در کنار سند گزارش باگ ضمیمه نمود.

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

گزینه‌ها (OPTIONS)

-o <path>, --output-directory <path>

فایل گزارش باگ نهایی را به جای دایرکتوری جاری در <path> قرار می‌دهد.

-s <format>, --suffix <format>, --no-suffix

یک پسوند جایگزین برای نام گزارش باگ مشخص می‌کند تا فایلی با نام git-bugreport-<formatted-suffix> ایجاد شود. این مقدار باید در قالب یک رشته فرمت strftime(3) باشد؛ زمان محلی جاری استفاده خواهد شد. --no-suffix پسوند را غیرفعال می‌کند و فایل فقط با نام git-bugreport بدون هیچ‌گونه شناسه تمایزبخش نام‌گذاری می‌شود.

--no-diagnose, --diagnose[=<mode>]

یک بایگانی zip از اطلاعات تکمیلی درباره رایانه کاربر، کلاینت گیت و وضعیت مخزن ایجاد می‌کند. بایگانی در همان دایرکتوری خروجی گزارش باگ نوشته می‌شود و نام آن git-diagnostics-<formatted-suffix> خواهد بود.

بدون مشخص کردن mode ، بایگانی تشخیصی حاوی مجموعه آمارهای پیش‌فرضی خواهد بود که توسط git diagnose گزارش می‌شود. یک مقدار اختیاری mode می‌تواند برای تغییر اطلاعات گنجانده‌شده در بایگانی مشخص شود. برای فهرست مقادیر معتبر mode و جزئیات مربوط به نحوه استفاده از آن‌ها، به git-diagnose(1) مراجعه کنید.

GIT

بخشی از مجموعه git(1)