summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/base/bugs.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-02-21 23:29:27 +0000
committerKarl Berry <karl@freefriends.org>2017-02-21 23:29:27 +0000
commit516a8bbf9db95a88ce2fdd2cf3407216f67e8049 (patch)
tree8a6508ac24539e2003f1efd5c758cdcea9e6891b /Master/texmf-dist/doc/latex/base/bugs.txt
parent7714e343948bfc6ff5fd5c4b7297c229f37070fa (diff)
latex (21feb17)
git-svn-id: svn://tug.org/texlive/trunk@43287 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/base/bugs.txt')
-rw-r--r--Master/texmf-dist/doc/latex/base/bugs.txt86
1 files changed, 14 insertions, 72 deletions
diff --git a/Master/texmf-dist/doc/latex/base/bugs.txt b/Master/texmf-dist/doc/latex/base/bugs.txt
index 7a11db47d42..1f1a19acae8 100644
--- a/Master/texmf-dist/doc/latex/base/bugs.txt
+++ b/Master/texmf-dist/doc/latex/base/bugs.txt
@@ -1,6 +1,6 @@
LaTeX Error Reports
- 28 March 2005
+ January 2017
ERROR REPORTS
@@ -8,7 +8,8 @@ Before you report an error, please check that:
* Your LaTeX system is not too old, i.e., your version is the
current or the previous release. Information about the latest
- release can be found at http://www.latex-project.org/ltnews/.
+ release can be found at
+ http://www.latex-project.org/news/latex2e-news/
* The error is not already mentioned in the documentation of the
distribution, e.g. in a .dtx file (in this case it is a feature :-).
@@ -16,11 +17,11 @@ Before you report an error, please check that:
* The error has not already been reported. If you have WWW
access, you can search the LaTeX bugs database using this URL:
- http://www.latex-project.org/bugs.html
+ https://www.latex-project.org/bugs.html
* The error is not caused by software other than the core LaTeX
software that is produced and maintained by the LaTeX3 project
- team. please report problems with other software to the authors
+ team. Please report problems with other software to the authors
or suppliers of that software, and not to us!
Thus you should check that the problem is not caused by, for
@@ -29,7 +30,9 @@ Before you report an error, please check that:
Also, the test file demonstrating the error should not use any
classes or packages other than those authored and supported by the
LaTeX3 team. The files for the package or class will tell you how
- it is supported.
+ it is supported. The test file should use the package latexbug to
+ check that all packages in the file are supported by the LaTeX3
+ Project (see the discussion on the website why this is important).
* The error is not caused by using an obsolete version of any file or
of other software.
@@ -45,78 +48,17 @@ core LaTeX software, please report it in the following way:
* Run this file through latex to obtain the transcript file
(often .log) since you will need to submit this file also.
-
- * There are two ways to submit a bug report:
- a) Submit the test and transcript files through the Web interface at:
- http://www.latex-project.org/bugs-upload.html
+
+ Submit the test and transcript files through the Web interface at:
+
+ https://www.latex-project.org/bugs/bugs-upload.html
Please fill in all required fields; in particular, make sure
that your name, email address, and the summary description
- are correct.
+ are correct (the email address will not be shared or made public).
- b) Submit your bug report by electronic mail. To do this, you need to
- * Generate a bug report template by running the file
- latexbug.tex through LaTeX.
-
- * Fill in the spaces in the generated template file. Please note that
- the reporting language is *English*, irregardless of the fact that
- the address you are sending the bug report to might not be in an
- English speaking country. Reports received in a language other than
- English might not be understandable to the person currently
- looking at bug reports!
-
- * Include all necessary information, especially a complete input
- file, a complete transcript file, and all other files used (if they
- are not standard).
-
- Please check carefully to ensure that any non-standard files are
- essential to the bug; and remember that we cannot debug files not
- supplied by us.
-
- Any such non-standard files should be included in a `filecontents'
- environment at the start of your input file! This allows us to
- run your test file without a lot of manual preparation; this is
- essential since we have to deal with many reports, not just with
- the one written by you.
-
- * Please note that it is important to make the input file as short
- as possible since this will enable us to find and fix the error
- quickly. It also helps us because then we can often use it as a test
- file for future releases.
-
- We would expect most files to be less than 60 lines, and very
- rarely to be longer than 100 lines.
-
- This can often be achieved by defining a command to be some
- arbitrary text and using this several times if it is necessary
- to generate longer bits of text.
-
- Error reports concerning UNCHANGED versions of CORE LaTeX files
- which are less than five years old should be sent by E-mail to:
-
- latex-bugs@latex-project.org
-
-You will receive an acknowledgement by E-mail containing at the
-beginning of its subject line a problem reference of the form
-category/number:, e.g. latex/1234:. Please use this subject line in ALL
-further E-mails concerning the problem. Otherwise your reply will be
-categorized and filed separately from the original.
-
-
-LAYOUT PROBLEMS
-
-If you think you have found a bug or some problematic behavior that
-has been present in LaTeX for a long time (e.g., it was already in
-LaTeX 2.09) you are, of course, equally welcome to report this, using
-the above procedure. However, please note that we will normally not
-change layout decisions made in the LaTeX standard classes (which are
-derived from their 2.09 counterparts); nor will we change layout
-decisions or the behaviour of core commands, even when these are
-questionable from a typographic point of view, since such changes
-would make thousands of documents invalid. See also the file
-ltnews07.tex with regard to this policy.
@@ -142,6 +84,6 @@ given in that corresponding errata file.
Please *do not* send such reports to the latex-bugs address.
---- Copyright 1997,1998,2006,2008 the LaTeX3 project. All rights reserved ---
+--- Copyright 1997,1998,2006,2008,2017 the LaTeX3 project. All rights reserved ---