Opened 14 years ago

Closed 14 years ago

Last modified 14 years ago

#13238 closed (wontfix)

make html fails at pip log

Reported by: mccolgst@… Owned by: nobody
Component: Documentation Version: 1.2-beta
Severity: Keywords: make html
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no


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.


Change History (2)

comment:1 by Brian Rosner, 14 years ago

Resolution: wontfix
Status: newclosed

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 By default it is . hence the pip-log.txt in your docs directory (likely from installing Sphinx there)

comment:2 by Jannis Leidel, 14 years ago

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

Note: See TracTickets for help on using tickets.
Back to Top