diff options
Diffstat (limited to 'Build/source/texk/web2c/cwebdir/examples/README')
-rw-r--r-- | Build/source/texk/web2c/cwebdir/examples/README | 55 |
1 files changed, 0 insertions, 55 deletions
diff --git a/Build/source/texk/web2c/cwebdir/examples/README b/Build/source/texk/web2c/cwebdir/examples/README deleted file mode 100644 index ca21cf075c8..00000000000 --- a/Build/source/texk/web2c/cwebdir/examples/README +++ /dev/null @@ -1,55 +0,0 @@ -This directory contains several files for programs that are tutorial -and/or useful. If you are new to CWEB, read "wc.w" first; it's a -typical example of CWEB applied to system programming. - -The Makefile on this directory is a generic way to build applications -written in CWEB. Say, for example, "make wc" to get an executable -program "wc" from wc.w. Say "make wc.dvi" to get a printable listing -of its documentation. The program "wc" is a slight improvement over -UNIX's standard word-count utility. (Try it, for example, with "wc *".) - -The treeprint program, by Norman Ramsey, generates tree-structured -representations of file hierarchies. To use it, say "make treeprint.run" -and then - find dir -type p -print | sort | treeprint -(on a UNIX system), where dir is a directory with interesting subdirectories. - -The wmerge program, by Silvio Levy, produces a single CWEB file from a -given CWEB file and a change file. It expands any "web include" (@i) -specifications in the original CWEB file. To use it, say "make wmerge.run" -and then, e.g., "wmerge foo.w bar.ch > foobar.w". Both CTANGLE and -CWEAVE already accept change files, so you need not merge anything yourself -in normal day-to-day operations; but wmerge can be useful in connection with -the spelling checker described below. - -If you intend to read the source code of CTANGLE and CWEAVE, you may -well wish to read wmerge.w first, or the hardcopy version obtained from -"make wmerge.dvi"; it is similar but much simpler. - -The extex and wordtest programs, by Don Knuth, are useful spellcheckers. -After "make extex.run" say also "ln extex excweb"; this gives -you two filter programs, extex and excweb, that remove extraneous -material from TeX and CWEB source files, respectively. To use them, -you can say for example - cat foo.w | excweb | spell -(or replace "cat foo.w" with "wmerge foo.w bar.ch"). A similar pipeline -for TeX files would be - cat foo.tex | extex | spell -Even better is to replace "spell" by "wordtest /usr/local/lib/dict/words", -if you have a suitable dictionary. One such dictionary in the public domain -can be found in directory ~ftp/pub/dict at ftp.cs.stanford.edu, available -via anonymous ftp. To make your own dictionary from given ones, - cat dict1 dict2 dict3 dict4 | wordtest > words -is quick and effective. See the documentation of wordtest for more info. - -A file kspell.el that provides an emacs user interface to extex+excweb+wordtest -also appears in this directory. (Somebody should write ELWEB...) - -The files xview_types.w and xlib_types.w are examples of @i (include) files -that can be used when writing XView programs. They are based on the header -files in OpenWindows Version 3.0. - -An example XView application appears in Knuth's program oemacs.w, which -he uses for heavy emacsing. It's not very portable, but if you have -OpenWindows3 and a Sun Type-4 keyboard you may like it as much as he does. -(It replaces "emacstool".) The file oemacs.el goes with it. |