tnaia / cwebbin

Literate Programming in C/C++

literate programming in ansi-c/c++

cwebbin is the ansi-c/c++ implementation of silvio levy's and donald e. knuth's cweb system and donald e. knuth's ctwill program. it requires the contents of the original cweb source drop and the secondary ctwill source drop, to which it applies a set of change files to fix warnings issued by modern c/c++ compilers and to introduce advanced features. see the extensive readme for the full story.

NOTE: the link to the ctwill tarball on the stanford cs server seems to be broken at this time; luckily, the source package for cwebbin contains the original 2000 ctwill.tar.gz (among other things). you can extract the contents of this package with pax -rzf cwebbin-2020-18.sdeb.

extract cwebbin-2020.tar.gz and add the contents of cweb-3.64c.tar.gz and ctwill.tar.gz for the full set of source files. unix/linux users should work with make -f Makefile.unix exclusively (targets boot, cautiously, and all).

advanced packaging

alternatively, you may want to use rpmbuild or debbuild for compiling the sources and for creating installable packages in rpm and deb format. clone cweb and cwebbin, create the source drops with

git archive -o cweb-3.64c.tar.gz cweb-3.64c
git archive -o cwebbin-2020.tar.gz cwebbin-2020

respectively, put these two tarballs and the original ctwill.tar.gz (see note above) in the SOURCES directory and cwebbin.spec in the SPECS directory of your build arena, and run

{deb|rpm}build -ba SPECS/cwebbin.spec

depending on your preferences.

cweb for texlive

the extended sources and the build system were modified to smoothly integrate with the texlive build system. by invoking

{deb|rpm}build -bi SPECS/cwebbin.spec --with texlive

you receive a small tarball cweb-texlive.tar.gz, which should be extracted in texlive's source directory texlive-source (or the subversion equivalent). this tarball contains *-w2c.ch files that modify the original cweb sources for the texlive ecosystem. additionally, it contains language catalogs, tex macros, and cweb include files.