6.4 Customizing the compiler output

Most LaTeX compilers produce a very large amount of output during compilation, most of which is not relevant to debugging type-setting errors. The compiler plugin provided with Latex-Suite (which is an enhanced version of the standard compiler plugin maintained by Artem Chuprina), provides a way to filter the compiler output so that the actual errors/warnings can be presented much more concisely.

The compiler plugin is set up by default to function in a "non-verbose", "ignore-common-warnings" mode, which means that irrelevant lines from the compiler output will be ignored and some very common warnings are also ignored. Latex-Suite does this via the global variable g:Tex_IgnoredWarnings. This is a list of patterns, which can be used to filter out (or ignore) some or the warnings and errors reported by the compiler. See the link above for its default value.

Latex-Suite uses the g:Tex_IgnoreLevel setting to set a default ignore level. For example, for the default value of 4, Latex-Suite ignores warnings and errors matching the first 4 patterns in g:Tex_IgnoredWarnings.

In addition to setting a default value of the ignore level, Latex-Suite provides the ability to set the level dynamically, using the TCLevel command. For example, if you issue the command:

TCLevel 3

from within Vim, then the next time you compile the document, Latex-Suite will ignore warnings and errors which match the first three patterns in g:Tex_IgnoredWarnings.

When TCLevel is called with the unquoted string strict as follows:

TClevel strict

then Latex-Suite switches to a "verbose", "no-lines-ignored" mode which is useful when you want to make final checks of your document and want to be careful not to let things slip by.

See the explanation of the settings g:Tex_IgnoredWarnings and g:Tex_IgnoreLevel to find out how to customize the filtering done by Latex-Suite