Message 263405 - Python tracker

➜

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.

In-reply-to
Author	vstinner
Recipients	docs@python, martin.panter, vstinner
Date	2016年04月14日.12:52:19
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1460638339.46.0.926901334261.issue26638@psf.upfronthosting.co.za>

Content
> FTR the warnings that I am fixing were apparently enabled in Sphinx 1.3.4, reverted in 1.3.6, and added in 1.4. Would it be possible to turn off the warning? Doc/using/cmdline.py uses ".. cmdoption::". If we cannot turn off the warning on option, maybe we should use a new :cmdoption:`xxx` which wouldn't emit a warning? I'm not strongly opposed to doc-warnings.patch. I understand that Sphinx expects the exact option, for example -W, whereas the doc uses option with parameter like -Wd. Sphinx is unable to link to the option. Maybe we need something like :cmdoption:`-Wd <-W>`: display -Wd but link to -W?

Content

> FTR the warnings that I am fixing were apparently enabled in Sphinx 1.3.4, reverted in 1.3.6, and added in 1.4.
Would it be possible to turn off the warning?
Doc/using/cmdline.py uses ".. cmdoption::". If we cannot turn off the warning on option, maybe we should use a new :cmdoption:`xxx` which wouldn't emit a warning?
I'm not strongly opposed to doc-warnings.patch.
I understand that Sphinx expects the exact option, for example -W, whereas the doc uses option with parameter like -Wd. Sphinx is unable to link to the option.
Maybe we need something like :cmdoption:`-Wd <-W>`: display -Wd but link to -W?

History
Date	User	Action	Args
2016年04月14日 12:52:19	vstinner	set	recipients: + vstinner, docs@python, martin.panter
2016年04月14日 12:52:19	vstinner	set	messageid: <1460638339.46.0.926901334261.issue26638@psf.upfronthosting.co.za>
2016年04月14日 12:52:19	vstinner	link	issue26638 messages
2016年04月14日 12:52:19	vstinner	create

homepage