Rename files in src/mathed and src/graphics from .C to .cpp, step 2

[lyx.git] / src / mathed / MathParser.h

diff --git a/src/mathed/MathParser.h b/src/mathed/MathParser.h
index 1e4b7b7392a3d5f39173f6f45b6a6de0a2aafec1..2fb712fa1124aecc43231c9c96b6ac56db70132e 100644 (file)
--- a/src/mathed/MathParser.h
+++ b/src/mathed/MathParser.h
@@ -35,11 +35,23 @@ public:
        docstring name;
        /// name of a inset that handles that macro
        docstring inset;
-       /// position of the thing in a font     
+       /**
+        * The string or symbol to draw.
+        * This is a string of length 1 if \p name is a known symbol, and
+        * the corresponding font is available. In this case it is
+        * NO UCS4 STRING! The only "character" of the string simply denotes
+        * the code point of the symbol in the font. Therefore you have to
+        * be very careful if you pass \c draw to any function that takes a
+        * docstring argument.
+        * If \p name is a known symbol, but the corresponding font is not
+        * available, or if it is a function name, then \c draw contains a
+        * regular UCS4 string (actuallay \c draw == \c name) that is painted
+        * on screen.
+        */
        docstring draw;
        /// operator/..., fontname e
        docstring extra;
-       /// how is this called as XML entity?
+       /// how is this called as XML entity in MathML?
        docstring xmlname;
        /// required LaTeXFeatures
        docstring requires;
@@ -51,16 +63,15 @@ latexkeys const * in_word_set(docstring const & str);
 
 /// parse formula from a string
 bool mathed_parse_normal(MathAtom &, docstring const &);
-/// ... a stream
-bool mathed_parse_normal(MathAtom &, std::istream &);
 /// ... the LyX lexxer
 bool mathed_parse_normal(MathAtom &, LyXLex &);
-/// ... the LyX lexxer
+/// parse formula from a string into a grid
 void mathed_parse_normal(InsetMathGrid &, docstring const &);
 
 /// parse a single cell from a string
 void mathed_parse_cell(MathArray & ar, docstring const &);
-/// ... a stream
+/// parse a single cell from a stream. Only use this for reading from .lyx
+/// file format, for the reason see Parser::tokenize(std::istream &).
 void mathed_parse_cell(MathArray & ar, std::istream &);
 
 void initParser();