RTD builds of Sphinx own PDF docs do not do enough pdflatex runs

[jfbu]

From http://readthedocs.org/projects/sphinx/builds/5413951/ one sees

pdflatex -interaction=nonstopmode /home/docs/checkouts/readthedocs.org/user_builds/sphinx/checkouts/1.6-release/doc/_build/latex/sphinx.tex
makeindex -s python.ist sphinx.idx
pdflatex -interaction=nonstopmode /home/docs/checkouts/readthedocs.org/user_builds/sphinx/checkouts/1.6-release/doc/_build/latex/sphinx.tex

but there should be 2 pdflatex runs after the makeindex: else there will (and is) no index entry at end of table of contents, as one can confirm at https://media.readthedocs.org/pdf/sphinx/1.6-release/sphinx.pdf, and this applies also to the bookmarks of the pdf.

I think the back links from the index are ok from 1 pdflatex + makeindex + 2 pdflatex but I have not checked thoroughly.

Best for RTD builds would be to use make latexpdf from Sphinx, which uses latexmk rather than the above recipes.

This is not Sphinx issue per se, but I did not know where better to report. The remark will apply to any project having a general index if PDF build does only 1 pdflatex + makeindex + 1 pdflatex. (in a clean repertory) I am not familiar with how RTD is configured for Sphinx doc.

[tk0miya]

I might be wrong, but the source code of readthedocs is hosted at https://github.com/rtfd/readthedocs.org .
So you should report this into the repository.

Thanks,

[jfbu]

This appears to be indeed a general RTD issue. I will add a comment to the discussion there.

edit I moved my comment to readthedocs/readthedocs.org#1583 (comment) which seems better suited.

[jfbu]

Temporary workaround at 6422f7b. Opened a new ticket readthedocs/readthedocs.org#2857 at RTD.

(fixed flake8 at b18a3f8)