astropy/astropy — pull request #485 by mdboom (2012-11-16 19:28:23+00:00)
Title: Building LaTeX docs fails

If I try and build the LaTeX version of the Astropy docs, in order to make a PDF file, I run into issues. Running

```
make latexpdf
```

results in

```
[snip]
Running LaTeX files through pdflatex...
make -C _build/latex all-pdf
pdflatex 'Astropy.tex'
This is pdfTeX, Version 3.1415926-2.3-1.40.12 (TeX Live 2011)
restricted \write18 enabled.
entering extended mode
(./Astropy.tex
LaTeX2e <2009/09/24>
Babel and hyphenation patterns for english, dumylang, nohyphenation, ge
rman-x-2009-06-19, ngerman-x-2009-06-19, afrikaans, ancientgreek, ibycus, arabi
c, armenian, basque, bulgarian, catalan, pinyin, coptic, croatian, czech, danis
h, dutch, ukenglish, usenglishmax, esperanto, estonian, ethiopic, farsi, finnis
h, french, galician, german, ngerman, swissgerman, monogreek, greek, hungarian,
icelandic, assamese, bengali, gujarati, hindi, kannada, malayalam, marathi, or
iya, panjabi, tamil, telugu, indonesian, interlingua, irish, italian, kurmanji,
lao, latin, latvian, lithuanian, mongolian, mongolianlmc, bokmal, nynorsk, pol
ish, portuguese, romanian, russian, sanskrit, serbian, serbianc, slovak, sloven
ian, spanish, swedish, turkish, turkmen, ukrainian, uppersorbian, welsh, loaded
.
(./sphinxmanual.cls
Document Class: sphinxmanual 2009/06/02 Document class (Sphinx manual)
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/report.cls
Document Class: report 2007/10/19 v1.4h Standard LaTeX document class
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/size10.clo)))
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/inputenc.sty
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/utf8.def
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/t1enc.dfu)
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/ot1enc.dfu)
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/omsenc.dfu)))
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/fontenc.sty
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/t1enc.def))
(/usr/local/texlive/2011/texmf-dist/tex/generic/babel/babel.sty
(/usr/local/texlive/2011/texmf-dist/tex/generic/babel/english.ldf
(/usr/local/texlive/2011/texmf-dist/tex/generic/babel/babel.def)))
(/usr/local/texlive/2011/texmf-dist/tex/latex/psnfss/times.sty) (./fncychap.sty
) (/usr/local/texlive/2011/texmf-dist/tex/latex/tools/longtable.sty)
(./sphinx.sty (/usr/local/texlive/2011/texmf-dist/tex/latex/base/textcomp.sty
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/ts1enc.def
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/ts1enc.dfu)))
(/usr/local/texlive/2011/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/fancybox/fancybox.sty
Style option: `fancybox' v1.4 <2010/05/15> (tvz)
) (/usr/local/texlive/2011/texmf-dist/tex/latex/titlesec/titlesec.sty)
(./tabulary.sty (/usr/local/texlive/2011/texmf-dist/tex/latex/tools/array.sty))
(/usr/local/texlive/2011/texmf-dist/tex/latex/amsmath/amsmath.sty
For additional information on amsmath, use the `?' option.
(/usr/local/texlive/2011/texmf-dist/tex/latex/amsmath/amstext.sty
(/usr/local/texlive/2011/texmf-dist/tex/latex/amsmath/amsgen.sty))
(/usr/local/texlive/2011/texmf-dist/tex/latex/amsmath/amsbsy.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/amsmath/amsopn.sty))
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/makeidx.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/framed/framed.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/ifthen.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/graphics/color.sty
(/usr/local/texlive/2011/texmf-dist/tex/latex/latexconfig/color.cfg)
(/usr/local/texlive/2011/texmf-dist/tex/latex/pdftex-def/pdftex.def
(/usr/local/texlive/2011/texmf-dist/tex/generic/oberdiek/infwarerr.sty)
(/usr/local/texlive/2011/texmf-dist/tex/generic/oberdiek/ltxcmds.sty)))
(/usr/local/texlive/2011/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty
Style option: `fancyvrb' v2.7a, with DG/SPQR fixes, and firstline=lastline fix
<2008/02/07> (tvz)
(/usr/local/texlive/2011/texmf-dist/tex/latex/graphics/keyval.sty))
(/usr/local/texlive/2011/texmf-dist/tex/latex/threeparttable/threeparttable.sty
) (/usr/local/texlive/2011/texmf-dist/tex/latex/mdwtools/footnote.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/wrapfig/wrapfig.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/parskip/parskip.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/graphics/graphicx.sty
(/usr/local/texlive/2011/texmf-dist/tex/latex/graphics/graphics.sty
(/usr/local/texlive/2011/texmf-dist/tex/latex/graphics/trig.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/latexconfig/graphics.cfg)))
(/usr/local/texlive/2011/texmf-dist/tex/plain/misc/pdfcolor.tex)
(/usr/local/texlive/2011/texmf-dist/tex/latex/hyperref/hyperref.sty
(/usr/local/texlive/2011/texmf-dist/tex/generic/oberdiek/hobsub-hyperref.sty
(/usr/local/texlive/2011/texmf-dist/tex/generic/oberdiek/hobsub-generic.sty))
(/usr/local/texlive/2011/texmf-dist/tex/generic/ifxetex/ifxetex.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/oberdiek/kvoptions.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/hyperref/pd1enc.def)
(/usr/local/texlive/2011/texmf-dist/tex/latex/latexconfig/hyperref.cfg)
(/usr/local/texlive/2011/texmf-dist/tex/latex/url/url.sty))

