diff options
author | Karl Berry <karl@freefriends.org> | 2006-08-27 18:16:22 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-08-27 18:16:22 +0000 |
commit | 4ab3220f33f1983f5aff7b7253ad229e44c952fe (patch) | |
tree | c9d2408cfe8c113537c0031bc7e50bda98a262dc /Master/texmf-dist/doc/latex/base/bugs.txt | |
parent | 6e05e1819838930d7f7e4eb36620d2994a45b97b (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.txt | 132 |
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 --- + + |