diff options
author | Karl Berry <karl@freefriends.org> | 2011-11-02 22:51:17 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-11-02 22:51:17 +0000 |
commit | 6f714441a5f4ecd5bc220e2f50cc98472bc079d0 (patch) | |
tree | c82791cc9234223333f0ad5ba4712aa7f0d4286f /Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex | |
parent | e5cd5f13085b6988a96d8e68ac5b703be949ad24 (diff) |
uk-tex-faq 3.24 (1nov11)
git-svn-id: svn://tug.org/texlive/trunk@24465 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex | 107 |
1 files changed, 53 insertions, 54 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex b/Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex index 7e6feabdb31..549315ed3be 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex +++ b/Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex @@ -1,4 +1,4 @@ -% $Id: faq-the-end.tex,v 1.1 2009/06/13 20:56:49 rf10 Exp $ +% $Id: faq-the-end.tex,v 1.2 2011/10/29 07:29:44 rf10 Exp rf10 $ \section{You're still stuck?} @@ -64,7 +64,59 @@ up to date for development purposes. \item[\nothtml{\rmfamily}\acro{FAQ} distribution]\CTANref{faq} \end{ctanrefs} +\Question[Q-bug]{What to do if you find a bug} + +For a start, make entirely sure you \emph{have} found a bug. +Double-check with books about \TeX{}, \LaTeX{}, or whatever you're using; +compare what you're seeing against the other answers above; ask every +possible person you know who has any \TeX{}-related expertise. +The reasons for all this caution are various. + +If you've found a bug in \TeX{} itself, you're a rare animal indeed. +Don Knuth is so sure of the quality of his code that he offers real +money prizes to finders of bugs; the cheques he writes are +such rare items that they are seldom cashed. If \emph{you} +think you have found a genuine fault in \TeX{} itself (or \MF{}, or the +\acro{CM} fonts, or the \TeX{}book), don't immediately write to Knuth, +however. He only looks at bugs infrequently, and even then +only after they are agreed as bugs by a small vetting team. In the +first instance, contact Barbara Beeton at the \acro{AMS} +(\Email{bnb@ams.org}), or contact +\Qref*{\acro{TUG}}{Q-TUG*}. + +If you've found a bug in \LaTeXe{}, \Qref*{report it}{Q-latexbug} +using mechanisms supplied by the \LaTeX{} team. (Please be +careful to ensure you've got a \LaTeX{} bug, or a bug in one of the +``required'' packages distributed by the \LaTeX{} team.) + +If you've found a bug in a contributed \LaTeX{} package, the best +starting place is usually to ask in the ``usual places for % ! line break +\Qref*{help on-line}{Q-gethelp}, or just possibly one of the % ! line break +\Qref*{specialised mailing lists}{Q-maillists*}. +The author of the package may well answer on-line, but if no-one +offers any help, you may stand a chance if you mail the author +(presuming that you can find an address\dots{}). + +If you've found a bug in \LaTeXo{}, or some other such unsupported +software, your only real hope is \Qref*{help on-line}{Q-gethelp}. + +Failing all else, you may need to pay for +help~--- \acro{TUG} maintains a % ! line break +\href{http://www.tug.org/consultants.html}{register of \TeX{} consultants}. +(This of course requires that you have the resources~--- and a +pressing enough need~--- to hire someone.) + + +\htmlignore +\par +\endhtmlignore \Question[Q-latexbug]{Reporting a \LaTeX{} bug} +\htmlignore +\par +\endhtmlignore +% +% This here isn't a reference to a question... +\label{lastquestion} The \LaTeX{} team supports \LaTeX{}, and will deal with % beware line wrap @@ -129,59 +181,6 @@ that members of the \LaTeX{} team \emph{need} your name and email address, as they may need to discuss the bug with you, or to advise you of a work-around. -\htmlignore -\par -\endhtmlignore -\Question[Q-bug]{What to do if you find a bug} -\htmlignore -\par -\endhtmlignore -% -% This here isn't a reference to a question... -\label{lastquestion} - -For a start, make entirely sure you \emph{have} found a bug. -Double-check with books about \TeX{}, \LaTeX{}, or whatever you're using; -compare what you're seeing against the other answers above; ask every -possible person you know who has any \TeX{}-related expertise. -The reasons for all this caution are various. - -If you've found a bug in \TeX{} itself, you're a rare animal indeed. -Don Knuth is so sure of the quality of his code that he offers real -money prizes to finders of bugs; the cheques he writes are -such rare items that they are seldom cashed. If \emph{you} -think you have found a genuine fault in \TeX{} itself (or \MF{}, or the -\acro{CM} fonts, or the \TeX{}book), don't immediately write to Knuth, -however. He only looks at bugs infrequently, and even then -only after they are agreed as bugs by a small vetting team. In the -first instance, contact Barbara Beeton at the \acro{AMS} -(\Email{bnb@ams.org}), or contact -\Qref*{\acro{TUG}}{Q-TUG*}. - -If you've found a bug in \LaTeXe{}, \Qref*{report it}{Q-latexbug} -using mechanisms supplied by the \LaTeX{} team. (Please be -careful to ensure you've got a \LaTeX{} bug, or a bug in one of the -``required'' packages distributed by the \LaTeX{} team.) - -If you've found a bug in a contributed \LaTeX{} package, you could try -contacting the author (if you can find a contact address). However, -it's generally best to treat any package as unsupported, in the first -instance, and only try the author \emph{after} mailing list/news group -support has failed you. - -If you've found a bug in \LaTeXo{}, or some other such unsupported -software, you may find help or -\emph{de facto} support on a newsgroup such as -\Newsgroup{comp.tex.tex} or on a mailing list such as -\mailto{texhax@tug.org}; be careful to include a % ! line wrap -\Qref*{code example}{Q-minxampl} of the -failure, if relevant. - -Failing all else, you may need to pay for -help~--- \acro{TUG} maintains a % ! line break -\href{http://www.tug.org/consultants.html}{register of \TeX{} consultants}. - - %%% Local Variables: %%% mode: latex %%% TeX-master: t |