docs@python.org discussions

0	[docs] [issue16473] quopri module differences in quoted-printable text with whitespace

Martin Panter added the comment: Will commit a slightly modified version of my doc patch to 3.4+, since mentioning the wrong functions is confusing. But I think we still need to fix the ?binascii? ...

Martin Panter
Sep 12, 2015 at 12:50 am
Sep 12, 2015 at 12:50 am

4	[docs] [issue25073] Document asyncio.test_utils

New submission from Zachary Ware: asyncio.test_utils is not documented. I'm unsure as to whether that's because it's meant to be private, or if it just hasn't been done yet. ---------- assignee: docs ...

Zachary Ware
Sep 11, 2015 at 6:09 pm
Sep 11, 2015 at 8:15 pm

2	[docs] Small typo on CSV documentation

Hello, There is a small bug at https://docs.python.org/3/library/csv.html. The word "be" is repeated. I believe the first one (in red) should be removed. Dialect.doublequote ...

Nat Dunn
Sep 11, 2015 at 3:17 pm
Sep 11, 2015 at 3:59 pm

1	[docs] [issue25070] Python 2.6 - Python 3.4 allows unparenthesized generator with args, *kw, forbidden in 3.5

Antti Haapala added the comment: Yeah, it is a bug in 2.5 too; https://docs.python.org/2.5/ref/calls.html call ::= primary "(" [argument_list [","] ---------- assignee: - docs at python components ...

Antti Haapala
Sep 11, 2015 at 1:50 pm
Sep 11, 2015 at 9:40 pm

0	[docs] Bug in doc for python 3 / argparse module

For actions 'store_false' and 'store_true', python 2 doc mentioned the default values (true / false) This info is no longer visible in python 3 doc ...

Pierre Wadier
Sep 11, 2015 at 1:09 pm
Sep 11, 2015 at 1:09 pm

0	[docs] encodings.aliases.aliases sjis2004 missing

Hi, In the documentation of the codecs module section standard encodings: https://docs.python.org/3/library/codecs.html#standard-encodings ...

Julien Marechal
Sep 11, 2015 at 12:52 pm
Sep 11, 2015 at 12:52 pm

1	[docs] [issue23484] SemLock acquire() keyword arg 'blocking' is invalid

Davin Potts added the comment: @berker.peksag, @r.david.murray: Could I gently nudge one of you into committing the final versions of these patches? ---------- Python tracker <report at ...

Davin Potts
Sep 11, 2015 at 4:53 am
Sep 11, 2015 at 9:52 am

1	[docs] [issue25065] https://docs.python.org/library should redirect to Python 3 doc

New submission from Mart?n Gait?n: The canonical link for documentation https://docs.python.org/ redirect to the index page of the stable Python 3's documentation However, ...

Martín Gaitán
Sep 11, 2015 at 4:21 am
Sep 11, 2015 at 4:57 am

0	[docs] [issue25064] Adjust tempfile documentation for bytes filename support

New submission from Martin Panter: This is a followup to Issue 24230, which added support for bytes filenames to ?tempfile? module. Currently I think the documentation is misleading, for example it ...

Martin Panter
Sep 11, 2015 at 3:46 am
Sep 11, 2015 at 3:46 am

7	[docs] [issue25062] Doc linter error: [2] library/typing.rst:358: default role used

New submission from STINNER Victor: The Docs buildbot is red since the changeset 7fc4306d537b5feedb7f9dac54d96ed378c093a7. http://buildbot.python.org/all/builders/Docs%203.x/builds/52 ---------- ...

STINNER Victor
Sep 10, 2015 at 6:33 pm
Sep 10, 2015 at 7:37 pm

4	[docs] [issue25059] Mistake in input-output tutorial regarding print() seperator

New submission from Saimadhav Heblikar: Feel free to make changes to the patch if you want to improve the sentence structure. ---------- assignee: docs at python components: Documentation messages ...

Saimadhav Heblikar
Sep 10, 2015 at 4:45 pm
Sep 10, 2015 at 5:20 pm

3	[docs] [issue25048] %e Directive Missing in Datetime Documentation

New submission from Marc Bouvier: The %e directive is missing in the Datetime documentation. I have tried this directive in 2.6.6, 2.7.2, and 2.7.10 using ...

Marc Bouvier
Sep 9, 2015 at 9:35 pm
Sep 9, 2015 at 9:45 pm

11	[docs] [issue25043] document socket constants for Bluetooth

New submission from Tim Tisdall: further to #24984, I noticed there are constants that aren't mentioned in the docs. Also BDADDR_ALL is missing (which is defined in Bluez's bluetooth.h) so I added ...

