3.5 TEX message parsers

Message parsers are used to scan the output of TEX/L^ATEX. The output is analysed by a sequence of TEX message parsers. Each message parser analyses the output and removes those parts of the output, it feels responsible for. If there is nothing left in the end, the message got validated, otherwise an exception is raised reporting the problem. A message parser might issue a warning when removing some output to give some feedback to the user.

class texmessage( ): This class acts as a container for TEX message parsers instances, which are all instances of classes derived from texmessage.

The following TEX message parser instances are available:

start: Check for TEX/L^ATEX startup message including scrollmode test.

noaux: Ignore L^ATEXs no-aux-file warning.

end: Check for proper TEX/L^ATEX tear down message.

load: Accepts arbitrary loading of files without checking for details, i.e. accept (file ...) where file is an readable file.

loaddef: Accepts arbitrary loading of fd files, i.e. accept (file.def) and (file.fd) where file.def or file.fd is an readable file, respectively.

graphicsload: Accepts arbitrary loading of eps files, i.e. accept (file.eps) where file.eps is an readable file.

ignore: Ignores everything (this is probably a bad idea, but sometimes you might just want to ignore everything).

allwarning: Ignores everything but issues a warning.

fontwarning: Issues a warning about font substitutions of the L^ATEXs NFSS.

boxwarning: Issues a warning on under- and overfull horizontal and vertical boxes.

class texmessagepattern( pattern, warning=None): This is a derived class of texmessage. It can be used to construct simple TEX message parsers, which validate a TEX message matching a certain regular expression pattern pattern. When warning is set, a warning message is issued. Several of the TEX message parsers described above are implemented using this class.