Message 342386 - Python tracker

Message342386

Author	nedbat
Recipients	docs@python, nedbat
Date	2019-05-13.21:15:22
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1557782122.73.0.455327263081.issue36908@roundup.psfhosted.org>
In-reply-to

Content
The math and cmath modules say this in their docs: "This module is always available." This lead a beginner to believe they didn't need to be imported. Nearly the entire standard library is always available in this sense (they can be imported). This sentence isn't useful. Can we change the first paragraph of the math module to be: "This module provides access to the mathematical functions defined by the C standard." (and similarly for the cmath module.)

Content

The math and cmath modules say this in their docs: "This module is always available."  This lead a beginner to believe they didn't need to be imported.

Nearly the entire standard library is always available in this sense (they can be imported).  This sentence isn't useful.

Can we change the first paragraph of the math module to be:

"This module provides access to the mathematical functions defined by the C standard."

(and similarly for the cmath module.)

History
Date	User	Action	Args
2019-05-13 21:15:22	nedbat	set	recipients: + nedbat, docs@python
2019-05-13 21:15:22	nedbat	set	messageid: <1557782122.73.0.455327263081.issue36908@roundup.psfhosted.org>
2019-05-13 21:15:22	nedbat	link	issue36908 messages
2019-05-13 21:15:22	nedbat	create