[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: thanks much for the commit -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubsc

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Éric Araujo added the comment: Georg said LGTM, I applied the patches. Thanks! -- resolution: -> fixed stage: patch review -> committed/rejected status: open -> closed ___ Python tracker _

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Roundup Robot added the comment: New changeset 9dc653f48357 by Éric Araujo in branch '3.3': Fix note markup (#16805). http://hg.python.org/cpython/rev/9dc653f48357 New changeset 44e815a33ae3 by Éric Araujo in branch 'default': Merge 3.3 (#16805) http://hg.python.org/cpython/rev/44e815a33ae3 ---

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Roundup Robot added the comment: New changeset ca43fa662b0d by Éric Araujo in branch '2.7': Fix note markup (#16805). http://hg.python.org/cpython/rev/ca43fa662b0d -- nosy: +python-dev ___ Python tracker __

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: BTW, these patches still apply, one to 2.7 and another to 3.3 and 3.4. They are pretty much harmless, so do not be afraid to accept them. -- ___ Python tracker _

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Changes by Tshepang Lekhonkhobe : Removed file: http://bugs.python.org/file28482/remove-directives-warnings-3.2.diff ___ Python tracker ___ _

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Éric Araujo added the comment: An additional reason is that docs of branches in security mode are not rebuilt and published, so changes would be useless. -- ___ Python tracker _

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: @murray thanks for the clarification; I saw that part of the devguide, but wasn't sure if doc fixes/improvements were exempt (even if not mentioned) -- ___ Python tracker __

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

R. David Murray added the comment: Tshepang: see the 'Development Cycle' section of the devguide. Only security related commits are allowed to security branches, and since the docs are part of the source tree, that means no doc commits. One reason for this is the same reason we only have one

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Georg Brandl added the comment: Please do not comment on policies if you don't understand our release system. -- ___ Python tracker ___ __

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: Ok. I thought doc fixes were exempt. Strange policy there. -- ___ Python tracker ___ ___ Pytho

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Ezio Melotti added the comment: 3.2 only gets security fixes. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: @ezio why remove 3.2 from applicable versions -- ___ Python tracker ___ ___ Python-bugs-list m

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Changes by Ezio Melotti : -- nosy: +ezio.melotti stage: -> patch review type: -> behavior versions: -Python 3.2 ___ Python tracker ___

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: ping -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pyt

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Changes by Éric Araujo : -- nosy: +eric.araujo ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pyth

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Georg Brandl added the comment: LGTM. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: And this one patch applies to 2.7. -- versions: +Python 2.7, Python 3.2 Added file: http://bugs.python.org/file28483/remove-directives-warnings-2.7.diff ___ Python tracker __

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: The previous patch applies cleanly to 3.3 and 3.4. I am now attaching one that applies cleanly to 3.2. -- versions: +Python 3.3 Added file: http://bugs.python.org/file28482/remove-directives-warnings-3.2.diff _

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: I have tested the attached patch using official tools (make -C Doc html) and the only differences, between before and after, are: * The genindex files, where some of the keywords that are duplicated in the documentation would end up getting randomly swap

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Sandro Tosi added the comment: On Sat, Dec 29, 2012 at 4:07 PM, Tshepang Lekhonkhobe wrote: >> no-one has done the work of testing, preparation and migration: do you >> volunteer? :) > > What needs doing exactly? I would volunteer if guided. I normally (you always can't expect to be guided) it'

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: > no-one has done the work of testing, preparation and migration: do you > volunteer? :) What needs doing exactly? I would volunteer if guided. I normally build with the Debian-provided tools, and the docs look good, all but those note directive errors. A

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Sandro Tosi added the comment: On Sat, Dec 29, 2012 at 4:33 AM, Tshepang Lekhonkhobe wrote: > It is my preference to be able to build all of CPython with the > already-installed distro packages, instead of pulling in foreign ones. IMO, I think with a project as bit as CPython, you should leave

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: docutils 0.8.1-8 -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: htt

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Georg Brandl added the comment: In this case it's more of a docutils version problem, I would guess. Tshepang, can you find out your docutils version? But "proper" use of the note directive is with an empty line, so we should fix these instances anyway. -- nosy: +georg.brandl ___

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Tshepang Lekhonkhobe added the comment: It is my preference to be able to build all of CPython with the already-installed distro packages, instead of pulling in foreign ones. Any reason why not use later versions? Can't the docs be written such that they can run on various versions of these tools

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

Sandro Tosi added the comment: Hello Tshepang, the documentation is not compatible with Sphinx versions different than the one the Makefile will download (in this case it's 1.0.7 for all active branches). I'd suggest to build the doc with just $ make -C Doc html and it will fetch the needed m

[issue16805] when building docs on Debian 7 --> ERROR: Error in "note" directive

New submission from Tshepang Lekhonkhobe: I am running Debian 7, which has sphinx is1.1.3+dfsg-4. When I run $ python tools/sphinx-build.py -bhtml . build/ I get a whole bunch of errors: Making output directory... Running Sphinx v1.1.3 loading pickled environment... not yet created building [