Package hyperref Message: Driver (autodetected): hpdftex.

(/usr/local/texlive/2011/texmf-dist/tex/latex/hyperref/hpdftex.def
(/usr/local/texlive/2011/texmf-dist/tex/latex/oberdiek/rerunfilecheck.sty))
(/usr/local/texlive/2011/texmf-dist/tex/latex/oberdiek/hypcap.sty))
(/usr/local/texlive/2011/texmf-dist/tex/latex/multirow/multirow.sty)
Writing index file Astropy.idx
No file Astropy.aux.
(/usr/local/texlive/2011/texmf-dist/tex/latex/base/ts1cmr.fd)
(/usr/local/texlive/2011/texmf-dist/tex/latex/psnfss/t1ptm.fd)
(/usr/local/texlive/2011/texmf-dist/tex/context/base/supp-pdf.mkii
[Loading MPS to PDF converter (version 2006.09.02).]
) (/usr/local/texlive/2011/texmf-dist/tex/latex/oberdiek/epstopdf-base.sty
(/usr/local/texlive/2011/texmf-dist/tex/latex/oberdiek/grfext.sty)
(/usr/local/texlive/2011/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg))
(/usr/local/texlive/2011/texmf-dist/tex/latex/hyperref/nameref.sty
(/usr/local/texlive/2011/texmf-dist/tex/generic/oberdiek/gettitlestring.sty))
Underfull \hbox (badness 10000) in paragraph at lines 113--113

(/usr/local/texlive/2011/texmf-dist/tex/latex/psnfss/t1phv.fd) [1{/usr/local/te
xlive/2011/texmf-var/fonts/map/pdftex/updmap/pdftex.map}] [2]
Adding blank page after the table of contents.
pdfTeX warning (ext4): destination with the same identifier (name{page.i}) has
been already used, duplicate ignored

\relax
l.113 \tableofcontents
[1]pdfTeX warning (ext4): destination with the same iden
tifier (name{page.ii}) has been already used, duplicate ignored

\relax
l.113 \tableofcontents
[2]

[1 <./astropy_banner_96
.png>] [2]
Chapter 1.
(/usr/local/texlive/2011/texmf-dist/tex/latex/psnfss/t1pcr.fd)

LaTeX Warning: Hyper reference `overview:user-docs' on page 3 undefined on inpu
t line 149.

LaTeX Warning: Hyper reference `configs/index:module-astropy.config' on page 3
undefined on input line 168.

