This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Bk
Recipients Bk, georg.brandl
Date 2008-09-28.08:50:46
SpamBayes Score 3.563816e-14
Marked as misclassified No
Message-id <1222591849.99.0.261672488348.issue3983@psf.upfronthosting.co.za>
In-reply-to
Content
Hello,

I would like to contribute to the development of the Python
documentation so I am reporting two typos. The first one is in the
documentation and the second one is in the module ntpath.

1) There's a typo under "The Python Tutorial" > "Using the Python
Interpreter" > "Invoking the Interpreter". The sentence with the typo is
positioned almost at the top, and starts like this:
"On Windows machines, the Python installation is usually placed in
C:Python30 ..."

The above text lacks a backslash in the path "C:Python30". Please add a
backslash to this path so that it would be written as "C:\Python30". The
text should be written like this:
"On Windows machines, the Python installation is usually placed in
C:\Python30 ..."


2) Please take a look at the source code of the module ntpath. The line
63 has a typo in the comment:
# set to 1 iff b makes path irrelevant

which should be
# set to 1 if b makes path irrelevant

Please note that the word 'iff' is fixed to 'if'.



Maybe just two little questions at the end... Please see the source code
of the module ntpath and note the line 72. Since the word in the comment
(i.e. 'But') is a continuation of the same sentence, doesn't it suppose
to be written with the lower-case initial as 'but'?

And also, why do some comments in modules start with the lower-case
initial and end without the dot, and others with the upper-case initial
and end with a dot? It would be nice if those things would be
conventionalized. I really don't understand when a comment must be
written as a sentence with its full orthographical rules. Please explain.
History
Date User Action Args
2008-09-28 08:50:50Bksetrecipients: + Bk, georg.brandl
2008-09-28 08:50:49Bksetmessageid: <1222591849.99.0.261672488348.issue3983@psf.upfronthosting.co.za>
2008-09-28 08:50:48Bklinkissue3983 messages
2008-09-28 08:50:47Bkcreate