🚀 go-pugleaf

I have created a new version of my CWEB sample program based on
the calculator program from Chapter 4 of Kernighan and Ritchie's
C book.  This program illustrates the use of CWEB with a program
that is divided into multiple, separatly compiled source files (note
that all the demo programs distributed with CWEB are "monolithic").
It incidentally also shows a way of handling ANSI function
prototypes in CWEB.  Since it's getting largish, I'm planning
to take George Greenwade up on his offer to house it in his
archive at niord.shsu.edu (the official archive of the LITPROG
literate programming mailing list).  I'll upload it ASAP; it
should be available tonight or tomorrow.  So please don't ask
for it by email; instead fetch it by anonymous FTP or by mail
request to FILESERV.  Thanks!

The actual Web source files haven't changed at all, but the
Makefile has been substantially improved, and two new files added.
The new version includes a ReadMe file that talks you through
the process of ctangle'ing, cweave'ing, compiling, and TeX'ing
(but assumes you know the basics of how a Makefile works),
and an additional Web file whose purpose is to assemble the output
(.tex and .toc files) from the separate documentation files into
a single file that contains a listing for the whole program, with
the tables of contents, indexes, and lists of sections grouped
together.  This project was created with the intention of having
it serve as a model or template that can be copied to give a
CWEB programmer a pre-built scaffold with which to erect his
own programs.  It is exhaustively (or perhaps exhaustingly ;-) )
documented.

Input from several "beta testers" has been very helpful in
creating this improved version, and I intend to continue
improving it if feedback continues to come in.  This is,
however, the last announcement that I will make in comp.text.tex;
now that the LITPROG list exists that seems a more appropriate
place for such things.

Thanks to everyone who has expressed interest and devoted
time to helping make this a useful example for CWEB novices!
--Cameron Smith
  cameron@symcom.math.uiuc.edu