Michel Dagenais Michel Dagenais, GNU General Public License, 1997
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.

- Documenting Modula-3 interfaces