Mention in README.md the need for the iftex package and how to get it.
[ibg.git] / README.md
index f2c7b151101483914c339c12764b9ce3ba0f8bf8..eadb3a6e19b8b1bc6b0fd2a62914f7233aabb2a7 100644 (file)
--- a/README.md
+++ b/README.md
@@ -53,44 +53,19 @@ guide from a command prompt, like this:
 
        make html
 
-For building the PDF version, you need a reasonably recent installation of
-TeX Live.  Release 2014 will do.  You will also need the Emerald font
-package from https://www.ctan.org/tex-archive/fonts/emerald/.  This cannot
-be installed with `tlmgr`, nor does it seem to be packaged by the usual
-Linux or BSD distributions.  Scripts for installing and uninstalling
-Emerald are provided in the `tools` directory.  When you're ready, type
+For building the PDF version, you need a reasonably recent installation 
+of TeX Live.  Release 2014 will do.  You will also need the iftex 
+package, which may or may not be automatically installed.  For Debian 
+and Debian-derived systems, the "texlive-generic-extra" package will 
+take care of this.
+
+You will also need the Emerald font package from 
+https://www.ctan.org/tex-archive/fonts/emerald/.  This cannot be 
+installed with `tlmgr`, nor does it seem to be packaged by the usual 
+Linux or BSD distributions.  Scripts for installing and uninstalling 
+Emerald are provided in the `tools` directory.  When you're ready, type 
 this:
 
        make latexpdf
 
 Other formats are available; just type `make` for more details.
-
-Conversion strategy
--------------------
-
-The first three editions of the IBG were created with
-[Adobe FrameMaker](http://www.adobe.com/products/framemaker.html).  And the
-FrameMaker source files have kindly been supplied by Roger Firth to make
-this update, which opened up the possibility of creating an auto-converter.
-
-But unfortunately, what with FrameMaker being proprietary, there isn't much
-out there apart from FrameMaker itself that can read them.  I was hoping
-that conversion using [Mif2Go](http://mif2go.com) might be a possibility,
-but it turns out that that's just a plugin for FrameMaker.  I guess I could
-get a trial FrameMaker license, try to set up the plugin and get it to
-autoconvert to some usable format, but it all looks far too messy.  But on
-the plus side, the supplied GIF images are totally usable.
-
-So, it's back to my original plan: use the PDF file.  Here's the first
-(major) part of the work:
-
-* Dump the text out of the PDF file
-* Convert all the 3rd edition text to Sphinx format
-* Get the online version to look good
-
-After that comes the 4th edition changes, hopefully in collaboration with
-others.  Also, in parallel with that, other niceties:
-
-* Add a glossary
-* Add an index
-* Prepare a new PDF version, via the Sphinx LaTeX converter