source/texk/web2c/web2c/README

   1 This directory contains the programs that convert the original web
   2 sources to C.
   3
   4 The convert shell script is the thing that actually gets invoked from
   5 the Makefile.  It runs web2c, fixwrites, and splitup in turn, plus
   6 various sed nonsense.  web2c parses Pascal and outputs C; fixwrites
   7 shouldn't be necessary, it converts multiple-argument writes into C;
   8 splitup splits the output file into pieces for the sake of broken
   9 compilers.
  10
  11 To define a new symbol (e.g., a function) to be used in the change
  12 files, it's necessary to add it to texmf.defines (if it's only used in
  13 TeX/MF/MP) or common.defines (otherwise) here, as well as making the
  14 actual definition.  New functions in the library should be declared
  15 somewhere, probably cpascal.h.  Of course no underscores are allowed,
  16 since tangle removes them.
  17
  18