From d25245fe76e6b975515d0d39636b38d08c5a9c61 Mon Sep 17 00:00:00 2001 From: Ray-V Date: Sun, 13 Jun 2021 21:47:32 +0100 Subject: Remove CMakeLists.txt for doc Move doc directory up a level from kdbg/doc Add macro call to source root CMakeLists.txt Remove tde_conditional_add_subdirectory() macro call for doc Signed-off-by: Ray-V (cherry picked from commit ae6f04289851574f38aedbd4666f7154cc67cad3) --- doc/ru/argspwdenv.html | 43 +++++++++++ doc/ru/breakptlist.html | 68 ++++++++++++++++++ doc/ru/globaloptions.html | 72 +++++++++++++++++++ doc/ru/howdoi.html | 78 ++++++++++++++++++++ doc/ru/index.html | 177 ++++++++++++++++++++++++++++++++++++++++++++++ doc/ru/localvars.html | 19 +++++ doc/ru/memory.html | 26 +++++++ doc/ru/pgmoutput.html | 43 +++++++++++ doc/ru/pgmsettings.html | 73 +++++++++++++++++++ doc/ru/registers.html | 31 ++++++++ doc/ru/sourcecode.html | 31 ++++++++ doc/ru/stack.html | 23 ++++++ doc/ru/threads.html | 38 ++++++++++ doc/ru/tips.html | 43 +++++++++++ doc/ru/types.html | 126 +++++++++++++++++++++++++++++++++ doc/ru/watches.html | 20 ++++++ 16 files changed, 911 insertions(+) create mode 100644 doc/ru/argspwdenv.html create mode 100644 doc/ru/breakptlist.html create mode 100644 doc/ru/globaloptions.html create mode 100644 doc/ru/howdoi.html create mode 100644 doc/ru/index.html create mode 100644 doc/ru/localvars.html create mode 100644 doc/ru/memory.html create mode 100644 doc/ru/pgmoutput.html create mode 100644 doc/ru/pgmsettings.html create mode 100644 doc/ru/registers.html create mode 100644 doc/ru/sourcecode.html create mode 100644 doc/ru/stack.html create mode 100644 doc/ru/threads.html create mode 100644 doc/ru/tips.html create mode 100644 doc/ru/types.html create mode 100644 doc/ru/watches.html (limited to 'doc/ru') diff --git a/doc/ru/argspwdenv.html b/doc/ru/argspwdenv.html new file mode 100644 index 0000000..9108a91 --- /dev/null +++ b/doc/ru/argspwdenv.html @@ -0,0 +1,43 @@ + + + + + + KDbg - Руководство Пользователя - Аргументы, Окружение + + +Содержание +

Указание аргументов программы, рабочего каталога, переменные окружения

+Выберите пункт меню Исполнение|Аргументы для вызова диалогового окна, в +котором вы сможете установить аргументы отлаживаемой программы, ее рабочий +каталог и переменные окружения. +

+Аргументы программ

+В самой верхней строке ввода укажите аргументы командной строки, которые должны +быть переданы программе. Эти аргументы будут использованы при следующием +запуске программы. +

+Рабочий каталог

+Ниже расположена строка ввода, в которой вы можете указать рабочий каталог +программы. Программа будет работать в указанном каталоге при следующем запуске. +

Рабочий каталог также действует и для gdb! Указанный вами каталог будет +немедленно передан gdb и вступит в силу как только вы нажмете OK. Это +может повлиять на поиск файлов исходных текстов. +

+Переменные окружения

+В секции переменных окружения введите выражение в виде VARIABLE=value +для установки переменной окружения VARIABLE в значение value +и кликните на кнопку Изменить. Для удаления переменной, выберите ее в +списке и кликните на кнопку Удалить. Для изменения значения переменной, +выберите ее из списка, отредактируйте ее значение в поле редактирования и +кликните по кнопке Изменить. Если вы измените имя переменной и кликните +по кнопке Изменить, то вы добавите новую переменную! Новые переменные +окружения будут использованы вашей программой при следующем запуске. +

