* (bug 6696) readme notes from taw

diff --git a/math/README b/math/README
index e58cbf0..d36e09c 100644 (file)
--- a/math/README
+++ b/math/README
@@ -24,6 +24,11 @@ The makefile requires GNU make.
 Rasterization is done via LaTeX, dvips, and ImageMagick. These need
 to be installed and in the PATH: latex, dvips, convert
 
+AMS* packages for LaTeX also need to be installed. Without AMS* some
+equations will render correctly while others won't render.
+Most distributions of TeX already contain AMS*.
+In Debian/Ubuntu you need to install tetex-extra.
+
 To work properly with rendering non-ASCII Unicode characters, a
 supplemental TeX package is needed (cjk-latex in Debian)
 
@@ -92,6 +97,15 @@ Ensure that the temporary and math directories exist and can be written to by
 the user account the web server runs under; if you don't control the server,
 you may have to make them world-writable.
 
+If some equations render correctly while others don't, you probably don't have
+AMS* packages for LaTeX installed. Most distributions of TeX come with AMS*.
+In Debian/Ubuntu AMS* is in tetex-extra package.
+To check if that is the problem you can try those two equations:
+    x + y
+    x \implies y
+The first uses only standard LaTeX, while the second uses symbol \implies from AMS*.
+If the first renders, but the second doesn't, you need to install AMS*.
+
 == Hacking ==
 
 Before you start hacking on the math package its good to know the workflow,