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.tex55
1 files changed, 50 insertions, 5 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 598b70649a9..3281e54a18e 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.24 2013/04/18 23:01:08 rf10 Exp rf10 $
+% $Id: faq-jot-err.tex,v 1.25 2014/01/28 18:17:36 rf10 Exp rf10 $
\section{The joy of \TeX{} errors}
@@ -1850,10 +1850,12 @@ there is probably something wrong with the class file.
\end{verbatim}
\end{wideversion}
\end{quote}
-is reporting something pretty fundamental (document base font size not
-set up). While this \emph{can}, as the message implies, be due to a
-broken class file, the more common cause is that you have simply
-forgotten to put a \csx{documentclass} command in your document.
+reports something pretty fundamental (document base font size has not
+been set, something the document class does for you). It \emph{can},
+in principle, be a problem with the document class, but is more often
+caused by the user forgetting to start their document with a
+\csx{documentclass} command.
+\LastEdit{2013-11-20}
\Question[Q-manymathalph]{Too many math alphabets}
@@ -2178,6 +2180,49 @@ This author has also encountered the error when developing macros that
used the \LaTeX{} internal float mechanisms. Most people doing that
sort of thing are expected to be able to work out their own problems\dots{}
+\Question[Q-parmoderr]{Not in outer par mode}
+
+For example:
+\begin{quote}
+\begin{verbatim}
+*\mbox{\marginpar{foo}}
+
+! LaTeX Error: Not in outer par mode.
+\end{verbatim}
+\end{quote}
+The error comes when you try to build something movable inside a box.
+Movable things, in this context, are floating environments
+(\environment{figure} and \environment{table}, for example), and
+\csx{marginpar}s. \latex{} simply doesn't have the mechanisms for
+floating out of boxes. In fact, floats and \csx{marginpar}s
+themselves are built out of boxes, so that they can't be nested.
+
+If your error arises from \csx{marginpar}, you simply have to think of
+an alternative way of placing the command; there is no slick solution.
+
+If a floating environment is the culprit, it may be possible to use
+the ``\texttt{H}'' placement option, provided (for example) by the
+\Package{float} package:
+\begin{quote}
+\begin{verbatim}
+\parbox{25cm}{%
+ \begin{figure}[H]
+ ...
+ \caption{Apparently floating...}
+ \end{figure}%
+}
+\end{verbatim}
+\end{quote}
+This example makes little sense as it stands; however, it is
+conceivable that sane uses could be found (for example, using a
+package such as \Package{algorithm2e} to place two algorithms
+side-by-side).
+\begin{ctanrefs}
+\item[algorithm2e.sty]\CTANref{algorithm2e}
+\item[float.sty]\CTANref{float}
+\end{ctanrefs}
+\LastEdit{2013-09-09}
+
\Question[Q-texorpdf]{Token not allowed in PDFDocEncoded string}
The package \Package{hyperref} produces this error when it doesn't