[issue12415] Missing: How to checkout the Doc sources

Sandro Tosi added the comment: Éric: I've just committed your patch, with also the latest changes. Philip: In order to be consistent with the way the documentation is compiled on the Python platform, the svn checkout must be used: else if you refer to the upstream website, a contributor can ch

[issue12415] Missing: How to checkout the Doc sources

Roundup Robot added the comment: New changeset e0d68c73e351 by Sandro Tosi in branch 'default': Issue #12415: describe where the documentation files are (patch by Éric Araujo) http://hg.python.org/devguide/rev/e0d68c73e351 -- nosy: +python-dev ___ Pyt

[issue12415] Missing: How to checkout the Doc sources

Philip Olson added the comment: I think you should make the commit. Also, the aforementioned [old] Subversion reference for Sphinx is a real issue here. And I think the "Without make" section should link to http://sphinx.pocoo.org/ -- ___ Python

[issue12415] Missing: How to checkout the Doc sources

Éric Araujo added the comment: Any comment on my last message? -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscrib

[issue12415] Missing: How to checkout the Doc sources

Éric Araujo added the comment: > I think "documentation sources" is a bit vague. I don’t know. I probably wrote it under the assumption that the audience of this doc was developers, who already know that programmers don’t write HTML manually but generate it, and just need to know where to fin

[issue12415] Missing: How to checkout the Doc sources

Ezio Melotti added the comment: +The documentation sources are part of the main :ref:`CPython Mercurial +repository `. I think "documentation sources" is a bit vague. If the goal is enable people to find those files, IMHO it would be better to state explicitly that there are bunch of rst fil

[issue12415] Missing: How to checkout the Doc sources

Sandro Tosi added the comment: that looks ok to me. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://

[issue12415] Missing: How to checkout the Doc sources

Changes by Éric Araujo : Added file: http://bugs.python.org/file24249/metadoc-where-are-the-sources.diff ___ Python tracker ___ ___ Python-bug

[issue12415] Missing: How to checkout the Doc sources

Éric Araujo added the comment: Please review. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.p

[issue12415] Missing: How to checkout the Doc sources

Changes by Éric Araujo : -- dependencies: +Moving "Documenting Python" to Devguide ___ Python tracker ___ ___ Python-bugs-list mailing

[issue12415] Missing: How to checkout the Doc sources

Éric Araujo added the comment: > Indeed, I was thinking about getting a CPython checkout with the doc Right. I’ll edit my wording to mention Mercurial. >> I don’t understand: "p"s? >From "_Developpers's Guide: http://docs.python.org/devguide"; The curse of being French :) I always want to wri

[issue12415] Missing: How to checkout the Doc sources

Ezio Melotti added the comment: > Well, the doc makefile still uses Subversion. Indeed, I was thinking about getting a CPython checkout with the doc, not about the tools used to built it (maybe it could be clarified). > I don’t understand: "p"s? >From "_Developpers's Guide: http://docs.python

[issue12415] Missing: How to checkout the Doc sources

Ezio Melotti added the comment: http://docs.python.org/dev/documenting/building.html also needs to be updated (it still mentions Subversion and probably obsolete versions of Sphinx and other packages). If you are going to add the text proposed in your second message, you might want to drop a

[issue12415] Missing: How to checkout the Doc sources

Éric Araujo added the comment: > http://docs.python.org/dev/documenting/building.html also needs to be updated > (it > still mentions Subversion and probably obsolete versions of Sphinx and other > packages). Well, the doc makefile still uses Subversion. As for the versions, if the ones liste

[issue12415] Missing: How to checkout the Doc sources

Éric Araujo added the comment: I merely forgot, thanks for the prod. I’m taking your message as a +1 to the wording and will commit when the server I use for tunnels is back online. -- ___ Python tracker ___

[issue12415] Missing: How to checkout the Doc sources

Sandro Tosi added the comment: Hi Éric, did you reconsider the text of the patch or this issue just passed under your radar? -- ___ Python tracker ___ _

[issue12415] Missing: How to checkout the Doc sources

Éric Araujo added the comment: We fix bugs in 3.2 and then forward-merge in what will become 3.3, using Mercurial. Then we apply the same change for 2.7. More info: http://docs.python.org/devguide I will commit this change this week. -- assignee: docs@python -> eric.araujo keywords

[issue12415] Missing: How to checkout the Doc sources

Philip Olson added the comment: Thank you, that patch solves this bug report. However, now I'm not sure which branches we should or must contribute documentation to. Python versions "2.7, 3.2, and 3.3" are now associated to this bug report, so are these the active documentation branches? How

[issue12415] Missing: How to checkout the Doc sources

Éric Araujo added the comment: How about adding this near the top of documenting/building: The sources for the Python documentation are included in the Python repository, alongside code and tests. Follow the instructions in the `Developpers' Guide`_ to get a copy of this repository.

[issue12415] Missing: How to checkout the Doc sources

Changes by Sandro Tosi : -- nosy: +sandro.tosi ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pyth

[issue12415] Missing: How to checkout the Doc sources

New submission from Philip Olson : I was unable to determine how to download the Python documentation source files (for building via Sphinx) but did figure out the following: hg clone http://hg.python.org/cpython cd cpython/Doc make html Where to get the Doc sources deserves a mention