Отладка с помощью 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.
[Содержание] [Назад] [Пред] [Вверх] [След] [Вперед]