trunk/base/bugs.txt

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