Bug: Failed to generate the rtd documenation due to howto.bf.mt.001

[steveyuwono]

1 Describe the bug
I failed to build the HTML while updating the rtd file due to an error found when running the howto.bf.mt.001, as you can see from the screenshot below.

2 To Reproduce
Steps to reproduce the behavior:

1. Go to rtd section
2. Build the HTML of the rtd, by 'make.bat html' or 'sphinx-autobuild . _build/html'
3. The error message appears

3 Expected behavior
See below

4 Screenshots

5 Additional Informations

5.1 Operating System

• Linux
• Windows
• Mac OS

Cross references
https://docs.python.org/3/library/multiprocessing.html?highlight=freeze_support#multiprocessing.freeze_support

[steveyuwono]

Hi @detlefarend , I found an error while building the html for rtd due to howto.bf.mt.001. I wonder, if this problem has also occurred in your PC. If yes, can you have a look on it? Thank you

[detlefarend]

Hi @steveyuwono, it seems to be a Windows specific problem. it runs under Linux and the unit tests are also running. In your screenshot is a hint for solving this. I'll take a look and come back with my findings...

[steveyuwono]

Hi @detlefarend , thank you for your response. I had no time yesterday to solve this issue. Since it's a Windows-related issue, I will also try to figure this out.

[detlefarend]

Hi @steveyuwono, your screenshot shows some hints to solve this problem. I researched a bit and added a call for function freeze_support() to module bf.mt.py. Obviously this is not enough. Could you please make a further try by calling this function in the howto itself as the first statement under if name == 'main:' and comment the call in module mt.py? If this doesn't solve the problem then a Windows specific implementation of creating a new process ("spawn") is necessary...