Отладка с помощью GDB - A. Форматирование документации

[Содержание]   [Назад]   [Пред]   [Вверх]   [След]   [Вперед]  


A. Форматирование документации

Выпуск 4 GDB содержит уже отформатированную справочную карточку, готовую к печати с PostScript или Ghostscript, в подкаталоге `gdb' главного исходного каталога(19). Если вы можете использовать PostScript или Ghostscript с вашим принтером, вы можете распечатать справочную карточку немедленно из `refcard.ps'.

Выпуск также включает исходный текст справочной карточки. Вы можете отформатировать ее при помощи TeX, набрав:

make refcard.dvi

Справочная карточка GDB разработана для печати в режиме landscape на бумаге американского размера "letter"; то есть на листе шириной 11 и высотой 8.5 дюймов. Вы должны будете указать этот формат печати в качестве ключа к вашей программе вывода DVI.

Вся документация для GDB поставляется как часть машинно-считываемого дистрибутива. Документация написана в формате Texinfo, который является системой построения документации, использующей один исходный файл, для создания как интерактивного, так и печатного руководства. Вы можете использовать одну из команд форматирования Info, чтобы создать интерактивную версию документации, и TeX (или texi2roff) для создания печатной версии.

GDB включает уже отформатированную копию интерактивной версии Info этого руководства в подкаталоге `gdb'. Основной файл Info--- `gdb-5.0/gdb/gdb.info', он ссылается на подчиненные файлы `gdb.info*' в том же каталоге. В случае необходимости, вы можете распечатать эти файлы, или прочитать их в любом редакторе; но их легче прочитать, используя подсистему info в GNU Emacs или автономную программу info, доступную как часть дистрибутива GNU Texinfo.

Если вы хотите форматировать эти Info-файлы самостоятельно, вам нужна одна из программ форматирования Info, например texinfo-format-buffer или makeinfo.

Если у вас установлена программа makeinfo, и вы находитесь на верхнем уровне иерархии каталогов GDB (`gdb-5.0' в случае версии 5.0), вы можете создать файл Info, набрав:

cd gdb
make gdb.info

Если вы хотите сформировать и распечатать копии этого руководства, вам нужен TeX, программа печати его выходных DVI-файлов и файл определений Texinfo `texinfo.tex'.

TeX---это программа форматирования; она не печатает файлы непосредственно, а создает выходные файлы, называемые DVI-файлами. Чтобы напечатать сформатированный документ, вам нужна программа печати DVI-файлов. Если в вашей системе установлен TeX, в ней, возможно, есть такая программа. Какую точно команду нужно использовать зависит от вашей системы; lpr -d является общей; другая программа (для PostScript-устройств)---это dvips. Команда печати DVI-файлов может требовать имя файла без расширения или с расширением `.dvi'.

TeX также требует файл макроопределений `texinfo.tex'. Этот файл сообщает TeX, как форматировать документ, написанный в формате Texinfo. Сам по себе TeX не может читать или форматировать файл Texinfo. `texinfo.tex' распространяется с GDB и размещается в каталоге `gdb-номер-версии/texinfo'.

Если у вас установлены TeX и программа печати DVI, вы можете отформатировать и распечатать это руководство. Сначала перейдите в подкаталог `gdb' главного исходного каталога (например, в `gdb-5.0/gdb'), и наберите:

make gdb.dvi

Это передаст `gdb.dvi' вашей программе печати DVI.


[Содержание]   [Назад]   [Пред]   [Вверх]   [След]   [Вперед]