summaryrefslogtreecommitdiff
path: root/t4ht-workaround/README
diff options
context:
space:
mode:
authormstsirkin <mstsirkin@0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652>2014-01-12 11:03:05 +0000
committermstsirkin <mstsirkin@0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652>2014-01-12 11:03:05 +0000
commit36937d05753be9ea5af6e7888b039e8f16594239 (patch)
treef0aeaf78da4b50175c0d178546972cbf5a3cdac4 /t4ht-workaround/README
parent6d6fc82c558db0ef91ad2a101503d5158a79ffda (diff)
README: note on issues and work-arounds
Document that makehtml needs to be edited to use workaround. Document that paths need to be adjusted if copying config from an old installation. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@181 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
Diffstat (limited to 't4ht-workaround/README')
-rw-r--r--t4ht-workaround/README18
1 files changed, 18 insertions, 0 deletions
diff --git a/t4ht-workaround/README b/t4ht-workaround/README
new file mode 100644
index 0000000..0e98f2c
--- /dev/null
+++ b/t4ht-workaround/README
@@ -0,0 +1,18 @@
+Recent Fedora and some other distros have broken t4ht
+packages, making makehtml fail. The correct fix is to put a
+working t4ht somewhere in your path.
+
+For example, for Fedora one can get an old copy from here:
+http://pkgs.fedoraproject.org/repo/pkgs/tetex-tex4ht/tex4ht-1.0.2008_02_28_2058.tar.gz/dc9d78c8ad22acd4b40dfd2cbbe2b8de/tex4ht-1.0.2008_02_28_
+after unpacking, t4ht is under ./bin/linux/t4ht, put it on
+path.
+tex4ht.env is under texmf/tex4ht/base/unix/tex4ht.env, put it
+in $HOME (you can rename it .tex4ht) or under current
+directory. Make sure to fix up paths otherwise output
+will be mailformed!
+
+Alternatively, you can also put this t4ht-workaround directory first
+on your path, it includes an emoty stub for t4ht.
+You will also need to uncomment a work-around in makehtml.sh.
+If you use this work-around you will get an html output though it
+won't be properly formatted.