% This file is part of CWEB.% The CWEB programs by Silvio Levy are based on programs by D. E. Knuth.% They are distributed WITHOUT ANY WARRANTY, express or implied.% This README file last updated May 2021 by Andreas Scherer % Copyright (C) 1987,1990,1993,2000,2016 Silvio Levy and Donald E. Knuth % Permission is granted to make and distribute verbatim copies of this% document provided that the copyright notice and this permission notice% are preserved on all copies. % Permission is granted to copy and distribute modified versions of this% document under the conditions for verbatim copying, provided that the% entire resulting derived work is given a different name and distributed% under the terms of a permission notice identical to this one. % Please send comments, suggestions, etc. to tex-k@tug.org, and people% there will verify and forward bug reports.%% DEK takes no responsibility for the changefiles; they should be% maintained independently. He even transferred the job to correct errors% in ctangle.w, cweave.w, prod.w, common.w, cwebmac.tex, cwebman.tex,% and in the files of examples/*.w to Andreas Scherer in 2021.% Further significant developments, including versions that neither% Don Knuth nor Silvio Levy themselves do maintain, are ongoing.% All of the really current news about CWEB is, in fact, now to be found% on the CWEB development page https://github.com/ascherer/cweb. This directory contains the following files: MakefileREADMEcomm-amiga.chcomm-bs.chcomm-mac.chcomm-man.chcomm-os2.chcomm-pc.chcomm-ql.chcomm-vms.chcomm-w32.chcommon.ccommon.hcommon.wctang-bs.chctang-man.chctang-pc.chctang-ql.chctang-vms.chctang-w32.chctangle.cctangle.wcweav-bs.chcweav-man.chcweav-pc.chcweav-ql.chcweav-vms.chcweave-w32.chcweave.wcweb.1cweb.elcwebmac.texcwebman.texexamples/makefile.bsprod.wreadme.qlc++lib.wiso_types.w The file cwebman.tex is the user manual.The examples directory contains additional examples of the use of CWEB.The files common.c and ctangle.c are used for bootstrapping.The file cweb.1 is a manual page.The file cweb.el is suggested for GNU-Emacs users.The files c++lib.w and iso_types.w are for C++ users (say `@i c++lib.w'and/or `@i iso_types.w' at beginning of program).The files *-man.ch are used if you want to make the full 243-page CWEB manual.The files *-bs.ch are used instead of *-pc.ch if you are doing BIG programs.You can use makefile.bs to make CWEB with *-bs.ch.The files *-ql.ch are for QDOS/SMSQ systems; see readme.ql for further info.The files *-w32.ch use __fastcall conventions on win32 systems.The file comm-mac.ch is for Macintosh conventions.The other files named *.ch are sample change files for local customization. IMPORTANT: Please touch *.c before proceeding.Then edit the opening lines of Makefile so that it has the properdirectory information for your local system. To make ctangle and cweave say `make all'; this should produce roughlythe following actions (possibly with harmless warning messages from cc): cc -g -w -c ctangle.ccc -g -w -DCWEBINPUTS=\"/usr/local/lib/cweb\" -c common.ccc -g -o ctangle ctangle.o common.o ./ctangle cweavecc -g -w -c cweave.ccc -g -w -o cweave cweave.o common.o To get some reassurance that things are OK, you can say `make cautiously',which ensures that CTANGLE will reproduce itself. (Otherwise the sourcefiles common.w and ctangle.w won't actually have been used.) To install cweave and ctangle say `make install'. You probably need tobe superuser to do this; but it's wise to `make all' first, BEFOREbecoming superuser and saying `make install'. Note that change files for VMS, AMIGA, MAC, and PCs are provided.  When youare first bootstrapping to a new system, you may need to edit common.c andctangle.c by hand, but the vast majority of the change-file changes areminor refinements that are not necessary for a rudimentary ctangle.