summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/base/bugs.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-08-27 18:16:22 +0000
committerKarl Berry <karl@freefriends.org>2006-08-27 18:16:22 +0000
commit4ab3220f33f1983f5aff7b7253ad229e44c952fe (patch)
treec9d2408cfe8c113537c0031bc7e50bda98a262dc /Master/texmf-dist/doc/latex/base/bugs.txt
parent6e05e1819838930d7f7e4eb36620d2994a45b97b (diff)
latex core update from latex-tds (27aug06)
git-svn-id: svn://tug.org/texlive/trunk@2043 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.txt132
1 files changed, 76 insertions, 56 deletions
diff --git a/Master/texmf-dist/doc/latex/base/bugs.txt b/Master/texmf-dist/doc/latex/base/bugs.txt
index a72ba3400d2..e94487cde2a 100644
--- a/Master/texmf-dist/doc/latex/base/bugs.txt
+++ b/Master/texmf-dist/doc/latex/base/bugs.txt
@@ -1,14 +1,14 @@
LaTeX Error Reports
- 12 January 1999
+ 28 March 2005
ERROR REPORTS
-Before you report an error please check that:
+Before you report an error, please check that:
- * Your LaTeX system is not more than one year old. New LaTeX
- releases occur at 6 monthly intervals, thus your problem may
- have already been fixed.
+ * 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/.
* The error is not already fixed by a patch added recently to the
current distribution. If you have access to a CTAN archive then
@@ -24,12 +24,20 @@ 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
+ http://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
- or suppliers of that software).
+ 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
+ example, the viewer or printing software you use.
+
+ 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.
* The error is not caused by using an obsolete version of any file or
of other software.
@@ -40,58 +48,69 @@ Before you report an error please check that:
If you think you have found a genuine bug in a recent version of the
core LaTeX software, please report it in the following way:
- * Prepare a *short* test file that clearly demonstrates your
- problem; see below for a discussion of `short'.
+ * Prepare a *short* test file, as described above, that clearly
+ demonstrates your problem; see below for a discussion of `short'.
* Run this file through latex to obtain the transcript file
(often .log) since you will need to submit this file also.
- * 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 for the person currently
- looking at bug reports!
+ * 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
+
+ Please fill in all required fields; in particular, make sure
+ that your name, email address, and the summary description
+ are correct.
+
+ 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.
+ * 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.
+ 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.
+ 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 one year old should be sent by E-mail to:
+ 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
+ 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
+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.
+categorized and filed separately from the original.
LAYOUT PROBLEMS
@@ -113,16 +132,15 @@ DOCUMENTATION ERRORS
If you find an error in one of the following books:
- TITLE Author Errata File
+ TITLE Author Errata File
- The LaTeX Manual Lamport manual.err
- The LaTeX Companion Goossens, Mittelbach, Samarin compan.err
+ The LaTeX Manual, 2ed Lamport manual.err
+ The LaTeX Companion, 2ed Mittelbach, Goossens, et al tlc2.err
The LaTeX Graphics
- Companion Goossens, Mittelbach, Rahtz grphcomp.err
- Das LaTeX Handbuch Lamport handbuch.err
- Der LaTeX Begleiter Goossens, Mittelbach, Samarin begleit.err
- The LaTeX Web Goossens, Rahtz webcomp.err
- Companion
+ Companion Goossens, Mittelbach, Rahtz grphcomp.err
+ Der LaTeX Begleiter, 2ed Mittelbach, Goossens, et al lb2.err
+ The LaTeX Web Companion Goossens, Rahtz webcomp.err
+
then please check first whether it is already mentioned in the errata
file for that book (these files are part of the LaTeX distribution).
@@ -132,4 +150,6 @@ given in that corresponding errata file.
Please *do not* send such reports to the latex-bugs address.
---- Copyright 1997,1998 the LaTeX3 project. All rights reserved ---
+--- Copyright 1997,1998,2006 the LaTeX3 project. All rights reserved ---
+
+