summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/web2c/README
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-17 21:41:51 +0000
committerKarl Berry <karl@freefriends.org>2006-01-17 21:41:51 +0000
commit487ca4806cc046076293cf6cc5fbba0db282bac7 (patch)
tree847b412ab5158dd7bdd7ed7e5a4cc3fbca94be32 /Build/source/texk/web2c/web2c/README
parenta3d3111bfe26b8e5f5bc6049dfb2a4ca2edc7881 (diff)
texk 1
git-svn-id: svn://tug.org/texlive/trunk@1485 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/web2c/README')
-rw-r--r--Build/source/texk/web2c/web2c/README18
1 files changed, 18 insertions, 0 deletions
diff --git a/Build/source/texk/web2c/web2c/README b/Build/source/texk/web2c/web2c/README
new file mode 100644
index 00000000000..3471cac9798
--- /dev/null
+++ b/Build/source/texk/web2c/web2c/README
@@ -0,0 +1,18 @@
+This directory contains the programs that convert the original web
+sources to C.
+
+The convert shell script is the thing that actually gets invoked from
+the Makefile. It runs web2c, fixwrites, and splitup in turn, plus
+various sed nonsense. web2c parses Pascal and outputs C; fixwrites
+shouldn't be necessary, it converts multiple-argument writes into C;
+splitup splits the output file into pieces for the sake of broken
+compilers.
+
+To define a new symbol (e.g., a function) to be used in the change
+files, it's necessary to add it to texmf.defines (if it's only used in
+TeX/MF/MP) or common.defines (otherwise) here, as well as making the
+actual definition. New functions in the libraryshould be declared
+somewhere, probably cpascal.h. Of course no underscores are allowed,
+since tangle removes them.
+
+