summaryrefslogtreecommitdiff
path: root/web/noweb/src/c/doc.nw
blob: d32e6cfc553cf7a8ee626667737f4e3af7c2a63c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
% $Id: doc.nw,v 1.21 2008/10/06 01:03:05 nr Exp nr $

\documentclass[twoside]{article}
\usepackage{noweb,multicol}
\makeatletter
\newenvironment{fields}{\@fields}{\crcr\egroup\par\end{quote}}
\def\@fields{\@ifnextchar[{\@@fields}{\@@fields[4in]}}
\def\@@fields[#1]{\begin{quote}\catcode`\_=\other
        \tabskip=\leftmargin
        \halign\bgroup\tt##\hfil\tabskip=2em&
        {\hsize=#1\vtop{\noindent\raggedright\let\\=\cr
                        \strut##\strut\par}}\tabskip=0pt\cr}
\makeatother
\pagestyle{noweb}\raggedbottom\noweboptions{shift}

\title{{\tt noweb} Source Code\thanks{{\tt noweb} is copyright 1989--2000 by Norman Ramsey.
Although it is freely available, it is not in the public domain.}}
\author{Norman Ramsey\thanks{Section~\ref{preston} is the 
generous contribution of Preston Briggs}\\{\tt nr@eecs.harvard.edu}}
\begin{document}
\maketitle
\section*{Preface}
This isn't a real literate program---there's just enough documentation
here to get the job done.
One of my observations is that the cost of creating a high-quality, well-documented 
literate program adds 1--3 times the amount of effort it took to create the program 
in the first place.
Most programs I write aren't worth that kind of effort, and {\tt noweb} is
no exception.
Don't expect too much.

\tableofcontents

\input{allcode.tex}

\bibliographystyle{plain}
\bibliography{web}

\section{List of all chunks from all files}

\nowebchunks

\begin{multicols}{2}[\section{Index}]
\nowebindex
\end{multicols}

\end{document}