Scribble: Closing the Book on Ad Hoc Documentation Tools

Matthew Flatt, Eli Barzilay and Robert Bruce Findler

The 14th ACM SIGPLAN International Conference on Functional Programming (ICFP 2009)
Edinburgh, Scotland, 31st August - 2nd September 2009


Scribble is a new system for writing library documentation, user guides, and tutorials. Scribble builds on PLT Scheme's technology for language extension, and at its heart is a new approach to connecting prose references with library bindings. We have built Scribble libraries that support standalone documentation and papers, JavaDoc-style API documentation, and literate programming. Thanks in large part to Scribble's flexibility and the ease with which we can cross-reference information across different levels, the documentation that is distributed with PLT Scheme now runs into the thousands of pages. This paper reports on the use of Scribble and on its design as both an extension and extensible part of PLT Scheme.

START Conference Manager (V2.56.8 - Rev. 748M)