Michel Dagenais Michel Dagenais, GNU General Public License, 1997
michel.dagenais@polymtl.ca
Ecole Polytechnique
C.P. 6079, Succ. Centre-Ville
Montreal, Quebec, H3C 3A7
8 October 1997 HTML SGML documentation literate programming medium audience

M3tosgml: Conversion of Documented Modula-3 Interfaces into HTML

This program converts a Modula-3 interface to HTML documentation, for browsing and inclusion into larger documents. A number of conventions are used which determine how each section of the interface is translated.

The program m3tosgml reads the Modula-3 interface input file (first command line argument, standard input when no argument given), and writes the corresponding SGML file. The option -html is the default and produces an HTML SGML file at output. SGML Document types other than HTML may be supported in the future.

The translation process is guided by conventions about how the different pisces of information are embedded into the Modula-3 interface comments, as described below.