Tim Tisdall
Sep 9, 2015 at 3:00 pm
Sep 11, 2015 at 11:33 pm

4	[docs] [issue25041] document AF_PACKET socket address format

New submission from Tim Tisdall: As mentioned in #24984, I'm making another issue to document the address format for AF_PACKET. In this case there's already documentation in Modules/socketmodule.c ...

Tim Tisdall
Sep 9, 2015 at 1:07 pm
Sep 10, 2015 at 1:54 pm

2	[docs] [issue25039] Docs: Link to Stackless Python in Design and History FAQ section is broken

New submission from Camilla Montonen: The link to Stackless Python here ...

Camilla Montonen
Sep 9, 2015 at 9:08 am
Sep 9, 2015 at 10:51 am

1	[docs] [BUG REPORT 2.7.10] ValueError: invalid \x escape

Hello, Python 2.7.10, Windows 7 "ValueError: invalid \x escape" Note that there is no indication of where is the error (no line number). the faulty ligne is a # commented line inside a """ commented ...

Guillaume ALLARD
Sep 9, 2015 at 7:08 am
Sep 11, 2015 at 3:49 pm

5	[docs] [issue25030] io.[Text]IOBase.seek doesn't take keyword parameter

New submission from shiyao.ma: The doc is here: https://docs.python.org/3.5/library/io.html#io.IOBase.seek and here: https://docs.python.org/3.5/library/io.html#io.TextIOBase.seek It is said the ...

Shiyao.ma
Sep 8, 2015 at 1:44 pm
Sep 11, 2015 at 4:46 am

1	[docs] Bug in web site

Bug in web site http://www.screencast.com/t/m4BGUJZc0 An HTML attachment was scrubbed... URL: <http://mail.python.org/pipermail/docs/attachments/20150908/aa333750/attachment-0001.html

Dmitry Kolesnikovich
Sep 8, 2015 at 12:39 pm
Sep 11, 2015 at 9:46 am

5	[docs] [issue25022] Remove PC/example_nt/

New submission from Zachary Ware: The instructions and examples in PC/example_nt/ are hopelessly outdated (the readme says "It has been tested with VC++ 7.1 on Python 2.4" on default!). Is there any ...

Zachary Ware
Sep 8, 2015 at 4:42 am
Sep 11, 2015 at 3:00 am

2	[docs] WCAG 2.0 from w3 consortium

Recently, webmaster received 2 queries from people who wanted to know how compliant ?Python and the Python documentation were with the Americans with Disabilities Act Provisions and with WCAG3 ...

Laura Creighton
Sep 7, 2015 at 3:58 pm
Sep 7, 2015 at 4:51 pm

5	[docs] [issue25017] htmllib deprecated: Which library to use? Missing sane default in docs

New submission from Thomas Guettler: At the top of the htmllib module: Source: https://docs.python.org/2/library/htmllib.html#module-htmllib Newcomers need more advice: Which library should be used? ...

Thomas Guettler
Sep 7, 2015 at 9:01 am
Sep 8, 2015 at 11:50 am

2	[docs] [issue25010] minor typo in PCBuild readme.txt

New submission from Shaun Walbridge: A minor documentation fix. Currently, the top-level PCBuild readme.txt mentions in the final section 'Your Own Extension DLLs' that the example project is located ...

Shaun Walbridge
Sep 5, 2015 at 5:36 pm
Sep 8, 2015 at 4:33 am

0	[docs] [issue25006] List pybind11 binding generator

New submission from Wenzel Jakob: Hi, over the last few months, I've been developing a library ("pybind11") for creating Python bindings of C++ code. It is similar in spirit to Boost.Python but uses ...

Wenzel Jakob
Sep 4, 2015 at 11:34 pm
Sep 4, 2015 at 11:34 pm

3	[docs] [issue23144] html.parser.HTMLParser: setting 'convert_charrefs = True' leads to dropped text

Ezio Melotti added the comment: I'll try to take care of this during the weekend. Feel free to ping me if I don't. ---------- Python tracker <report at bugs.python.org ...

Ezio Melotti
Sep 4, 2015 at 8:55 am
Sep 9, 2015 at 1:51 pm

3	[docs] [issue24998] docs: subprocess.Popen example has extra/invalid parameter

New submission from Paul Clarke: in "subprocess" module documentation has a section for "replacing older functions with subprocess", specifically 17.1.4.5 "replacing os.popen", which includes the ...

Paul Clarke
Sep 4, 2015 at 5:11 am
Sep 4, 2015 at 2:05 pm

1	[docs] htmllib is deprecated: Newcomers need more advice

At the top of the htmllib module: {{{ Deprecated since version 2.6: The htmllib module has been removed in Python 3. }}} Source: https://docs.python.org/2/library/htmllib.html#module-htmllib ...

