Mailman 3 May 2014 - docs

Download Python 2.7.7rc1 Documentation 404
by Strohmaier Franz 20 May '14

20 May '14

Hi there Not even one of the links on this page is working: https://docs.python.org/2.7/download.html e.g.: https://docs.python.org/2.7/archives/python-2.7.7rc1-docs-pdf-a4.zip results in 404 Not Found ________________________________ nginx Regards Franz Franz Strohmaier Amt der Steiermärkischen Landesregierung Abteilung 1 Organisation und Informationstechnik Burggasse 2 II/203 A-8010 Graz Tel.: +43 316 877 3381 Mobil: +43 676 8666 3381 Fax: +43 316 877 3992 [cid:image001.png@01CF7432.44DE4D40]

1 0

rlcompleter documentation
by Mark Ballard 20 May '14

20 May '14

rlcompleter documentation doesn't show adequately how to switch it off. This is important because rlcompleter is for some an unwelcome change to the python interpreter. It is unwelcome because it is poorly implemented. It has disabled the tab key you would normally use to indent code in the interpreter. It also appears to have broken the interpreter's ability to accept cut-and-paste code on the command line (http://www.gossamer-threads.com/lists/python/python/1086863). These are both essential features for learners, for skething code and so on. So I need to get rid of it. But the Python documentation does not tell you how to switch it off: https://docs.python.org/3/tutorial/interactive.html (It has some surreal discussion that appears to refer to the missing tab indent feature: 13.2. Alternatives to the Interactive Interpreter. But sympathy is not much use here.) That text includes a link from the words that say rlcompleter is 'automatically enabled'. This implies it will tell how to switch it off as well. It leads here: https://docs.python.org/3/library/site.html#rlcompleter-config (It is of course obvious that the rlcompleter is automatically enabled. But I would challenge anyone who would criticize this. The Python documentation needs more statements of the obvious like, for example, how to switch the rlcompleter off.) The link goes to an arcane description of "site-specific" functions that would be enough by now to deter most novices. Persistence will get you to a description of the rlcompleter that says you can turn it off by changing an attribute in your "sitecustomize or usercustomize module or your PYTHONSTARTUP file". So, determined now to find my Python startup file (that sounds like something more substantial, more likely to be identified than these customize modules), I follow the link to the given help page for PYTHONSTARTUP: https://docs.python.org/3/using/cmdline.html#envvar-PYTHONSTARTUP That doesn't tell me where to find PYTHONSTARTUP. It even suggests I might not have such a file at all! I am by now so far from my original, simple problem that I'm beginning to wish I'd taken a ball of string and unravelled it as I went so I could find my way back again. The Python interpreter help pages don't tell you how to switch rlcompleter off either. Looky here: " help> module rlcompleter no Python documentation found for 'module rlcompleter' " It does suggest to me the documention is treated as an afterthought. If whoever implemented this function was *answerable* to some sort of appointed documentation representative then not only would the disable function have been properly documented, but they might have been forced to implement the disable feature properly because they would have been forced to address awkward questions posed by someone with such authority that they couldn't simply say, 'sod off documentation worm, don't you know who I am - I've got far more important things to do than bother with your pathetic, snivelling questions". Just a thought.

1 0

Broken LInks
by Thomas T 20 May '14

20 May '14

I tried several times to download the documentation for Python but each time I got a server error that it didn't exist - that is, the files I wanted to download. I tried both the zip and tar files and text files, but to no avail. Thank you for your time and consideration. Sincerely, Tom Tuckhorn

1 0

Documentation PDF Links are broken
by Phillip Ruppert 20 May '14

20 May '14

I get 404s on the download links on this page. Download — Python v2.7.7rc1 documentation

1 0

[issue20620] Update the min()/max() docs for the new default argument
by Raymond Hettinger 20 May '14

20 May '14

New submission from Raymond Hettinger: There is a new "default" argument for min() and max(): >>> min([], default=10) 10 The new argument is not currently shown by help(): >>> help(min) Help on built-in function min in module builtins: min(...) min(iterable[, key=func]) -> value min(a, b, c, ...[, key=func]) -> value With a single iterable argument, return its smallest item. With two or more arguments, return the smallest argument. ---------- assignee: docs@python components: Documentation messages: 211168 nosy: docs@python, rhettinger priority: normal severity: normal status: open title: Update the min()/max() docs for the new default argument versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20620> _______________________________________

6 10

[issue21484] More clarity needed about difference between "x += e" and "x = x + e"
by Feliks 20 May '14

20 May '14

New submission from Feliks: In Sec. 7.2.1 of the Language Reference, in the description of "+=" we have: "Also, when possible, the actual operation is performed in-place, meaning that rather than creating a new object and assigning that to the target, the old object is modified instead." Although this is quite accurate, not all the consequences are immediately obvious, and sometimes they are quite serious. I would suggest adding a note that points the reader's attention in particular to the phenomenon exhibited in the following example: >>> def f(ls): ls += [2] ... >>> def g(ls): ls = ls + [2] ... >>> a = [1] >>> g(a) >>> a [1] >>> f(a) >>> a [1, 2] ---------- assignee: docs@python components: Documentation messages: 218338 nosy: Kluzniak, docs@python priority: normal severity: normal status: open title: More clarity needed about difference between "x += e" and "x = x + e" type: enhancement versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21484> _______________________________________

4 4

Documents download gives 404 Not found
by Islam Otmani 19 May '14

19 May '14

Hello, I just wanted to let you know that I attempted to download the docs but got a dead-link via the following page: https://docs.python.org/2/download.html Thanks in advance, Islam.

1 0

404 Not Found
by Daniel Inman 19 May '14

19 May '14

Hey there! Just thought someone on this list should know: when you go to https://docs.python.org/2/download.html and try to download any of the files listed it returns a 404 error. Not sure if the links just aren't pointing to the correct directory or what. -- Daniel

1 0

Python Documentation download 404
by Zachary Ware 19 May '14

19 May '14

(Note: I have Bcc'd the 8 people who have reported this issue so far) Thank you all for the reports! I have opened http://bugs.python.org/issue21534 to make sure this is fixed; I expect it should be resolved fairly quickly. Regards, -- Zach

1 0

Broken link for Python 3.4.1 EPUB download
by cclauss 19 May '14

19 May '14

https://docs.python.org/3/download.html can not download the EPUB document. Thanks, CCC - +41-79-799-1210

1 0