www.delorie.com/djgpp/v2faq/faq026.html | search |
| Previous | Next | Up | Top |
If some package doesn't have a ready *d.zip archive, you will need to get and install a program called TeX or its work-alike, like emTeX. A DJGPP port of
TeX is available on SimTel.NET. Install TeX, then run the texi2dvi
shell
script(Note: You will need to install the port of Bash and some auxiliary utilities to be able to run shell scripts; texi2dvi
itself is part of the GNU Texinfo distribution and
comes with the v2gnu/txiNNNb.zip archive.) on the docs' source files (called *.txi or *.texi) which you get with the source distribution of every
package you download. TeX produces a .dvi file which you can then print using one of the available DVI drivers, as explained above. To convert a .dvi file
into PostScript, use the DVIPS program; you can find it as dvps566.zip on the above-mentioned site, together with the TeX port.
If TeX won't run, check that you have the file texinfo.tex which defines the TeX macros specific to Texinfo files. If you don't, get the latest GNU or DJGPP Texinfo distribution which includes that file.
If you'd like to produce printed docs of the library reference, TeX might complain that it cannot find a file named libc2.tex. This file is generated from all the *.txh files in the DJGPP source distribution (djlsr201.zip). In order to build this file, you need to install djlsr201.zip and the C++ compiler, then go to the src/libc directory and type this from the DOS command prompt:
make -C ../mkdoc make docIf the above command fails due to unresolved externals, you will need to edit the file makefile in the mkdoc directory. It has a line which calls ld (the linker), where you should change -lgcc -lc into -lgcc -lc -lgcc. Save makefile and try the above commands again.
Note that some documentation files (notably, the one for GCC and Emacs) will produce voluminous print-outs. You have been warned!
DJGPP comes with a program called TEXI2PS which can convert *.txi files to a crude PostScript; try it if you don't care much about the appearance of the printed docs. Its advantage is that you don't need to install any additional packages, just to fetch the Texinfo sources of the docs.
Finally, if you don't mind paying for the printed documentation, the Free Software Foundation sells printed copies of manuals for GNU packages. You can contact the FSF for details.
For those who prefer reading docs with a Web browser, many GNU manuals in HTML (hypertext) format, suitable for reading with your Web browser, can be viewed at the DJGPP Web site. The *d.zip archives also include the docs converted to HTML, which you can browse locally on your machine.
webmaster donations bookstore | delorie software privacy |
Copyright ⌐ 1998 by Eli Zaretskii | Updated Sep 1998 |
You can help support this site by visiting the advertisers that sponsor it! (only once each, though)