Если в Linux вы используете библиотеку glibc2, то вам необходимо установить +переменную окружения LD_BIND_NOW. Очень важно, чтобы вы установили +значение этой переменной в 1 для всех сессий отладки. Если она не +будет установлена, то gdb не сможет осуществлять пошаговую отладку (в и из) +системных функций, импортируемых из разделяемых библиотек libc и +остальных. + + diff --git a/doc/ru/breakptlist.html b/doc/ru/breakptlist.html new file mode 100644 index 0000000..b3007b3 --- /dev/null +++ b/doc/ru/breakptlist.html @@ -0,0 +1,68 @@ + + + + + + KDbg - Руководство Пользователя - Список точек останова + + +Содержание +

Список точек останова

+Список точек останова отображает все установленные точки останова и просмотра и +позволяет манипулировать ими. Он может быть вызван посредством пункта меню +Вид|Точки останова. +

Перечень точек останова

+Для каждой точки останова отображается следующее: + +Иконка напротив записи указаывает состояние точки останова: включена - красная +точка, выключена - светло-красная точка, временная точка останова - маленькие +часы или условная точка останова - маленький знак вопроса. +

Точки просмотра обозначаются иконкой лупы напротив соответствующей записи. +

Управление точками останова

+Необходимо отметить, что точками останова и просмотра +невозможно управлять во время работы программы. Если программа уже запущена, +необходимо, чтобы она остановилась либо попав в точку останова, либо +принудительно посредством вызова пункта меню Исполнение|Прервать. +Это не завершит исполнение программы, а всего лишь остановит ее. Теперь вы +можете управлять точками останва, после чего выберите пункт +Исполнение|Продолжить для продолжения исполнения программы. +

Для установки точки останова на определенную строку исходного текста самым +простым способом является установка ее в окне исходных текстов. Если вы не +знаете имени файла и номера строки, где находится интересующая вас функция, вы +просто можете ввести ее имя в строке ввода над списком и кликнуть на кнопку +Добавить Точку Останова. +

Вы можете включать и выключать точки останова, выбрав их в списке, а затем +кликнув на кнопки Включить или Выключить. Или просто кликните +средней кнопкой мыши по нужному элементу списка - вы будете включать и +выключать их так же, как и в окне исходных текстов. +

Вы можете установить условие срабатывания точки останова или установить +счетчик пропусков этой точки, показывающий количество проходов, при которых не +будет произведен останов. Для этого кликните на кнопку Условия и введите +условие и/или счетчик пропусков. +

Управление точками просмотра

+Точки просмотра похожи на точки останова, за исключением того, что прерывание +происходит только при изменении значения содержимого памяти. Также как и точки +останова, точками просмотра нельзя управлять во время исполнения программы. +Подробнее см. выше. +

Для установки точки просмотра, введите выражение в строку ввода над списком +и кликните на кнопку Добавить Точку Просмотра. Программа остановится при +изменении значения выражения. Необходимо отметить, что точки просмотра, +использующие локальные переменные, могут быть установлены только когда +программа прервана в точке останова (или принудительно посредством вызова +пункта меню Исполнение|Прервать). +

Для удаления точки просмотра, выберите ее из списка и кликните на кнопку +Удалить. Если выражение использует локальные переменные, то точка +просмотра будет удалена автоматически при выходе программы из данной области +стека (функции). +

Вы также можете установить для точек просмотра условия и счетчик пропусков, +выбрав его из списка и кликнув на кнопку Условия. + + diff --git a/doc/ru/globaloptions.html b/doc/ru/globaloptions.html new file mode 100644 index 0000000..c82a73d --- /dev/null +++ b/doc/ru/globaloptions.html @@ -0,0 +1,72 @@ + + + + + + KDbg - Руководство пользователя - Глобальные Переменные + + +Солдержание +

+Далоговое окно Глобальных Переменных

+Для установки некоторых глобальных переменных можно использовать +Файл|Глобальные Переменные. Вы можете установить: + + +

+Как вызывать gdb

+ +
Если вы используете различные версии gdb, нужно указать +их в Как вызывать gdb. По умолчанию используется +форма gdb --fullname +--nx. Проверьте, указаны ли данные опции, +если вы изменили исполняемый модуль gdb. Если вы пропустите их, KDbg не +будет работать. Если вы испортили запись, ее можно очистить, переведя +в значения по умолчанию.
+ +

+Как вызвать эмулятор терминала

