summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/web2c/README
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
committerKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
commitad547a6b5986815fda458221149728d9d9ab1d87 (patch)
tree16296910eb3eca724371474ea9aea3994dc69614 /Build/source/texk/web2c/web2c/README
parent947b43de3dd21d58ccc2ffadefc4441ea1c2a813 (diff)
restore Build,TODO from r57911
git-svn-id: svn://tug.org/texlive/trunk@57915 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..8ad3b0eff39
--- /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 library should be declared
+somewhere, probably cpascal.h. Of course no underscores are allowed,
+since tangle removes them.
+
+