NOWEB(7)

NAME
nowebstyle - LaTeX package for noweb

SYNOPSIS
\\usepackage{noweb}

DESCRIPTION
When noweave generates code for LaTeX, the noweb package is required. In addition to the necessary arcana, it defines a webcode environment in which you can place fragments of code, and in which only backslash and curly braces have their special meanings; all other characters are taken literally. It also defines a noweb pagestyle. Finally, it defines a \\noweboptions{...} command that can be used to tinker with the appearance of the output. Options are separated by commas and include:

margintag
    Put the sub-page number (tag) of each code-chunk definition in the left margin. (Default)

nomargintag
    Don't use margin tags.

shift
    Shift text to the left so that long code lines won't extend off the right-hand side of the page.

smallcode
    Set code in LaTeX \\small font instead of \\normalsize.

longxref, shortxref
    Use either long, Knuth-style chunk cross-reference, or short, Hanson-style chunk cross-reference. The former uses small paragraphs after the chunk; the latter uses symbols on the definition line. Defaults to shortxref.

alphasubpage, numsubpage, nosubpage
    Number chunks by the number of the page on which they appear, followed by an alphabetic (numeric, not used) ``sub-page'' indicator. Defaults to alphasubpage. nosubpage implies nomargintag.

webnumbering
    Number chunks consecutively, in WEB style, instead of using sub-page numbers.

hideunuseddefs
    Omit defined but unused identifiers from the local identifier cross-reference (Preston Briggs).

noidentxref
    Omit the local identifier cross-reference which follows each code chunk.

externalindex
    Use an index generated with noindex(1) (q.v.).

longchunks
    When expanding \\nowebchunks, show page numbers of definitions and uses of each chunk.

CONTROL SEQUENCES
The noweb package describes a gazillion special control sequences. Only a few are listed here.

\nextchunklabel{l}
    Associates label l with the sub-page reference of the next code chunk. Can be used in for concise chunk cross-reference with, e.g., chunk~\subpageref{l}.

\\nwanchorto{URL}{anchor text}
    Creates a link to the given URL with the given anchor text. Implemented in latex(1) using footnotes, but sl2h(1) translates this to <a href=URL>anchor text</a>

\\nwanchorname{name}{anchor text}
    Creates an anchor point for a hyperlink. Implemented in latex(1) using \\label , but sl2h(1) translates this to <a name=name>anchor text</a>

\\ifhtml ... \\fi
    Text between \\ifhtml and \\fi is ignored by latex(1), but sl2h(1) and the l2h noweb filter translate the text into HTML.

SEE ALSO
noweave(1), noweb(1)

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.