summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toodeep.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toodeep.html')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toodeep.html58
1 files changed, 58 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toodeep.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toodeep.html
new file mode 100644
index 00000000000..cd84fa8cb06
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toodeep.html
@@ -0,0 +1,58 @@
+<head>
+<title>UK TeX FAQ -- question label toodeep</title>
+</head><body>
+<h3>&ldquo;Too deeply nested&rdquo;</h3>
+<p/>This error appears when you start a LaTeX list.
+<p/>LaTeX keeps track of the nesting of one list inside another. There
+is a set of list formatting parameters built-in for application to
+each of the list nesting levels; the parameters determine indentation,
+item separation, and so on. The <code>list</code> environment (the
+basis for list environments like <code>itemize</code> and
+<code>enumerate</code>) &ldquo;knows&rdquo; there are only 6 of these sets.
+<p/>There are also different label definitions for the
+<code>enumerate</code> and <code>itemize</code> environments at
+their own private levels of nesting. Consider this example:
+<blockquote>
+<pre>
+\begin{enumerate}
+\item first item of first enumerate
+ \begin{itemize}
+ \item first item of first itemize
+ \begin{enumerate}
+ \item first item of second enumerate
+ ...
+ \end{enumerate}
+ ...
+ \end{itemize}
+...
+\end{enumerate}
+</pre>
+</blockquote><p>
+In the example,
+<ul>
+<li> the first <code>enumerate</code> has labels as for a
+ first-level <code>enumerate</code>, and is indented as for a
+ first-level list;
+<li> the first <code>itemize</code> has labels as for a first level
+ <code>itemize</code>, and is indented as for a second-level list;
+ and
+<li> the second <code>enumerate</code> has labels as for a
+ second-level <code>enumerate</code>, and is indented as for a
+ third-level list.
+</ul>
+Now, as well as LaTeX <em>knowing</em> that there are 6 sets of
+parameters for indentation, it also <em>knows</em> that there are only
+4 types of labels each, for the environments <code>enumerate</code>
+and <code>itemize</code> (this &ldquo;knowledge&rdquo; spells out a requirement
+for class writers, since the class supplies the sets of parameters).
+<p/>From the above, we can deduce that there are several ways we can run
+out of space: we can have 6 lists (of any sort) nested, and try to
+start a new one; we can have 4 <code>enumerate</code> environments
+somewhere among the set of nested lists, and try to add another one;
+and we can have 4 <code>itemize</code> environments somewhere among
+the set of nested lists, and try to add another one.
+<p/>What can be done about the problem? Not much, short of rewriting
+LaTeX &mdash; you really need to rewrite your document in a slightly
+less labyrinthine way.
+<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=toodeep">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=toodeep</a>
+</body>