XML.com: XML From the Inside Out
oreilly.comSafari Bookshelf.Conferences.

advertisement
 Resource Guide -> XLink -> SWEB: an SGML Tag Set for Literate Programming

SWEB: an SGML Tag Set for Literate Programming

Date: Sep. 1, 1996
Link: http://www.uic.edu/~cmsmcq/tech/sweb/sweb.html
Source Author or Organization: C. M. Sperberg-McQueen

Excerpted from "Abstract": "This document describes an SGML tag set for literate programming. First, markup is provided for embedding fragments of programming-language code into SGML documents in arbitrary order, to be recombined before compilation into the order required by the programming language's syntax."

"Next, tags are defined for identifiers, keywords, code fragments, and literal values occurring as phrase-level elements in the prose documentation. Finally, tags for indexing and for a general structure for reference documentation (alphabetical lists of functions and identifiers, etc.) are defined."

"For each type of markup, the document gives examples and describes how the markup should be processed by conventional literate-programming weave and tangle processes."