Go to the first, previous, next, last section, table of contents.


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).


Go to the first, previous, next, last section, table of contents.