# Podręcznik &kdebugdialog;

## Czym jest &kdebugdialog;?

Jest to okno dialogowe wyświetlające informacje diagnostyczne w trakcie działania programów.

Jeśli po prostu uruchomisz `kdebugdialog`, zobaczysz listę obszarów, które mogą być włączone lub wyłączone. Wywołanie `kDebug(area)` w kodzie programu pokaże coś na wyjściu debugowania tylko jeśli dany obszar jest włączony.

Uwaga: kWarning, kError oraz kFatal zawsze się pojawiają; to ustawienie NIE odnosi się do nich.

Obszar

- Obszary, które powinny być dawane na wyjściu. Każdy komunikat, o którym tutaj wspominamy, po prostu nie będzie przekazany na wyjście (chyba że to pole pozostanie puste, co jest domyślne i oznacza, że wszystkie komunikaty są przekazywane). Możesz podać kilka obszarów oddzielonych tutaj przecinkami, i możesz także używać zakresów używając składni początek-koniec. Dlatego poprawnym wpisem będzie na przykład 117,214-289,356-359,221. Nie używaj znaków białych.

Jeżeli program uruchomiony zostanie poleceniem `kdebugdialog` `--fullmode`, można dla każdego poziomu istotności i obszaru definiować rodzaj wyświetlanych informacji diagnostycznych.

W trybie pełnym najpierw powinieneś wybrać obszar debugowania, który Cię interesuje, z rozwijalnej listy na górze.

Możesz niezależnie ustawić wyjście dla różnych typów komunikatów:

- Information

- Ostrzeżenie

- Błąd

- Błąd krytyczny

Dla każdego z tych typów możesz ustawić następujące parametry:

Przekazuj do:

- W tym polu możesz wybrać, gdzie powinny być przekazywane komunikaty. Do wyboru są: Plik, Okienko wiadomości, Powłoka (czyli stderr-standardowe wyjście błędu) oraz Syslog. Proszę nie kierować błędów krytycznych do syslog'u, chyba że sam jesteś administratorem systemu. Domyślnie jest Message Box.

Nazwa pliku:

- Jest aktywne tylko jeżeli wybrano Plik jako wyjście i\ umożliwia wpisanie nazwy tego pliku (podrzędnego do bieżącego katalogu). Domyślną nazwą jest: `kdebug.dbg`.

Oprócz tego, można zaznaczyć pole Przerwij przy krytycznych błędach. Jeśli wtedy pojawi się komunikat o poziomie `KDEBUG_FATAL`, program zakończy działanie z SIGABRT po jego wypisaniu.

Po zamknięciu okna przy pomocy przycisku OK ustawienie są wykorzystywane od razu i zapisywane do pliku `kdebugrc`. Jeśli naciśniesz Anuluj, nowe wpisy zostaną odrzucone i będą wykorzystywane stare ustawienia.

Podziękowania dla Kalle Dalheimer'a za oryginalną wersję programu &kdebugdialog;

Polskie tłumaczenie: Suse Polska suse@suse.pl

&underFDL;
&documentation.index;