New submission from Ned Batchelder <n...@nedbatchelder.com>:

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.)

----------
assignee: docs@python
components: Documentation
messages: 342386
nosy: docs@python, nedbat
priority: normal
severity: normal
status: open
title: "This module is always available" is confusing

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue36908>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to