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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.0//EN">
<HTML>
<head>
<TITLE>noweb for Debian GNU/Linux</TITLE>
</head>
<BODY BGCOLOR=white>
<CENTER><H1>noweb for Debian GNU/Linux</H1></CENTER>
<P>This package contains the Debianized version of noweb,
a simple literate-programming tool.
<P>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.
<P>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.
<P>The primary sacrifice relative to the original
<TT>WEB</TT> is that code is not prettyprinted; but a number of
prettyprinter exist for noweb, from the simplest one (<tt>dpp</tt>),
to the very complex and featurefull (<tt>pretzel</tt>).
<H2>How to begin</H2>
First read the
<A HREF="http://localhost:80/cgi-bin/dwww?type=runman&location=noweb/1">
noweb manual page</A> (it's only three pages!), then go to the
<A HREF="examples">example directory</A>
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
<A HREF="http://localhost:80/cgi-bin/dwww?type=runman&location=nowebstyle/7">
noweb style</a> manual page.
If you really want, you can go to the
<A HREF="http://www.cs.virginia.edu/~nr/noweb/intro.html">
official noweb homepage</A> (external link). There are some
links and other interesting stuff.
<P>noweb also comes with some good manual pages for all the other tools
like
<a HREF="http://localhost:80/cgi-bin/dwww?type=runman&location=notangle/1">
notangle and noweave</a>, the
<a HREF="http://localhost:80/cgi-bin/dwww?type=runman&location=nowebfilters/7">
noweb filters</a> and
<a HREF="http://localhost:80/cgi-bin/dwww?type=runman&location=noroots/7">
noroots</a>.
<H2>More documentation</H2>
<P>Some more documentation avaiable with this package
(you need <strong>dwww</strong> to read the man page):
<TABLE>
<TR><TD><A HREF="guide.html.gz">guide.html</A></TD> <TD>The noweb hacker guide</TD></TR>
<TR><TD><A HREF="README.gz">README</A></TD> <TD>Upstream README</TD></TR>
<TR><TD><A HREF="FAQ.gz">FAQ</A></TD><TD>Upstream FAQ</TD></TR>
<TR><TD><A HREF="changelog.gz">changelog</A></TD>
<TD>Upstream changelog</TD></TR>
<TR><TD><A HREF="changelog.Debian.gz">changelog.Debian</A></TD>
<TD>Debian package changelog</TD></TR>
</TABLE>
</BODY>
</HTML>
|
