| 1 |
LaTeX Error Reports |
| 2 |
|
| 3 |
April 2020 |
| 4 |
|
| 5 |
ERROR REPORTS |
| 6 |
|
| 7 |
Before you report an error, please check that: |
| 8 |
|
| 9 |
* Your LaTeX system is not too old, i.e., your version is the |
| 10 |
current or the previous release. Information about the latest |
| 11 |
release can be found at |
| 12 |
https://www.latex-project.org/news/latex2e-news/ |
| 13 |
|
| 14 |
* The error is not already mentioned in the documentation of the |
| 15 |
distribution, e.g. in a .dtx file (in this case it is a feature :-). |
| 16 |
|
| 17 |
* The error has not already been reported. If you have WWW |
| 18 |
access, you can find out how to search the LaTeX bugs database |
| 19 |
using this URL: |
| 20 |
|
| 21 |
https://www.latex-project.org/bugs.html |
| 22 |
|
| 23 |
* The error is not caused by software other than the core LaTeX |
| 24 |
software that is produced and maintained by the LaTeX Project |
| 25 |
team. Please report problems with other software to the authors |
| 26 |
or suppliers of that software, and not to us! |
| 27 |
|
| 28 |
Thus you should check that the problem is not caused by, for |
| 29 |
example, the viewer or printing software you use. |
| 30 |
|
| 31 |
Also, the test file demonstrating the error should not use any |
| 32 |
classes or packages other than those authored and supported by the |
| 33 |
LaTeX Project team. The files for the package or class will tell you how |
| 34 |
it is supported. The test file should use the package latexbug to |
| 35 |
check that all packages in the file are supported by the LaTeX |
| 36 |
Project (see the discussion on the website why this is important). |
| 37 |
|
| 38 |
* The error is not caused by using an obsolete version of any file or |
| 39 |
of other software. |
| 40 |
|
| 41 |
* You are using the original version of all files, not one that has |
| 42 |
been modified elsewhere. |
| 43 |
|
| 44 |
If you think you have found a genuine bug in a recent version of the |
| 45 |
core LaTeX software, please report it in the following way: |
| 46 |
|
| 47 |
* Prepare a *short* test file, as described above, that clearly |
| 48 |
demonstrates your problem; see below for a discussion of `short'. |
| 49 |
|
| 50 |
* Run this file through latex to obtain the transcript file |
| 51 |
(often .log) since you will need to submit this file also. |
| 52 |
|
| 53 |
|
| 54 |
Submit the test and transcript files through the Web interface at: |
| 55 |
|
| 56 |
https://github.com/latex3/latex2e/issues |
| 57 |
|
| 58 |
Please fill in all required fields; in particular, make sure |
| 59 |
that your name, email address, and the summary description |
| 60 |
are correct (the email address will not be shared or made public). |
| 61 |
|
| 62 |
|
| 63 |
|
| 64 |
|
| 65 |
|
| 66 |
DOCUMENTATION ERRORS |
| 67 |
|
| 68 |
If you find an error in one of the following books: |
| 69 |
|
| 70 |
TITLE Author Errata File |
| 71 |
|
| 72 |
The LaTeX Manual, 2ed Lamport manual.err |
| 73 |
The LaTeX Companion, 2ed Mittelbach, Goossens, et al tlc2.err |
| 74 |
The LaTeX Graphics |
| 75 |
Companion Goossens, Mittelbach, Rahtz grphcomp.err |
| 76 |
Der LaTeX Begleiter, 2ed Mittelbach, Goossens, et al lb2.err |
| 77 |
The LaTeX Web Companion Goossens, Rahtz webcomp.err |
| 78 |
|
| 79 |
|
| 80 |
then please check first whether it is already mentioned in the errata |
| 81 |
file for that book (these files are part of the LaTeX distribution). |
| 82 |
If this is not the case then please report the error to the address |
| 83 |
given in that corresponding errata file. |
| 84 |
|
| 85 |
Please *do not* send such reports to the latex-bugs address. |
| 86 |
|
| 87 |
|
| 88 |
--- Copyright (C) 1997-2021 the LaTeX Project. All rights reserved --- |