summaryrefslogtreecommitdiff
path: root/support/TeX4ht/source/README
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-05-12 03:01:15 +0000
committerNorbert Preining <norbert@preining.info>2021-05-12 03:01:15 +0000
commitbcdf6c829c6761de02484473ebe43fa3760adcaa (patch)
treede384ae80a1a9e34f900739a9478f92a0660a9ef /support/TeX4ht/source/README
parent4a8a25f4c6acac624cf323115db94d934b19d6b1 (diff)
CTAN sync 202105120301
Diffstat (limited to 'support/TeX4ht/source/README')
-rw-r--r--support/TeX4ht/source/README23
1 files changed, 23 insertions, 0 deletions
diff --git a/support/TeX4ht/source/README b/support/TeX4ht/source/README
new file mode 100644
index 0000000000..9d8b2e663a
--- /dev/null
+++ b/support/TeX4ht/source/README
@@ -0,0 +1,23 @@
+$Id: README 924 2021-05-02 22:55:22Z karl $
+This file is public domain. Originally written 2010, Karl Berry.
+
+Sources for TeX4ht, https://tug.org/tex4ht.
+
+Eitan Gurari (the original author of tex4ht) devised his own literate
+programming system, which supports multiple output files from a single
+source (https://ctan.org/pkg/protex). The files here are such "literate"
+source files. They are processed with (ht)(la)tex, as given by commands
+at the top of each file and in the Makefile.
+
+The extra-bin subdirectory contains do-nothing scripts named xmllint
+and vcss, which are called for validation via tex4ht-env.tex. (Of
+course they won't be used unless ./extra-bin is early enough in PATH.)
+The real xmllint can take a long time to run, and fails to find the
+DTD on the tex4ht-docbook*.html output.
+
+The Makefile has commands to build the derived files (e.g., *.4ht) from
+the *.tex sources, compare them against an installed system, etc. Much
+work remains to be done to make it a clean build, but it's a start.
+
+Bug reports and patches are most welcome. See https://tug.org/tex4ht
+for contact and other information.