New submission from Mitchell Model :
Mac OSX, py3k 70991
cd doc; make html
fails due to an old style except clause in Doc/tools/sphinx/__init__.py
The make works in release30-maint.
The difference is that the generated doc/Makefile in release30-maint
assigns python2.5 to PYTHON, but the
Mitchell Model added the comment:
OK, makes sense. Just out of curiosity where does a user find that
information? a developer?
There is still an inconsistency between the Makefiles in the two
versions. That seems dangerous.
--
--
--- Mitchell
--
title: make html in doc
Mitchell Model added the comment:
It strikes me as an inconsistency because I wouldn't expect the build
process to differ from Python 3.0 to 3.1 except for fixing bugs. A
developer, or someone trying to keep up with the most recent
versions, who had been successfiully making the html d
Mitchell Model added the comment:
OK
--
--
--- Mitchell
--
Added file: http://bugs.python.org/file13583/unnamed
___
Python tracker
<http://bugs.python.org/issue5658>
___
<!--
blockquote, d
New submission from Mitchell Model :
In the section at reference/lexical_analysis.html#keywords of the HTML
documentation some of the keywords are formatted differently from the
majority. In the HTML markup most of the keywords have CSS class 'k',
but others have 'n',
New submission from Mitchell Model :
There are some problems with the dbm documentation. In the opening section:
1. The comment before the iteration example says that .values() works,
but the method is not defined.
2. The statement in the paragraph after the documentation of dbm.open()
says
New submission from Mitchell Model :
It isn't clear from the explanation of dbm.open's flag values at the
beginning of the dbm documentation page whether 'c' and 'n' open the
database just for writing or for reading and writing. I'm sure it's
obvious to a
Mitchell Model added the comment:
Further confusion:
dbm.dumb._Database objects DO support items(), DO NOT support
iteritems(), and DO support iterkeys()
My previous comments referred to the general dbm documentation and the
specifics of dbm.gnu. I haven't checked any of this agains
Mitchell Model added the comment:
And, checking the methods of dbm.ndbm, I find get() and setdefault() but
nothing like iterkeys() or iteritems(), just keys().
I think it might also be worth pointing out that a particular variation
of dbm may be chosen to create a database file by calling the
New submission from Mitchell Model :
I just discovered to my (deep) surprise that
range(n) != range(n)
I think that's worth including in the what's new document.
I realize that the document essentially says that in python 3 range
behaves the way xrange did in python 2 and t
New submission from Mitchell Model :
The documentation of shelve.open() states (paragraph 3) that "By
default, mutations to persistent-dictionary mutable entries are not
automatically written back." It then goes on to describe what happens if
the writeback parameter is True, whic
New submission from Mitchell Model :
In the documentation of shelve.sync, 'shelf' is mispelled 'Shelf' --
both the word and case are wrong.
--
assignee: georg.brandl
components: Documentation
messages: 87382
nosy: MLModel, georg.brandl
severity: normal
status:
Mitchell Model added the comment:
OK, I've figured out from the comments in the example later on in the
shelf documentation what the paragraph is supposed to mean. I still
think it should be stated clearly. The distinction to be made is that
modifications to the dictionary immediately c
Mitchell Model added the comment:
Sorry. Careless again.
--
--
--- Mitchell
--
Added file: http://bugs.python.org/file13924/unnamed
___
Python tracker
<http://bugs.python.org/issue5
Mitchell Model added the comment:
>http://bugs.python.org/file13925/issue5957.doc.patch
I just spent some time attempting a rewrite, and while I liked what I
ended up with it wasn't all that different from the patch. I'm happy
with the patch.
--
--
--- Mitchell
---
Mitchell Model added the comment:
Yes, that's why I was surprised. It's rare (isn't it?) to have str(a)
== str(b) but a != b. a not is b, sure, but a != b? Note also that
list(range(n)) == list(range(n)). If the lists are equal and the
strings are equal it's hard to
Mitchell Model added the comment:
Sorry -- I did notice in the copies sent to me of my replies to bugs.python.org
that there was HTML, but I can't figure out why. I didn't use any style text
in the message nor in my signature. I thought my email program only sent HTML
when ther
Mitchell Model added the comment:
Sounds right. (1) I was raising the issue in case either the behavior was
unintended or the documentation should mention it; (2) I realize that comparing
ranges is strange; (3) I understand that range works in 3 the way xrange worked
in 2, and that the
Mitchell Model added the comment:
Ah. I see. I hadn't realized that. OK, I see how all the pieces fit together
now. Thanks for all the explanations. They'll help me understand better what
kinds of comments to make on the documentation.
--
--
--
Mitchell Model added the comment:
No, I mean dbm.open. The third paragraph of its documentation says "'c'
to create the database if it doesn’t exist, or 'n', which will always
create a new empty database". This could easily be read as opening the
database just
New submission from Mitchell Model :
Why are there references to "pysqlite" in the documentation and examples
for the sqlite3 module. Was sqlite3 derived from the earlier pysqlite
module? Seems to me that all the references to "pysqlite" should read
"sqlite3&quo
Mitchell Model added the comment:
I see that the _sqlite .h and .c files, and the sqlite3/dbapi2.py file,
all use "pysqlite" instead of "sqlite3" internally. Should that be
changed too, or is there just no point? My main concern is that people
relatively new to Python who
New submission from Mitchell Model :
I can't find any documentation of the exception classes defined in the
sqlite3 module. There are quite a few, and some inheritance. The
examples in the sqlite3 module documentation have a few exception
clauses, but the errors they catch are not explaine
Mitchell Model added the comment:
Thanks for the informatiion about the exception classes documented in the PEP.
I didn't mean to suggest that the information wasn't available. (For that
matter, I was able to extract it for my purposes by looking at the .c source.)
I've been
New submission from Mitchell Model :
2to3 -f import l.py
--- l.py (original)
File p.py (the four modules exist in the same directory as p.py):
from mod_a import a
from modb import b
from mod_c import *
from modd import *
% 2to3 -f import p.py
+++ p.py (refactored)
@@ -1,5 +1,5 @@
-from mod_a
New submission from Mitchell Model :
2to3 changes "import m" to "from . import m" but it doesn't change
"import sub.s".
The directory q.py is in has a file m.py and a subdirectory sub.
The subdirectory sub has a file s.py.
File q.py contains two lines:
im
Mitchell Model added the comment:
Yes, I meant to mention that: the directory sub does contain an
__init__.py with "__all__ = ['s']". I'm attaching a zip of the test
package pkg that contains the sub-package sub.
It wasn't clear to me what "import sub.s"
Mitchell Model added the comment:
Thanks. I sure couldn't find a way!
I encountered this trying to convert someone else's code. There is a
main directory and a subdirectory, both with __init__.py files. The
files in the main directory import each other just by "import
oth
Mitchell Model added the comment:
I apologize. This example evolved from my attempt to simplify things
from the actual code, and I oversimplified to the point where I misread
the 2to3 results. I thought there was a space after the period for the
modules without the underscores in their name but
New submission from Mitchell Model :
The documentation of the for statement in Section 7 of the Python 3
Reference states "range(3) returns the list [0, 1, 2]". Since range() no
longer returns a list, shouldn't this statement be made more precise?
(since this is the referen
New submission from Mitchell Model :
In the documentation of the re module the ASCII flag is described as
"Make \w, \W, \b, \B, \s and \S perform ASCII-only matching instead of
full Unicode matching." This should also include \d and \D.
--
assignee: georg.brandl
New submission from Mitchell Model :
Change the print statements in the example at the bottom of the
documentation for HTMLParser to function calls.
--
assignee: georg.brandl
components: Documentation
messages: 89755
nosy: MLModel, georg.brandl
severity: normal
status: open
title
Mitchell Model added the comment:
Also, while you're at it I think the example should show a call to feed
since HTMLParser is unusual in not taking a contents argument when it is
created. Nothing wrong with the design, and it is clearly stated at the
beginning, but I like examples
New submission from Mitchell Model :
I think it would be useful to have a permalink to the built-in exception
class hierarchy at the end of the library exceptions documentation.
--
assignee: georg.brandl
components: Documentation
messages: 89904
nosy: MLModel, georg.brandl
severity
New submission from Mitchell Model :
In the documentation of the built-in exception class hierarhcy in the
library documentation WindowsError (Windows) and VMSError (VMS) are not
in the same color as the rest of the exception names.
--
messages: 89905
nosy: MLModel
severity: normal
New submission from Mitchell Model :
The documentation of dict.update says that it "accepts either another
dictionary object or an iterable of key/value pairs (as a tuple or other
iterable of length two)" The parenthesized phrase is slightly misleading in
that it could be inte
New submission from Mitchell Model:
In looking at the source for unittest.TestCase I was very surprised to see
quite a few assertion methods that are not included in the module
documentation. Every available assertion method should be included in the
library documentation. Users should not
Mitchell Model added the comment:
My strong apology. I missed a section of the documentation. It didn't seem
possible that they weren't there, but I made a mistake when I checked for them.
Sorry.
> On Jul 12, 2016, at 9:15 PM, R. David Murray wrote:
>
>
> R. David Mu
101 - 138 of 138 matches
Mail list logo
