Mailman 3 February 2015 - docs

docs can not be downloaded
by Noha H 03 Feb '15

03 Feb '15

Hello, all the links for documentation download is broken. 404 error is giventhank you https://docs.python.org/2/download.html ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- "Don't say you don't have enough time. You have exactly the same hours per day that were given to Helen Keller, Pasteur, Michelangelo, Mother Teresa, Leonardo Da Vinci, Thomas Jefferson and Albert Einstein."

2 1

download links are not working
by deva seetharam 03 Feb '15

03 Feb '15

none of the links on the docs download page ( https://docs.python.org/2.7/download.html) are working. pls. help. -- best regards, Deva P. Seetharam

2 1

Documentation
by Petros 03 Feb '15

03 Feb '15

https://docs.python.org/2/archives/python-2.7.9rc1-docs-pdf-a4.zip fails to work 404 etc. give me a heads up if you care when it gets back online Regards Petros

2 1

2.7.9rc1 Doc Links 404'ing
by Jake Fenton 03 Feb '15

03 Feb '15

Hello! I was recently trying to download the full docs for the 2.7 release (I will be off the grid for a bit) and found that all the download links for the current release are 404-ing. The relevant page is here: https://docs.python.org/2.7/download.html --JF

2 1

Download Python 2.7.9rc1 Documentation
by Mathias Kemmler 03 Feb '15

03 Feb '15

Dear Python-team, I just tried to download the documentation for python, but got a 404 error when I tried to download the zip file. After a quick try it seems as if non of the files are accessible. Any chance this could be corrected in the near future? Kind regards, Mathias

2 1

Problem with link
by Lucivaldo Castro 03 Feb '15

03 Feb '15

Hello, Have a problem with the link that target to page of the downloads of the documentation of the latest version of the release of the Python 2.7.x. I am Brazilian, forgive me for typos. Link: https://docs.python.org/2/download.html Thanks!!!

2 1

(no subject)
by samuel eewewew 03 Feb '15

03 Feb '15

I can not download the documentation, have some alternate link: https://docs.python.org/2/archives/python-2.7.9rc1-docs-pdf-letter.zip404 Not Found

2 1

Link to Python 2.7.9rc1 documentation dead
by Woody＠mail.python.org 03 Feb '15

03 Feb '15

Dear maintainer, The links to documentations here is dead: https://docs.python.org/2/download.html Please update it, and thanks for your kind work. :-) Best regards, Haochi Kiang

2 1

[issue6634] sys.exit() called from threads other than the main one: undocumented behaviour
by Jan-Philip Gehrcke 03 Feb '15

03 Feb '15

Jan-Philip Gehrcke added the comment: Thanks for your feedback Antoine. > I'm not sure what the doc patch achieves. Let me try to bring things in order. It should achieve two things: 1. Properly describe the stderr-writing behavior of sys.exit(). =============================================================== Current 2.7 docs: "..., and any other object is printed to stderr". This is wrong in its generality and requires clarification. Agreed? How would you improve the docs in this regard? This is the reasoning I had in mind: We could change the original sentence, but IMO it then contains too many pieces of important information and becomes difficult to digest, e.g.: "If another type of object is passed, None is equivalent to passing zero, and any other object is printed to stderr (only when called in the main thread) and results in an exit code of 1.". Difficult, right? I thought about removing the stderr part from this sentence and discussing this topic separately, in simpler sentences. But: I think the stderr part needs to stay in the original sentence, because it clarifies how different argument types are dealt with. Then I took another point of view: we have acknowledged that the behavior is problematic, we just cannot change it anymore for 2.7. The direct consequence from this point of view is to warn about current behavior. 6 years ago, I took the docs literally and relied on getting proper error messages printed to stderr. And I didn't get those. I would have appreciated a warning, I guess. With this being said, I'd love to look at an alternative proposal of how we could change the docs in this regard. 2. Clarify that when called from a thread, the thread exits silently ==================================================================== Current 2.7 docs: "Since exit ultimately "only" raises an exception, it will only exit the process when called from the main thread." This sentence is problematic. It relates a cause to an effect, and this relation is wrong or at least incomplete. The only valuable information left in the sentence is the *effect*, without providing an explanation. I would rather want to take the inverse approach, and explain the *cause* as correct as possible. In other words: the above sentence misses to explain what actually happens when sys.exit() is called in a non-primary thread. The actual behavior and cause for mentioned effect is, as far as I am aware: If raised in a non-primary thread, SystemExit is caught automatically and causes the calling thread to exit silently. This is what I added as a note. And I think that we agree that this cause may have many effects, whereas only one of them is that sys.exit() called from a non-primary thread can not terminate the process. > It only states more verbosely what is already > said in the current version. I hope to have convinced you that this is not true. > Also, warnings are really for important issues > (such as security issues); using them too liberally > is a disservice to the reader. I agree. I really think that both points need to be addressed in the docs, and I have now clarified my reasoning, but am very open to further suggestions. And I really do not want to make a strong point about whether things should end up in red or blue boxes :-). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6634> _______________________________________

1 0

[issue23379] Incorrect links within PEPs
by Jonathan Sharpe 03 Feb '15

03 Feb '15

New submission from Jonathan Sharpe: For example, the link to PEP-340 in PEP-343 points to https://www.python.org/dev/peps/pep-0343/pep-0340.html rather than https://www.python.org/dev/peps/pep-0340/ and the link to PEP-288 from PEP-340 points to https://www.python.org/dev/peps/pep-0340/pep-0288.html rather than https://www.python.org/dev/peps/pep-0288/ ---------- assignee: docs@python components: Documentation messages: 235278 nosy: docs@python, jonrsharpe priority: normal severity: normal status: open title: Incorrect links within PEPs _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23379> _______________________________________

2 1