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.

classification
Title: Typos in Documentation
Type: Stage:
Components: Documentation Versions: Python 3.0, Python 3.1
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: georg.brandl Nosy List: Bk, georg.brandl
Priority: normal Keywords:

Created on 2008-09-28 08:50 by Bk, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Messages (2)
msg73960 - (view) Author: Bk (Bk) Date: 2008-09-28 08:50
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.
msg73962 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2008-09-28 09:12
Fixed typo 1) in r66669, thanks for that. For 2), "iff" is a usual
abbreviation for "if and only if".

About your two questions, comments in modules are written in whatever
way the author likes to write his comments. There are no rules for that,
other than that a comment should explain the code it comments on. (PEP 8
has some examples of unhelpful comments.)
History
Date User Action Args
2022-04-11 14:56:39adminsetgithub: 48233
2008-09-28 09:12:44georg.brandlsetstatus: open -> closed
resolution: fixed
messages: + msg73962
2008-09-28 08:50:49Bkcreate