Thomas Güttler
Sep 3, 2015 at 3:03 pm
Sep 7, 2015 at 9:02 am

0	[docs] document AF_BLUETOOTH socket address formats (issue 24984)

https://bugs.python.org/review/24984/diff/15453/Doc/library/socket.rst File Doc/library/socket.rst (right): https://bugs.python.org/review/24984/diff/15453/Doc/library/socket.rst#newcode120 ...

Vadmium+py
Sep 2, 2015 at 10:02 pm
Sep 2, 2015 at 10:02 pm

0	[docs] interning and list comprehension leads to unexpected behavior (issue 23406)

https://bugs.python.org/review/23406/diff/15454/Doc/library/stdtypes.rst File Doc/library/stdtypes.rst (right): https://bugs.python.org/review/23406/diff/15454/Doc/library/stdtypes.rst#newcode900 ...

Vadmium+py
Sep 2, 2015 at 9:40 pm
Sep 2, 2015 at 9:40 pm

17	[docs] [issue24984] document AF_BLUETOOTH socket address formats

New submission from Tim Tisdall: Currently https://docs.python.org/3.6/library/socket.html#socket-families only says "Certain other address families (AF_BLUETOOTH, AF_PACKET, AF_CAN) support specific ...

Tim Tisdall
Sep 2, 2015 at 4:06 pm
Sep 11, 2015 at 2:37 am

2	[docs] [issue24978] Contributing to Python 2x and 3x Documentation. Translation to Russian.

New submission from Eugene: I am very much begging pardon if this is not the place to ask for, but.. I would like to make a thorough translation of the official Library Reference and the beginners ...

Eugene
Sep 1, 2015 at 12:04 pm
Sep 1, 2015 at 5:30 pm

0	[docs] [issue12833] raw_input misbehaves when readline is imported

Martin Panter added the comment: I wonder if this information would be better off under the input() function, rather than under the Readline module itself. Also see Issue 17337, about control codes ...

Martin Panter
Aug 31, 2015 at 4:41 am
Aug 31, 2015 at 4:41 am

1	[docs] [issue24963] ipaddress.IPv6Network doc typo

New submission from zodalahtathi: This is probably not the biggest bug ever, but in the doc for ipaddress.IPv6Network: "An integer packed into a bytes object of length 16, bit-endian" should be ...

Zodalahtathi
Aug 30, 2015 at 4:26 pm
Aug 30, 2015 at 9:43 pm

2	[docs] [issue24962] Unnecessary space in using/mac

New submission from TAKASE Arihiro: https://docs.python.org/3.4/using/mac.html#configuration A newline in the file path of the .plist file makes a space in the rendered result. The attached patch ...

TAKASE Arihiro
Aug 30, 2015 at 3:18 am
Aug 30, 2015 at 3:28 am

0	[docs] unittest: test seem to be run out of order

Hello, I am new to unittest, so I may have missed something in the docs. My understanding was that tests were run in the order they appear in the class. I am writing a series of tests that are ...

Dwyer, Chris (KBB)
Aug 28, 2015 at 8:48 pm
Aug 28, 2015 at 8:48 pm

7	[docs] [issue24952] stack_size([size]) is actually stack_size(size=0)

New submission from mattip: when using thread.stack_size or threading.stack_size, if no argument is provided the stack size is reset to default. Trivial patch for 3.5 provided ---------- assignee ...

Mattip
Aug 28, 2015 at 2:59 pm
Aug 31, 2015 at 3:48 am

2	[docs] [issue24947] asyncio-eventloop documentation grammar (minor)

New submission from tagatac: "amongst which" in the Base Event Loop subsection of the docs does not really describe a list of facilities. "amongst which are" would be better, but "including" conveys ...

Tagatac
Aug 27, 2015 at 8:50 pm
Aug 27, 2015 at 8:56 pm

2	[docs] Should I fire a bug against io.IOBase.seek function sig ?

Hi, The doc is here: https://docs.python.org/3/library/io.html#io.IOBase.seek It is said the parameter list is in the form of: seek(offset, whence=SEEK_SET) But actually only: *seek(offset) *or* ...

Shiyao Ma
Aug 27, 2015 at 9:01 am
Sep 8, 2015 at 1:45 pm

1	[docs] Distributing .c and .pyd modules

Dear Sir, I got your email from the manual with the title "Distributing Python modules". After writing my modules in Python, I used Cython to convert them to .c and .pyd files. But I faced problem in ...

Desta Wubishet
Aug 26, 2015 at 3:36 pm
Aug 27, 2015 at 7:48 am

