NOWEB(7)

NAME
nowebfilters - filters and parsers for use with noweb

SYNOPSIS
[noweave|notangle|noweb] [-filter filter|-markup parser] ...

DESCRIPTION
This man page documents the various filters and parsers that are supplied with noweb(1). A filter, which transforms the pipeline representation, is used with the -filter option. A parser, which reads a source file and emits the pipeline representation, is used with the -markup option. Not all filters and parsers are available at all installations.

FILTERS

autodefs.*
    noweave's -autodefs and -showautodefs options use these filters, which automatically find defined identifiers. The * stands for the name of a programming language.

disambiguate
    The disambiguate filter makes it possible to abbreviate chunk names using a trailing ellipsis (three periods), in the style of WEB and nuweb(1).

elide patterns
    The elide filter removes from the stream any code chunk matching any of the arguments. Each argument is a pattern in which ? matches any single character and * matches any sequence of characters.

emptydefn
    The emptydefn filter makes an empty definition (<<>>=) an abbreviation for a continuation of the previous definition.

l2h [-show-unknowns]
    The l2h filter converts LaTeX to HTML in documentation chunks. If the -show-unknowns options is given, unrecognized LaTeX control sequences appear in bold in the output. l2h uses the LaTeX-generated .toc and .bbl files to help create table of contents and bibliography.

PARSERS
A parser converts a source file to the noweb pipeline format, interpreting the ``markup'' in that file. By default, the tools use the standard noweb markup, but some installations may support nuweb markup as well. Parsers include

markup
    Converts standard noweb(1) markup to pipeline format.

numarkup
    Converts nuweb(1) markup to noweb pipeline format. It is not part of the standard installation, but it can be found in noweb's contrib/norman directory.

FILES
All filters and parsers are stored in |LIBDIR|

BUGS
It is possible to tell l2h about new control sequences by putting special TeX comments in one's documentation chunks, but there's no documentation. Use the source, Luke.

numarkup loses information, e.g., about the proper treatment of tabs. It also doesn't compensate for notangle's newline-removal heuristic, which means results on nuweb files may differ subtly from those produced by nuweb.

SEE ALSO
noweave(1), notangle(1), noweb(1)
The Noweb Hacker's Guide

VERSION
This man page is from noweb version 2.8a.

AUTHOR
Norman Ramsey, University of Virginia. Internet address nr@cs.virginia.edu.
Noweb home page at http://www.cs.virginia.edu/~nr/noweb.