Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

latexml::mathparser(3pm) [debian man page]

LaTeXML::MathParser(3pm)				User Contributed Perl Documentation				  LaTeXML::MathParser(3pm)

NAME

       "LaTeXML::MathParser" - parses mathematics content

DESCRIPTION

       "LaTeXML::MathParser" parses the mathematical content of a document.  It uses Parse::RecDescent and a grammar "MathGrammar".

   Math Representation
       Needs description.

   Possibile Customizations
       Needs description.

   Convenience functions
       The following functions are exported for convenience in writing the grammar productions.

       "$node = New($name,$content,%attributes);"
	   Creates a new "XMTok" node with given $name (a string or undef), and $content (a string or undef) (but at least one of name or content
	   should be provided), and attributes.

       "$node = Arg($node,$n);"
	   Returns the $n-th argument of an "XMApp" node; 0 is the operator node.

       "Annotate($node,%attributes);"
	   Add attributes to $node.

       "$node = Apply($op,@args);"
	   Create a new "XMApp" node representing the application of the node $op to the nodes @args.

       "$node = ApplyDelimited($op,@stuff);"
	   Create a new "XMApp" node representing the application of the node $op to the arguments found in @stuff.  @stuff are delimited
	   arguments in the sense that the leading and trailing nodes should represent open and close delimiters and the arguments are seperated
	   by punctuation nodes.  The text of these delimiters and punctuation are used to annotate the operator node with "argopen", "argclose"
	   and "separator" attributes.

       "$node = recApply(@ops,$arg);"
	   Given a sequence of operators and an argument, forms the nested application "op(op(...(arg)))">.

       "$node = InvisibleTimes;"
	   Creates an invisible times operator.

       "$boole = isMatchingClose($open,$close);"
	   Checks whether $open and $close form a `normal' pair of delimiters, or if either is ".".

       "$node = Fence(@stuff);"
	   Given a delimited sequence of nodes, starting and ending with open/close delimiters, and with intermediate nodes separated by
	   punctuation or such, attempt to guess what type of thing is represented such as a set, absolute value, interval, and so on.	If nothing
	   specific is recognized, creates the application of "FENCED" to the arguments.

	   This would be a good candidate for customization!

       "$node = NewFormulae(@stuff);"
	   Given a set of formulas, construct a "Formulae" application, if there are more than one, else just return the first.

       "$node = NewList(@stuff);"
	   Given a set of expressions, construct a "list" application, if there are more than one, else just return the first.

       "$node = LeftRec($arg1,@more);"
	   Given an expr followed by repeated (op expr), compose the left recursive tree.  For example "a + b + c - d" would give "(- (+ a b c)
	   d)">

       "Problem($text);"
	   Warn of a potential math parsing problem.

       "MaybeFunction($token);"
	   Note the possible use of $token as a function, which may cause incorrect parsing.  This is used to generate warning messages.

AUTHOR

       Bruce Miller <bruce.miller@nist.gov>

COPYRIGHT

       Public domain software, produced as part of work done by the United States Government & not subject to copyright in the US.

perl v5.10.1							    2009-06-11						  LaTeXML::MathParser(3pm)

Check Out this Related Man Page

LaTeXML::Mouth(3pm)					User Contributed Perl Documentation				       LaTeXML::Mouth(3pm)

NAME

       "LaTeXML::Mouth" - tokenize the input.

DESCRIPTION

       A "LaTeXML::Mouth" (and subclasses) is responsible for tokenizing, ie.  converting plain text and strings into LaTeXML::Tokens according to
       the current category codes (catcodes) stored in the "LaTeXML::State".

       "LaTeXML::FileMouth"
	   specializes "LaTeXML::Mouth" to tokenize from a file.

       "LaTeXML::StyleMouth"
	   further specializes "LaTeXML::FileMouth" for processing style files, setting the catcode for "@" and ignoring comments.

       "LaTeXML::PerlMouth"
	   is not really a Mouth in the above sense, but is used to definitions from perl modules with exensions ".ltxml" and ".latexml".

   Creating Mouths
       "$mouth = LaTeXML::Mouth->new($string);"
	   Creates a new Mouth reading from $string.

       "$mouth = LaTeXML::FileMouth->new($pathname);"
	   Creates a new FileMouth to read from the given file.

       "$mouth = LaTeXML::StyleMouth->new($pathname);"
	   Creates a new StyleMouth to read from the given style file.

   Methods
       "$token = $mouth->readToken;"
	   Returns the next LaTeXML::Token from the source.

       "$boole = $mouth->hasMoreInput;"
	   Returns whether there is more data to read.

       "$string = $mouth->getLocator($long);"
	   Return a description of current position in the source, for reporting errors.

       "$tokens = $mouth->readTokens($until);"
	   Reads tokens until one matches $until (comparing the character, but not catcode).  This is useful for the "verb" command.

       "$lines = $mouth->readRawLines($endline,$exact);"
	   Reads raw (untokenized) lines from $mouth until a line matching $endline is found.  If $exact is true, $endline is matched exactly,
	   with no leading or trailing data (like in the c<comment> package).  Otherwise, the match is done like with the c<verbatim> environment;
	   any text preceding $endline is returned as the last line, and any characters after $endline remains in the mouth to be tokenized.

AUTHOR

       Bruce Miller <bruce.miller@nist.gov>

COPYRIGHT

       Public domain software, produced as part of work done by the United States Government & not subject to copyright in the US.

perl v5.10.1							    2009-06-11						       LaTeXML::Mouth(3pm)
Man Page