Next: , Previous: , Up: Compiling the Source Code   [Index]


A.5 Compiling the help file, the charset files and the documentation

After you have created the executables, you need to create some other files, namedly the compiled online help file, the character set translation files, and the manual.

To compile the help file, call the MsgEd TE executable with the ‘-hc <infile> <outfile>’ options. On OS/2:

[C:\COMPILE\MSGED] msgedp -hc msghelp.src msghelp.dat

and on Unix:

~/msged $ ./msged -hc msghelp.src msghelp.dat

In order for MsgEd TE to behave smoothly in environments where mails with special national characters are received and/or transmitted (i.E.: everywhere in Europe, both Western Europe and particularly in Russia), you must create readmaps.dat and writmaps.dat files that match your local character map settings. On Unix, this is easily done thanks to the shell expansion feature:

~/msged $ cd ~/msged/maps
~/msged/maps $ gcc -o makemaps makemaps.c
~/msged/maps $ ./makemaps LATIN-1 *.CHS *.chs

(If you have misconfigured your Unix to use CP850 or CP437 instead of ISO-9660, you should enter ‘IBMPC’ instead of ‘LATIN-1’ in the example above).

On OS/2, DOS and NT it is a little more cumbersome. First, you have to compile the makemaps.c file with your C compiler. Then, you have to specify all character map files that are to be included into readmaps.dat and writmaps.dat manually:

[C:\COMPILE\MSGED] cd c:\compile\msged\maps
[C:\COMPILE\MSGED\MAPS] icc makemaps.c
 (...)
[C:\COMPILE\MSGED\MAPS] makemaps CP437 IBM_ISO.CHS ISO_IBM.CHS
IBM_ASC.CHS IBM_MAC.CHS MAC_IBM.CHS IBM_850.CHS 850_IBM.CHS 866_IBM.CHS 1125_IBM.CHS

Finally, you may want to create the documentation in your favourite output format. This requires quite some prerequisite software to be installed on your system, so you probably might simply want to grab MSGTE6_M.ZIP.

But if you really want to compile the manual by hand, proceed as follows: Change to the doc/manual subdirectory:

[C:\COMPILE\MSGED\MAPS] cd \compile\msged\doc\manual

or on Unix:

~/msged/maps $ cd ~/msged/doc/manual

There, you have various options. You can type:

make info

This creates the documentation in GNU info format. It requires the makeinfo tool to be installed, and the info viewer for viewing. Both should be part of any modern Unix installation. For OS/2, they can be found in GNUINFO.ZIP

make html

This creates the documentation in HTML format. This requires Perl 5 to be installed as well as the texi2html.pl perl script. (The latter script does also work on OS/2 with the Perl for OS/2 port).

make dvi

This creates the documentation in DVI format. DVI can be converted to PS with dvips and yields a very high-quality output. However, this requires a working TeX installation and the texi2dvi shell script. (On OS/2, you need pdksh for executing the script and EmTeX. With a little manual work, it can also be done with Juergen Kleinboehls OS2TeX.

make inf

This creates the documentation in OS/2 INF format. It requires a Texi2Ipf tool as well as the IPFC compiler (which only runs on OS/2).


Next: Installing, Previous: Building the Executables, Up: Compiling the Source Code   [Index]