+ +
Если вы хотите испотльзовать различные терминальные программы +для показа вывода программы, укажите их в +Терминалы для вывода программ. Значение по умолчанию – +xterm -name kdbgio -title %T -e sh -c %C. +В данной записи, +%T заменяется титульной строкой, %C +заменяется скриптом командного интерпретатора Борна, который будет циклически +вызываться, пока не произойдет закрытия терминального окна. +(Скрипт использует в цикле sleep +3600). Альтернави\ой данных установок может служить +konsole --name kdbgio --caption %T -e sh -c %C.
+ +

+Переход в обычный режим

+ +
Вы можете указать KDbg окну перевестись в обычный режим, +когда отлаживаемая программа завершится (в точке останова или по сигналу). +Иначе окно KDbg не активируется (по крайней мере в KWM &150; оконном менеджере +KDE). Некоторым пользователям такое поведение может показатся навязчивым, +поэтому по умолчанию данная опция отключена. +
+ +
Если опция включена, KDbg переключится в фоновый режим, если +программа будет продолжена, но только по прошествии заданного временного +промежутка. Это сделано для того, чтобы окно отладчика не переключалось +все время, когда используется пошаговое исполнение программы. +
+ + + diff --git a/doc/ru/howdoi.html b/doc/ru/howdoi.html new file mode 100644 index 0000000..1549702 --- /dev/null +++ b/doc/ru/howdoi.html @@ -0,0 +1,78 @@ + + + + + + KDbg - Руководство пользователя - Как я могу...? + + +Содержание +

+Как я могу...?

+ +

+... установить точки останова?

+Существует несколько способов: + +Если вы не можете установить точки останова, возможно программа работает +в данный момент. Когда программа работает, установка точек останова невозможна. +Остановите программу с помощью Выполнение|Прервать. Если +вы по-прежнему не можете установить точку останова, проверьте, скомпилирована +и собрана ли ваша программа с поддержкой информации для отладки. +

... установить значение глобальной переменной или какого-либо выражения?

+Используйте окно Просмотра. +

+... установить точку просмотра?

+Точки просмотра устанавливаются в списке +точек останова. +

+... использовать дамп памяти?

+Сначала необходимо загрузить исполняемый модуль, используя меню +Файл|Исполняемый модуль, затем указать соответствующий дамп памяти, +используя Файл|Дамп Памяти. +

+... отлаживать программу, содержащую бесконечный цикл?

+Запустите программу и подождите, пока она войдет в бесконечный цикл. +Переключитесь в KDbg и выберите Выполнение|Прервать. +Далее можно использовать отладочные средства. +

+... сделать так, чтобы программа определенное количество раз игнорировала +точку останова во время прохода до того, как начнет прерываться?

+В списке точек останова выберите точку +останова; нажмите Условная и укажите количество раз для пропуска +точки останова в поле Число пропусков. +

+... установить переменную среды для исполнемого модуля?

+Выберите Выполнение|Аргументы и укажите переменные среды в +диалоге аргументов программы. +

+... установить рабочий каталог для исполняемого модуля?

+Выберите Выполнение|Аргументы и укажите рабочий каталог в +диалоге ургументов программы. +

+... избавиться от терминального окна?

+Выберите Файл|Настройки и перейдите на меню +Вывод. +Выберите Только вывод, простая эмуляция терминала и нажмите +OK. +Теперь перезапустите программу (выберите ее из списка +Файл|Последний исполняемый модуль). Вывод программы теперь перенаправлен +в созданное окно вывода, а в качестве +стандартного потока ввода используется /dev/null. +

Вы должны произвести данную операцию для каждой новой отлаживаемой +программы. +

Важно:Вы не должны делать этого, если программа +читает данные со стандартного потока ввода (обычно терминала) или +ее вывод требует более интеллектуальной эмуляции терминала (то есть +не только возврата каретки и прогона строки). Окно вывода не +поддерживает ввод и эмуляцию терминала. + + diff --git a/doc/ru/index.html b/doc/ru/index.html new file mode 100644 index 0000000..08e0d88 --- /dev/null +++ b/doc/ru/index.html @@ -0,0 +1,177 @@ + + + + + + KDbg - Руководство Пользователя + + + +

KDbg - Руководство пользователя

+ +

Содержание

+ + + +
+

+Введение

+KDbg является графическим интерфейсом к gdb, отладчиком проекта GNU. +

