author: Michel Dagenais
copyright: Michel Dagenais, GNU General Public License, 1997
date: 8 October 1997
keyword: HTML
keyword: SGML
keyword: documentation
keyword: literate programming
keyword: medium audience

# M3tosgml: Conversion of Documented Modula-3 Interfaces into HTML

## Abstract

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