[3] (/usr/local/texlive/2011/texmf-dist/tex/latex/psnfss/ts1ptm.fd) [4]

LaTeX Warning: Hyper reference `install:developer-docs' on page 5 undefined on
input line 292.

[5]
Underfull \hbox (badness 10000) in paragraph at lines 358--359

[6]

LaTeX Warning: Hyper reference `development/testguide:running-tests' on page 7
undefined on input line 466.

LaTeX Warning: Hyper reference `nddata/index:module-astropy.nddata' on page 7 u
ndefined on input line 478.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 7 undefined on input line 478.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 7 undefined on input line 488.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 7 undefined on input line 495.

[7]

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 8 undefined on input line 534.

LaTeX Warning: Hyper reference `nddata/nddata::doc' on page 8 undefined on inpu
t line 536.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 8 undefined on input line 547.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 8 undefined on input line 556.

[8]

LaTeX Warning: Hyper reference `_generated/astropy.nddata.flag_collection.FlagC
ollection:astropy.nddata.flag_collection.FlagCollection' on page 9 undefined on
input line 600.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 9 undefined on input line 631.

LaTeX Warning: Hyper reference `nddata/subclassing::doc' on page 9 undefined on
input line 643.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 9 undefined on input line 650.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 9 undefined on input line 652.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData.add' on page 9 undefined on input line 659.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData.subtract' on page 9 undefined on input line 660.

[9]
Underfull \hbox (badness 10000) in paragraph at lines 669--670

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 10 undefined on input line 674.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 10 undefined on input line 692.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 10 undefined on input line 704.

Underfull \hbox (badness 5970) in paragraph at lines 725--728
[]\T1/pcr/m/n/10 astropy.nddata \T1/ptm/m/n/10 in-cludes a con-vo-lu-tion func-
tion that of-fers im-prove-ments com-pared to the scipy

[10]

LaTeX Warning: Hyper reference `_generated/astropy.nddata.convolution.convolve.
convolve:astropy.nddata.convolution.convolve.convolve' on page 11 undefined on
input line 783.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.convolution.convolve.
convolve_fft:astropy.nddata.convolution.convolve.convolve_fft' on page 11 undef
ined on input line 784.

[11 <./original.png> <./scipy.png> <./astropy.png>]

LaTeX Warning: Hyper reference `_generated/astropy.nddata.convolution.make_kern
el.make_kernel:astropy.nddata.convolution.make_kernel.make_kernel' on page 12 u
ndefined on input line 861.

[12]

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 13 undefined on input line 909.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 13 undefined on input line 911.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nduncertainty.StdDevU
ncertainty:astropy.nddata.nduncertainty.StdDevUncertainty' on page 13 undefined
on input line 936.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.nddata.NDData:astropy
.nddata.nddata.NDData' on page 13 undefined on input line 948.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.convolution.convolve.
convolve:astropy.nddata.convolution.convolve.convolve' on page 13 undefined on
input line 973.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.convolution.convolve.
convolve_fft:astropy.nddata.convolution.convolve.convolve_fft' on page 13 undef
ined on input line 978.

LaTeX Warning: Hyper reference `_generated/astropy.nddata.convolution.make_kern
el.make_kernel:astropy.nddata.convolution.make_kernel.make_kernel' on page 13 u
ndefined on input line 983.

Overfull \hbox (410.13806pt too wide) in alignment at lines 970--987
[] []

Package longtable Warning: Column widths have changed
(longtable) in table 1.1 on input line 987.

Underfull \hbox (badness 10000) in paragraph at lines 995--995
[]\T1/ptm/m/it/10 array\T1/ptm/m/n/10 , \T1/ptm/m/it/10 ker-nel\T1/ptm/m/n/10 ,
\T1/ptm/m/it/10 bound-ary=None\T1/ptm/m/n/10 ,
[13]

! LaTeX Error: Too deeply nested.

See the LaTeX manual or LaTeX Companion for explanation.
Type H for immediate help.
...

l.1024 \item {} \begin{description}

?
```

If anyone would be interested in debugging this, it would be valuable for the long term.