Это означает, что KDbg сам по себе не является отладчиком. Скорее, он +общается с gdb, отладчиком, использующим командную строку, посылая ему +команды и получая их результат, например, значения переменных. Пункты меню и +указания мышью преобразуются в последовательность команд gdb, а +результат преобразуется к более-менее визуальному представлению, такому как +структурное содержимое переменных. +

Обобщение выше сказанного - KDbg целиком зависит от возможностей +используемого отладчика gdb. KDbg не может делать больше, чем делает +gdb. Например, если имеющаяся у вас версия gdb не +поддерживает отладку многопоточных программ, то и KDbg не поможет вам в этом +(несмотря на то, что он выводит окно потоков). + +

+Использование KDbg

+Перед началом использования KDbg вы наверное захотите просмотреть опции в +диалоге Глобальные Опции, который можно +вызвать из пункта меню Файл|Глобальные Опции. +

Указание отлаживаемой программы

+Для отладки программы выберите пункт меню Файл|Исполняемые модули. Если +вы ранее отлаживали эту программу, вы можете выбрать ее из пункта +Файл|Последние Исполняемые Модули. Программа загрузится. +

Если вы хотите произвести отладку по дампу памяти, то сначала вы должны +загрузить программу, породившую этот дамп, а потом загрузить сам дамп, выбрав +пункт меню Файл|Дамп Памяти. Теперь KDbg перейдет в ту точку программы, +которая вызвала создание дампа памяти. +

Теперь вы можете устанавливать точки останова, ипользуя меню +Breakpoint, меню, вызваемое правой кнопкой мышы, или +окно точек останова. +

Также вы можете установить настройки только для отлаживаемой в данный момент +программы в диалоге Настройки Программы, +вызываемом пунктом меню Файл|Настройки. + +

Исполнение программы

+Теперь запустите программу, выбрав пункт меню Исполнение|Запуск. Теперь +программа будет исполняться обычным образом до тех пор, пока она либо не +окончится, либо не попадет в точку останова или точку просмотра, либо не +получит сигнал. +

Вы можете запустить программу с аргументами, установить рабочий каталог, а +также переменные окружения для данной программы. Для этого выберите пункт меню +Исполнение|Аргументы и укажите ваши параметры в диалоге +Аргументы Программы (перед запуском программы). +

Вы также можете подключиться к уже работающей программе. Для этого загрузите +исполняемый модуль, как описано выше. Затем выберите пункт меню +Исполнение|Подсоединиться. Укажите идентификатор процесса и кликните на +OK. Работающая программа будет остановлена (но не прервана), а в окне +исходных текстов будет указана текущая точка останова. + +

Программа остановлена - что теперь?

+Когда программа останавливается в точке останова, просмотра или при получении +сигнала, в окне исходных текстов указывается +текущая строка остановки программы. Часто встречается ситуация, когда программа +останавливается, получая сигнал (обычно SIGSEGV), находясь в функции, +которую вы вызываете из своей программы, но сами не разрабатывали. В этом +случае просмотрите окно стека и найдите функцию, +которую писали вы (начиная с вершины списка) и кликните на нее. Это укажет вам +место, с которого вы сможете начать поиск ошибки в вашей программе. +

В меню Исполнение вы найдете команды, которые вам понадобятся для +запуска программы, пошаговой отладке, прерывания исполнения программы +(Прерывание). Важные команды, такие как Запуск и все виды +Шагов, привязаны к функциональным клавишам, которыми рекомендуется +пользоваться для повышения эффективности отладки. +
Эти функции не настраиваются, но может вы захотите внести +свой вклад и разработать эту функциональность? +

В меню Точки останова вы найдете команды для установки, снятия, +включени и выключения временных и постоянных точек останова. Вы можете вывести +список точек останова в окно точек останова. +Вы также может установить точку останова, кликнув левой кнопкой мыши в левое +поле строки исходного текста. Для включения и выключения точки останова +кликните средней кнопкой мыши на точку останова. +

Шестеренка на панели инструментов показывает, что gdb работает, в этом +случае она вертится. Когда она вертится быстро, KDbg не будет принимать +команды исполнения, а если она вращается медленно, то KDbg считывает значения +переменных. +

+Информационные окна KDbg

