Message18019
The csv module's documentation in python 2.3 has the
following (not
severe) problems:
1. http://www.python.org/doc/current/lib/node545.html
("Modules Contents")
In addition to the problems mentioned in bug #792558
(csv.DictReader parms inconsistent with docs),
there is a
repetition and a typo in the doc for csv.DictReader:
If the row read has fewer fields than the
fieldnames sequence, the
value of restval will be used as the default
value. [...] If the
row read has fewer fields than the fieldnames
sequence, the
remaining keys take the value of the optiona
restval parameter
(the typo is "optiona")
2.
http://www.python.org/doc/current/lib/csv-fmt-params.html
("Dialects and Formatting Parameters")
The first paragraph contains:
In addition to, or instead of, the dialect
parameter, the
programmer can also specify individual formatting
parameters,
which have the same names as the attributes
defined above for the
Dialect class.
but the "attributes defined above" are actually
defined below. Also,
the documentation of the "quoting" paramteres contains:
It can take on any of the QUOTE_* constants
defined below and
defaults to QUOTE_MINIMAL.
which is probably correct for text, DVI, PS and PDF
output formats
but a bit confusing in the HTML output (and perhaps
Info, for the
systems where it is generated--at least in Debian)
since the
"QUOTE_* constants" are defined in another HTML
page (the "Modules
Contents" page). I think a real cross-reference
(\ref or whatever it
is with the python doc. document class) should be
introduced.
3. http://www.python.org/doc/current/lib/node547.html
("Reader Objects")
The first sentence reads:
Reader objects (DictReader instances and objects
returned by the
reader()function) have the following public methods:
where a space is missing between "reader()" and
"function".
4. The docs are not ideally explicit as for what types
of parameters are
accepted by some functions, for instance the "row"
and "rows"
parameters of writer objects in
http://www.python.org/doc/current/lib/node548.html
("Writer
Objects").
Thank you very much for your work on Python!
|
|
Date |
User |
Action |
Args |
2007-08-23 14:16:33 | admin | link | issue797853 messages |
2007-08-23 14:16:33 | admin | create | |
|