Jonathan Sachs - 2012-01-12

I'm getting PDF output from "my" first DOxygen project, which is a large PHP application written and documented by another person.

One of the results is an extensive log of "LaTeX errors." It's being displayed by the "compose" command in TexWorks, an editor packaged with MikTEX, and it's formatted as a three-column table. The columns contain:

- A fragmentary link to the directory where the TEX source is located. (It is truncated at the first space, in the middle of a directory name.)

- A number. In some cases the "number" is a question mark. In many cases consecutive errors have consecutive numbers, but there are also discontinuities, duplicates, and gaps.

- An error message.

The table has no column headings.

I need to relate the messages back to their ultimate causes in the PHP source. How can I do that?

If I'm on my own I'll have to learn a lot more than I know about TEX commands, learn LaTeX, figure out what each error means in terms of the TEX files, and deduce the relationship between the error in the TEX files and the state of the PHP source. I'm sure those skills would be valuable in another context, but right now I don't have time to learn them, and if I did I couldn't justify using it that way to my boss. I'm supposed to be producing a manual for a product delivery, not learning how to fix parts of the DOxygen/TEX machinery that are supposed to be buried under the hood!

Here are examples of the most common types of error messages I need to understand:

LaTeX Warning: Reference `class_daily__reports' on page 3 undefined on input line 8.
(In some cases the quoted name corresponds to an actual class name in the application. In others it doesn't. In yet others it doesn't even begin with 'class'.)

LaTeX Warning: Label `class_pages_ad38b444fd6244c0afc5cf225a1d60fa0' multiply defined.
(Need I say it? The quoted name is not in the source code!)

Overfull \hbox (1.18007pt too wide) in paragraph at lines 101-101
Underfull \hbox (badness 4686) in paragraph at lines 436-437
(I know that an hbox is part of TEX's text composing machinery, but that's not too helpful in this context. "In lines 101-101" of what? The document is being built from dozens of files, and there's no clue to which one contains the error.)