+KDbg выводит информацию и принимает команды в различных окнах. В меню +Вид вы обнаружите команды для вызова и закрытия этих окон. Все эти окна +вы можете размещать так, как вам удобно. + + + +

+Советы и пр.

+Следующие разделы содержат полезные сведения об использовании KDbg. + + +

+Известные проблемы

+gdb 4.16 имеет проблемы с обработкой классов С++ с виртуальным базовым классом. +(Такие классы обычно встречаются в программах, использующих CORBA.) Он +прерывается по ошибке сегментации, а KDbg сообщает о том, что gdb неожиданно +завершился. К сожалению, с этим ничего нельзя сделать. Вам придется +перезапустить gdb, выбрав пункт меню Файл|Исполняемый модуль, который +перезапустит сессию отладки. +

Распознавание типов в KDbg работает только для библиотек, динамически +линкуемых с отлаживаемой программой. + +

+Автор

+KDbg разработан Johannes Sixt +с помощью многих остальных. +
Домашняя страница KDbg расположена по адресу +http://www.kdbg.org/. + + diff --git a/doc/ru/localvars.html b/doc/ru/localvars.html new file mode 100644 index 0000000..31b9a8b --- /dev/null +++ b/doc/ru/localvars.html @@ -0,0 +1,19 @@ + + + + + + KDbg - Руководство Пользователя - Локальные Переменные + + +Содержание +

Окно Локальных Переменных

+Окно локальных переменных вызывается выбором пункта меню Вид|Локальные. +Данное окно отображает содержимое локальных переменных, определенных +указанной текущей областью стека (stack frame). +

Отображаемый набор локальных переменных определяется областью стека (stack +frame), выбранной в окне стека. +

Значения переменных, изменивщихся между остановами программы, отображаются +красным цветом. + + diff --git a/doc/ru/memory.html b/doc/ru/memory.html new file mode 100644 index 0000000..e8ba057 --- /dev/null +++ b/doc/ru/memory.html @@ -0,0 +1,26 @@ + + + + + + KDbg - Руководство пользователя - Образ памяти + + +Содержание +

Окно образа памяти

+Чтобы отобразить окно образа памяти нужно выбрать Вид|Память. +Оно выводит содержимое памяти программы по любым адресам. +

Для просмотра содержимого памяти, введите нужный адрес в поле редактирования. +Адрес не обязательно должен задаваться в шестнадцатеричной форме и может +задаваться выражением. +

Вы можете определить формат отображения содержимого памяти с помощью +выбора соответствующих опций из выпадающего меню, которое вызывается +нажатием правой клавиши мыши. +

Адресные выражения запоминаются и впоследствии могут быть +вызваны из выпадающего списка. Обратите внимание, что адресные выражения +запоминаются вместе с их форматом. +

Если вы не собираетесь исследовать содержимое памяти, рекомендуется +очистить выражение таким образом, чтобы содержимое памяти не выводилось +– это увеличит скорость процесса отладки. + + diff --git a/doc/ru/pgmoutput.html b/doc/ru/pgmoutput.html new file mode 100644 index 0000000..2a17c69 --- /dev/null +++ b/doc/ru/pgmoutput.html @@ -0,0 +1,43 @@ + + + + + + KDbg - Руководство Пользователя - Вывод Программы + + +Содержание +

Окно Вывода Программы

+Окно вывода программы можно вызвать, выбрав пункт меню Вид|Вывод. В это +окно выводятся стандартные потоки вывода и диагностики отлаживаемой программы. +

Оно не позволяет вводить какие-либо данные в программу и реализует лишь +минимальную эмуляцию терминала: \n (перевод строки) преобразуется в +комбинацию начало строки-перевод строки, а \r (начало строки) +игнорируется. Этих возможностей обычно предостаточно для отладки GUI программ, +которые выводят отладочные сообщение в стандартные потоки вывода или +диагностики. +

Когда программа отлаживается первый раз, окно вывода программы не +неиспользуется. Ведь KDbg не знает, достаточно ли программе столь +ограниченных возможностей или же она ожидает ввода с терминала. Поэтому по +умолчанию используется штатный эмулятор терминала. Для перенаправления вывода +программы в окно вывода необходимо проделать следующие шаги: +

    +
  1. +Вызвать диалоговое окно Настройки посредством +пункта меню Файл|Настройки.
    2. + +
  2. Выбрать закладку Вывод.
    3. + +
  3. Выбрать Только вывод, простой эмулятор терминал и кликнуть на +кнопку OK.
    4. + +
  4. Перезагрузить программу из списка Файл|Последние Исполняемые Модули.
    5. +
