From a9d59a2d83b345581f2eb0c6b7f08c091f5622f0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 29 Dec 2005 00:31:48 +0000 Subject: doc/english/F-ca git-svn-id: svn://tug.org/texlive/trunk@19 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/english/FAQ-en/html/FAQ-semanticnest.html | 49 ++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 Master/texmf-doc/doc/english/FAQ-en/html/FAQ-semanticnest.html (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-semanticnest.html') diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-semanticnest.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-semanticnest.html new file mode 100644 index 00000000000..4ee01d4c9a4 --- /dev/null +++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-semanticnest.html @@ -0,0 +1,49 @@ + +UK TeX FAQ -- question label semanticnest + +

Capacity exceeded [semantic nest ...]

+

+

+! TeX capacity exceeded, sorry [semantic nest size=100].
+...
+If you really absolutely need more capacity,
+you can ask a wizard to enlarge me.
+
+Even though TeX suggests (as always) that enlargement by a wizard +may help, this message usually results from a broken macro or bad +parameters to an otherwise working macro. +

The "semantic nest" TeX talks about is the nesting +of boxes within boxes. A stupid macro can provoke the error pretty +easily: +

+ +
+\def\silly{\hbox{here's \silly being executed}}
+\silly
+
+
+The extended traceback + +(see general advice on errors) +does help, though it does rather run on. In the case above, +the traceback consists of +
+\silly ->\hbox {
+                here's \silly being executed}
+
+followed by 100 instances of +
+\silly ->\hbox {here's \silly 
+                              being executed}
+
+The repeated lines are broken at exactly the offending macro; of +course the loop need not be as simple as this - if \silly calls +\dopy which boxes \silly, the effect is just the same and +alternate lines in the traceback are broken at alternate positions. +

There are in fact two items being consumed when you nest boxes: the +other is the grouping level. Whether you exhaust your +semantic nest or your permitted grouping levels first is +controlled entirely by the relative size of the two different sets of +buffers in your (La)TeX executable. +

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=semanticnest + -- cgit v1.2.3