make html fails at pip log

[mccolgst@…]

I was using an make html on django 1.2's docs, and it always failed during 'reading sources' at 31% (pip log)

First it said:
Django-1.2-beta-1/docs/pip-log.txt:605: (SEVERE/4) Missing matching underline for section title overline.

So I went in, removed the preceding line from the '-----------------------------' line, (which was line 604), and tried again, getting this error:

/home/sean/dev/django/Django-1.2-beta-1/docs/pip-log.txt:633: (SEVERE/4) Missing matching underline for section title overline.

So I did the same and removed line 632

Then it made the html just fine.
Figured I'd just put that in in case anyone else has that trouble.

Thanks

[Brian Rosner]

I would recommend deleting pip-log.txt as Sphinx is picking it up. Django uses .txt for documentation file extension. I simply don't see this as being a common enough case to warrant exclusion. Take a look at log-file option for pip. You can set it in the [global] section of ~/.pip/pip.conf to point somewhere else (see ​http://pip.openplans.org/configuration.html). By default it is . hence the pip-log.txt in your docs directory (likely from installing Sphinx there)

[Jannis Leidel]

Gladly, pip will soon default to ~/.pip/pip.log as the log file location, instead of pwd/pip-log.txt.