Communication Dans Un Congrès Année : 2019

Quickref: Common Lisp Reference Documentation as a Stress Test for Texinfo

Résumé

Quickref is a global documentation project for the Common Lisp ecosystem. It creates reference manuals automatically by introspecting libraries and generating corresponding documentation in Texinfo format. The Texinfo files may subsequently be converted into PDF or HTML. Quickref is non-intrusive: software developers do not have anything to do to get their libraries documented by the system.\par Quickref may be used to create a local website documenting your current, partial, working environment, but it is also able to document the whole Common Lisp ecosystem at once. The result is a website containing almost two thousand reference manuals. Quickref provides a Docker image for an easy recreation of this website, but a public version is also available and actively maintained.\par Quickref constitutes an enormous and successful stress test for Texinfo. In this paper, we give an overview of the design and architecture of the system, describe the challenges and difficulties in generating valid Texinfo code automatically, and put some emphasis on the currently remaining problems and deficiencies.

Fichier principal
Vignette du fichier
verna.19.tug.pdf (137.93 Ko) Télécharger le fichier
Origine Fichiers éditeurs autorisés sur une archive ouverte
Licence

Dates et versions

hal-04580387 , version 1 (27-05-2024)

Licence

Identifiants

  • HAL Id : hal-04580387 , version 1

Citer

Didier E Verna. Quickref: Common Lisp Reference Documentation as a Stress Test for Texinfo. TUGboat, Aug 2019, Palo Alto, USA, Unknown Region. pp.119--125. ⟨hal-04580387⟩
52 Consultations
121 Téléchargements

Partager

  • More