summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-11-02 22:51:17 +0000
committerKarl Berry <karl@freefriends.org>2011-11-02 22:51:17 +0000
commit6f714441a5f4ecd5bc220e2f50cc98472bc079d0 (patch)
treec82791cc9234223333f0ad5ba4712aa7f0d4286f /Master/texmf-dist/doc/generic/FAQ-en/faq-the-end.tex
parente5cd5f13085b6988a96d8e68ac5b703be949ad24 (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.tex107
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