Opened 5 years ago

Closed 5 years ago

Last modified 5 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: UI/UX:

Description

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

Change History (2)

comment:1 Changed 5 years ago by brosner

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Resolution set to wontfix
  • Status changed from new to closed

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)

comment:2 Changed 5 years ago by jezdez

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