[issue5501] Update multiprocessing docs re: freeze_support

[Roundup Robot]

Roundup Robot added the comment:

New changeset f08d4712a055 by Berker Peksag in branch '3.5':
Issue #5501: Clarify that invoking freeze_support() on non-Windows platforms 
has no effect
https://hg.python.org/cpython/rev/f08d4712a055

New changeset 2902f32d1ae9 by Berker Peksag in branch 'default':
Issue #5501: Clarify that invoking freeze_support() on non-Windows platforms 
has no effect
https://hg.python.org/cpython/rev/2902f32d1ae9

--
nosy: +python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Camilla Montonen]

Camilla Montonen added the comment:

Patch review:

3.X patch:
Applied to docs locally in the default branch(3.6). Docs build passes, doc 
layout has not been broken. 

Applied to branch 3.5. Docs build passes, doc layout has not been broken.

2.X patch:
Applied to docs locally in the 2.7 branch. Docs build passes, doc layout has 
not been broken. 


Comments on the contents of the patch:

if the module is being run normally by the Python interpreter on Windows (the 
program has not been frozen)

For a newbie Python user it might not be entirely clear what 'run normally by 
the Python interpreter' means. Perhaps it would be nice to add a clarifying 
clause 

if the module is being run normally by the Python interpreter ( for example, by 
running python  from the command prompt) on Windows (the program 
has not been frozen)

or something similar.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Davin Potts]

Changes by Davin Potts :


--
nosy: +rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Davin Potts]

Davin Potts added the comment:

Thank you, Winterflower, for the nudge to see this set right.

In truth, invoking multiprocessing.freeze_support() has zero effect on 
platforms other than Windows.

This should be reflected in the 2.7 docs as well as the 3.x docs that are still 
actively being updated.

Attached are 2 patches -- they should be cleanly applied to the 2.7, 3.5, and 
default (3.6) branches.  This change clarifies the last line of existing 
documentation around freeze_support() as well as clearly states what I 
mentioned above.

--
assignee: jnoller -> davin
stage:  -> patch review
versions: +Python 3.5, Python 3.6 -Python 3.2
Added file: 
http://bugs.python.org/file41330/issue_5501_explicit_freeze_support_nonWin_v27.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Davin Potts]

Changes by Davin Potts :


Added file: 
http://bugs.python.org/file41331/issue_5501_explicit_freeze_support_nonWin_v3x.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Berker Peksag]

Changes by Berker Peksag :


--
nosy: +davin

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Camilla Montonen]

Camilla Montonen added the comment:

Hi everyone!
It has been a while since this issue has been updated. 
The addition requested by Brandon Corfman is a simple clarification of what 
happens when the freeze_support function from multiprocessing is called on 
non-Windows platforms (if I understand correctly, the primary purpose of 
freeze_support is to help in creating Windows executables). 
Although there is already some documentation which suggests that no adverse 
effects will occur when running code that calls freeze_support on OS X and 
Unix, I added a sentence in the docs that will hopefully clarify this. 

Patch attached.

--
keywords: +patch
nosy: +Winterflower
Added file: http://bugs.python.org/file41278/issue5501-v1.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Sandro Tosi]

Sandro Tosi sandro.t...@gmail.com added the comment:

Sorry Éric, I don't get it: do you mean that the fact that freeze_support() 
can be called without issues on Unix or OS X is a new feature? or I misread it 
completely?

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Éric Araujo]

Éric Araujo mer...@netwok.org added the comment:

Rephrased: Is this relevant for 3.1?

(Bug and doc fixes go into 3.2, 3.1 and 2.7, but here only 3.2 and 2.7 are 
selected, so I asked if the bugfix/new feature/behavior in question was 
something new in 3.2 and thus not in 3.1.)

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Sandro Tosi]

Sandro Tosi sandro.t...@gmail.com added the comment:

Hello,
well it's just 3 words that can clarify the situation, so maybe just add them 
would be nice

Regards,
Sandro

--
nosy: +sandro.tosi

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Éric Araujo]

Éric Araujo mer...@netwok.org added the comment:

I’m assuming this is a feature new in 2.7 and 3.2, please add 3.1 if this is 
wrong.

--
nosy: +d...@python, eric.araujo

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Ask Solem]

Changes by Ask Solem a...@opera.com:


--
nosy: +asksol

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Terry J. Reedy]

Terry J. Reedy tjre...@udel.edu added the comment:

I think that question is covered by If the module is being run normally by the 
Python interpreter then freeze_support() has no effect.

Jesse, do you think anything more is needed, like '(on any platform)' after 
'interpreter', or should be close this?

--
nosy: +terry.reedy

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Terry J. Reedy]

Changes by Terry J. Reedy tjre...@udel.edu:


--
versions: +Python 2.7, Python 3.2 -Python 2.6

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Jesse Noller]

Changes by Jesse Noller jnol...@gmail.com:


--
priority:  - low

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Brandon Corfman]

New submission from Brandon Corfman bcorf...@fastmail.fm:

Indicate in docs whether freeze_support() can be called without issues
on Unix or OS X, so the user knows whether they can have a single code
base that works correctly on all platforms.

--
assignee: georg.brandl
components: Documentation
messages: 83690
nosy: bcorfman, georg.brandl, jnoller
severity: normal
status: open
title: Update multiprocessing docs re: freeze_support
type: feature request
versions: Python 2.6

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue5501] Update multiprocessing docs re: freeze_support

[Jesse Noller]

Changes by Jesse Noller jnol...@gmail.com:


--
assignee: georg.brandl - jnoller

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue5501
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com