homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author terry.reedy
Recipients docs@python, eric.araujo, ezio.melotti, georg.brandl, martin.panter, python-dev, terry.reedy, vstinner, zach.ware
Date 2016年08月24日.20:18:53
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1472069933.83.0.453472828517.issue26638@psf.upfronthosting.co.za>
In-reply-to
Content
I built the 3.5 docs on Win10 with Sphinx 1.3.3 and corresponding dependencies and got a new warning as a result of 8ba0000c90be for #26462:
F:\Python\dev36円\Doc\whatsnew3円.2.rst:2063: WARNING: Pygments lexer name 'doscon' is not known
Thinking the problem was an out-of-date pygments module, I updated sphinx and dependencies (to 1.4.6, etc). I was right that updating pygments fixed the warning above, but now I get 140 warnings!!!
4 are from the reading phase for configparser.rst. The first:
F:\Python\dev35円\Doc\library\configparser.rst:240: WARNING: Could not lex literal_block as "ini". Highlighting skipped.
I presume this could be fixed, but I don't know how.
136 are about "<path: WARNING: unknown option: -x."
Sphinx, at least with how we use it, and the Python docs are out of sync here. I think we need more eyes on this.
"This patch disables the warning," ??? Not here.
" but I tend to think it is not a good long-term solution."
Printing 136 warnings is also not a good solution. I rebuilt the docs locally because I was planning to patch a misspelling I found while reading the doc. Looking in a list of several pages for a warning I might have caused is failure-prone and no fun. In the Windows console, the page-up and page-down keys do not page up and down. To not miss anything, I would have to carefully use a mouse wheel or scrollbar clicks.
I am building with "sphinx-build -bhtml . build/html" is a .bat file. Is there anything I can add to suppress only 'unknown option' warnings?
History
Date User Action Args
2016年08月24日 20:18:53terry.reedysetrecipients: + terry.reedy, georg.brandl, vstinner, ezio.melotti, eric.araujo, docs@python, python-dev, martin.panter, zach.ware
2016年08月24日 20:18:53terry.reedysetmessageid: <1472069933.83.0.453472828517.issue26638@psf.upfronthosting.co.za>
2016年08月24日 20:18:53terry.reedylinkissue26638 messages
2016年08月24日 20:18:53terry.reedycreate

AltStyle によって変換されたページ (->オリジナル) /