[issue26638] Avoid warnings about missing CLI options when building documentation

Martin Panter added the comment: For the “unittest” module, I added separate text with a link: (see Warning control). Similarly for “timeit” in 2.7. Now the only Sphinx warnings I get are a handful about syntax highlighting, and two genuine ones relating to the missing -b documentation (Issue

[issue26638] Avoid warnings about missing CLI options when building documentation

Roundup Robot added the comment: New changeset 307d7568b6ae by Martin Panter in branch '3.5': Issue #26638: Mask undefined CLI options to defeat new Sphinx warnings https://hg.python.org/cpython/rev/307d7568b6ae New changeset 57f4ba6b29bf by Martin Panter in branch '3.5': Issue #26638: Work arou

[issue26638] Avoid warnings about missing CLI options when building documentation

SilentGhost added the comment: Patch (v3) is fine, except it no longer applies cleanly. I have a patch against the tip which I could upload if needed. I would also be in favour of disabling the unittest options directly, currently no link is generated and it doesn't seem like there is a strai

[issue26638] Avoid warnings about missing CLI options when building documentation

Martin Panter added the comment: Terry: the four "ini" syntax highlighting warnings were also mentioned in . In that bug, we fixed many other similar warnings, but I think we left those as being less easy to fix. One thing (other than suppress_warn

[issue26638] Avoid warnings about missing CLI options when building documentation

Terry J. Reedy added the comment: Thank you, that worked -- and should have been documented in the help output. All the sphinx dependencies were inequalities, and rebuilding worked. The devguide only says "You are expected to have installed a recent version of Sphinx on your system or in a vi

[issue26638] Avoid warnings about missing CLI options when building documentation

Zachary Ware added the comment: The syntax is ` install ""`, so in this case 'pip install "Sphinx==1.3.6"` (or `pip install "Sphinx<1.4"`) should do it for you. That ought to also take care of downgrading any other packages that need it (though I don't think there are any), or at least tell y

[issue26638] Avoid warnings about missing CLI options when building documentation

Terry J. Reedy added the comment: Only 138 warnings with 2.7. Zack, how do I downgrade. I examined the result of pip install -h but cannot see how. I presume that 'sphinx' and '1.3.6' should be combined into a '' but this latter is not defined and the things I tried, including the output fo

[issue26638] Avoid warnings about missing CLI options when building documentation

Zachary Ware added the comment: Terry: for now, you can downgrade Sphinx to 1.3.6 as it is known to build with no warnings (that's the version the Docs buildbot currently uses). -- ___ Python tracker

[issue26638] Avoid warnings about missing CLI options when building documentation

Terry J. Reedy added the comment: 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 8bac90be for #26462: F:\Python\dev\36\Doc\whatsnew\3.2.rst:2063: WARNING: Pygments lexer name 'doscon' is not known Thinking the problem was

[issue26638] Avoid warnings about missing CLI options when building documentation

Changes by Martin Panter : Added file: http://bugs.python.org/file43889/doc-warnings.v3.patch ___ Python tracker ___ ___ Python-bugs-list mail

[issue26638] Avoid warnings about missing CLI options when building documentation

Roundup Robot added the comment: New changeset 3996dd17ca21 by Martin Panter in branch '3.5': Issue #26638: Don’t link 2to3 -l option to the tarfile -l option https://hg.python.org/cpython/rev/3996dd17ca21 New changeset d7cbaaba59e8 by Martin Panter in branch 'default': Issue #26638: Merge CLI l

[issue26638] Avoid warnings about missing CLI options when building documentation

Martin Panter added the comment: This patch disables the warning, but I tend to think it is not a good long-term solution. -- Added file: http://bugs.python.org/file42482/disable-warning.patch ___ Python tracker _

[issue26638] Avoid warnings about missing CLI options when building documentation

Changes by Martin Panter : Added file: http://bugs.python.org/file42481/doc-warnings.v2.patch ___ Python tracker ___ ___ Python-bugs-list mail

[issue26638] Avoid warnings about missing CLI options when building documentation

Martin Panter added the comment: I committed the parts of my patch that improve real links in the end result. doc-warnings.v2.patch has the remaining changes which add exclamation marks to mask undefined options. -- ___ Python tracker

[issue26638] Avoid warnings about missing CLI options when building documentation

Roundup Robot added the comment: New changeset 23a884c32a39 by Martin Panter in branch '3.5': Issue #26638: Fix links to some CLI options and section headings https://hg.python.org/cpython/rev/23a884c32a39 New changeset 68b84643dffd by Martin Panter in branch 'default': Issue #26638: Merge link

[issue26638] Avoid warnings about missing CLI options when building documentation

Martin Panter added the comment: I’m not an expert on Sphinx. Maybe could help with disabling these warnings. Considering there are so many false positives, it might be best to disable the warning. Though my patch does

[issue26638] Avoid warnings about missing CLI options when building documentation

STINNER Victor added the comment: > 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

[issue26638] Avoid warnings about missing CLI options when building documentation

Martin Panter added the comment: 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. -- ___ Python tracker ___ __

[issue26638] Avoid warnings about missing CLI options when building documentation

New submission from Martin Panter: Defeat many warnings and related fixes building documentation * Mask various CLI options with exclamation marks (!) * Correct link to CLI section in zipapp * Make CLI section label in timeit less ambiguous The following warnings from unittest remain. Ideally t