nowebfilters

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

The btdefn filter uses Dave Hanson's convention to mark definitions. In code chunks, each defining instances of an identifier should be preceded by a single backtick character (ASCII 140). The btdefn filter removes these backticks from the code and converts them to definitions, thus: R `definition. It, not R @ %def , should be used with both R notangle (1) and R noweave (1), at least for programs written in C-like languages.

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

The docs2comments filter converts documentation chunks to comments in code chunks. Options include R -all , which converts all documentation chunks into comments; -one converts only one documentation chunk preceding each code chunk. The I -w k option formats comments k columns wide.

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.

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

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. (Icon installation only.)

The pipedocs filter runs each documentation chunk through an invocation of R command , which may be any Unix command. The Noweb library includes the command R h2a , which uses R lynx (1) to convert HTML to ASCII.

The xchunks filter pulls in code chunks from an external source. The files argument lists one or more noweb files, which are used only for their definitions of code chunks. Empty chunk definitions in the main document are replaced with the external definitions of the same name. This filter makes it possible to include the same code chunks in multiple documents, or even the same code chunks multiple times in the same document. (Icon installation only.)

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

Converts R 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.