mathematical 1.5.0 → 1.5.12

data/ext/mathematical/lasem_overrides.c

@@ -1,8 +1,27 @@
 #include "ruby.h"
 
-#include <lasem_overrides.h>
+#include "lasem_overrides.h"
 #include <string.h>
-#include "mtex2MML.h"
+#include <mtex2MML.h>
+
+void
+itex2MML_free_string (char * str)
+{
+  return mtex2MML_free_string(str);
+}
+
+void
+lsm_itex_free_mathml_buffer	(char *mathml)
+{
+  if (mathml == NULL)
+    return;
+
+  mtex2MML_free_string (mathml);
+}
+
+char *
+lsm_itex_to_mathml (const char *itex, gssize size) { }
+
 
 char *
 lsm_mtex_to_mathml (const char *mtex, gssize size, int delimiter, int render_type)
@@ -41,8 +60,10 @@ lsm_mtex_to_mathml (const char *mtex, gssize size, int delimiter, int render_typ
     mathml = mtex2MML_output();
     break;
   default:
-    /* should be impossible, Ruby code prevents this */
-    print_and_raise(rb_eTypeError, "not valid render format");
+    mathml = mtex2MML_parse(mtex, usize, delimiter);
+    if (mathml == NULL) {
+      status = 1;
+    }
     break;
   }
 

data/ext/mathematical/lasem_overrides.h

@@ -8,6 +8,11 @@
 #define TEXT_FILTER 2
 #define STRICT_FILTER 3
 