+Для очистки содержимого окна выберите пункт Очистить в всплывающем меню, +вызываемом нажатием правой кнопки мыши в этом окне. +

Если последняя строка окна заполнена текстом, то окно прокручивается +автоматически таким образом, что последняя строка всегда остается видимой при +поступлении новых сообщений. Если вы прокрутите окно, то отображаемая позиция +не изменится. + + diff --git a/doc/ru/pgmsettings.html b/doc/ru/pgmsettings.html new file mode 100644 index 0000000..ca14b4b --- /dev/null +++ b/doc/ru/pgmsettings.html @@ -0,0 +1,73 @@ + + + + + + KDbg - Руководство Пользователя - Настройки Программ + + +Содержание +

Диалог Настройки Программ

+В этом диалоге можно указать настройки конкретной программы. Для его вызова +выберите пункт меню Файл|Настройки. Данные настройки будут применены +только к текущей отлаживаемой программе и будут сохранены между сессиями ее +отладки. +
Важное замечание: Настройки будут применены только +при следующей загрузке исполняемого модуля в KDbg. Это означает, что после +нажатия на OK вы должны перезагрузить исполняемый модуль с помощью +пункта меню Файл|Исполняемые модули!!
+ + + +

+Отладчик

+В этом разделе вы можете указать отладчик, которым будете отлаживать программу. +

Как вызвать GDB

+ +
Введите команду для вызова gdb. Оставьте это поле пустым для вызова +gdb по умолчанию, указанного в +глобальных опциях. Если вы занимаетесь +кросс-компиляцией и удаленной отладкой, то вы наверное захотите использовать +другой gdb, более подходящий для конкретной платформы. По умолчанию вызывается +gdb --fullname --nx. Не забудьте указать данные опции при изменении +используемого отладчика. Если вы их не укажите, KDbg не будет работать. +
+ +

+Вывод

+В этом разделе вы можете указать степень эмуляции терминала, в которой будет +работать программа. +

Нет ввода и вывод

+ +
Отметьте эту опцию, если ваша программа не получает входных данных +с терминал и вы не хотите видеть то, что она выводит в стандартные потоки +вывода и диагностики. Все стандартные потоки (stdin, stdout и +stderr) перенаправляются в /dev/null.
+ +

Только вывод, простая эмуляция терминала

+ +
Отметьте эту опцию, если ваша программа не получает входных данных +с терминала (stdin будет перенаправлен в /dev/null), а вывод +(stdout и stderr) не требует сложной эмуляции терминала. +Вывод будет отображаться в окне выовда. + +
Важно: Встроенный эмулятор терминала интерпретирует только символ +новой строки \n (ASCII 10) в перевод строки. Он не обрабатывает +символ перевода каретки \r (ASCII 13). Этого вполне достаточно для +отображения простых отладочных сообщений, которые обычно используются +разработчиками программ, использующих графический интерфейс.
+ +

Полная эмуляция терминала

+ +
Отметьте эту опцию, если ваша программа получает данные из +stdin, или вывод в stdout or stderr требует полной +эмуляции терминала. В этом случае будет использован эмулятор терминала, +указанный в глобальных опциях.
+ + diff --git a/doc/ru/registers.html b/doc/ru/registers.html new file mode 100644 index 0000000..eb5c216 --- /dev/null +++ b/doc/ru/registers.html @@ -0,0 +1,31 @@ + + + + + + KDbg - Руководство Пользователя - Содержимое регистров + + +Содержание +

Окно Содержимого Регистров

+Всякий раз, когда происходит останов программы, +KDbg выводит содержимое регистров ЦПУ в соответсвующем окне. Для того, чтобы +отобразить данное окно, выберите Вид|Регистры. +