0	[docs] [issue23144] html.parser.HTMLParser: setting 'convert_charrefs = True' leads to dropped text

Robert Collins added the comment: @ezio - you seem busy, so I'll commit this next week if its still pending. ---------- Python tracker <report at bugs.python.org <http://bugs.python.org/issue23144 ...

Robert Collins
Aug 25, 2015 at 10:18 pm
Aug 25, 2015 at 10:18 pm

6	[docs] [issue24937] Multiple problems in getters & setters in capsulethunk.h

New submission from Petr Viktorin: In https://docs.python.org/3/howto/cporting.html#cobject-replaced-with-capsule (added in issue13053): 1) __PyCapsule_GetField is defined as:: #define ...

Petr Viktorin
Aug 25, 2015 at 4:41 pm
Sep 8, 2015 at 1:37 pm

1	[docs] Translation of the Python documentation

Hi?! Introducing myself, I?m Lucas, a French translator on the Transifex project of the documentation ( https://www.transifex.com/python-doc-ja/python-34-ja/) , and, in fact, i?m the only one on it ...

Mascaro Lucas
Aug 25, 2015 at 12:59 am
Aug 25, 2015 at 8:12 am

3	[docs] [issue24926] Incorrect Example in HTMLParser.handle_comment(data)

New submission from Vineet Kumar Doshi: Hi, link : https://docs.python.org/2/library/htmlparser.html#HTMLParser.HTMLParser.handle_comment Incorrect Line : The content of Internet Explorer conditional ...

Vineet Kumar Doshi
Aug 24, 2015 at 4:42 pm
Aug 24, 2015 at 4:56 pm

0	[docs] Incorrect Example in HTMLParser.handle_comment(data)

Hi, link : https://docs.python.org/2/library/htmlparser.html#HTMLParser.HTMLParser.handle_comment Incorrect Line : The content of Internet Explorer conditional comments (condcoms) will also be sent ...

Vineet Kumar Doshi
Aug 24, 2015 at 4:34 pm
Aug 24, 2015 at 4:34 pm

4	[docs] [issue24921] Operator precedence table in 5.15 should be highest to lowest precedence

New submission from Joseph Schachner: We should not make people who need to read Python documentation do an extra transformation in their heads to correctly understand that in section 5.15 higher ...

Joseph Schachner
Aug 24, 2015 at 1:08 pm
Aug 29, 2015 at 5:10 am

1	[docs] [issue24918] Docs layout bug

New submission from asldkjfn: Green bars cover yellow text box. https://docs.python.org/2/faq/windows.html ---------- assignee: docs at python components: Documentation messages: 249018 nosy: docs at ...

Asldkjfn
Aug 23, 2015 at 8:20 pm
Aug 23, 2015 at 8:59 pm

3	[docs] [issue24914] Python: Not just OO style but this is not mentioned on python.org or in FAQ

New submission from Paddy McCarthy: Just read ...

Paddy McCarthy
Aug 22, 2015 at 6:45 am
Aug 29, 2015 at 5:08 am

3	[docs] [issue24911] Context manager of socket.socket is not documented

New submission from zodalahtathi: socket.socket has a context manager to automatically close the socket with the `with` statement: https://hg.python.org/cpython/file/d1bf181afa82/Lib/socket.py#l138 ...

Zodalahtathi
Aug 21, 2015 at 8:34 pm
Aug 31, 2015 at 4:14 am

0	[docs] [issue24247] "unittest discover" modifies sys.path

Robert Collins added the comment: It did that because you did not specify a top level directory. Without that, the cwd is not on the path and that breaks many environments. We should probably ...

Robert Collins
Aug 21, 2015 at 1:41 am
Aug 21, 2015 at 1:41 am

2	[docs] [issue24899] Add an os.path <=> pathlib equivalence table in pathlib docs

New submission from Ezio Melotti: I think it would be useful to add to the pathlib documentation a table listing os/os.path operations and their pathlib equivalent. This will be useful both for ...

Ezio Melotti
Aug 20, 2015 at 6:03 am
Sep 11, 2015 at 2:27 pm

2	[docs] [issue24898] Documentation for str.find() is confusing

New submission from Ted Lemon: The documentation for str.find() on python.org, for all current versions, says: Return the lowest index in the string where substring sub is found, such that sub is ...

Ted Lemon
Aug 20, 2015 at 2:34 am
Aug 20, 2015 at 2:54 pm

group	docs @
categories	python
discussions	5,053
posts	22,978
users	1,204
website	python.org

summaries	on	Hotkey: s
users list	on	Hotkey: d
user style	avatars	Hotkey: a

Python > docs

Search Discussions

5,053 discussions - 22,978 posts

Top users

Content

People

Support

Translate