# noweb for Debian GNU/Linux

This package contains the Debianized version of noweb, a simple literate-programming tool.

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.

The noweb manual is only 3 pages; an additional page explains how to customize its LaTeX output. noweb works ``out of the box'' with any programming language, and supports TeX, latex, and HTML back ends.

The primary sacrifice relative to the original `WEB` is that code is not prettyprinted; but a number of prettyprinter exist for noweb, from the simplest one (`dpp`), to the very complex and featurefull (`pretzel`).

## How to begin

First read the noweb manual page (it's only three pages!), then go to the example directory and try some of them. After that you can begin writing literate code! If you want to customize your LaTeX output don't forget to read the noweb style manual page. If you really want, you can go to the official noweb homepage (external link). There are some links and other interesting stuff.

noweb also comes with some good manual pages for all the other tools like notangle and noweave, the noweb filters and noroots.

## More documentation

Some more documentation avaiable with this package (you need dwww to read the man page):

guide.html | The noweb hacker guide
README | Upstream README
FAQ | Upstream FAQ
changelog | Upstream changelog
changelog.Debian | Debian package changelog