./devel/noweb, Simple, extensible literate-programming tool

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]


Branch: pkgsrc-2010Q2, Version: 2.11b, Package name: noweb-2.11b, Maintainer: pkgsrc-users

INTRODUCTION --- WHAT IS NOWEB, ANYWAY?

noweb is a literate-programming tool like FunnelWEB or nuweb, only
simpler. A noweb file contains program source code interleaved with
documentation. When noweb is invoked, it writes the program source
code to the output files mentioned in the noweb file, and it writes
a TeX file for typeset documentation.

noweb is designed to meet the needs of literate programmers while
remaining as simple as possible. Its primary advantages are
simplicity, extensibility, and language-independence. noweb works
``out of the box'' with any programming language, and supports TeX,
latex, and HTML (Mosaic) back ends. A back end to support full
hypertext or indexing takes about 250 lines; a simpler one can be
written in 40 lines of awk. The primary sacrifice relative to WEB
is that code is not prettyprinted.

If you're brand new to literate programming, check out the FAQ for
the USENET newsgroup comp.programming.literate. There are also some
resources available through the noweb home page.


Master sites:

SHA1: 3b391c42f46dcb8a002b863fb2e483560a7da51d
RMD160: 01e4fbb636dfd0f6d117caa045cf105e49d25fca
Filesize: 721.553 KB

Version history: (Expand)