[issue14814] Implement PEP 3144 (the ipaddress module)

2012-05-20 Thread Sandro Tosi
Sandro Tosi added the comment: I'm attaching a very preliminary draft of the howto, any comment is welcome. Of course, it misses several references to the API doc; I'll see if I can beat Georg and post a preliminary version of that too :) -- keywords: +patch nosy: +sandro.

[issue14814] Implement PEP 3144 (the ipaddress module)

2012-05-22 Thread Sandro Tosi
Sandro Tosi added the comment: Thank Nick for pointing to Terry's review! I'm attaching here a patch addressing the points Terry highlighed. probably we should review this patch before moving forward with the API doc? -- Added file: http://bugs.python.org

[issue14814] Implement PEP 3144 (the ipaddress module)

2012-05-23 Thread Sandro Tosi
Sandro Tosi added the comment: Thanks Hynek: comments committed -- ___ Python tracker <http://bugs.python.org/issue14814> ___ ___ Python-bugs-list mailin

[issue14968] Section "Inplace Operators" of :mod:`operator` should be a subsection

2012-06-01 Thread Sandro Tosi
Sandro Tosi added the comment: Thanks Lars for the patch! Éric, why did you add 2.7 version? AFAISee 2.7 doesn't have the "Inplace Operators" section. -- ___ Python tracker <http://bugs.pyt

[issue14814] Implement PEP 3144 (the ipaddress module)

2012-06-02 Thread Sandro Tosi
Sandro Tosi added the comment: Attached is a draft of the module documentation. I didn't commit yet cause we might want to rework it deeply. Else we can just commit the patch and let the comments coming as additional diffs. -- stage: needs patch -> patc

[issue14814] Implement PEP 3144 (the ipaddress module)

2012-06-02 Thread Sandro Tosi
Sandro Tosi added the comment: and the patch... -- Added file: http://bugs.python.org/file25800/ipaddress_module_doc.diff ___ Python tracker <http://bugs.python.org/issue14

[issue14926] random.seed docstring needs edit of "*a *is"

2012-06-02 Thread Sandro Tosi
Sandro Tosi added the comment: Thanks Christopher! -- resolution: -> fixed stage: -> committed/rejected status: open -> closed versions: -Python 2.7 ___ Python tracker <http://bugs.python.or

[issue15013] smtplib: add low-level APIs to doc?

2012-06-06 Thread Sandro Tosi
New submission from Sandro Tosi : In the smtplib doc I read: Low-level methods corresponding to the standard SMTP/ESMTP commands HELP, RSET, NOOP, MAIL, RCPT, and DATA are also supported. Normally these do not need to be called directly, so they are not documented here. For details, consult

[issue15014] smtplib: allow to choose auth method on login()

2012-06-06 Thread Sandro Tosi
New submission from Sandro Tosi : Hello, I'm writing some tests from an MTA, and so I'm using smtplib. Sadly the login() method doesn't allow to choose the auth method to use (but it's selected from a static list compared with what's advertized from the MTA) while

[issue15060] docs: socket typo

2012-06-13 Thread Sandro Tosi
Sandro Tosi added the comment: Thanks! -- nosy: +sandro.tosi resolution: -> fixed stage: -> committed/rejected status: open -> closed versions: +Python 2.7, Python 3.2, Python 3.3 ___ Python tracker <http://bugs.python.or

[issue15656] "Extending Python with C" page needs update for 3.x

2012-08-14 Thread Sandro Tosi
New submission from Sandro Tosi: Hello, this has been reported at http://mail.python.org/pipermail/docs/2012-July/009223.html but since I have no experience to judge if it's correct or not, i'll just report it: >>> I've recenty started to try using C code in python us

[issue15657] Error in Python 3 docs for PyMethodDef

2012-08-14 Thread Sandro Tosi
New submission from Sandro Tosi: Hello, it has been reported at http://mail.python.org/pipermail/docs/2012-April/008215.html but given it raises some question whether it's a bug in the doc or in the code, i'd rather report the issue here and hear what other think: >>>

[issue15656] "Extending Python with C" page needs update for 3.x

2012-08-15 Thread Sandro Tosi
Sandro Tosi added the comment: It's fixed in default too: http://hg.python.org/cpython/rev/f46b4b7b817c It was not shown because the commit message misses the issue reference. -- ___ Python tracker <http://bugs.python.org/is

[issue15677] Gzip/zlib allows for compression level=0

2012-08-15 Thread Sandro Tosi
New submission from Sandro Tosi: As reported at http://mail.python.org/pipermail/docs/2012-August/009837.html gzip/zlib allows for a compression level=0 (that's basically no compression) so the documentation should mention that possibility too. -- assignee: docs@python compo

[issue13799] Base 16 should be hexadecimal in Unicode HOWTO

2012-08-20 Thread Sandro Tosi
Sandro Tosi added the comment: I tend to agree with Terry that this report can be closed: base 16 is quite known and it's high likely that if you know what hexadecimal is, you also aware of the concept of "base X" and viceversa. If no-one objects, I&

[issue14468] Update cloning guidelines in devguide

2012-08-20 Thread Sandro Tosi
Sandro Tosi added the comment: Hi Ezio, thanks for the review: how about this new version of the patch? I've left the more "verbose" version in the 3.2 example, while used the more compact way for the 2.7 . Re first committing to 2.7 then 3.2 and then merge, that would work f

[issue12415] Missing: How to checkout the Doc sources

2012-08-20 Thread Sandro Tosi
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 contributo

[issue14468] Update cloning guidelines in devguide

2012-08-20 Thread Sandro Tosi
Sandro Tosi added the comment: I think the aim of that part of the devguide is to give one clear, simple, working way to operate on different branches at the same time. Additional workflows can be presented, but probably in another place (like the FAQ indeed). What others thing about this

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

2012-12-28 Thread Sandro Tosi
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

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

2012-12-29 Thread Sandro Tosi
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

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

2012-12-29 Thread Sandro Tosi
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

[issue16814] use --directory option of make

2012-12-29 Thread Sandro Tosi
Sandro Tosi added the comment: i'd use make -C Doc html much more compact and what you would usually find on the internet for "cd into the dir and run the html target in it" -- nosy: +sandro.tosi ___ Python tracker <http

[issue16813] use paths relative to CPython root in documentation building instructions

2012-12-29 Thread Sandro Tosi
Sandro Tosi added the comment: > Out of curiosity, does anyone know if the following works on all or most > systems? > > $ open _build/html/index.html it doesn't work on my Debian system: $ open _build/html/index.html Couldn't get a file descriptor referring to the cons

[issue16932] urlparse fails at parsing "www.python.org:80/"

2013-01-11 Thread Sandro Tosi
New submission from Sandro Tosi: Hello, as reported at http://mail.python.org/pipermail/docs/2013-January/012375.html urlparse fails to parse URLs without a schema and with a url path, as opposed to what's documented at http://docs.python.org/2/library/urlparse.html?highlight=url

[issue16932] urlparse fails at parsing "www.python.org:80/"

2013-01-11 Thread Sandro Tosi
Sandro Tosi added the comment: Adding Senthil as per expert list -- nosy: +orsenthil ___ Python tracker <http://bugs.python.org/issue16932> ___ ___ Python-bug

[issue16932] urlparse fails at parsing "www.python.org:80/"

2013-01-11 Thread Sandro Tosi
Sandro Tosi added the comment: The documentation reports this example: >>> urlparse('www.cwi.nl:80/%7Eguido/Python.html') ParseResult(scheme='', netloc='', path='www.cwi.nl:80/%7Eguido/Python.html', params='', query=

<    1   2   3   4   5