PRODUCING IDIOMATIC SOFTWARE DOCUMENTATION FOR MANY PROGRAMMING LANGUAGES FROM A COMMON SPECIFICATION

Computer-implemented techniques solve a number of problems with producing idiomatic software documentation for many programming languages from a common specification written in a common specification programming language. The techniques may be employed by a documentation generator computer program that translates the common specification into software programming interface documentation for each of many different programming language targets. The techniques may also be employed by a source-to-source compiler that incorporates the techniques to generate documentation from the common specification for each of many different programming language targets in addition to compiling the common specification into the different target languages. L'invention concerne des techniques mises en œuvre par ordinateur qui résolvent un certain nombre de problèmes par la production d'une documentation logicielle idiomatique pour de nombreux langages de programmation à partir d'une spécification commune écrite dans un langage de programmation de spécification commun. Les techniques peuvent être utilisées par un programme informatique de générateur de documentation qui traduit la spécification commune en une documentation d'interface de programmation logicielle pour chacune de nombreuses cibles de langage de programmation différentes. Les techniques peuvent également être utilisées par un compilateur source à source qui incorpore les techniques pour générer une documentation à partir de la spécification commune pour chacune de nombreuses cibles de langage de programmation différentes en plus de compiler la spécification commune dans les différents langages cibles.