summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/faq-jot-err.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/faq-jot-err.tex')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/faq-jot-err.tex26
1 files changed, 17 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faq-jot-err.tex b/Master/texmf-dist/doc/generic/FAQ-en/faq-jot-err.tex
index 30e7dc88121..7bf27aba3fa 100644
--- a/Master/texmf-dist/doc/generic/FAQ-en/faq-jot-err.tex
+++ b/Master/texmf-dist/doc/generic/FAQ-en/faq-jot-err.tex
@@ -1,4 +1,4 @@
-% $Id: faq-jot-err.tex,v 1.1 2009/06/13 20:56:47 rf10 Exp rf10 $
+% $Id: faq-jot-err.tex,v 1.3 2009/12/10 20:38:28 rf10 Exp $
\section{The joy of \TeX{} errors}
@@ -1267,8 +1267,14 @@ problem is usually soluble: see % beware line break
answer also describes the problem in more detail.
If the identifier in the message is different, for example
-|name{figure.1.1}|, the problem is (usually) due to a problem of
-package interaction. Some packages are simply incompatible with
+\texttt{name\{figure.1.1\}}, the problem is (often) due to a problem of
+package interaction. The \File{README} in the \Package{hyperref}
+distribution mentions some of these issues~--- for example,
+\environment{equation} and \environment{eqnarray} as supplied by the
+\Package{amsmath} package; means of working around the problem are
+typically supplied there.
+
+Some packages are simply incompatible with
\Package{hyperref}, but most work simply by ignoring it. In most
cases, therefore, you should load your package before you load
\Package{hyperref}, and \Package{hyperref} will patch things up so
@@ -1310,7 +1316,7 @@ will use the command, patched to create `proper' hyperreferences.
\end{narrowversion}
You should load packages in this order as a matter of course, unless
the documentation of a package says you \emph{must} load it after
-\Package{hyperref}. (There aren't many packages that require to be
+\Package{hyperref}. (There are few packages that require to be
loaded after hyperref: one such is \Class{memoir}'s
``\Package{hyperref} fixup'' package \Package{memhfixc}.)
@@ -1669,12 +1675,12 @@ want to number the cells in a table, you have to do it ``by hand'':
\begin{quote}
\begin{verbatim}
\newcounter{tablecell}
+...
\begin{tabular}{l}
\stepcounter{tablecell}
\thetablecell. foo\\
\stepcounter{tablecell}
\thetablecell. bar
- \end{enumerate}
\end{tabular}
\end{verbatim}
\end{quote}
@@ -1682,6 +1688,7 @@ This is obviously untidy; a command \csx{numbercell} defined as:
\begin{quote}
\begin{verbatim}
\newcounter{tablecell}
+...
\newcommand*{\numbercell}{%
\stepcounter{tablecell}%
\thetablecell. % **
@@ -1694,14 +1701,15 @@ could make life easier:
\begin{tabular}{l}
\numbercell foo\\
\numbercell bar
- \end{enumerate}
\end{tabular}
\end{verbatim}
\end{quote}
-(Note the deliberate introduction of a space as part of the command,
-marked with asterisks.)
+Note the deliberate introduction of a space as part of the command,
+marked with asterisks. Omitted above, the code needs to set the
+counter \ltxcounter{tablecell} to zero
+(\cmdinvoke{setcounter}{tablecell}{0}) before each tabular that uses it.
-However, the error regularly appears when you would never have thought
+The error also regularly appears when you would never have thought
that a \csx{item} command might be appropriate. For example, the
seemingly innocent:
\begin{quote}