'\" t
.\"     Title: kdebugsettings
.\"    Author: Laurent Montel <montel@kde.org>
.\" Generator: Parch Linux Man Pages Project
.\"      Date: 2026-10-08
.\"    Manual: راهنمای کاربر KDebugSettings
.\"    Source: KDE Applications
.\"  Language: Persian
.\"
.TH "KDEBUGSETTINGS" "1" "2026\-10\-08" "KDE Applications" "راهنمای کاربر KDebugSettings"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.nh
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
kdebugsettings \- مدیریت و تنظیم خروجی‌های اشکال‌زدایی QLoggingCategory در KDE
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBkdebugsettings\fR\ 'u
\fBkdebugsettings\fR [\fB\-\-list\fR] [\fB\-\-enable\-full\-debug\fR] [\fB\-\-disable\-full\-debug\fR] [\fB\-\-debug\-mode\fR\ \fIحالت\fR\ \fIدسته‌بندی\&.\&.\&.\fR] [\fB\-\-test\-mode\fR] [\fIگزینه‌های عمومی\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
.B kdebugsettings
ابزاری برای محیط رومیزی KDE است که امکان پیکربندی و مدیریت پیام‌های اشکال‌زدایی و لاگ‌های برنامه‌ها و کتابخانه‌های مبتنی بر Qt و KDE را بدون نیاز به کامپایل مجدد آن‌ها فراهم می‌کند.
.PP
برنامه‌های مدرن KDE و Qt خروجی‌های اشکال‌زدایی خود را در قالب «دسته‌بندی‌های وقایع‌نگاری»
.RB ( QLoggingCategory )
گروه‌بندی می‌کنند. با استفاده از
.B kdebugsettings
می‌توان مشخص کرد که کدام دسته‌بندی‌ها فعال یا غیرفعال باشند و پیام‌ها با چه سطح حساسیتی
.RB ( Debug ,
.BR Info ,
.BR Warning ,
.BR Critical )
نمایش داده شوند.
.PP
این برنامه تنظیمات را در فایل
.I ~/.config/qtlogging.ini
ذخیره می‌کند. علاوه بر رابط کاربری گرافیکی (GUI)، این ابزار گزینه‌های خط فرمان متنوعی را برای مشاهده و تغییر قوانین بدون باز کردن پنجره برنامه ارائه می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-list
چاپ نام تمام دسته‌بندی‌های وقایع‌نگاری شناخته‌شده در خروجی استاندارد و خروج بدون اعمال هیچ تغییری.
.TP
.B \-\-enable\-full\-debug
تنظیم تمام دسته‌بندی‌های شناخته‌شده روی حالت اشکال‌زدایی کامل
.RB ( "Full Debug" )
و خروج از برنامه.
.TP
.B \-\-disable\-full\-debug
خاموش کردن
.RB ( Off )
تمام دسته‌بندی‌های وقایع‌نگاری شناخته‌شده و خروج از برنامه.
.TP
\fB\-\-debug\-mode\fR \fIحالت\fR \fIدسته‌بندی\&.\&.\&.\fR
تنظیم سطح اشکال‌زدایی مشخص‌شده روی دسته‌بندی‌های ذکرشده و خروج از برنامه.
مقادیر مجاز برای
.I حالت
عبارتند از:
.BR Full ،
.BR Info ،
.BR Warning ،
.B Critical
یا
.BR Off .
حداقل نام یک دسته‌بندی باید به عنوان آرگومان مشخص شود.
.TP
.B \-\-test\-mode
فعال‌سازی حالت آزمایشی
.B QStandardPaths
جهت استفاده از تنظیمات آزمون‌های واحد به جای تنظیمات واقعی کاربر.
.TP
.BR \-h , \ \-\-help
نمایش پیام راهنما درباره گزینه‌های خط فرمان و خروج.
.TP
.BR \-v , \ \-\-version
نمایش اطلاعات نسخه برنامه و خروج.
.TP
.B \-\-author
نمایش اطلاعات نویسندگان برنامه.
.TP
.B \-\-license
نمایش اطلاعات مجوز برنامه.
.SH "فایل‌ها (FILES)"
.TP
.I ~/.config/qtlogging.ini
فایل پیکربندی محلی کاربر که قوانین وقایع‌نگاری کیوت در آن ذخیره می‌شوند.
.TP
.I /usr/share/qlogging\-categories6/
دایرکتوری سیستم حاوی فایل‌های تعریف دسته‌بندی‌ها
.RI ( .categories )
برای برنامه‌های مبتنی بر KDE Frameworks 6.
.TP
.I /usr/share/qlogging\-categories5/
دایرکتوری سیستم حاوی فایل‌های تعریف دسته‌بندی‌ها برای برنامه‌های مبتنی بر KDE Frameworks 5.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B QT_LOGGING_RULES
قوانین موقت وقایع‌نگاری کیوت را برای نشست یا پردازش جاری مشخص می‌کند و بر تنظیمات ذخیره‌شده در فایل
.I qtlogging.ini
ارجحیت دارد.
.SH "مثال‌ها (EXAMPLES)"
.PP
مشاهده فهرست تمامی دسته‌بندی‌های وقایع‌نگاری موجود در سیستم:
.PP
.RS 4
.nf
kdebugsettings \-\-list
.fi
.RE
.PP
فعال‌سازی اشکال‌زدایی کامل برای دسته‌بندی‌های مربوط به KMail و پلاسما:
.PP
.RS 4
.nf
kdebugsettings \-\-debug\-mode Full org.kde.pim.kmail org.kde.plasma
.fi
.RE
.PP
غیرفعال‌سازی تمام پیام‌های اشکال‌زدایی در سراسر سیستم:
.PP
.RS 4
.nf
kdebugsettings \-\-disable\-full\-debug
.fi
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
مستندات کامل در وب‌سایت رسمی KDE:
.PP
.RS 4
<https://docs.kde.org/trunk_kf6/en/kdebugsettings/kdebugsettings>
.RE
.SH "نویسندگان (AUTHORS)"
.PP
برنامه
.B kdebugsettings
توسط
.MT montel@kde.org
Laurent Montel
.ME
نوشته شده است.
.PP
این صفحه راهنما توسط تیم ترجمه صفحات راهنمای پارچ لینوکس به فارسی ترجمه و مستندسازی شده است.
.SH "گزارش اشکالات (REPORTING BUGS)"
.PP
گزارش اشکالات و پیشنهادات را به سامانه ردیابی خطاهای KDE ارسال کنید:
.PP
.RS 4
<https://bugs.kde.org>
.RE