+/* Dummies for mtex2MML_free_string */
+void itex2MML_free_string (char * str);
+void lsm_itex_free_mathml_buffer	(char *mathml);
+char * lsm_itex_to_mathml (const char *itex, gssize size);
+
 /**
  * lsm_mtex_to_mathml:
  * @mtex: (allow-none): an mtex string

data/ext/mathematical/mtex2MML/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+## Bug fixes
+
+If you're interested in fixing a bug, there are two files you'll likely need to change:
+
+* *lexer.l*, which contains the grammar rules for the TeX characters.
+* *parser.y*, which acts on the grammar states and converts the data into MathML.
+
+If you submit a PR for something new, you should also add tests. You may need to update [SUPPORTED.md](SUPPORTED.md), too.
+
+## Feature requests
+
+Want something added, but don't want to code? That's cool! Please provide a clear example of the math TeX and a reason why you think it should be added. For example:
+
+> I'd like to be able to use `\douglas` in my equations, like this:
+>
+>     $$
+>     \douglas - 2 = 40
+>     $$
+>
+> This shorthand notation is very popular among British mathematicians.
+
+Simply stating "Please add this syntax" without a reason might not get a reply.

data/ext/mathematical/mtex2MML/README.md

@@ -0,0 +1,143 @@
+# mtex2MML
+
+[![Build Status](https://travis-ci.org/gjtorikian/mtex2MML.svg?branch=master)](https://travis-ci.org/gjtorikian/mtex2MML) [![Build status](https://ci.appveyor.com/api/projects/status/0ynwxikxqp5rseu3?svg=true)](https://ci.appveyor.com/project/gjtorikian/mtex2mml)
+
+This is a Bison grammar to convert TeX math into MathML. It can be used as a standalone program or as a static library. It is written in standard C99. It's been tested on OS X, Ubuntu, and Windows.
+
+The goal of this project is to implement as much of AMS-TeX math as possible.
+
+This code is a fork of [the itex2MML project](https://golem.ph.utexas.edu/~distler/blog/itex2MML.html), originally written by Jacques Distler and Paul Gartside. It has vastly more support for AMS-TeX math than the original, with a much larger test suite.
+
+### Why MathML?!
+
+It's true, MathML is not well supported in browsers. (Kudos to the Firefox team for sticking with it!)
+
+However, you can consider MathML as an intermediate format onto greater things, like conversion to SVG via [mathematical](https://github.com/gjtorikian/mathematical).
+
+## What's supported?
+
+Please refer to [SUPPORTED.md](SUPPORTED.md) for more information on what this lib can do. Right now it has a ~93% compatibility with everything MathJax can do.
+
+The most obvious gap in this library is the inability to define new commands (via `\mathop`, `\def`, `\mathchoice`, etc.). Everything else in standard TeX math should be fine.
+
+## Usage
+
+By default, inline equations are demarcated by `$...$`. Display equations are demarcated by `$$...$$`. You can change these to `\(..\)` and `\[..\]` respectively; see below for configuration.
+
+You cannot nest equations; for example, `$$...\text{foo $...$ bar}...$$` is not allowed.
+
+### Heuristics
+
+Since `$` signs appear quite often in plaintext, a basic heuristic is applied to calculate whether `$` should be interpreted as math or not:
+
+> Basic heuristic is: opening $ can't be followed by whitespace, closing $ can't be followed by
+   a digit or preceded by whitespace." -- @jgm, http://bit.ly/1HVtemx */
+
+Of course, if you type `\$`, no math is applied as the `$` is considered skipped.
+
+### As a library
+
+Both a static and dynamic library are created as part of the `cmake` build process. Include one of them during the compilation of your program.
+
+#### Methods available
+
+The library exposes the following methods:
+
+* `char * mtex2MML_parse(const char * str, unsigned long strlen, const int options)`: Converts a single TeX equation in `str` to MathML. Returns just the MathML equation, as a string.
+
+* `char * mtex2MML_global_parse(const char * str, unsigned long strlen, const int options, int global_start)`: The same as `mtex2MML_parse`, but allows you to provide a starting integer for equation numbering. Returns just the MathML equation, as a string.
+
+* `int mtex2MML_filter(const char * str, unsigned long strlen, const int options)`: Given a string with a mix of TeX math and non-math elements, this returns a single string containing just the converted math elements. Equations are automatically numbered. Returns a `status` indicating success (`0`) or failure. You must access the resulting string with `mtex2MML_output`.
+
+* `int mtex2MML_text_filter(const char * str, unsigned long strlen, const int options)`: Given a string with a mix of TeX math and non-math elements, this converts all the math and leaves the rest of the string unmodified. Equations are automatically numbered. Returns a `status` indicating success (`0`) or failure. You must access the resulting string with `mtex2MML_output`. HTML within a math equation are normalized (eg. `<` becomes `&lt;`).
+
+* `int mtex2MML_strict_filter(const char * str, unsigned long strlen, const int options)`: Given a string with a mix of TeX math and non-math elements, this converts all the math and leaves the rest of the string unmodified. Equations are automatically numbered. Returns a `status` indicating success (`0`) or failure. You must access the resulting string with `mtex2MML_output`. HTML tags are removed completely.
+
+The `options` argument determines which types of delimiters are to be used:
+
+* `MTEX2MML_DELIMITER_DEFAULT` is the default, using `$..$` for inline and `$$..$$` for display.
+* `MTEX2MML_DELIMITER_DOLLAR` uses single dollar signs: `$..$` for inline.
+* `MTEX2MML_DELIMITER_DOUBLE` uses double dollar signs: `$$..$$` for display.
+* `MTEX2MML_DELIMITER_PARENS` uses parenthesis: `\(..\)` for inline.
+* `MTEX2MML_DELIMITER_BRACKETS` uses brackets: `\[..\]` for brackets.
+
+[The *tests/basic.c*](tests/basic.c) and [the *tests/delimiters.c*](tests/delimiters.c) suites provides a demonstrate of how these methods can be used.
+
+### As a command
+
+Like any good Unix program, the mtex2MML binary operates on pipes. That is to say, it works like this:
+
+```
+echo '\sin y' | mtex2MML --inline > math.txt
+```
+
+Use `mtex2MML -h` to get documentation on the options.
+
+## Error handling
+
+A `0` status indicates a success, while anything else indicates a failure, [as per the Bison documentation](http://www.gnu.org/software/bison/manual/html_node/Parser-Function.html). If a token cannot be parsed, or if the tokenization is nested too deep, the library will bail with a non-zero status code. An error message is also printed to STDERR.
+
+[The *tests/maliciousness.c* suite](tests/maliciousness.c) has a demonstration on how to perform error handling.
+
+## Building
+
+To build mtex2MML, you need:
+
+* [CMake](http://www.cmake.org/download/) (at least version 2.8.7)
+* [Bison](https://www.gnu.org/software/bison/)
+* [Flex](http://flex.sourceforge.net/)
+* [Python3](https://www.python.org/) (just for the tests)
+
+### OS X and Ubuntu
+
+To fetch dependencies, build, and run the library, call:
+
+```
+script/bootstrap
+cd build
+cmake ..
+make
+```
+
+### Windows
+
+With [Chocolatey](https://chocolatey.org/), you can run:
+
+```
+choco install cmake winflexbison python3
+```
+
+Then, with Powershell, simply run `build.ps1`.
+
+## Testing
+
+Assuming you've built the programs, to run the test suite:
+
+```
+cd build
+ctest -V
+```
+
+mtex2MML has a test suite that mimics the one found in [MathJax](https://github.com/mathjax/MathJax-test), with a few exceptions:
+
+* Files marked as `.xtex` have features that are not implemented, but probably should be in the future.
+* Files marked as `.no_tex` have features that probably won't be implemented.
+
+During the test run, the suite will list the percentage of features that still need coverage.
+
+## Installing
+
+To install the mtex2MML binary, you can run:
+
+```
+cd build
+make install
+```
+
+## Contributing
+
+Found a bug or want to request a feature? Great! Check out [CONTRIBUTING.md](CONTRIBUTING.md) for more information!
+
+## License
+
+As with the original version(s), this is Open Source software, released under a triple license: [GPL](http://choosealicense.com/licenses/gpl-2.0/), [MPL](http://choosealicense.com/licenses/mpl-2.0/), and [LGPL](http://choosealicense.com/licenses/lgpl-2.1/).

data/ext/mathematical/mtex2MML/SUPPORTED.md

@@ -0,0 +1,1214 @@
+This list represents the complete set of commands supported by mtex2MML.
+
+The most obvious gap in this library is the inability to define new commands (via `\mathop`, `\def`, `\mathchoice`, etc.). Everything else in standard TeX math should be fine, though.
+
+## Symbols
+
+``` latex
+_
+(
+)
+[
+]
+/
+\
+\,
+\;
+\:
+\!
+\!
+\{
+\}
+\&
+\#
+\%
+\>
+\|
+\|
+\$
+```
+
+## A
+
+``` latex
+\above
+\abovewithdelims
+\acute
+\aleph
+\alpha
+\Alpha
+\amalg
+\And
+\angle
+\approx
+\approxeq
+\arccos
+\arcsin
+\arctan
+\arg
+\Arrowvert
+\arrowvert
+\ast
+\asymp
+\atop
+\atopwithdelims
+```
+
+## B
+
+``` latex
+\backepsilon
+\backprime
+\backsim
+\backsimeq
+\backslash
+\bar
+\barwedge
+\Bbb
+\bbox
+\bcancel
+\because
+\beta
+\Beta
+\beth
+\between
+\bf
+\bgcolor
+\big
+\Big
+\bigcap
+\bigcirc
+\bigcup
+\Bigg
+\bigg
+\Biggl
+\biggl
+\Biggm
+\biggm
+\Biggr
+\biggr
+\biginterleave
+\Bigl
+\bigl
+\Bigm
+\bigm
+\bigodot
+\bigoplus
+\bigotimes
+\bigr
+\Bigr
+\bigsqcap
+\bigsqcup
+\bigstar
+\bigtriangledown
+\bigtriangleup
+\biguplus
+\bigvee
+\bigwedge
+\binom
+\blacklozenge
+\blacksquare
+\blacktriangle
+\blacktriangledown
+\blacktriangleleft
+\blacktriangleright
+\bmod
+\boldsymbol
+\bot
+\bottom
+\bowtie
+\Box
+\boxdot
+\boxed
+\boxminus
+\boxplus
+\boxtimes
+\brace
+\bracevert
+\brack
+\breve
+\buildrel
+\bullet
+\Bumpeq
+\bumpeq
+```
+
+## C
+
+``` latex
+\cal
+\cancel
+\cancelto
+\canceledto
+\Cap
+\cap
+\cdot
+\cdotp
+\cdots
+\centerdot
+\cfrac
+\check
+\checkmark
+\chi
+\choose
+\circ
+\circeq
+\circlearrowleft
+\circlearrowright
+\circledast
+\circledcirc
+\circleddash
+\circledR
+\circledS
+\clap
+\closure
+\clubsuit
+\colon
+\Colonapprox
+\colonapprox
+\Coloneq
+\coloneq
+\Coloneqq
+\coloneqq
+\Colonsim
+\colonsim
+\color
+\colorbox
+\complement
+\cong
+\conint
+\contourintegral
+\coprod
+\coproduct
+\cos
+\cosh
+\cot
+\coth
+\cr
+\csc
+\Cup
+\cup
+\curlyeqprec
+\curlyeqsucc
+\curlyvee
+\curlywedge
+\curvearrowbotright
+\curvearrowleft
+\curvearrowright
+```
+
+## D
+
+``` latex
+\dagger
+\daleth
+\darr
+\dashleftarrow
+\dashrightarrow
+\dashv
+\dbinom
+\dblcolon
+\ddagger
+\ddddot
+\dddot
+\ddot
+\ddots
+\deg
+\Del
+\Delta
+\delta
+\det
+\dfrac
+\diagdown
+\diagup
+\Diamond
+\diamond
+\diamondsuit
+\digamma
+\dim
+\displaystyle
+\div
+\divideontimes
+\dot
+\Doteq
+\doteq
+\doteqdot
+\dotplus
+\dots
+\dotsb
+\dotsc
+\dotsi
+\dotsm
+\dotso
+\doublebarwedge
+\doublecap
+\doublecup
+\doubleintegral
+\Downarrow
+\downarrow
+\downdownarrows
+\downharpoonleft
+\downharpoonright
+\downuparrow
+\duparr
+```
+
+## E
+
+``` latex
+\ell
+\embedsin
+\emptyset
+\enclose
+\enspace
+\epsilon
+\eqcirc
+\eqalign
+\eqalignno
+\eqcolon
+\Eqcolon
+\eqqcolon
+\Eqqcolon
+\eqsim
+\eqslantgtr
+\eqslantless
+\equiv
+\eta
+\Eta
+\eth
+\exists
+\exp
+```
+
+## F
+
+``` latex
+\fallingdotseq
+\fbox
+\Finv
+\flat
+\forall
+\frac
+\frak
+\frown
+```
+
+## G
+
+``` latex
+\Game
+\Gamma
+\gamma
+\gcd
+\ge
+\geq
+\geqq
+\geqslant
+\genfrac
+\gets
+\gg
+\ggg
+\gggtr
+\gimel
+\gnapprox
+\gneq
+\gneqq
+\gnsim
+\grave
+\gt
+\gtrapprox
+\gtrdot
+\gtreqless
+\gtreqqless
+\gtrless
+\gtrsim
+\gvertneqq
+```
+
+## H
+
+``` latex
+\hat
+\hbar
+\hbox
+\hdashline
+\heartsuit
+\hline
+\hom
+\hookleftarrow
+\hookrightarrow
+\hphantom
+\hskip
+\hslash
+\hspace
+\Huge
+\huge
+```
+
+## I
+
+``` latex
+\idotsint
+\iff
+\iiiint
+\iiint
+\iint
+\Im
+\imath
+\implies
+\impliedby
+\in
+\inf
+\infinity
+\infty
+\injlim
+\int
+\integral
+\intercal
+\intersection
+\Intersection
+\intop
+\invamp
+\iota
+\Iota
+\it
+```
+
+## J
+
+``` latex
+\jmath
+\Join
+```
+
+## K
+
+``` latex
+\Kappa
+\kappa
+\ker
+\kern
+```
+
+## L
+
+``` latex
+\Lambda
+\lambda
+\land
+\lang
+\langle
+\LARGE
+\Large
+\large
+\LaTeX
+\lbrace
+\lbrack
+\lceil
+\lcorner
+\ldotp
+\ldots
+\le
+\leadsto
+\Leftarrow
+\leftarrow
+\leftarrowtail
+\leftharpoondown
+\leftharpoonup
+\leftleftarrows
+\Leftrightarrow
+\leftrightarrow
+\leftrightarrows
+\leftrightharpoons
+\leftrightsquigarrow
+\leftrightsquigarrow
+\leftroot
+\leftsquigarrow
+\leftthreetimes
+\lefttorightarrow
+\leq
+\leqq
+\leqslant
+\lessapprox
+\lessdot
+\lesseqgtr
+\lesseqqgtr
+\lessgtr
+\lesssim
+\lfloor
+\lg
+\lgroup
+\lhd
+\lim
+\liminf
+\limits
+\limsup
+\ll
+\llangle
+\llap
+\llcorner
+\Lleftarrow
+\lll
+\llless
+\lmoustache
+\ln
+\lnapprox
+\lneq
+\lneqq
+\lnot
+\lnsim
+\log
+\lor
+\Longleftarrow
+\longleftarrow
+\Longleftrightarrow
+\longleftrightarrow
+\longmapsto
+\longrightarrow
+\Longrightarrow
+\looparrowleft
+\looparrowright
+\lrcorner
+\lower
+\lozenge
+\Lsh
+\lt
+\ltimes
+\lVert
+\lvert
+\lvertneqq
+```
+
+## M
+
+``` latex
+\maltese
+\map
+\mapsto
+\mathbb
+\mathbf
+\mathbin
+\mathcal
+\mathclap
+\mathclose
+\mathfr
+\mathfrak
+\mathit
+\mathinner
+\mathllap
+\mathop
+\mathopen
+\mathord
+\mathpunct
+\mathraisebox
+\mathrel
+\mathring
+\mathrlap
+\mathrm
+\mathscr
+\mathsf
+\mathstrut
+\mathtt
+\max
+\mbox
+\measuredangle
+\medspace
+\mho
+\mid
+\min
+\minusb
+\mkern
+\mod
+\models
+\moveleft
+\moveright
+\mp
+\mskip
+\mspace
+\mtexnum
+\mu
+\Mu
+\multimap
+\multiscripts
+```
+
+## N
+
+``` latex
+\nabla
+\natural
+\ncong
+\ne
+\neArr
+\nearr
+\neArrow
+\nearrow
+\neg
+\negmedspace
+\negthickspace
+\negthinspace
+\neq
+\nequiv
+\nexists
+\ngeq
+\ngeqq
+\ngeqslant
+\ngtr
+\ni
+\nLeftarrow
+\nleftarrow
+\nLeftrightarrow
+\nleftrightarrow
+\nleq
+\nleqq
+\nleqslant
+\nless
+\nmid
+\nobreakspace
+\nolimits
+\nonumber
+\normalsize
+\not
+\notag
+\notin
+\notni
+\nparallel
+\nprec
+\npreceq
+\nRightarrow
+\nrightarrow
+\nshortmid
+\nshortparallel
+\nsim
+\nsubset
+\nsubseteq
+\nsubseteqq
+\nsucc
+\nsucceq
+\nsupset
+\nsupseteq
+\nsupseteqq
+\ntriangleleft
+\ntrianglelefteq
+\ntriangleright
+\ntrianglerighteq
+\Nu
+\nu
+\nvDash
+\nvdash
+\nVDash
+\nVdash
+\nwArr
+\nwarr
+\nwArrow
+\nwarrow
+```
+
+## O
+
+``` latex
+\odash
+\odot
+\oint
+\oldstyle
+\Omega
+\omega
+\omicron
+\ominus
+\operatorname
+\oplus
+\Oplus
+\oslash
+\otimes
+\Otimes
+\over
+\overbrace
+\overbracket
+\overleftarrow
+\overleftrightarrow
+\overline
+\overrightarrow
+\overset
+\overwithdelims
+\owns
+```
+
+## P
+
+``` latex
+\parallel
+\parr
+\partial
+\Perp
+\perp
+\phantom
+\Phi
+\phi
+\Pi
+\pi
+\pitchfork
+\plusb
+\pm
+\pmb
+\pmod
+\pod
+\Pr
+\prec
+\precapprox
+\preccurlyeq
+\preceq
+\precnapprox
+\precneqq
+\precnsim
+\precsim
+\prime
+\prod
+\product
+\projlim
+\propto
+\Psi
+\psi
+```
+
+## Q
+
+``` latex
+\qed
+\qquad
+\quad
+\quadrupleintegral
+```
+
+## R
+
+``` latex
+\raise
+\rang
+\rangle
+\rbrace
+\rbrack
+\rceil
+\Re
+\restriction
+\rfloor
+\rgroup
+\rhd
+\Rho
+\rho
+\Rightarrow
+\rightarrow
+\rightarrowtail
+\rightharpoondown
+\rightharpoonup
+\rightleftarrows
+\rightleftharpoons
+\rightrightarrows
+\rightsquigarrow
+\rightthreetimes
+\righttoleftarrow
+\risingdotseq
+\rlap
+\rm
+\rmoustache
+\root
+\Rrightarrow
+\rrangle
+\Rsh
+\rtimes
+\rVert
+\rvert
+```
+
+## S
+
+``` latex
+\S
+\scr
+\scriptscriptsize
+\scriptscriptstyle
+\scriptsize
+\scriptstyle
+\searr
+\seArr
+\searrow
+\seArrow
+\sec
+\setminus
+\sf
+\sharp
+\shortmid
+\shortparallel
+\sideset
+\Sigma
+\sigma
+\sim
+\simeq
+\sin
+\sinh
+\slash
+\skew
+\small
+\smallfrown
+\smallint
+\smallsetminus
+\smallsmile
+\smash
+\smile
+\Space
+\space
+\spadesuit
+\sphericalangle
+\sqcap
+\sqcup
+\sqrt
+\sqsubset
+\sqsubseteq
+\sqsupset
+\sqsupseteq
+\square
+\sslash
+\stackrel
+\star
+\strut
+\subset
+\Subset
+\subseteq
+\subseteqq
+\subsetneq
+\subsetneqq
+\substack
+\succ
+\succapprox
+\succcurlyeq
+\succeq
+\succnapprox
+\succneqq
+\succnsim
+\succsim
+\sum
+\sup
+\supset
+\Supset
+\supseteq
+\supseteqq
+\supsetneq
+\supsetneqq
+\surd
+\swarr
+\swArr
+\swarrow
+\swArrow
+```
+
+## T
+
+``` latex
+\tan
+\tanh
+\tau
+\Tau
+\tbinom
+\tensor
+\TeX
+\text
+\textbf
+\textit
+\textrm
+\textsf
+\textsize
+\textstyle
+\texttt
+\tfrac
+\therefore
+\Theta
+\theta
+\thickapprox
+\thicksim
+\thickspace
+\thinspace
+\tilde
+\times
+\timesb
+\Tiny
+\tiny
+\to
+\top
+\triangle
+\triangledown
+\triangleleft
+\trianglelefteq
+\triangleq
+\triangleright
+\trianglerighteq
+\tripleintegral
+\tt
+\twoheadleftarrow
+\twoheadrightarrow
+```
+
+## U
+
+``` latex
+\udots
+\ulcorner
+\underbrace
+\underbracket
+\underleftarrow
+\underleftrightarrow
+\underline
+\underoverset (such as `\underoverset{subscript}{superscript}{symbol}`)
+\underrightarrow
+\underset
+\Union
+\union
+\unlhd
+\unrhd
+\uparr
+\Uparrow
+\uparrow
+\updarr
+\Updownarrow
+\updownarrow
+\upharpoonleft
+\upharpoonright
+\uplus
+\uproot
+\Upsi
+\Upsilon
+\upsilon
+\upuparrows
+\urcorner
+```
+
+## V
+
+``` latex
+\varDelta
+\varepsilon
+\varGamma
+\varinjlim
+\varkappa
+\varLambda
+\varliminf
+\varlimsup
+\varnothing
+\varOmega
+\varphi
+\varPhi
+\varpi
+\varPi
+\varprojlim
+\varpropto
+\varPsi
+\varrho
+\varsigma
+\varSigma
+\varsubsetneq
+\varsubsetneqq
+\varsupsetneq
+\varsupsetneqq
+\vartheta
+\varTheta
+\vartriangle
+\vartriangleleft
+\vartriangleright
+\varUpsilon
+\varXi
+\Vbar
+\vcenter
+\vDash
+\vdash
+\VDash
+\Vdash
+\vdots
+\vec
+\vee
+\Vee
+\veebar
+\verb
+\Vert
+\vert
+\vphantom
+\Vvdash
+```
+
+## W
+
+``` latex
+\wedge
+\Wedge
+\widebar
+\widecheck
+\widehat
+\widetilde
+\widevec
+\wp
+\wr
+```
+
+## X
+
+``` latex
+\xcancel
+\xhookleftarrow
+\xhookrightarrow
+\Xi
+\xi
+\xleftarrow
+\xLeftarrow
+\xleftrightarrow
+\xLeftrightarrow
+\xleftrightharpoons
+\xlongequal
+\xmapsto
+\xrightarrow
+\xRightarrow
+\xrightleftharpoons
+\xtofrom
+\xtwoheadleftarrow
+\xtwoheadrightarrow
+```
+
+## Y
+
+``` latex
+\yen
+```
+
+## Z
+
+``` latex
+\zeta
+\Zeta
+```
+
+## Environments
+
+``` latex
+\begin{env}...\end{env}
+```
+
+where `env` is one of
+
+``` latex
+align
+align*
+alignat
+alignat*
+aligned
+alignedat
+array
+
+Bmatrix
+bmatrix
+
+cases
+
+eqnarray
+eqnarray*
+equation
+equation*
+
+gather
+gather*
+gathered
+
+matrix
+multline
+multline*
+
+pmatrix
+
+smallmatrix
+split
+subarray
+svg
+
+Vmatrix
+vmatrix
+```
+
+### The `array` Environment
+
+As in standard LaTeX, the `array` environment takes one optional
+argument, indicating the alignment of the whole array with the respect
+to the equation axis, and one mandatory argument, indicating the
+alignment of the columns. Thus
+
+``` latex
+\begin{array}[t]{clrc}
+  1 & 2 & 3 & 4 \\
+  5 & 6 & 7 & 8 \\
+  9 & 10& 11& 12
+\end{array}
+```
+
+produces an array with four columns. The first and last column are
+centered; the second and third are, respectively, left- and
+right-aligned. The top line of the array is aligned with the equation
+axis.
+
+As in AMSLaTeX
+
+``` latex
+\begin{matrix}
+   ...
+\end{matrix}
+```
+
+is precisely equivalent to
+
+```
+\begin{array}{cc...c}
+   ...
+\end{array}
+```
+
+except that you don't have to explicitly state the number of columns.
+
+### Column separators
+
+While defining columns, you can use `|` to indicate an unbroken vertical line, and `:` to indicate a dashed line. For example:
+
+``` latex
+\begin{array}[b]{c:c|c}
+Bad & Good & Ugly
+\end{array}
+```
+
+This creates a dashed column between `Bad & Good` and an unbroken line between `Good & Bad`.
+
+Placing either a `:` or `|` as the first or last character creates a frame around the array. For example:
+
+
+``` latex
+\begin{array}[b]{|c:c|c}
+Bad & Good & Ugly
+\end{array}
+```
+
+This creates an unbroken frame around the array. It's also equivalent to
+
+
+``` latex
+\begin{array}[b]{c:c|c|}
+Bad & Good & Ugly
+\end{array}
+```
+
+### The `svg` Environment
+
+Using the `svg` environment:
+
+``` latex
+\begin{svg}
+   ...
+\end{svg}
+```
+
+allows you to embed snippets of SVG in mtex equations. To assist in [Instiki](http://golem.ph.utexas.edu/instiki/show/HomePage)'s LaTeX export feature, you can also include a `graphicx` command:
+
+``` latex
+\begin{svg}
+   ...
+\end{svg}
+\includegraphics[width=...]{foo}
+```
+
+where `foo.pdf` is a file containing a PDF version of the graphic. In mtex, the `\includegraphics` command is defined as a NOOP, and the SVG is embedded in the MathML output. In Instiki's LaTeX export, the opposite is true: the `svg` environment is a NOOP, and the `\includegraphics` command is included in the output.
+
+## WebTeX-style Arrays and Array Options
+
+The [WebTeX notation for arrays](https://golem.ph.utexas.edu/~distler/WebTeX/docs/wtxsec7.html#ARRAY) is also supported.
+
+The `\array{}` command allows much finer control over the layout of arrays than is available in the standard (AMS)LaTeX-style environments above.
+
+<dl>
+ <dt><code>\array</code></dt>
+ <dd>
+   <dl>
+     <dt><code>\arrayopts</code></dt>
+     <dd>
+              <code>\collayout</code> (=<code>\colalign</code>)
+              <code>\rowalign</code>
+              <code>\align</code>
+              <code>\equalcols</code>
+              <code>\equalrows</code>
+              <code>\collines</code>
+              <code>\rowlines</code>
+              <code>\frame</code>
+              <code>\padding</code>
+      </dd>
+      <dt><code>\rowopts</code></dt>
+      <dd>
+             <code>\colalign</code>
+             <code>\rowalign</code>
+      </dd>
+      <dt><code>\cellopts</code></dt>
+      <dd>
+             <code>\colalign</code>
+             <code>\rowalign</code>
+             <code>\rowspan</code>
+              <code>\colspan</code>
+      </dd>
+   </dl>
+ </dd>
+</dl>
+
+## Numbers
+
+In MathML, numbers are represented as `<mn>127.3</mn>`. mtex2MML does its best to intelligently parse what's a number and what's not. Unfortunately, conventions for things like [decimal markers](http://en.wikipedia.org/wiki/Decimal_separator) are very culture-dependent, and incompatibly-so. If you don't like the way mtex2MML parses the would-be numbers in your input, you can force it to interpret a certain string as a number, using the `\mtexnum{}` command.
+
+## Colors
+
+`\color{colourspec}` changes the current foreground color. `colourspec` is either:
+
+* A CSS named color: https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#Color_Keywords
+* A LaTeX named color: http://en.wikibooks.org/wiki/LaTeX/Colors
+* An RGB color value:
+  * `#rgb` or `#rrggbb`, a three- or six-digit hexadecimal number.
+  `#000000` is black `#FFFFFF` is white, and `#1AC=#11AACC`.
+
+For example:
+
+``` latex
+a { b \color{red} c \color{#0F0} d } e
+```
+
+renders `a`, `b`, and `e` in the default color (usually black), `c` in red, and `d` in green.
+
+The alternate LaTeX syntax, involving specifying a color model is not supported:
+
+``` latex
+\color[cmyk]{0, 0.1, 0.5, 0.3}
+```
+
+A new command, `\bgcolor{colourspec}` works the same way, but changes the current background color.
+
+`\colorbox` changes the background color, and adds some padding, using the `mpadding` element.
+
+## Interactivity
+
+
+<dl>
+    <dt><code>\href{<i>url</i>}{<i>expression</i>}</code></dt>
+    <dd>Turns a mathematical <i>expression</i> into a clickable link. This makes use of <a href="http://www.w3.org/TR/xlink/">Xlink</a>.</dd>
+
+    <dt><code>\statusline{<i>message</i>}{<i>expression</i>}</code></dt>
+    <dd>Displays the <i>message</i> text in the browser's status-line, when the user hovers his mouse over the mathematical <i>expression</i>.</dd>
+
+    <dt><code>\tooltip{<i>message</i>}{<i>expression</i>}</code></dt>
+    <dd>Displays the <i>message</i> text as a tooltip, when the user hovers his mouse over the mathematical <i>expression</i>.</dd>
+
+    <dt><code>\fghilight{<i>colourspec</i>}{<i>expression</i>}</code> (<code>\fghighlight</code>)</dt>
+    <dd>Change the foreground color of an expression when the user hovers over it.</dd>
+
+    <dt><code>\bghilight{<i>colourspec</i>}{<i>expression</i>}</code> (<code>\bghighlight</code>)</dt>
+    <dd>Change the background color of an expression when the user hovers over it.</dd>
+
+    <dt><code>\toggle{<i>expression1</i>}{<i>expression2</i>}</code></dt>
+    <dd>Toggle between these two expressions when the user clicks on them.</dd>
+
+    <dt><code>\begintoggle{<i>expression1</i>}{<i>expression2</i>}...{<i>expressionN</i>}\endtoggle</code></dt>
+    <dd>Toggle between these <i>n</i> expressions when the user clicks on them.</dd>
+</dl>