Next: Installing, Previous: Building the Executables, Up: Compiling the Source Code [Index]
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]