KDebugDialog — це діалогове вікно, призначене для керування діагностичними повідомленнями під час виконання програм. У ньому передбачено простий та повний режими.
Щоб мати змогу вносити зміни, вам слід зняти позначку з пункту Вимкнути всі повідомлення налагоджування.
Примітка
Лише для програм, де використовується бібліотека Frameworks kdelibs4support.
kDebug() вважається застарілим у KDE Frameworks 5. Замість нього використовується вбудоване до Qt™ категоризоване ведення журналу, див. QLoggingCategory. Для вмикання та вимикання qCDebug скористайтеся kdebugsettings.
- Простий режим
Якщо ви просто виконаєте команду kdebugdialog5, ви побачите список «областей», які можна вимкнути або увімкнути. Виклик
kDebug(область)
у коді дасть якийсь налагоджувальний вивід, лише якщо цю область було увімкнено.Примітка
Зауважте, що kWarning, kError і kFatal з’являтимуться завжди, їх поява НЕ контролюється цим параметром.
Введіть шаблон пошуку у поле Пошук, розташоване у верхній частині списку. Таким чином, ви зможете наказати програмі виконати фільтрування пунктів, які буде показано на панелі списку. За допомогою кнопок, розташованих під панеллю списку ви можете позначити або зняти позначення з усіх пунктів (без виконання будь-яких інших дій) чи увімкнути або вимкнути вивід даних для певного пункту позначенням або зняттям позначки у полі перед ним.
- Повний режим
Якщо ви запустите команду kdebugdialog5
--fullmode
, ви зможете самі визначити дії, які буде виконано з діагностичними повідомленнями для кожного з рівнів важливості, те саме стосується і кожної з областей налагоджування.У повному режимі (fullmode), вам спочатку слід буде обрати потрібну область налагоджування за допомогою списку, розташованого у діалоговому вікні ліворуч, та поля для пошуку, розташованого над списком.
Ви можете окремо встановити виведення для різних типів повідомлень:
Інформація
Попередження
Помилка
Фатальна помилка
Для кожного з цих типів ви можете встановити такі параметри:
- Виводити до:
За допомогою цього спадного списку ви можете обрати область призначення для повідомлень. Серед варіантів: «Файл», «Вікно повідомлень», «Командна оболонка» (тобто stderr) і «Системний журнал». Будь ласка, не спрямовуйте повідомлення про критичні помилки до системного журналу (syslog), якщо ви не є системним адміністратором. Типовим значенням є «Командна оболонка».
- Назва файла:
Це поле стане доступним, лише якщо ви обрали як область призначення «Файл», у ньому ви можете вказати назву цього файла (відносно поточної теки). Типовим значенням є
kdebug.dbg
.
Окрім всього переліченого, ви також можете позначити поле з міткою Зупинятися під час фатальних помилок. У цьому випадку, якщо буде виведено діагностичне повідомлення з рівнем важливості
KDEBUG_FATAL
, програма завершить свою роботу з сигналом SIGABRT після виведення цього повідомлення.
Після того, як ви закриєте це діалогове вікно натисканням кнопки , вказані вами параметри буде негайно застосовано і збережено до файла $
(типово XDG_CONFIG_HOME
/kdebugrc~/.config/kdebugrc
). Якщо ви натиснете кнопку , вказані вами параметри буде скасовано і відновлено попередні значення.
Дякуємо Kalle Dalheimer за початкову версію KDebugDialog
Переклад українською: Юрій Чорноіван (yurchor ukr.net)
Цей документ поширюється за умов дотримання GNU Free Documentation License.