]> git.lyx.org Git - lyx.git/blob - src/mathed/MathParser.cpp
61e000ccc2f02e81243d4c0befb11b9d96050a7a
[lyx.git] / src / mathed / MathParser.cpp
1 /**
2  * \file MathParser.cpp
3  * This file is part of LyX, the document processor.
4  * Licence details can be found in the file COPYING.
5  *
6  * \author André Pönitz
7  *
8  * Full author contact details are available in file CREDITS.
9  */
10
11 /*
12
13 If someone desperately needs partial "structures" (such as a few
14 cells of an array inset or similar) (s)he could uses the
15 following hack as starting point to write some macros:
16
17   \newif\ifcomment
18   \commentfalse
19   \ifcomment
20           \def\makeamptab{\catcode`\&=4\relax}
21           \def\makeampletter{\catcode`\&=11\relax}
22     \def\b{\makeampletter\expandafter\makeamptab\bi}
23     \long\def\bi#1\e{}
24   \else
25     \def\b{}\def\e{}
26   \fi
27   ...
28
29   \[\begin{array}{ccc}
30 1
31 &
32
33   \end{array}\]
34
35 */
36
37
38 #include <config.h>
39
40 #include "MathParser.h"
41
42 #include "InsetMathArray.h"
43 #include "InsetMathBig.h"
44 #include "InsetMathBrace.h"
45 #include "InsetMathCancelto.h"
46 #include "InsetMathChar.h"
47 #include "InsetMathColor.h"
48 #include "InsetMathComment.h"
49 #include "InsetMathDelim.h"
50 #include "InsetMathEnsureMath.h"
51 #include "InsetMathEnv.h"
52 #include "InsetMathFrac.h"
53 #include "InsetMathKern.h"
54 #include "MathMacro.h"
55 #include "InsetMathPar.h"
56 #include "InsetMathRef.h"
57 #include "InsetMathRoot.h"
58 #include "InsetMathScript.h"
59 #include "InsetMathSideset.h"
60 #include "InsetMathSpace.h"
61 #include "InsetMathSplit.h"
62 #include "InsetMathSqrt.h"
63 #include "InsetMathStackrel.h"
64 #include "InsetMathString.h"
65 #include "InsetMathTabular.h"
66 #include "MathMacroTemplate.h"
67 #include "MathFactory.h"
68 #include "MathMacroArgument.h"
69 #include "MathSupport.h"
70
71 #include "Buffer.h"
72 #include "BufferParams.h"
73 #include "Encoding.h"
74 #include "Lexer.h"
75
76 #include "support/debug.h"
77 #include "support/convert.h"
78 #include "support/docstream.h"
79
80 #include <sstream>
81
82 //#define FILEDEBUG
83
84 using namespace std;
85
86 namespace lyx {
87
88 namespace {
89
90 InsetMath::mode_type asMode(InsetMath::mode_type oldmode, docstring const & str)
91 {
92         //lyxerr << "handling mode: '" << str << "'" << endl;
93         if (str == "mathmode")
94                 return InsetMath::MATH_MODE;
95         if (str == "textmode" || str == "forcetext")
96                 return InsetMath::TEXT_MODE;
97         return oldmode;
98 }
99
100
101 bool stared(docstring const & s)
102 {
103         size_t const n = s.size();
104         return n && s[n - 1] == '*';
105 }
106
107
108 docstring const repl(docstring const & oldstr, char_type const c,
109                      docstring const & macro, bool textmode = false)
110 {
111         docstring newstr;
112         size_t i;
113         size_t j;
114
115         for (i = 0, j = 0; i < oldstr.size(); ++i) {
116                 if (c == oldstr[i]) {
117                         newstr.append(oldstr, j, i - j);
118                         newstr.append(macro);
119                         j = i + 1;
120                         if (macro.size() > 2 && j < oldstr.size())
121                                 newstr += (textmode && oldstr[j] == ' ' ? '\\' : ' ');
122                 }
123         }
124
125         // Any substitution?
126         if (j == 0)
127                 return oldstr;
128
129         newstr.append(oldstr, j, i - j);
130         return newstr;
131 }
132
133
134 docstring escapeSpecialChars(docstring const & str, bool textmode)
135 {
136         docstring const backslash = textmode ? from_ascii("\\textbackslash")
137                                              : from_ascii("\\backslash");
138         docstring const caret = textmode ? from_ascii("\\textasciicircum")
139                                          : from_ascii("\\mathcircumflex");
140         docstring const tilde = textmode ? from_ascii("\\textasciitilde")
141                                          : from_ascii("\\sim");
142
143         return repl(repl(repl(repl(repl(repl(repl(repl(repl(repl(str,
144                         '\\', backslash, textmode),
145                         '^', caret, textmode),
146                         '~', tilde, textmode),
147                         '_', from_ascii("\\_")),
148                         '$', from_ascii("\\$")),
149                         '#', from_ascii("\\#")),
150                         '&', from_ascii("\\&")),
151                         '%', from_ascii("\\%")),
152                         '{', from_ascii("\\{")),
153                         '}', from_ascii("\\}"));
154 }
155
156
157 /*!
158  * Add the row \p cellrow to \p grid.
159  * \returns wether the row could be added. Adding a row can fail for
160  * environments like "equation" that have a fixed number of rows.
161  */
162 bool addRow(InsetMathGrid & grid, InsetMathGrid::row_type & cellrow,
163             docstring const & vskip, bool allow_newpage_ = true)
164 {
165         ++cellrow;
166         if (cellrow == grid.nrows()) {
167                 //lyxerr << "adding row " << cellrow << endl;
168                 grid.addRow(cellrow - 1);
169                 if (cellrow == grid.nrows()) {
170                         // We can't add a row to this grid, so let's
171                         // append the content of this cell to the previous
172                         // one.
173                         // This does not happen in well formed .lyx files,
174                         // but LyX versions 1.3.x and older could create
175                         // such files and tex2lyx can still do that.
176                         --cellrow;
177                         lyxerr << "ignoring extra row";
178                         if (!vskip.empty())
179                                 lyxerr << " with extra space " << to_utf8(vskip);
180                         if (!allow_newpage_)
181                                 lyxerr << " with no page break allowed";
182                         lyxerr << '.' << endl;
183                         return false;
184                 }
185         }
186         grid.vcrskip(Length(to_utf8(vskip)), cellrow - 1);
187         grid.rowinfo(cellrow - 1).allow_newpage_ = allow_newpage_;
188         return true;
189 }
190
191
192 /*!
193  * Add the column \p cellcol to \p grid.
194  * \returns wether the column could be added. Adding a column can fail for
195  * environments like "eqnarray" that have a fixed number of columns.
196  */
197 bool addCol(InsetMathGrid & grid, InsetMathGrid::col_type & cellcol)
198 {
199         ++cellcol;
200         if (cellcol == grid.ncols()) {
201                 //lyxerr << "adding column " << cellcol << endl;
202                 grid.addCol(cellcol);
203                 if (cellcol == grid.ncols()) {
204                         // We can't add a column to this grid, so let's
205                         // append the content of this cell to the previous
206                         // one.
207                         // This does not happen in well formed .lyx files,
208                         // but LyX versions 1.3.x and older could create
209                         // such files and tex2lyx can still do that.
210                         --cellcol;
211                         lyxerr << "ignoring extra column." << endl;
212                         return false;
213                 }
214         }
215         return true;
216 }
217
218
219 /*!
220  * Check whether the last row is empty and remove it if yes.
221  * Otherwise the following code
222  * \verbatim
223 \begin{array}{|c|c|}
224 \hline
225 1 & 2 \\ \hline
226 3 & 4 \\ \hline
227 \end{array}
228  * \endverbatim
229  * will result in a grid with 3 rows (+ the dummy row that is always present),
230  * because the last '\\' opens a new row.
231  * Note that this is only needed for inner-hull grid types, such as array
232  * or aligned, but not for outer-hull grid types, such as eqnarray or align.
233  */
234 void delEmptyLastRow(InsetMathGrid & grid)
235 {
236         InsetMathGrid::row_type const row = grid.nrows() - 1;
237         for (InsetMathGrid::col_type col = 0; col < grid.ncols(); ++col) {
238                 if (!grid.cell(grid.index(row, col)).empty())
239                         return;
240         }
241         // Copy the row information of the empty row (which would contain the
242         // last hline in the example above) to the dummy row and delete the
243         // empty row.
244         grid.rowinfo(row + 1) = grid.rowinfo(row);
245         grid.delRow(row);
246 }
247
248
249 /*!
250  * Tell whether the environment name corresponds to an inner-hull grid type.
251  */
252 bool innerHull(docstring const & name)
253 {
254         // For [bB]matrix, [vV]matrix, and pmatrix we can check the suffix only
255         return name == "array" || name == "cases" || name == "aligned"
256                 || name == "alignedat" || name == "gathered" || name == "split"
257                 || name == "subarray" || name == "tabular" || name == "matrix"
258                 || name == "smallmatrix" || name.substr(1) == "matrix";
259 }
260
261
262 // These are TeX's catcodes
263 enum CatCode {
264         catEscape,     // 0    backslash
265         catBegin,      // 1    {
266         catEnd,        // 2    }
267         catMath,       // 3    $
268         catAlign,      // 4    &
269         catNewline,    // 5    ^^M
270         catParameter,  // 6    #
271         catSuper,      // 7    ^
272         catSub,        // 8    _
273         catIgnore,     // 9
274         catSpace,      // 10   space
275         catLetter,     // 11   a-zA-Z
276         catOther,      // 12   none of the above
277         catActive,     // 13   ~
278         catComment,    // 14   %
279         catInvalid     // 15   <delete>
280 };
281
282 CatCode theCatcode[128];
283
284
285 inline CatCode catcode(char_type c)
286 {
287         /* The only characters that are not catOther lie in the pure ASCII
288          * range. Therefore theCatcode has only 128 entries.
289          * TeX itself deals with 8bit characters, so if needed this table
290          * could be enlarged to 256 entries.
291          * Any larger value does not make sense, since the fact that we use
292          * unicode internally does not change Knuth's TeX engine.
293          * Apart from that a table for the full 21bit UCS4 range would waste
294          * too much memory. */
295         if (c >= 128)
296                 return catOther;
297
298         return theCatcode[c];
299 }
300
301
302 enum {
303         FLAG_ALIGN      = 1 << 0,  //  next & or \\ ends the parsing process
304         FLAG_BRACE_LAST = 1 << 1,  //  next closing brace ends the parsing
305         FLAG_RIGHT      = 1 << 2,  //  next \\right ends the parsing process
306         FLAG_END        = 1 << 3,  //  next \\end ends the parsing process
307         FLAG_BRACK_LAST = 1 << 4,  //  next closing bracket ends the parsing
308         FLAG_TEXTMODE   = 1 << 5,  //  we are in a box
309         FLAG_ITEM       = 1 << 6,  //  read a (possibly braced) token
310         FLAG_LEAVE      = 1 << 7,  //  leave the loop at the end
311         FLAG_SIMPLE     = 1 << 8,  //  next $ leaves the loop
312         FLAG_EQUATION   = 1 << 9,  //  next \] leaves the loop
313         FLAG_SIMPLE2    = 1 << 10, //  next \) leaves the loop
314         FLAG_OPTION     = 1 << 11, //  read [...] style option
315         FLAG_BRACED     = 1 << 12  //  read {...} style argument
316 };
317
318
319 //
320 // Helper class for parsing
321 //
322
323 class Token {
324 public:
325         ///
326         Token() : cs_(), char_(0), cat_(catIgnore) {}
327         ///
328         Token(char_type c, CatCode cat) : cs_(), char_(c), cat_(cat) {}
329         ///
330         explicit Token(docstring const & cs) : cs_(cs), char_(0), cat_(catIgnore) {}
331
332         ///
333         docstring const & cs() const { return cs_; }
334         ///
335         CatCode cat() const { return cat_; }
336         ///
337         char_type character() const { return char_; }
338         ///
339         docstring asString() const { return !cs_.empty() ? cs_ : docstring(1, char_); }
340         ///
341         docstring asInput() const { return !cs_.empty() ? '\\' + cs_ : docstring(1, char_); }
342
343 private:
344         ///
345         docstring cs_;
346         ///
347         char_type char_;
348         ///
349         CatCode cat_;
350 };
351
352
353 ostream & operator<<(ostream & os, Token const & t)
354 {
355         if (!t.cs().empty()) {
356                 docstring const & cs = t.cs();
357                 // FIXME: For some strange reason, the stream operator instanciate
358                 // a new Token before outputting the contents of t.cs().
359                 // Because of this the line
360                 //     os << '\\' << cs;
361                 // below becomes recursive.
362                 // In order to avoid that we return early:
363                 if (cs == "\\")
364                         return os;
365                 os << '\\' << to_utf8(cs);
366         }
367         else if (t.cat() == catLetter)
368                 os << t.character();
369         else
370                 os << '[' << t.character() << ',' << t.cat() << ']';
371         return os;
372 }
373
374
375 class Parser {
376 public:
377         ///
378         typedef  InsetMath::mode_type mode_type;
379         ///
380         typedef  Parse::flags parse_mode;
381
382         ///
383         Parser(Lexer & lex, parse_mode mode, Buffer * buf);
384         /// Only use this for reading from .lyx file format, for the reason
385         /// see Parser::tokenize(istream &).
386         Parser(istream & is, parse_mode mode, Buffer * buf);
387         ///
388         Parser(docstring const & str, parse_mode mode, Buffer * buf);
389
390         ///
391         bool parse(MathAtom & at);
392         ///
393         bool parse(MathData & array, unsigned flags, mode_type mode);
394         ///
395         bool parse1(InsetMathGrid & grid, unsigned flags, mode_type mode,
396                 bool numbered);
397         ///
398         MathData parse(unsigned flags, mode_type mode);
399         ///
400         int lineno() const { return lineno_; }
401         ///
402         void putback();
403
404 private:
405         ///
406         void parse2(MathAtom & at, unsigned flags, mode_type mode, bool numbered);
407         /// get arg delimited by 'left' and 'right'
408         docstring getArg(char_type left, char_type right);
409         ///
410         char_type getChar();
411         ///
412         void error(string const & msg);
413         void error(docstring const & msg) { error(to_utf8(msg)); }
414         /// dump contents to screen
415         void dump() const;
416         /// Only use this for reading from .lyx file format (see
417         /// implementation for reason)
418         void tokenize(istream & is);
419         ///
420         void tokenize(docstring const & s);
421         ///
422         void skipSpaceTokens(idocstream & is, char_type c);
423         ///
424         void push_back(Token const & t);
425         ///
426         void pop_back();
427         ///
428         Token const & prevToken() const;
429         ///
430         Token const & nextToken() const;
431         ///
432         Token const & getToken();
433         /// skips spaces if any
434         void skipSpaces();
435         ///
436         void lex(docstring const & s);
437         ///
438         bool good() const;
439         ///
440         docstring parse_verbatim_item();
441         ///
442         docstring parse_verbatim_option();
443
444         ///
445         int lineno_;
446         ///
447         vector<Token> tokens_;
448         ///
449         unsigned pos_;
450         /// Stack of active environments
451         vector<docstring> environments_;
452         ///
453         parse_mode mode_;
454         ///
455         bool success_;
456         ///
457         Buffer * buffer_;
458 };
459
460
461 Parser::Parser(Lexer & lexer, parse_mode mode, Buffer * buf)
462         : lineno_(lexer.lineNumber()), pos_(0), mode_(mode), success_(true),
463           buffer_(buf)
464 {
465         tokenize(lexer.getStream());
466         lexer.eatLine();
467 }
468
469
470 Parser::Parser(istream & is, parse_mode mode, Buffer * buf)
471         : lineno_(0), pos_(0), mode_(mode), success_(true), buffer_(buf)
472 {
473         tokenize(is);
474 }
475
476
477 Parser::Parser(docstring const & str, parse_mode mode, Buffer * buf)
478         : lineno_(0), pos_(0), mode_(mode), success_(true), buffer_(buf)
479 {
480         tokenize(str);
481 }
482
483
484 void Parser::push_back(Token const & t)
485 {
486         tokens_.push_back(t);
487 }
488
489
490 void Parser::pop_back()
491 {
492         tokens_.pop_back();
493 }
494
495
496 Token const & Parser::prevToken() const
497 {
498         static const Token dummy;
499         return pos_ > 0 ? tokens_[pos_ - 1] : dummy;
500 }
501
502
503 Token const & Parser::nextToken() const
504 {
505         static const Token dummy;
506         return good() ? tokens_[pos_] : dummy;
507 }
508
509
510 Token const & Parser::getToken()
511 {
512         static const Token dummy;
513         //lyxerr << "looking at token " << tokens_[pos_] << " pos: " << pos_ << endl;
514         return good() ? tokens_[pos_++] : dummy;
515 }
516
517
518 void Parser::skipSpaces()
519 {
520         while (nextToken().cat() == catSpace || nextToken().cat() == catNewline)
521                 getToken();
522 }
523
524
525 void Parser::putback()
526 {
527         --pos_;
528 }
529
530
531 bool Parser::good() const
532 {
533         return pos_ < tokens_.size();
534 }
535
536
537 char_type Parser::getChar()
538 {
539         if (!good()) {
540                 error("The input stream is not well...");
541                 return 0;
542         }
543         return tokens_[pos_++].character();
544 }
545
546
547 docstring Parser::getArg(char_type left, char_type right)
548 {
549         docstring result;
550         skipSpaces();
551
552         if (!good())
553                 return result;
554
555         char_type c = getChar();
556
557         if (c != left)
558                 putback();
559         else
560                 while ((c = getChar()) != right && good())
561                         result += c;
562
563         return result;
564 }
565
566
567 void Parser::skipSpaceTokens(idocstream & is, char_type c)
568 {
569         // skip trailing spaces
570         while (catcode(c) == catSpace || catcode(c) == catNewline)
571                 if (!is.get(c))
572                         break;
573         //lyxerr << "putting back: " << c << endl;
574         is.putback(c);
575 }
576
577
578 void Parser::tokenize(istream & is)
579 {
580         // eat everything up to the next \end_inset or end of stream
581         // and store it in s for further tokenization
582         string s;
583         char c;
584         while (is.get(c)) {
585                 s += c;
586                 if (s.size() >= 10 && s.substr(s.size() - 10) == "\\end_inset") {
587                         s = s.substr(0, s.size() - 10);
588                         break;
589                 }
590         }
591         // Remove the space after \end_inset
592         if (is.get(c) && c != ' ')
593                 is.unget();
594
595         // tokenize buffer
596         tokenize(from_utf8(s));
597 }
598
599
600 void Parser::tokenize(docstring const & buffer)
601 {
602         idocstringstream is(mode_ & Parse::VERBATIM
603                         ? escapeSpecialChars(buffer, mode_ & Parse::TEXTMODE)
604                         : buffer, ios::in | ios::binary);
605
606         char_type c;
607         while (is.get(c)) {
608                 //lyxerr << "reading c: " << c << endl;
609
610                 switch (catcode(c)) {
611                         case catNewline: {
612                                 ++lineno_;
613                                 is.get(c);
614                                 if (catcode(c) == catNewline)
615                                         ; //push_back(Token("par"));
616                                 else {
617                                         push_back(Token('\n', catNewline));
618                                         is.putback(c);
619                                 }
620                                 break;
621                         }
622
623 /*
624                         case catComment: {
625                                 while (is.get(c) && catcode(c) != catNewline)
626                                         ;
627                                 ++lineno_;
628                                 break;
629                         }
630 */
631
632                         case catEscape: {
633                                 is.get(c);
634                                 if (!is) {
635                                         error("unexpected end of input");
636                                 } else {
637                                         if (c == '\n')
638                                                 c = ' ';
639                                         docstring s(1, c);
640                                         if (catcode(c) == catLetter) {
641                                                 // collect letters
642                                                 while (is.get(c) && catcode(c) == catLetter)
643                                                         s += c;
644                                                 skipSpaceTokens(is, c);
645                                         }
646                                         push_back(Token(s));
647                                 }
648                                 break;
649                         }
650
651                         case catSuper:
652                         case catSub: {
653                                 push_back(Token(c, catcode(c)));
654                                 is.get(c);
655                                 skipSpaceTokens(is, c);
656                                 break;
657                         }
658
659                         case catIgnore: {
660                                 if (!(mode_ & Parse::QUIET))
661                                         lyxerr << "ignoring a char: " << int(c) << endl;
662                                 break;
663                         }
664
665                         default:
666                                 push_back(Token(c, catcode(c)));
667                 }
668         }
669
670 #ifdef FILEDEBUG
671         dump();
672 #endif
673 }
674
675
676 void Parser::dump() const
677 {
678         lyxerr << "\nTokens: ";
679         for (unsigned i = 0; i < tokens_.size(); ++i) {
680                 if (i == pos_)
681                         lyxerr << " <#> ";
682                 lyxerr << tokens_[i];
683         }
684         lyxerr << " pos: " << pos_ << endl;
685 }
686
687
688 void Parser::error(string const & msg)
689 {
690         success_ = false;
691         if (!(mode_ & Parse::QUIET)) {
692                 lyxerr << "Line ~" << lineno_ << ": Math parse error: "
693                        << msg << endl;
694                 dump();
695         }
696 }
697
698
699 bool Parser::parse(MathAtom & at)
700 {
701         skipSpaces();
702         MathData ar(buffer_);
703         parse(ar, false, InsetMath::UNDECIDED_MODE);
704         if (ar.size() != 1 || ar.front()->getType() == hullNone) {
705                 if (!(mode_ & Parse::QUIET))
706                         lyxerr << "unusual contents found: " << ar << endl;
707                 at = MathAtom(new InsetMathPar(buffer_, ar));
708                 //if (at->nargs() > 0)
709                 //      at.nucleus()->cell(0) = ar;
710                 //else
711                 //      lyxerr << "unusual contents found: " << ar << endl;
712                 success_ = false;
713         } else
714                 at = ar[0];
715         return success_;
716 }
717
718
719 docstring Parser::parse_verbatim_option()
720 {
721         skipSpaces();
722         docstring res;
723         if (nextToken().character() == '[') {
724                 Token t = getToken();
725                 for (Token t = getToken(); t.character() != ']' && good(); t = getToken()) {
726                         if (t.cat() == catBegin) {
727                                 putback();
728                                 res += '{' + parse_verbatim_item() + '}';
729                         } else
730                                 res += t.asInput();
731                 }
732         }
733         return res;
734 }
735
736
737 docstring Parser::parse_verbatim_item()
738 {
739         skipSpaces();
740         docstring res;
741         if (nextToken().cat() == catBegin) {
742                 Token t = getToken();
743                 for (Token t = getToken(); t.cat() != catEnd && good(); t = getToken()) {
744                         if (t.cat() == catBegin) {
745                                 putback();
746                                 res += '{' + parse_verbatim_item() + '}';
747                         }
748                         else
749                                 res += t.asInput();
750                 }
751         }
752         return res;
753 }
754
755
756 MathData Parser::parse(unsigned flags, mode_type mode)
757 {
758         MathData ar(buffer_);
759         parse(ar, flags, mode);
760         return ar;
761 }
762
763
764 bool Parser::parse(MathData & array, unsigned flags, mode_type mode)
765 {
766         InsetMathGrid grid(buffer_, 1, 1);
767         parse1(grid, flags, mode, false);
768         array = grid.cell(0);
769         return success_;
770 }
771
772
773 void Parser::parse2(MathAtom & at, const unsigned flags, const mode_type mode,
774         const bool numbered)
775 {
776         parse1(*(at.nucleus()->asGridInset()), flags, mode, numbered);
777 }
778
779
780 bool Parser::parse1(InsetMathGrid & grid, unsigned flags,
781         const mode_type mode, const bool numbered)
782 {
783         int limits = 0;
784         InsetMathGrid::row_type cellrow = 0;
785         InsetMathGrid::col_type cellcol = 0;
786         MathData * cell = &grid.cell(grid.index(cellrow, cellcol));
787         Buffer * buf = buffer_;
788
789         if (grid.asHullInset())
790                 grid.asHullInset()->numbered(cellrow, numbered);
791
792         //dump();
793         //lyxerr << " flags: " << flags << endl;
794         //lyxerr << " mode: " << mode  << endl;
795         //lyxerr << "grid: " << grid << endl;
796
797         while (good()) {
798                 Token const & t = getToken();
799
800 #ifdef FILEDEBUG
801                 lyxerr << "t: " << t << " flags: " << flags << endl;
802                 lyxerr << "mode: " << mode  << endl;
803                 cell->dump();
804                 lyxerr << endl;
805 #endif
806
807                 if (flags & FLAG_ITEM) {
808
809                         if (t.cat() == catBegin) {
810                                 // skip the brace and collect everything to the next matching
811                                 // closing brace
812                                 parse1(grid, FLAG_BRACE_LAST, mode, numbered);
813                                 return success_;
814                         }
815
816                         // handle only this single token, leave the loop if done
817                         flags = FLAG_LEAVE;
818                 }
819
820
821                 if (flags & FLAG_BRACED) {
822                         if (t.cat() == catSpace)
823                                 continue;
824
825                         if (t.cat() != catBegin) {
826                                 error("opening brace expected");
827                                 return success_;
828                         }
829
830                         // skip the brace and collect everything to the next matching
831                         // closing brace
832                         flags = FLAG_BRACE_LAST;
833                 }
834
835
836                 if (flags & FLAG_OPTION) {
837                         if (t.cat() == catOther && t.character() == '[') {
838                                 MathData ar;
839                                 parse(ar, FLAG_BRACK_LAST, mode);
840                                 cell->append(ar);
841                         } else {
842                                 // no option found, put back token and we are done
843                                 putback();
844                         }
845                         return success_;
846                 }
847
848                 //
849                 // cat codes
850                 //
851                 if (t.cat() == catMath) {
852                         if (mode != InsetMath::MATH_MODE) {
853                                 // we are inside some text mode thingy, so opening new math is allowed
854                                 Token const & n = getToken();
855                                 if (n.cat() == catMath) {
856                                         // TeX's $$...$$ syntax for displayed math
857                                         if (mode == InsetMath::UNDECIDED_MODE) {
858                                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullEquation)));
859                                                 parse2(cell->back(), FLAG_SIMPLE, InsetMath::MATH_MODE, false);
860                                                 getToken(); // skip the second '$' token
861                                         } else {
862                                                 // This is not an outer hull and display math is
863                                                 // not allowed inside text mode environments.
864                                                 error("bad math environment");
865                                                 break;
866                                         }
867                                 } else {
868                                         // simple $...$  stuff
869                                         putback();
870                                         if (mode == InsetMath::UNDECIDED_MODE) {
871                                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullSimple)));
872                                                 parse2(cell->back(), FLAG_SIMPLE, InsetMath::MATH_MODE, false);
873                                         } else {
874                                                 // Don't create nested math hulls (bug #5392)
875                                                 cell->push_back(MathAtom(new InsetMathEnsureMath(buf)));
876                                                 parse(cell->back().nucleus()->cell(0), FLAG_SIMPLE, InsetMath::MATH_MODE);
877                                         }
878                                 }
879                         }
880
881                         else if (flags & FLAG_SIMPLE) {
882                                 // this is the end of the formula
883                                 return success_;
884                         }
885
886                         else {
887                                 Token const & n = getToken();
888                                 if (n.cat() == catMath) {
889                                         error("something strange in the parser");
890                                         break;
891                                 } else {
892                                         // This is inline math ($...$), but the parser thinks we are
893                                         // already in math mode and latex would issue an error, unless we
894                                         // are inside a text mode user macro. We have no way to tell, so
895                                         // let's play safe by using \ensuremath, as it will work in any case.
896                                         putback();
897                                         cell->push_back(MathAtom(new InsetMathEnsureMath(buf)));
898                                         parse(cell->back().nucleus()->cell(0), FLAG_SIMPLE, InsetMath::MATH_MODE);
899                                 }
900                         }
901                 }
902
903                 else if (t.cat() == catLetter)
904                         cell->push_back(MathAtom(new InsetMathChar(t.character())));
905
906                 else if (t.cat() == catSpace && mode != InsetMath::MATH_MODE) {
907                         if (cell->empty() || cell->back()->getChar() != ' ')
908                                 cell->push_back(MathAtom(new InsetMathChar(t.character())));
909                 }
910
911                 else if (t.cat() == catNewline && mode != InsetMath::MATH_MODE) {
912                         if (cell->empty() || cell->back()->getChar() != ' ')
913                                 cell->push_back(MathAtom(new InsetMathChar(' ')));
914                 }
915
916                 else if (t.cat() == catParameter) {
917                         Token const & n = getToken();
918                         cell->push_back(MathAtom(new MathMacroArgument(n.character()-'0')));
919                 }
920
921                 else if (t.cat() == catActive)
922                         cell->push_back(MathAtom(new InsetMathSpace(string(1, t.character()), "")));
923
924                 else if (t.cat() == catBegin) {
925                         MathData ar;
926                         parse(ar, FLAG_BRACE_LAST, mode);
927                         // do not create a BraceInset if they were written by LyX
928                         // this helps to keep the annoyance of  "a choose b"  to a minimum
929                         if (ar.size() == 1 && ar[0]->extraBraces())
930                                 cell->append(ar);
931                         else
932                                 cell->push_back(MathAtom(new InsetMathBrace(ar)));
933                 }
934
935                 else if (t.cat() == catEnd) {
936                         if (flags & FLAG_BRACE_LAST)
937                                 return success_;
938                         error("found '}' unexpectedly");
939                         //LASSERT(false, /**/);
940                         //add(cell, '}', LM_TC_TEX);
941                 }
942
943                 else if (t.cat() == catAlign) {
944                         //lyxerr << " column now " << (cellcol + 1)
945                         //       << " max: " << grid.ncols() << endl;
946                         if (flags & FLAG_ALIGN)
947                                 return success_;
948                         if (addCol(grid, cellcol))
949                                 cell = &grid.cell(grid.index(cellrow, cellcol));
950                 }
951
952                 else if (t.cat() == catSuper || t.cat() == catSub) {
953                         bool up = (t.cat() == catSuper);
954                         // we need no new script inset if the last thing was a scriptinset,
955                         // which has that script already not the same script already
956                         if (cell->empty())
957                                 cell->push_back(MathAtom(new InsetMathScript(buf, up)));
958                         else if (cell->back()->asScriptInset() &&
959                                         !cell->back()->asScriptInset()->has(up))
960                                 cell->back().nucleus()->asScriptInset()->ensure(up);
961                         else if (cell->back()->asScriptInset())
962                                 cell->push_back(MathAtom(new InsetMathScript(buf, up)));
963                         else
964                                 cell->back() = MathAtom(new InsetMathScript(buf, cell->back(), up));
965                         InsetMathScript * p = cell->back().nucleus()->asScriptInset();
966                         // special handling of {}-bases
967                         // Here we could remove the brace inset for things
968                         // like {a'}^2 and add the braces back in
969                         // InsetMathScript::write().
970                         // We do not do it, since it is not possible to detect
971                         // reliably whether the braces are needed because the
972                         // nucleus contains more than one symbol, or whether
973                         // they are needed for unknown commands like \xx{a}_0
974                         // or \yy{a}{b}_0. This was done in revision 14819
975                         // in an unreliable way. See this thread
976                         // http://www.mail-archive.com/lyx-devel%40lists.lyx.org/msg104917.html
977                         // for more details.
978                         // However, we remove empty braces because they look
979                         // ugly on screen and we are sure that they were added
980                         // by the write() method (and will be re-added on save).
981                         if (p->nuc().size() == 1 &&
982                             p->nuc().back()->asBraceInset() &&
983                             p->nuc().back()->asBraceInset()->cell(0).empty())
984                                 p->nuc().erase(0);
985
986                         parse(p->cell(p->idxOfScript(up)), FLAG_ITEM, mode);
987                         if (limits) {
988                                 p->limits(limits);
989                                 limits = 0;
990                         }
991                 }
992
993                 else if (t.character() == ']' && (flags & FLAG_BRACK_LAST)) {
994                         //lyxerr << "finished reading option" << endl;
995                         return success_;
996                 }
997
998                 else if (t.cat() == catOther) {
999                         char_type c = t.character();
1000                         if (isAsciiOrMathAlpha(c)
1001                             || mode_ & Parse::VERBATIM
1002                             || !(mode_ & Parse::USETEXT)
1003                             || mode == InsetMath::TEXT_MODE) {
1004                                 cell->push_back(MathAtom(new InsetMathChar(c)));
1005                         } else {
1006                                 MathAtom at = createInsetMath("text", buf);
1007                                 at.nucleus()->cell(0).push_back(MathAtom(new InsetMathChar(c)));
1008                                 while (nextToken().cat() == catOther
1009                                        && !isAsciiOrMathAlpha(nextToken().character())) {
1010                                         c = getToken().character();
1011                                         at.nucleus()->cell(0).push_back(MathAtom(new InsetMathChar(c)));
1012                                 }
1013                                 cell->push_back(at);
1014                         }
1015                 }
1016
1017                 else if (t.cat() == catComment) {
1018                         docstring s;
1019                         while (good()) {
1020                                 Token const & t = getToken();
1021                                 if (t.cat() == catNewline)
1022                                         break;
1023                                 s += t.asInput();
1024                         }
1025                         cell->push_back(MathAtom(new InsetMathComment(buf, s)));
1026                         skipSpaces();
1027                 }
1028
1029                 //
1030                 // control sequences
1031                 //
1032
1033                 else if (t.cs() == "lyxlock") {
1034                         if (!cell->empty())
1035                                 cell->back().nucleus()->lock(true);
1036                 }
1037
1038                 else if ((t.cs() == "global" && nextToken().cs() == "def") ||
1039                          t.cs() == "def") {
1040                         if (t.cs() == "global")
1041                                 getToken();
1042                         
1043                         // get name
1044                         docstring name = getToken().cs();
1045                         
1046                         // read parameters
1047                         int nargs = 0;
1048                         docstring pars;
1049                         while (good() && nextToken().cat() != catBegin) {
1050                                 pars += getToken().cs();
1051                                 ++nargs;
1052                         }
1053                         nargs /= 2;
1054                         
1055                         // read definition
1056                         MathData def;
1057                         parse(def, FLAG_ITEM, InsetMath::UNDECIDED_MODE);
1058                         
1059                         // is a version for display attached?
1060                         skipSpaces();
1061                         MathData display;
1062                         if (nextToken().cat() == catBegin)
1063                                 parse(display, FLAG_ITEM, InsetMath::MATH_MODE);
1064                         
1065                         cell->push_back(MathAtom(new MathMacroTemplate(buf,
1066                                 name, nargs, 0, MacroTypeDef,
1067                                 vector<MathData>(), def, display)));
1068
1069                         if (buf && (mode_ & Parse::TRACKMACRO))
1070                                 buf->usermacros.insert(name);
1071                 }
1072                 
1073                 else if (t.cs() == "newcommand" ||
1074                          t.cs() == "renewcommand" ||
1075                          t.cs() == "newlyxcommand") {
1076                         // get name
1077                         if (getToken().cat() != catBegin) {
1078                                 error("'{' in \\newcommand expected (1) ");
1079                                 return success_;
1080                         }
1081                         docstring name = getToken().cs();
1082                         if (getToken().cat() != catEnd) {
1083                                 error("'}' in \\newcommand expected");
1084                                 return success_;
1085                         }
1086                                 
1087                         // get arity
1088                         docstring const arg = getArg('[', ']');
1089                         int nargs = 0;
1090                         if (!arg.empty())
1091                                 nargs = convert<int>(arg);
1092                                 
1093                         // optional argument given?
1094                         skipSpaces();
1095                         int optionals = 0;
1096                         vector<MathData> optionalValues;
1097                         while (nextToken().character() == '[') {
1098                                 getToken();
1099                                 optionalValues.push_back(MathData());
1100                                 parse(optionalValues[optionals], FLAG_BRACK_LAST, mode);
1101                                 ++optionals;
1102                         }
1103                         
1104                         MathData def;
1105                         parse(def, FLAG_ITEM, InsetMath::UNDECIDED_MODE);
1106                         
1107                         // is a version for display attached?
1108                         skipSpaces();
1109                         MathData display;
1110                         if (nextToken().cat() == catBegin)
1111                                 parse(display, FLAG_ITEM, InsetMath::MATH_MODE);
1112                         
1113                         cell->push_back(MathAtom(new MathMacroTemplate(buf,
1114                                 name, nargs, optionals, MacroTypeNewcommand,
1115                                 optionalValues, def, display)));
1116
1117                         if (buf && (mode_ & Parse::TRACKMACRO))
1118                                 buf->usermacros.insert(name);
1119                 }
1120                 
1121                 else if (t.cs() == "newcommandx" ||
1122                          t.cs() == "renewcommandx") {
1123                         // \newcommandx{\foo}[2][usedefault, addprefix=\global,1=default]{#1,#2}
1124                         // get name
1125                         docstring name;
1126                         if (nextToken().cat() == catBegin) {
1127                                 getToken();
1128                                 name = getToken().cs();
1129                                 if (getToken().cat() != catEnd) {
1130                                         error("'}' in \\newcommandx expected");
1131                                         return success_;
1132                                 }
1133                         } else
1134                                 name = getToken().cs();
1135                                 
1136                         // get arity
1137                         docstring const arg = getArg('[', ']');
1138                         if (arg.empty()) {
1139                                 error("[num] in \\newcommandx expected");
1140                                 return success_;
1141                         }
1142                         int nargs = convert<int>(arg);
1143                         
1144                         // get options
1145                         int optionals = 0;
1146                         vector<MathData> optionalValues;
1147                         if (nextToken().character() == '[') {
1148                                 // skip '['
1149                                 getToken();
1150                                         
1151                                 // handle 'opt=value' options, separated by ','.
1152                                 skipSpaces();
1153                                 while (nextToken().character() != ']' && good()) {
1154                                         if (nextToken().character() >= '1'
1155                                             && nextToken().character() <= '9') {
1156                                                 // optional value -> get parameter number
1157                                                 int n = getChar() - '0';
1158                                                 if (n > nargs) {
1159                                                         error("Arity of \\newcommandx too low "
1160                                                               "for given optional parameter.");
1161                                                         return success_;
1162                                                 }
1163                                                 
1164                                                 // skip '='
1165                                                 if (getToken().character() != '=') {
1166                                                         error("'=' and optional parameter value "
1167                                                               "expected for \\newcommandx");
1168                                                         return success_;
1169                                                 }
1170                                                 
1171                                                 // get value
1172                                                 int optNum = max(size_t(n), optionalValues.size());
1173                                                 optionalValues.resize(optNum);
1174                                                 optionalValues[n - 1].clear();
1175                                                 while (nextToken().character() != ']'
1176                                                        && nextToken().character() != ',') {
1177                                                         MathData data;
1178                                                         parse(data, FLAG_ITEM, InsetMath::UNDECIDED_MODE);
1179                                                         optionalValues[n - 1].append(data);
1180                                                 }
1181                                                 optionals = max(n, optionals);
1182                                         } else if (nextToken().cat() == catLetter) {
1183                                                 // we in fact ignore every non-optional
1184                                                 // parameter
1185                                                 
1186                                                 // get option name
1187                                                 docstring opt;
1188                                                 while (nextToken().cat() == catLetter)
1189                                                         opt += getChar();
1190                                         
1191                                                 // value?
1192                                                 skipSpaces();
1193                                                 MathData value;
1194                                                 if (nextToken().character() == '=') {
1195                                                         getToken();
1196                                                         while (nextToken().character() != ']'
1197                                                                 && nextToken().character() != ',')
1198                                                                 parse(value, FLAG_ITEM, 
1199                                                                       InsetMath::UNDECIDED_MODE);
1200                                                 }
1201                                         } else {
1202                                                 error("option for \\newcommandx expected");
1203                                                 return success_;
1204                                         }
1205                                         
1206                                         // skip komma
1207                                         skipSpaces();
1208                                         if (nextToken().character() == ',') {
1209                                                 getChar();
1210                                                 skipSpaces();
1211                                         } else if (nextToken().character() != ']') {
1212                                                 error("Expecting ',' or ']' in options "
1213                                                       "of \\newcommandx");
1214                                                 return success_;
1215                                         }
1216                                 }
1217                                 
1218                                 // skip ']'
1219                                 if (!good())
1220                                         return success_;
1221                                 getToken();
1222                         }
1223
1224                         // get definition
1225                         MathData def;
1226                         parse(def, FLAG_ITEM, InsetMath::UNDECIDED_MODE);
1227
1228                         // is a version for display attached?
1229                         skipSpaces();
1230                         MathData display;
1231                         if (nextToken().cat() == catBegin)
1232                                 parse(display, FLAG_ITEM, InsetMath::MATH_MODE);
1233
1234                         cell->push_back(MathAtom(new MathMacroTemplate(buf,
1235                                 name, nargs, optionals, MacroTypeNewcommandx,
1236                                 optionalValues, def, display)));
1237
1238                         if (buf && (mode_ & Parse::TRACKMACRO))
1239                                 buf->usermacros.insert(name);
1240                 }
1241
1242                 else if (t.cs() == "(") {
1243                         cell->push_back(MathAtom(new InsetMathEnsureMath(buf)));
1244                         parse(cell->back().nucleus()->cell(0), FLAG_SIMPLE2, InsetMath::MATH_MODE);
1245                 }
1246
1247                 else if (t.cs() == "[") {
1248                         if (mode != InsetMath::UNDECIDED_MODE) {
1249                                 error("bad math environment");
1250                                 break;
1251                         }
1252                         cell->push_back(MathAtom(new InsetMathHull(buf, hullEquation)));
1253                         parse2(cell->back(), FLAG_EQUATION, InsetMath::MATH_MODE, false);
1254                 }
1255
1256                 else if (t.cs() == "protect")
1257                         // ignore \\protect, will hopefully be re-added during output
1258                         ;
1259
1260                 else if (t.cs() == "end") {
1261                         if (flags & FLAG_END) {
1262                                 // eat environment name
1263                                 docstring const name = getArg('{', '}');
1264                                 if (environments_.empty())
1265                                         error("'found \\end{" + name +
1266                                               "}' without matching '\\begin{" +
1267                                               name + "}'");
1268                                 else if (name != environments_.back())
1269                                         error("'\\end{" + name +
1270                                               "}' does not match '\\begin{" +
1271                                               environments_.back() + "}'");
1272                                 else {
1273                                         environments_.pop_back();
1274                                         // Delete empty last row in matrix
1275                                         // like insets.
1276                                         // If you abuse InsetMathGrid for
1277                                         // non-matrix like structures you
1278                                         // probably need to refine this test.
1279                                         // Right now we only have to test for
1280                                         // single line hull insets.
1281                                         if (grid.nrows() > 1 && innerHull(name))
1282                                                 delEmptyLastRow(grid);
1283                                         return success_;
1284                                 }
1285                         } else
1286                                 error("found 'end' unexpectedly");
1287                 }
1288
1289                 else if (t.cs() == ")") {
1290                         if (flags & FLAG_SIMPLE2)
1291                                 return success_;
1292                         error("found '\\)' unexpectedly");
1293                 }
1294
1295                 else if (t.cs() == "]") {
1296                         if (flags & FLAG_EQUATION)
1297                                 return success_;
1298                         error("found '\\]' unexpectedly");
1299                 }
1300
1301                 else if (t.cs() == "\\") {
1302                         if (flags & FLAG_ALIGN)
1303                                 return success_;
1304                         bool added = false;
1305                         if (nextToken().asInput() == "*") {
1306                                 getToken();
1307                                 added = addRow(grid, cellrow, docstring(), false);
1308                         } else if (good())
1309                                 added = addRow(grid, cellrow, getArg('[', ']'));
1310                         else
1311                                 error("missing token after \\\\");
1312                         if (added) {
1313                                 cellcol = 0;
1314                                 if (grid.asHullInset())
1315                                         grid.asHullInset()->numbered(
1316                                                         cellrow, numbered);
1317                                 cell = &grid.cell(grid.index(cellrow,
1318                                                              cellcol));
1319                         }
1320                 }
1321
1322 #if 0
1323                 else if (t.cs() == "multicolumn") {
1324                         // extract column count and insert dummy cells
1325                         MathData count;
1326                         parse(count, FLAG_ITEM, mode);
1327                         int cols = 1;
1328                         if (!extractNumber(count, cols)) {
1329                                 success_ = false;
1330                                 lyxerr << " can't extract number of cells from " << count << endl;
1331                         }
1332                         // resize the table if necessary
1333                         for (int i = 0; i < cols; ++i) {
1334                                 if (addCol(grid, cellcol)) {
1335                                         cell = &grid.cell(grid.index(
1336                                                         cellrow, cellcol));
1337                                         // mark this as dummy
1338                                         grid.cellinfo(grid.index(
1339                                                 cellrow, cellcol)).dummy_ = true;
1340                                 }
1341                         }
1342                         // the last cell is the real thing, not a dummy
1343                         grid.cellinfo(grid.index(cellrow, cellcol)).dummy_ = false;
1344
1345                         // read special alignment
1346                         MathData align;
1347                         parse(align, FLAG_ITEM, mode);
1348                         //grid.cellinfo(grid.index(cellrow, cellcol)).align_ = extractString(align);
1349
1350                         // parse the remaining contents into the "real" cell
1351                         parse(*cell, FLAG_ITEM, mode);
1352                 }
1353 #endif
1354
1355                 else if (t.cs() == "limits" || t.cs() == "nolimits") {
1356                         CatCode const cat = nextToken().cat();
1357                         if (cat == catSuper || cat == catSub)
1358                                 limits = t.cs() == "limits" ? 1 : -1;
1359                         else {
1360                                 MathAtom at = createInsetMath(t.cs(), buf);
1361                                 cell->push_back(at);
1362                         }
1363                 }
1364
1365                 else if (t.cs() == "nonumber") {
1366                         if (grid.asHullInset())
1367                                 grid.asHullInset()->numbered(cellrow, false);
1368                 }
1369
1370                 else if (t.cs() == "number") {
1371                         if (grid.asHullInset())
1372                                 grid.asHullInset()->numbered(cellrow, true);
1373                 }
1374
1375                 else if (t.cs() == "hline") {
1376                         grid.rowinfo(cellrow).lines_ ++;
1377                 }
1378
1379                 else if (t.cs() == "sqrt") {
1380                         MathData ar;
1381                         parse(ar, FLAG_OPTION, mode);
1382                         if (!ar.empty()) {
1383                                 cell->push_back(MathAtom(new InsetMathRoot(buf)));
1384                                 cell->back().nucleus()->cell(0) = ar;
1385                                 parse(cell->back().nucleus()->cell(1), FLAG_ITEM, mode);
1386                         } else {
1387                                 cell->push_back(MathAtom(new InsetMathSqrt(buf)));
1388                                 parse(cell->back().nucleus()->cell(0), FLAG_ITEM, mode);
1389                         }
1390                 }
1391
1392                 else if (t.cs() == "cancelto") {
1393                         MathData ar;
1394                         parse(ar, FLAG_ITEM, mode);
1395                                 cell->push_back(MathAtom(new InsetMathCancelto(buf)));
1396                                 cell->back().nucleus()->cell(1) = ar;
1397                                 parse(cell->back().nucleus()->cell(0), FLAG_ITEM, mode);
1398                 }
1399
1400                 else if (t.cs() == "unit") {
1401                         // Allowed formats \unit[val]{unit}
1402                         MathData ar;
1403                         parse(ar, FLAG_OPTION, mode);
1404                         if (!ar.empty()) {
1405                                 cell->push_back(MathAtom(new InsetMathFrac(buf, InsetMathFrac::UNIT)));
1406                                 cell->back().nucleus()->cell(0) = ar;
1407                                 parse(cell->back().nucleus()->cell(1), FLAG_ITEM, mode);
1408                         } else {
1409                                 cell->push_back(MathAtom(new InsetMathFrac(buf, InsetMathFrac::UNIT, 1)));
1410                                 parse(cell->back().nucleus()->cell(0), FLAG_ITEM, mode);
1411                         }
1412                 }
1413
1414                 else if (t.cs() == "unitfrac") {
1415                         // Here allowed formats are \unitfrac[val]{num}{denom}
1416                         MathData ar;
1417                         parse(ar, FLAG_OPTION, mode);
1418                         if (!ar.empty()) {
1419                                 cell->push_back(MathAtom(new InsetMathFrac(buf, InsetMathFrac::UNITFRAC, 3)));
1420                                 cell->back().nucleus()->cell(2) = ar;
1421                         } else {
1422                                 cell->push_back(MathAtom(new InsetMathFrac(buf, InsetMathFrac::UNITFRAC)));
1423                         }
1424                         parse(cell->back().nucleus()->cell(0), FLAG_ITEM, mode);
1425                         parse(cell->back().nucleus()->cell(1), FLAG_ITEM, mode);
1426                 }
1427
1428                 else if (t.cs() == "cfrac") {
1429                         // allowed formats are \cfrac[pos]{num}{denom}
1430                         docstring const arg = getArg('[', ']');
1431                         //lyxerr << "got so far: '" << arg << "'" << endl;                              
1432                                 if (arg == "l")
1433                                         cell->push_back(MathAtom(new InsetMathFrac(buf, InsetMathFrac::CFRACLEFT)));
1434                                 else if (arg == "r")
1435                                         cell->push_back(MathAtom(new InsetMathFrac(buf, InsetMathFrac::CFRACRIGHT)));
1436                                 else if (arg.empty() || arg == "c")
1437                                         cell->push_back(MathAtom(new InsetMathFrac(buf, InsetMathFrac::CFRAC)));
1438                                 else {
1439                                         error("found invalid optional argument");
1440                                         break;
1441                                 }
1442                         parse(cell->back().nucleus()->cell(0), FLAG_ITEM, mode);
1443                         parse(cell->back().nucleus()->cell(1), FLAG_ITEM, mode);
1444                 }
1445
1446                 else if (t.cs() == "sideset") {
1447                         // Here allowed formats are \sideset{_{bl}^{tl}}{_{br}^{tr}}{operator}
1448                         cell->push_back(MathAtom(new InsetMathSideset(buf)));
1449                         for (int i = 0; i < 2; ++i) {
1450                                 MathData ar;
1451                                 parse(ar, FLAG_ITEM, mode);
1452                                 if (!ar.empty()) {
1453                                         InsetMathScript * script = (ar.size() == 1) ?
1454                                                 ar[0].nucleus()->asScriptInset() : 0;
1455                                         if (!script) {
1456                                                 error("found invalid sideset argument");
1457                                                 break;
1458                                         }
1459                                         if (script->hasDown())
1460                                                 cell->back().nucleus()->cell(2 * i + 1) = script->down();
1461                                         if (script->hasUp())
1462                                                 cell->back().nucleus()->cell(2 * i + 2) = script->up();
1463                                 }
1464                         }
1465                         parse(cell->back().nucleus()->cell(0), FLAG_ITEM, mode);
1466                 }
1467
1468                 else if (t.cs() == "stackrel") {
1469                         // Here allowed formats are \stackrel[subscript]{superscript}{operator}
1470                         MathData ar;
1471                         parse(ar, FLAG_OPTION, mode);
1472                         cell->push_back(MathAtom(new InsetMathStackrel(buf, !ar.empty())));
1473                         if (!ar.empty())
1474                                 cell->back().nucleus()->cell(2) = ar;
1475                         parse(cell->back().nucleus()->cell(0), FLAG_ITEM, mode);
1476                         parse(cell->back().nucleus()->cell(1), FLAG_ITEM, mode);
1477                 }
1478
1479                 else if (t.cs() == "xrightarrow" || t.cs() == "xleftarrow") {
1480                         cell->push_back(createInsetMath(t.cs(), buf));
1481                         parse(cell->back().nucleus()->cell(1), FLAG_OPTION, mode);
1482                         parse(cell->back().nucleus()->cell(0), FLAG_ITEM, mode);
1483                 }
1484
1485                 else if (t.cs() == "ref" || t.cs() == "eqref" || t.cs() == "prettyref"
1486                           || t.cs() == "pageref" || t.cs() == "vpageref" || t.cs() == "vref") {
1487                         cell->push_back(MathAtom(new InsetMathRef(buf, t.cs())));
1488                         docstring const opt = parse_verbatim_option();
1489                         docstring const ref = parse_verbatim_item();
1490                         if (!opt.empty()) {
1491                                 cell->back().nucleus()->cell(1).push_back(
1492                                         MathAtom(new InsetMathString(opt)));
1493                         }
1494                         cell->back().nucleus()->cell(0).push_back(
1495                                         MathAtom(new InsetMathString(ref)));
1496                 }
1497
1498                 else if (t.cs() == "left") {
1499                         skipSpaces();
1500                         Token const & tl = getToken();
1501                         // \| and \Vert are equivalent, and InsetMathDelim
1502                         // can't handle \|
1503                         // FIXME: fix this in InsetMathDelim itself!
1504                         docstring const l = tl.cs() == "|" ? from_ascii("Vert") : tl.asString();
1505                         MathData ar;
1506                         parse(ar, FLAG_RIGHT, mode);
1507                         if (!good())
1508                                 break;
1509                         skipSpaces();
1510                         Token const & tr = getToken();
1511                         docstring const r = tr.cs() == "|" ? from_ascii("Vert") : tr.asString();
1512                         cell->push_back(MathAtom(new InsetMathDelim(buf, l, r, ar)));
1513                 }
1514
1515                 else if (t.cs() == "right") {
1516                         if (flags & FLAG_RIGHT)
1517                                 return success_;
1518                         //lyxerr << "got so far: '" << cell << "'" << endl;
1519                         error("Unmatched right delimiter");
1520                         return success_;
1521                 }
1522
1523                 else if (t.cs() == "begin") {
1524                         docstring const name = getArg('{', '}');
1525                         environments_.push_back(name);
1526
1527                         if (name == "array" || name == "subarray") {
1528                                 docstring const valign = parse_verbatim_option() + 'c';
1529                                 docstring const halign = parse_verbatim_item();
1530                                 cell->push_back(MathAtom(new InsetMathArray(buf, name,
1531                                         InsetMathGrid::guessColumns(halign), 1, (char)valign[0], halign)));
1532                                 parse2(cell->back(), FLAG_END, mode, false);
1533                         }
1534
1535                         else if (name == "tabular") {
1536                                 docstring const valign = parse_verbatim_option() + 'c';
1537                                 docstring const halign = parse_verbatim_item();
1538                                 cell->push_back(MathAtom(new InsetMathTabular(buf, name,
1539                                         InsetMathGrid::guessColumns(halign), 1, (char)valign[0], halign)));
1540                                 parse2(cell->back(), FLAG_END, InsetMath::TEXT_MODE, false);
1541                         }
1542
1543                         else if (name == "split" || name == "cases") {
1544                                 cell->push_back(createInsetMath(name, buf));
1545                                 parse2(cell->back(), FLAG_END, mode, false);
1546                         }
1547
1548                         else if (name == "alignedat") {
1549                                 docstring const valign = parse_verbatim_option() + 'c';
1550                                 // ignore this for a while
1551                                 getArg('{', '}');
1552                                 cell->push_back(MathAtom(new InsetMathSplit(buf, name, (char)valign[0])));
1553                                 parse2(cell->back(), FLAG_END, mode, false);
1554                         }
1555
1556                         else if (name == "math") {
1557                                 cell->push_back(MathAtom(new InsetMathEnsureMath(buf)));
1558                                 parse(cell->back().nucleus()->cell(0), FLAG_END, InsetMath::MATH_MODE);
1559                         }
1560
1561                         else if (name == "equation" || name == "equation*"
1562                                         || name == "displaymath") {
1563                                 if (mode != InsetMath::UNDECIDED_MODE) {
1564                                         error("bad math environment");
1565                                         break;
1566                                 }
1567                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullEquation)));
1568                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, (name == "equation"));
1569                         }
1570
1571                         else if (name == "eqnarray" || name == "eqnarray*") {
1572                                 if (mode != InsetMath::UNDECIDED_MODE) {
1573                                         error("bad math environment");
1574                                         break;
1575                                 }
1576                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullEqnArray)));
1577                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, !stared(name));
1578                         }
1579
1580                         else if (name == "align" || name == "align*") {
1581                                 if (mode != InsetMath::UNDECIDED_MODE) {
1582                                         error("bad math environment");
1583                                         break;
1584                                 }
1585                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullAlign)));
1586                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, !stared(name));
1587                         }
1588
1589                         else if (name == "flalign" || name == "flalign*") {
1590                                 if (mode != InsetMath::UNDECIDED_MODE) {
1591                                         error("bad math environment");
1592                                         break;
1593                                 }
1594                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullFlAlign)));
1595                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, !stared(name));
1596                         }
1597
1598                         else if (name == "alignat" || name == "alignat*") {
1599                                 if (mode != InsetMath::UNDECIDED_MODE) {
1600                                         error("bad math environment");
1601                                         break;
1602                                 }
1603                                 // ignore this for a while
1604                                 getArg('{', '}');
1605                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullAlignAt)));
1606                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, !stared(name));
1607                         }
1608
1609                         else if (name == "xalignat" || name == "xalignat*") {
1610                                 if (mode != InsetMath::UNDECIDED_MODE) {
1611                                         error("bad math environment");
1612                                         break;
1613                                 }
1614                                 // ignore this for a while
1615                                 getArg('{', '}');
1616                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullXAlignAt)));
1617                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, !stared(name));
1618                         }
1619
1620                         else if (name == "xxalignat") {
1621                                 if (mode != InsetMath::UNDECIDED_MODE) {
1622                                         error("bad math environment");
1623                                         break;
1624                                 }
1625                                 // ignore this for a while
1626                                 getArg('{', '}');
1627                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullXXAlignAt)));
1628                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, !stared(name));
1629                         }
1630
1631                         else if (name == "multline" || name == "multline*") {
1632                                 if (mode != InsetMath::UNDECIDED_MODE) {
1633                                         error("bad math environment");
1634                                         break;
1635                                 }
1636                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullMultline)));
1637                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, !stared(name));
1638                         }
1639
1640                         else if (name == "gather" || name == "gather*") {
1641                                 if (mode != InsetMath::UNDECIDED_MODE) {
1642                                         error("bad math environment");
1643                                         break;
1644                                 }
1645                                 cell->push_back(MathAtom(new InsetMathHull(buf, hullGather)));
1646                                 parse2(cell->back(), FLAG_END, InsetMath::MATH_MODE, !stared(name));
1647                         }
1648
1649                         else if (latexkeys const * l = in_word_set(name)) {
1650                                 if (l->inset == "matrix") {
1651                                         cell->push_back(createInsetMath(name, buf));
1652                                         parse2(cell->back(), FLAG_END, mode, false);
1653                                 } else if (l->inset == "split") {
1654                                         docstring const valign = parse_verbatim_option() + 'c';
1655                                         cell->push_back(MathAtom(
1656                                                 new InsetMathSplit(buf, name, (char)valign[0])));
1657                                         parse2(cell->back(), FLAG_END, mode, false);
1658                                 } else {
1659                                         success_ = false;
1660                                         if (!(mode_ & Parse::QUIET)) {
1661                                                 dump();
1662                                                 lyxerr << "found math environment `"
1663                                                        << to_utf8(name)
1664                                                        << "' in symbols file with unsupported inset `"
1665                                                        << to_utf8(l->inset)
1666                                                        << "'." << endl;
1667                                         }
1668                                         // create generic environment inset
1669                                         cell->push_back(MathAtom(new InsetMathEnv(buf, name)));
1670                                         parse(cell->back().nucleus()->cell(0), FLAG_END, mode);
1671                                 }
1672                         }
1673
1674                         else {
1675                                 success_ = false;
1676                                 if (!(mode_ & Parse::QUIET)) {
1677                                         dump();
1678                                         lyxerr << "found unknown math environment '"
1679                                                << to_utf8(name) << "'" << endl;
1680                                 }
1681                                 // create generic environment inset
1682                                 cell->push_back(MathAtom(new InsetMathEnv(buf, name)));
1683                                 parse(cell->back().nucleus()->cell(0), FLAG_END, mode);
1684                         }
1685                 }
1686
1687                 else if (t.cs() == "kern") {
1688                         // FIXME: A hack...
1689                         docstring s;
1690                         int num_tokens = 0;
1691                         while (true) {
1692                                 Token const & t = getToken();
1693                                 ++num_tokens;
1694                                 if (!good()) {
1695                                         s.clear();
1696                                         while (num_tokens--)
1697                                                 putback();
1698                                         break;
1699                                 }
1700                                 s += t.character();
1701                                 if (isValidLength(to_utf8(s)))
1702                                         break;
1703                         }
1704                         if (s.empty())
1705                                 cell->push_back(MathAtom(new InsetMathKern));
1706                         else
1707                                 cell->push_back(MathAtom(new InsetMathKern(s)));
1708                 }
1709
1710                 else if (t.cs() == "label") {
1711                         // FIXME: This is swallowed in inline formulas
1712                         docstring label = parse_verbatim_item();
1713                         MathData ar;
1714                         asArray(label, ar);
1715                         if (grid.asHullInset()) {
1716                                 grid.asHullInset()->label(cellrow, label);
1717                         } else {
1718                                 cell->push_back(createInsetMath(t.cs(), buf));
1719                                 cell->push_back(MathAtom(new InsetMathBrace(ar)));
1720                         }
1721                 }
1722
1723                 else if (t.cs() == "choose" || t.cs() == "over"
1724                                 || t.cs() == "atop" || t.cs() == "brace"
1725                                 || t.cs() == "brack") {
1726                         MathAtom at = createInsetMath(t.cs(), buf);
1727                         at.nucleus()->cell(0) = *cell;
1728                         cell->clear();
1729                         parse(at.nucleus()->cell(1), flags, mode);
1730                         cell->push_back(at);
1731                         return success_;
1732                 }
1733
1734                 else if (t.cs() == "color") {
1735                         docstring const color = parse_verbatim_item();
1736                         cell->push_back(MathAtom(new InsetMathColor(buf, true, color)));
1737                         parse(cell->back().nucleus()->cell(0), flags, mode);
1738                         return success_;
1739                 }
1740
1741                 else if (t.cs() == "textcolor") {
1742                         docstring const color = parse_verbatim_item();
1743                         cell->push_back(MathAtom(new InsetMathColor(buf, false, color)));
1744                         parse(cell->back().nucleus()->cell(0), FLAG_ITEM, InsetMath::TEXT_MODE);
1745                 }
1746
1747                 else if (t.cs() == "normalcolor") {
1748                         cell->push_back(createInsetMath(t.cs(), buf));
1749                         parse(cell->back().nucleus()->cell(0), flags, mode);
1750                         return success_;
1751                 }
1752
1753                 else if (t.cs() == "substack") {
1754                         cell->push_back(createInsetMath(t.cs(), buf));
1755                         parse2(cell->back(), FLAG_ITEM, mode, false);
1756                         // Delete empty last row if present
1757                         InsetMathGrid & subgrid =
1758                                 *(cell->back().nucleus()->asGridInset());
1759                         if (subgrid.nrows() > 1)
1760                                 delEmptyLastRow(subgrid);
1761                 }
1762
1763                 else if (t.cs() == "xymatrix") {
1764                         odocstringstream os;
1765                         while (good() && nextToken().cat() != catBegin)
1766                                 os << getToken().asInput();
1767                         cell->push_back(createInsetMath(t.cs() + os.str(), buf));
1768                         parse2(cell->back(), FLAG_ITEM, mode, false);
1769                         // Delete empty last row if present
1770                         InsetMathGrid & subgrid =
1771                                 *(cell->back().nucleus()->asGridInset());
1772                         if (subgrid.nrows() > 1)
1773                                 delEmptyLastRow(subgrid);
1774                 }
1775
1776                 else if (t.cs() == "Diagram") {
1777                         odocstringstream os;
1778                         while (good() && nextToken().cat() != catBegin)
1779                                 os << getToken().asInput();
1780                         cell->push_back(createInsetMath(t.cs() + os.str(), buf));
1781                         parse2(cell->back(), FLAG_ITEM, mode, false);
1782                 }
1783
1784                 else if (t.cs() == "framebox" || t.cs() == "makebox") {
1785                         cell->push_back(createInsetMath(t.cs(), buf));
1786                         parse(cell->back().nucleus()->cell(0), FLAG_OPTION, InsetMath::TEXT_MODE);
1787                         parse(cell->back().nucleus()->cell(1), FLAG_OPTION, InsetMath::TEXT_MODE);
1788                         parse(cell->back().nucleus()->cell(2), FLAG_ITEM, InsetMath::TEXT_MODE);
1789                 }
1790
1791                 else if (t.cs() == "tag") {
1792                         if (nextToken().character() == '*') {
1793                                 getToken();
1794                                 cell->push_back(createInsetMath(t.cs() + '*', buf));
1795                         } else
1796                                 cell->push_back(createInsetMath(t.cs(), buf));
1797                         parse(cell->back().nucleus()->cell(0), FLAG_ITEM, InsetMath::TEXT_MODE);
1798                 }
1799
1800                 else if (t.cs() == "hspace") {
1801                         bool const prot =  nextToken().character() == '*';
1802                         if (prot)
1803                                 getToken();
1804                         docstring const name = t.cs();
1805                         docstring const arg = parse_verbatim_item();
1806                         Length length;
1807                         if (prot && arg == "\\fill")
1808                                 cell->push_back(MathAtom(new InsetMathSpace("hspace*{\\fill}", "")));
1809                         else if (isValidLength(to_utf8(arg), &length))
1810                                 cell->push_back(MathAtom(new InsetMathSpace(length, prot)));
1811                         else {
1812                                 // Since the Length class cannot use length variables
1813                                 // we must not create an InsetMathSpace.
1814                                 cell->push_back(MathAtom(new MathMacro(buf, name)));
1815                                 MathData ar;
1816                                 mathed_parse_cell(ar, '{' + arg + '}', mode_);
1817                                 cell->append(ar);
1818                         }
1819                 }
1820
1821 #if 0
1822                 else if (t.cs() == "infer") {
1823                         MathData ar;
1824                         parse(ar, FLAG_OPTION, mode);
1825                         cell->push_back(createInsetMath(t.cs(), buf));
1826                         parse2(cell->back(), FLAG_ITEM, mode, false);
1827                 }
1828
1829                 // Disabled
1830                 else if (1 && t.cs() == "ar") {
1831                         auto_ptr<InsetMathXYArrow> p(new InsetMathXYArrow);
1832                         // try to read target
1833                         parse(p->cell(0), FLAG_OTPTION, mode);
1834                         // try to read label
1835                         if (nextToken().cat() == catSuper || nextToken().cat() == catSub) {
1836                                 p->up_ = nextToken().cat() == catSuper;
1837                                 getToken();
1838                                 parse(p->cell(1), FLAG_ITEM, mode);
1839                                 //lyxerr << "read label: " << p->cell(1) << endl;
1840                         }
1841
1842                         cell->push_back(MathAtom(p.release()));
1843                         //lyxerr << "read cell: " << cell << endl;
1844                 }
1845 #endif
1846
1847                 else if (t.cs() == "lyxmathsym") {
1848                         skipSpaces();
1849                         if (getToken().cat() != catBegin) {
1850                                 error("'{' expected in \\" + t.cs());
1851                                 return success_;
1852                         }
1853                         int count = 0;
1854                         docstring cmd;
1855                         CatCode cat = nextToken().cat();
1856                         while (good() && (count || cat != catEnd)) {
1857                                 if (cat == catBegin)
1858                                         ++count;
1859                                 else if (cat == catEnd)
1860                                         --count;
1861                                 cmd += getToken().asInput();
1862                                 cat = nextToken().cat();
1863                         }
1864                         if (getToken().cat() != catEnd) {
1865                                 error("'}' expected in \\" + t.cs());
1866                                 return success_;
1867                         }
1868                         bool termination;
1869                         docstring rem;
1870                         do {
1871                                 cmd = Encodings::fromLaTeXCommand(cmd,
1872                                         Encodings::MATH_CMD | Encodings::TEXT_CMD,
1873                                         termination, rem);
1874                                 for (size_t i = 0; i < cmd.size(); ++i)
1875                                         cell->push_back(MathAtom(new InsetMathChar(cmd[i])));
1876                                 if (!rem.empty()) {
1877                                         char_type c = rem[0];
1878                                         cell->push_back(MathAtom(new InsetMathChar(c)));
1879                                         cmd = rem.substr(1);
1880                                         rem.clear();
1881                                 } else
1882                                         cmd.clear();
1883                         } while (!cmd.empty());
1884                 }
1885
1886                 else if (!t.cs().empty()) {
1887                         bool const no_mhchem =
1888                                 (t.cs() == "ce" || t.cs() == "cf")
1889                                 && buf && buf->params().use_package("mhchem") ==
1890                                                 BufferParams::package_off;
1891
1892                         bool const is_user_macro = no_mhchem ||
1893                                 (buf && (mode_ & Parse::TRACKMACRO
1894                                          ? buf->usermacros.count(t.cs()) != 0
1895                                          : buf->getMacro(t.cs(), false) != 0));
1896
1897                         latexkeys const * l = in_word_set(t.cs());
1898                         if (l && !is_user_macro) {
1899                                 if (l->inset == "big") {
1900                                         skipSpaces();
1901                                         docstring const delim = getToken().asInput();
1902                                         if (InsetMathBig::isBigInsetDelim(delim))
1903                                                 cell->push_back(MathAtom(
1904                                                         new InsetMathBig(t.cs(), delim)));
1905                                         else {
1906                                                 cell->push_back(createInsetMath(t.cs(), buf));
1907                                                 putback();
1908                                         }
1909                                 }
1910
1911                                 else if (l->inset == "font") {
1912                                         cell->push_back(createInsetMath(t.cs(), buf));
1913                                         parse(cell->back().nucleus()->cell(0),
1914                                                 FLAG_ITEM, asMode(mode, l->extra));
1915                                 }
1916
1917                                 else if (l->inset == "oldfont") {
1918                                         cell->push_back(createInsetMath(t.cs(), buf));
1919                                         parse(cell->back().nucleus()->cell(0),
1920                                                 flags | FLAG_ALIGN, asMode(mode, l->extra));
1921                                         if (prevToken().cat() != catAlign &&
1922                                             prevToken().cs() != "\\")
1923                                                 return success_;
1924                                         putback();
1925                                 }
1926
1927                                 else if (l->inset == "style") {
1928                                         cell->push_back(createInsetMath(t.cs(), buf));
1929                                         parse(cell->back().nucleus()->cell(0),
1930                                                 flags | FLAG_ALIGN, mode);
1931                                         if (prevToken().cat() != catAlign &&
1932                                             prevToken().cs() != "\\")
1933                                                 return success_;
1934                                         putback();
1935                                 }
1936
1937                                 else {
1938                                         MathAtom at = createInsetMath(t.cs(), buf);
1939                                         for (InsetMath::idx_type i = 0; i < at->nargs(); ++i)
1940                                                 parse(at.nucleus()->cell(i),
1941                                                         FLAG_ITEM, asMode(mode, l->extra));
1942                                         cell->push_back(at);
1943                                 }
1944                         }
1945
1946                         else {
1947                                 bool is_unicode_symbol = false;
1948                                 if (mode == InsetMath::TEXT_MODE && !is_user_macro) {
1949                                         int num_tokens = 0;
1950                                         docstring cmd = prevToken().asInput();
1951                                         CatCode cat = nextToken().cat();
1952                                         if (cat == catBegin) {
1953                                                 int count = 0;
1954                                                 while (good() && (count || cat != catEnd)) {
1955                                                         cat = nextToken().cat();
1956                                                         cmd += getToken().asInput();
1957                                                         ++num_tokens;
1958                                                         if (cat == catBegin)
1959                                                                 ++count;
1960                                                         else if (cat == catEnd)
1961                                                                 --count;
1962                                                 }
1963                                         }
1964                                         bool is_combining;
1965                                         bool termination;
1966                                         char_type c = Encodings::fromLaTeXCommand(cmd,
1967                                                 Encodings::MATH_CMD | Encodings::TEXT_CMD,
1968                                                 is_combining, termination);
1969                                         if (is_combining) {
1970                                                 if (cat == catLetter)
1971                                                         cmd += '{';
1972                                                 cmd += getToken().asInput();
1973                                                 ++num_tokens;
1974                                                 if (cat == catLetter)
1975                                                         cmd += '}';
1976                                                 c = Encodings::fromLaTeXCommand(cmd,
1977                                                         Encodings::MATH_CMD | Encodings::TEXT_CMD,
1978                                                         is_combining, termination);
1979                                         }
1980                                         if (c) {
1981                                                 if (termination) {
1982                                                         if (nextToken().cat() == catBegin) {
1983                                                                 getToken();
1984                                                                 if (nextToken().cat() == catEnd) {
1985                                                                         getToken();
1986                                                                         num_tokens += 2;
1987                                                                 } else
1988                                                                         putback();
1989                                                         } else {
1990                                                                 while (nextToken().cat() == catSpace) {
1991                                                                         getToken();
1992                                                                         ++num_tokens;
1993                                                                 }
1994                                                         }
1995                                                 }
1996                                                 is_unicode_symbol = true;
1997                                                 cell->push_back(MathAtom(new InsetMathChar(c)));
1998                                         } else {
1999                                                 while (num_tokens--)
2000                                                         putback();
2001                                         }
2002                                 }
2003                                 if (!is_unicode_symbol) {
2004                                         MathAtom at = is_user_macro ?
2005                                                 MathAtom(new MathMacro(buf, t.cs()))
2006                                                 : createInsetMath(t.cs(), buf);
2007                                         InsetMath::mode_type m = mode;
2008                                         //if (m == InsetMath::UNDECIDED_MODE)
2009                                         //lyxerr << "default creation: m1: " << m << endl;
2010                                         if (at->currentMode() != InsetMath::UNDECIDED_MODE)
2011                                                 m = at->currentMode();
2012                                         //lyxerr << "default creation: m2: " << m << endl;
2013                                         InsetMath::idx_type start = 0;
2014                                         // this fails on \bigg[...\bigg]
2015                                         //MathData opt;
2016                                         //parse(opt, FLAG_OPTION, InsetMath::VERBATIM_MODE);
2017                                         //if (!opt.empty()) {
2018                                         //      start = 1;
2019                                         //      at.nucleus()->cell(0) = opt;
2020                                         //}
2021                                         for (InsetMath::idx_type i = start; i < at->nargs(); ++i) {
2022                                                 parse(at.nucleus()->cell(i), FLAG_ITEM, m);
2023                                                 skipSpaces();
2024                                         }
2025                                         cell->push_back(at);
2026                                 }
2027                         }
2028                 }
2029
2030
2031                 if (flags & FLAG_LEAVE) {
2032                         flags &= ~FLAG_LEAVE;
2033                         break;
2034                 }
2035         }
2036         return success_;
2037 }
2038
2039
2040
2041 } // anonymous namespace
2042
2043
2044 bool mathed_parse_cell(MathData & ar, docstring const & str, Parse::flags f)
2045 {
2046         return Parser(str, f, ar.buffer()).parse(ar, 0, f & Parse::TEXTMODE ?
2047                                 InsetMath::TEXT_MODE : InsetMath::MATH_MODE);
2048 }
2049
2050
2051 bool mathed_parse_cell(MathData & ar, istream & is, Parse::flags f)
2052 {
2053         return Parser(is, f, ar.buffer()).parse(ar, 0, f & Parse::TEXTMODE ?
2054                                 InsetMath::TEXT_MODE : InsetMath::MATH_MODE);
2055 }
2056
2057
2058 bool mathed_parse_normal(Buffer * buf, MathAtom & t, docstring const & str,
2059                          Parse::flags f)
2060 {
2061         return Parser(str, f, buf).parse(t);
2062 }
2063
2064
2065 bool mathed_parse_normal(Buffer * buf, MathAtom & t, Lexer & lex,
2066                          Parse::flags f)
2067 {
2068         return Parser(lex, f, buf).parse(t);
2069 }
2070
2071
2072 bool mathed_parse_normal(InsetMathGrid & grid, docstring const & str,
2073                          Parse::flags f)
2074 {
2075         return Parser(str, f, &grid.buffer()).parse1(grid, 0, f & Parse::TEXTMODE ?
2076                         InsetMath::TEXT_MODE : InsetMath::MATH_MODE, false);
2077 }
2078
2079
2080 void initParser()
2081 {
2082         fill(theCatcode, theCatcode + 128, catOther);
2083         fill(theCatcode + 'a', theCatcode + 'z' + 1, catLetter);
2084         fill(theCatcode + 'A', theCatcode + 'Z' + 1, catLetter);
2085
2086         theCatcode[int('\\')] = catEscape;
2087         theCatcode[int('{')]  = catBegin;
2088         theCatcode[int('}')]  = catEnd;
2089         theCatcode[int('$')]  = catMath;
2090         theCatcode[int('&')]  = catAlign;
2091         theCatcode[int('\n')] = catNewline;
2092         theCatcode[int('#')]  = catParameter;
2093         theCatcode[int('^')]  = catSuper;
2094         theCatcode[int('_')]  = catSub;
2095         theCatcode[int(0x7f)] = catIgnore;
2096         theCatcode[int(' ')]  = catSpace;
2097         theCatcode[int('\t')] = catSpace;
2098         theCatcode[int('\r')] = catNewline;
2099         theCatcode[int('~')]  = catActive;
2100         theCatcode[int('%')]  = catComment;
2101 }
2102
2103
2104 } // namespace lyx