Окно содержит 3 колонки: +

    +
  1. Колонка Регистр выводит имя регистра.
    2. + +
  2. Колонка Значение выводит содержимое регистров в более или менее +необработанном формате. Необработанный формат обычно выводит шестнадцатеричное +значение, даже для содержимого регистров с плавающей точкой.
    3. + +
  3. Колонка Декодированное значение выводит содержимое регистров +в декодированной форме. Для арифметических регистров это +обычно знаковое десятичное значение, для регистров с плавающей точкой +– число с плавающей точкой, регистры флагов декодируются в имена +флагов.
    4. +
+С помощью правой клавиши мыши можно вызвать меню, которое позволяет +установить формат значений во второй колонке. + + diff --git a/doc/ru/sourcecode.html b/doc/ru/sourcecode.html new file mode 100644 index 0000000..fba5f3b --- /dev/null +++ b/doc/ru/sourcecode.html @@ -0,0 +1,31 @@ + + + + + + KDbg - Руководство пользователя - Исходный Текст + + +Содержание +

Окно Исходного Текста

+Данное окно является главным и всегда отображается. +

Окно исходного текста содержит исходный текст программы. Слева от +каждой строки текста находится "активная область". Она содержит +указатель на строку исходного текста, которая выполняется в текущий момент +времени, а также указывает те строки исходного текста, которые содержат +точки останова. +

Новые точки останова устанавливаются нажатием левой клавиши мыши в +"активной области". Существующая точка останова может быть активирована +или дезактивирована с помощью средней клавиши мыши. +

Может быть нажат знак плюса '+' между "активной областью" и строкой +исходного текста. Это приведет к выводу ассемблерного кода для данной +строки. Чтобы скрыть ассемблерный код, необходимо +нажать клавишу '-'. +

Обычно окна исходного текста открываются автоматически. Чтобы +открыть файл с исходным текстом вручную, нужно нажать правую +кнопку мыши и выбрать Открыть исходный текст или +выбрать Файл|Открыть исходный текст. +

Для переключения между несколькими файлами с исходными текстами, +выберите нужный файл в меню Окно. + + diff --git a/doc/ru/stack.html b/doc/ru/stack.html new file mode 100644 index 0000000..082ba9b --- /dev/null +++ b/doc/ru/stack.html @@ -0,0 +1,23 @@ + + + + + + KDbg - Руководство Пользователя - Стек + + +Содержание +

Окно Стека

+Окно стека вызывается выбором пункта меню Вид|Стек. Окно стека содержит +списки областей стека (stack frames), например, функции, которые были вызваны, +но еще не завершились. +

Самая внутренняя (вложенная) область (место текущего исполнения программы) +находится в самом верху списка. +

Для переключения на другую область стека, просто выберите эту область +мышкой. Окно исходных текстов отображает строки +исходных текстов, которые исполняются программой в текущий момент, а +окно локальных переменных и +окно отслеживаемых выражений изменяются, отображая +локальные переменные выбранной области стека. + + diff --git a/doc/ru/threads.html b/doc/ru/threads.html new file mode 100644 index 0000000..674c309 --- /dev/null +++ b/doc/ru/threads.html @@ -0,0 +1,38 @@ + + + + + + KDbg - Руководство Пользователя - Потоки + + +Содержание +

Окно Потоков

+Окно потоков можно вывести, выбрав пункт меню Вид|Потоки. В окне потоков +отображается список активных потоков программы. +

Замечание: Отладка многопоточных программ должна +поддерживаться используемой версией gdb - это не является функцией KDbg. Для +Linux-систем лучше использовать gdb5. +

Содержимое окна потоков обновляется при каждой остановке программы +отладчиком. (Т.е. в окне не отображается состояние потоков во время +работы программы.) +

Первая колонка отображает идентификатор потока, вторая указывает на текущее +место исполнения данного потока. +

Маркер напротив одной из строк указывает на текущий активный поток: +

+Если кликнуть на другой поток в списке, то он станет активным и соответственно +будет изменено содержимое других окон. В частности, +окно исходных кодов отобразит место, где текущий +поток был остановлен. + + diff --git a/doc/ru/tips.html b/doc/ru/tips.html new file mode 100644 index 0000000..7739496 --- /dev/null +++ b/doc/ru/tips.html @@ -0,0 +1,43 @@ + + + + + + KDbg - Руководство Пользователя - Полезные Советы + + +Содержание +

Полезные Советы

