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
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
New submission from Mitchell Model:
The documentation of itertools.accumulate (10.1) starts out with 2 misleading
sentences: "Make an iterator that returns accumulated sums. Elements may be any
addable type..." It then goes on to show examples of using the func parameter
added in 3.
Mitchell Model added the comment:
Patch looks good to me. I like the choice to drop the parens. This is my first
time reviewing a change; did I go through the right mechanics? I clicked Review
on the issue's patch, looked at the diff, and a published a message similar to
this one.
New submission from Mitchell Model:
An index entry should be added for __main__ as it appears in the documentation
of runpy (30.5 in 3.3, 31.5 in 3.4).
--
assignee: docs@python
components: Documentation
messages: 207030
nosy: MLModel, docs@python
priority: normal
severity: normal
New submission from Mitchell Model:
I tried to build the docs for v3.4.0b1 following the instructions in the
Doc/README.txt. My default python is v3.3. I got the following error message:
"Error: Sphinx needs to be executed with Python 2.4 or newer (not 3.0 though)."
I wondered what
New submission from Mitchell Model:
[ctypes correct component for this?]
The TypeError messages given for incompatible types in comparison operators
differ from incompatible types in arithmetic operators. The arithmetic operator
error messages show the names of the types in single quotes
New submission from Mitchell Model:
[Sorry if ctypes is wrong component -- don't know which to use.]
Given an invalid type, int()'s TypeError message includes the name of the
invalid type, but float()'s doesn't. (Nor does complex()'s.) All three should
give analogou
Mitchell Model added the comment:
I still think the Exception class hierarchy should be described in the sqlite3
module documentation. Someone should decide one way or another and close this
issue.
--
___
Python tracker
<http://bugs.python.
Mitchell Model added the comment:
Ping. I just noticed that this is still unresolved in the Python 3.3 docs. This
should be closed, with or without my suggested change.
--
versions: +Python 3.3
___
Python tracker
<http://bugs.python.org/issue8
New submission from Mitchell Model :
I can't find a reference to footnote [1] on page "6. Simple Statements" in
Language Reference. Either the footnote should be removed or a [1] link to it
should appear on the page.
--
assignee: docs@python
components: Documentation
m
Mitchell Model added the comment:
Thanks for letting me know (and with a personalized message, yet!). I wasn't
paying attention -- i verified that the problem exists in 2.7 and 3.1 and I
just dragged 3.1 down to 2.6. Although I've been working furiously in Python
for the past six
Mitchell Model added the comment:
I can see where that does make it tricky. (I also tried reading the plist after
opening the file as binary, but no luck.) The problem here, of course, is that
the only reason for the existence of this library is to read Apple's plist
files, howeve
New submission from Mitchell Model :
plistlib rejects control characters found in XML plists that Apple's 'plutil
lint' accepts. I have attached my Terminal preferences as an example. (plistlib
accepts the contents of the default Terminal preferences file)
--
assignee:
Mitchell Model added the comment:
On Aug 5, 2010, at 3:48 PM, Terry J. Reedy wrote:
>
> Terry J. Reedy added the comment:
>
> Can you suggest a specific link and a specific location where to add it?
I would add a sentence to the first paragraph of the readline doc:
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 :
Requesting a function to be added to the readline module that produces a
dictionary of the current keystroke bindings Also, one to write it to a file in
readline init file format. This would be a big help for people interested in
customizing the behavior
New submission from Mitchell Model :
The documentation of the readline module refers to readline initialization
files, but does not give any information about their format or the available
commands. I realize that this is a standard part of environments that support
readline, not anything
New submission from Mitchell Model :
Strangely, the extensive documentation of the property function in the
"Built-in Functions" of the documentation has no example of the use of a
property. Readers unfamiliar with properties should be told that obj.x invokes
the getter, obj.x
New submission from Mitchell Model :
I am reluctant to post this because (a) I might have made some dumb mistake in
my code, simple as it is, and (b) the problem might be well-known or even
hopeless because the cgi module may not be WSGI compliant, but if this isn't
going to be fixed th
New submission from Mitchell Model :
I created a profile file, started up python3 -m pstats myfilename, did strip,
then "stats 10" and got:
stats 10
Mon Jan 25 17:58:39 2010cd.profile
17529566 function calls (17528644 primitive calls) in 88.626 CPU
seconds
Trace
Mitchell Model added the comment:
Still true in 3.1
--
nosy: +MLModel
versions: +Python 3.1 -Python 3.0
___
Python tracker
<http://bugs.python.org/issue4
New submission from Mitchell Model :
Is there some reason the OS X installer is missing from
http://www.python.org/download/ but present on
http://www.python.org/download/releases/3.1.1/? Seems it should be in
both places.
--
components: None
messages: 96317
nosy: MLModel
severity
New submission from Mitchell Model :
The file Mac/README in the Subversion source continues to refer to 2.6,
not the appropriate version of 3.
--
components: Build
messages: 96316
nosy: MLModel
severity: normal
status: open
title: Mac/README continues to refer to 2.6, not 3
versions
New submission from Mitchell Model :
I'm sure this has been reported before, by I can't find it. Right button
clicks do nothing on Mac OS X -- they don't go to the line of a
traceback, and in debug mode they don't pop up the breakpoint menu.
--
assignee: ronaldousso
New submission from Mitchell Model :
The documentation of urllib.parse contains:
URL encoded
a “url-encoded” string
I am not sure what the official usage is, either in Python or more
generally. Actually, in formal W3C documents the term used is percent-
encoding (with the hyphen, even
New submission from Mitchell Model :
string.capwords has an optional second argument, sep, which is not
documented
--
assignee: georg.brandl
components: Documentation
messages: 93139
nosy: MLModel, georg.brandl
severity: normal
status: open
title: optional second argument of
New submission from Mitchell Model :
Section 2.1 of the tutorial describes using import sys; sys.exit() if ^D
or ^Z doesn't work. However, both quit() and exit() work, as documented
in the "Built-in Constants" section of the Library documentation. Is
there something about them
New submission from Mitchell Model :
Footnote 1 in section 2.1 of the Tutorial and the example of invoking
Python in the middle of the page need their version number upped to 3.2
in both the invocation and the greeting.
The same page in the 3.1 documentation should have the 'a' remove
Mitchell Model added the comment:
No problem with the None's -- I see your point about that. Just that
maybe the alias example should point out that the Nones will be
printed so people won't be surprised and try to figure out what's wrong.
--- Mitchell
On Sep 16, 2
New submission from Mitchell Model :
Just before 6.11.1 of the Language Reference:
"Attempting to use it in class for function definitions"
should be "or" not "for"
--
assignee: georg.brandl
components: Documentation
messages: 92614
nosy: MLModel, georg.
New submission from Mitchell Model :
Near the bottom of the library documentation for pdb there is an example
of a very useful alias:
alias pi for k in %1.__dict__.keys(): print("%1.",k,"=",%1.__dict__[k])
It turns out that doing print in a for loop in pdb results in Non
Mitchell Model added the comment:
There are other places on the same page with weird trailing commas that
should be removed. I think they all follow right parentheses.
--
___
Python tracker
<http://bugs.python.org/issue6
New submission from Mitchell Model :
The help example in the middle of the optparse library documentation is
broken. The code reads:
parser = OptionParser()
parser.add_option("-h", "--help", action="help"),
parser.add_option("-v", action="store_true
New submission from Mitchell Model :
Typing just
alias
in pdb doesn't work. Because dict.keys() now returns a dict_keys object
instead of a list the line
keys.sort()
in Pdb.do_alias breaks because dict_keys doesn't have a sort method.
--
components: Library (Lib
New submission from Mitchell Model :
Some of the executables in lib begin with the line:
#! /usr/bin/env python
Shouldn't that be python3?
--
components: Library (Lib)
messages: 92518
nosy: MLModel
severity: normal
status: open
title: executables in lib use /usr/bin/env python
New submission from Mitchell Model :
The file cgi.py in the lib directory is an executable beginning with the
line:
#! /usr/local/bin/python
Shouldn't that be python3?
--
components: Library (Lib)
messages: 92517
nosy: MLModel
severity: normal
status: open
title: cgi.py runs p
New submission from Mitchell Model :
The library documentation page for pdb shows running pdb as a script
using the command
python -m pdb
Shouldn't that be
python3 -m pdb
?
--
assignee: georg.brandl
components: Documentation
messages: 92515
nosy: MLModel, georg.b
New submission from Mitchell Model :
There should be a standard URL on the web site to reach the
documentation of the current stable release of Python 3.
http://docs.python.org leads to the documentation for Python 2.
I can get to Python 3.1 documentation, but I have to specify 3.1 in the
URL
New submission from Mitchell Model :
The documentation of re.sub states:
"The pattern may be a string or an RE object; if you need to specify
regular expression flags, you must use a RE object, or use embedded
modifiers in a pattern; for example, sub("(?i)b+", "x",
Mitchell Model added the comment:
doh. sorry. I was in a reading mode, not a "using" mode, and wasn't
thinking of the entries as links, though of course I use them that way
all the time. The pages just seemed oddly sprinkled with black items.
All I said is that I couldn
New submission from Mitchell Model :
Documentation of ElementTree.Element.getiterator implies element will
always be included, but it is only included if it matches. (It says
"creates a tree iterator with the current element as the root" and also
says, ambiguously, "iterates ov
New submission from Mitchell Model :
The documentation of ElementTree mentions "path" in describing the
arguments to certain methods. However, "path" is never defined. I
realize that a "path" is (at least a partial implementation of) an
XPath, but there's noth
New submission from Mitchell Model :
Some index entries appear in black. I think this happens only with
top-level entries. I can't find any pattern to which ones are in black,
so it doesn't look like black has any actual significance. The C general
index page is rich wit
New submission from Mitchell Model :
At the end of the introduction page of the library documentation there
is a strange suggestion to begin with "Built-in Objects" as a starting
point. The "Built-in Objects" page consists of two paragraphs that will
surely mystify people ne
New submission from Mitchell Model :
I can't quite sort this out, because it's difficult to see what is
intended. The documentation of xml.etree.ElementTree (19.11 in the
Library doc) uses terms like "iterator", "tree iterator", "iterable",
"list&quo
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 :
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
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 :
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
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 :
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
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
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:
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"
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
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
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 :
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:
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 :
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:
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
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:
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:
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:
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:
>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:
Sorry. Careless again.
--
--
--- Mitchell
--
Added file: http://bugs.python.org/file13924/unnamed
___
Python tracker
<http://bugs.python.org/issue5
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
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:
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 :
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
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
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
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
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 :
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',
Mitchell Model added the comment:
OK
--
--
--- Mitchell
--
Added file: http://bugs.python.org/file13583/unnamed
___
Python tracker
<http://bugs.python.org/issue5658>
___
<!--
blockquote, d
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, 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
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
New submission from Mitchell Model :
The documentation of urlparse in Python2 and urllib.urlparse in Python3
refers to three RFC's, the last of which (RFC 2396) says that it
supersedes the other two and, in fact, clicking on the links to the other
two doesn't work; the link and d
Mitchell Model added the comment:
Never mind about the garbage -- I was looking at weird HTML in the
copy of the message I received but it didn't make it into the entry
on this page. I should have looked first.
--
--
--- Mitchell
--
Added file: http://bugs.pytho
Mitchell Model added the comment:
whoops
Sorry for the garbage in the previous message.
--
--
--- Mitchell
--
Added file: http://bugs.python.org/file13533/unnamed
___
Python tracker
<http://bugs.python.org/issue5
Mitchell Model added the comment:
The problem is not so much that I think people should use it for file
URLs, it's that the behavior when they do can be quite confusing.
Perhaps a note that webbrowser is not meant for file URLs and that
it's behavior is undefine
New submission from Mitchell Model :
The middle sentence of the last paragraph of the documentation of
urllib.request.urlopen is garbled, reading:
"The urlopen function from the previous version, Python 2.6 and
earlier, of the module urllib has been discontinued as urlopen can return
New submission from Mitchell Model :
In the documentation of the urllib.request module, the function
urllib.request.urlretrieve is shown with parameters:
(url[, data][, timeout])
Shouldn't the right bracket after 'data' be after 'timeout'?
--
assignee
New submission from Mitchell Model :
There is a problem with the documentation of the webbrowser module:
opening a URL doesn't necessarily open it in a browser. The
documentation of the open function and method should say that the URL is
opened in whatever application the system chooses
New submission from Mitchell Model :
The sentence introducing "Browser Controller Objects" in the documentation
of the webbrowser module says that the methods parallel two of the
module's convenience functions; it's really three.
--
assignee: georg.brandl
compo
New submission from Mitchell Model :
The second sentence of the re module documentation -- " The re module is
always available." seems extraneous at best. What is it saying? What
modules are not always available? Do other "always available" modules say
that they are alw
Mitchell Model added the comment:
At 11:03 AM -0400 3/19/09, Mitchell L Model wrote:
>>Martin v. Löwis added the comment:
>>
>>> The Python 3 "What's New" should SCREAM that the type file is gone
>>
>>I don't think the documentation should
New submission from Mitchell Model :
MAIN POINT
The Python 3 "What's New" should SCREAM that the type file is gone, not
just that people should use the function open() to open files, since
that has been a recommendation for quite a while.
EXPLANATION
In multiple readings
New submission from Mitchell Model :
In the Python Language Reference, in the Naming and binding section of
Execution Model, there is a paragraph that states:
The following constructs bind names: formal parameters to functions,
import statements, class and function definitions (these bind the
Mitchell Model added the comment:
Whoops! It didn't say "the executable that gets built is called
python.exe", but it is in the build section, so taking things
literally, yes, the executable is called python.exe and I maybe
should have taken it at its word.
There's a s
New submission from Mitchell Model :
Trying to build 3.1 in recent 'svn update's on OSX 10.5 after
make clean
configure --enable-framework
I get the following error near the end of the build:
ld: duplicate symbol _PyExc_BlockingIOError in
libpython3.1.a(_iobase.o) and libp
Mitchell Model added the comment:
Nothing on OSX is ever named .exe.
On OSX building and installing Python with "configure
--enable-framework" installs an executable just called 'python' in
/Library/Frameworks/Python.framework/Versions/3.1/bin (using 3.1 as
an examp
New submission from Mitchell Model :
Line 136 of the 3.0 README and line 179 of the 3.1 README state that the
executable on OSX is called python.exe. It's not.
--
assignee: georg.brandl
components: Documentation
messages: 83203
nosy: MLModel, georg.brandl
severity: normal
status:
New submission from Mitchell Model :
There needs to be something somewhere in the documentation that makes
the simple point that data coming in from the web is bytes not strings,
which is a big change from Python 2, and that it needs to be manipulated
as such, including writing in binary mode
New submission from Mitchell Model :
response = urllib.request.open(someURL)
page = response.read()
close() be called on response after the read(), right? Experimentation
shows that I can repeatedly read from response until I close it, getting
back empty bytes objects.
Thinking that
New submission from Mitchell Model :
In the library documentation of standard types, the instance method
str.format is shown as taking a format-specification as its first
argument. I'm pretty sure that this is incorrect. When format is called
through a string, it is that string that i
1 - 100 of 138 matches
Mail list logo
