classification
Title: The description of multiprocessing.cpu_count() is not accurate in the documentation
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.7
process
Status: closed Resolution: wont fix
Dependencies: Superseder:
Assigned To: docs@python Nosy List: asvetlov, docs@python, songyuc
Priority: normal Keywords:

Created on 2019-12-19 11:59 by songyuc, last changed 2019-12-20 10:02 by asvetlov. This issue is now closed.

Messages (3)
msg358675 - (view) Author: (songyuc) Date: 2019-12-19 11:59
In the documentation of Python 3.7, the description of multiprocessing.cpu_count() is "Return the number of CPUs in the system.", but, in fact, this function return the CPU threads number.
msg358676 - (view) Author: Andrew Svetlov (asvetlov) * (Python committer) Date: 2019-12-19 12:13
While your suggestion is technically correct, CPU as a shortcut for "logical processor" is very common in software engineering.

For me, "number of CPU threads" is more unclear than just "number of CPUs"
msg358677 - (view) Author: (songyuc) Date: 2019-12-19 12:26
Hi, Andrew!
Thanks for your explanation! I am sorry about my unfamiliarity about the shortcut, as a student from China whose mother tongue is not English. So I am not quite familiar with the English customs in Computer engineering.
History
Date User Action Args
2019-12-20 10:02:04asvetlovsetstatus: open -> closed
resolution: wont fix
stage: resolved
2019-12-19 12:26:56songyucsetmessages: + msg358677
2019-12-19 12:13:08asvetlovsetnosy: + asvetlov
messages: + msg358676
2019-12-19 11:59:20songyuccreate