On writing user manuals of programming languages

An Experiment with a User Manual of a Programming Language with Denotational Semantics, a preprint 2019   Download

DOI: 10.13140/RG.2.2.23355.67366

Keywords: Structured user definable and storable types, structured programming, functional procedures without recursion, imperative procedures with mutual recursion.

Denotational models should provide an opportunity for the revision of current practices seen in the manuals of programming languages. New styles should on one hand base on denotational models but on the other ? do not assume that today readers are acquainted in this field. A manual should, therefore, provide some basic knowledge and notation needed to understand the definition of a programming language written in a new style. At the same time ? I strongly believe that ? it should be written for professional programmers rather than for amateurs. The role of a manual is not to teach the skills of programming. Such textbooks are, of course, necessary, but they should tell the readers what the programming is about rather than the technicalities of a concrete language. The paper contains an example of a manual for a virtual programming language Lingua developed in our project.