+ + + + + diff --git a/doc/ru/types.html b/doc/ru/types.html new file mode 100644 index 0000000..2d29941 --- /dev/null +++ b/doc/ru/types.html @@ -0,0 +1,126 @@ + + + + + + KDbg - Руководство Пользователя - Таблицы Типов + + +Содержание +

Таблица Типов KDbg

+KDbg может отображать содержимое отдельно взятых членов структурированных типов +данных, таким образом отсутствует необходимость в раскрытии переменных в +окне локальных переменных или в +окне отслеживаемых выражений. Информация о том, +переменная какого члена отображается, хранится в таблицах типов. Обычно +существует одна таблица на разделяемую библиотеку. +

Таблицы типов KDbg расположены в каталоге +$TDEDIR/share/apps/kdbg/types. Имена файло таблиц оканчиваются на +.kdbgtt. Например, таблица типов для libqt.so называется +qt.kdbgtt. +

Файлы таблиц типов соответствуют стандартному синтаксису файлов конфигурации +KDE. Файл содержит следующие группы: +

+Для определения таблиц типов, применимых к отлаживаемой программе, KDbg +запрашивает список разделяемых библиотек, с которыми слинкована программа. +Затем он осуществляет поиск имен этих библиотек в таблицах типов в элементах +ShlibRE. Используются те таблицы, в которых были найдены +соответствующие имена библиотек. Если тип появляется в нескольких таблицах, то +неопределено, какое же из описаний будет выбрано. +

Группа [Type Table]

+Эта группа содержит следующие элементы: + + +

Группа типа

+На каждый заявленый тип должна быть заведена группа, названная именем типа. +На данный момент шаблоны С++ не поддерживаются. +Каждая группа содержит следующие элементы: + +На данный момент количество выражений для каждого типа ограничено +пятью. Это может быть с легкостью изменено, но я не рекомендую вообще +приближаться к данному рубежу - это только затормозить процесс отладки. +

KDbg распознает специальное расширение, которое используется для вывода +строк TQt 2.0 в unicode: Если перед Exprx стоит +/TQString::Data, подразумевается, что результат операции является +указателем на TQString::Data. Выводимое значение является строкой в +unicode, представленное TQString::Data (которое может быть +TQString::null, если это пустая строка TQt, или (null), если +unicode член структуры является нулевым указателем). Для примера см. +qt2.kdbgtt. + +

Совет: Совсем необязательно описывать наследуемые типы, если они должны +обрабатываться также как и базовый класс - KDbg может определить наследование +и использовать описание типа первого (слева) базового класса. Вы можете +использовать элемент Alias для быстрого указания класса при +множественном наследовании, отличного от первого слева. +

Пример

+Этот пример показывает, как TQString и TQObject описаны в +qt.kdbgtt. Дополнительно определен TQTableView, ссылающийся +на TQObject. Этот пример применим к TQt 1.x, который расположен в +разделяемых библиотеках, имена которых оканчиваются как libqt.so.1. +
[Type Table]
+Types1=TQString
+Types2=TQObject,TQTableView
+LibDisplayName=libqt 1.x
+ShlibRE=libqt\.so\.1$
+[TQString]
+Display={ % }
+Expr1=(%s).shd->data
+[TQObject]
+Display={ name=% #chld=% }
+Expr1=(%s).objname
+Expr2=(%s).childObjects->numNodes
+[TQTableView]
+Alias=TQObject
+Замечание: гораздо безопаснее заключать %s в скобки. + + diff --git a/doc/ru/watches.html b/doc/ru/watches.html new file mode 100644 index 0000000..0953b7c --- /dev/null +++ b/doc/ru/watches.html @@ -0,0 +1,20 @@ + + + + + + KDbg - Руководство Пользователя - Отслеживаемые Выражения + + +Содержание +

Окно Отслеживаемых Выражений

+Окно отслеживаемых выражений вызывается выбором пункта меню +Вид|Отслеживаемые Выражения. Оно отображает произвольные выражения. +

Для добавления выражения, введите его в поле редактирования и нажмите Enter +или кликните на кнопку Добавить. Для удаления выражения, выберите его +(выбирайте корень выражения?) и кликните на кнопку Del. +

Отслеживаемые выражения сохраняются между сессиями отладки. Поэтому +рекомендуется удалять выражения, которыми вы уже не пользуетесь, т.к. это +повысит скорость отладки. + + -- cgit v1.2.1