[PATCH] doc: Various fixes to makedocbook for python3.8

[Brian Inglis]

On 2020-08-23 13:41, Jon Turney wrote:
> On 23/08/2020 16:23, Ken Brown wrote:
>> On 8/22/2020 2:45 PM, Jon Turney wrote:
>>> ---
>>>   newlib/doc/makedocbook.py | 8 +++++---
>>>   1 file changed, 5 insertions(+), 3 deletions(-)
>>>
>>> diff --git a/newlib/doc/makedocbook.py b/newlib/doc/makedocbook.py
>>> index 92d0f279d..3fab26f1a 100755
>>> --- a/newlib/doc/makedocbook.py
>>> +++ b/newlib/doc/makedocbook.py
> [...]
>> Would it make sense to also change the shebang line so that makedocbook.py
>> uses python3?  Currently the build of Cygwin on Fedora uses python3, but the
>> build of Cygwin on Cygwin uses python2.  This is of no great importance, but a
>> recent IRC discussion shows that it can be confusing.
> 
> Yeah, I guess that would make some sense, given that python2 is now EOL.
> 
> Otoh, making it gratuitously not work with python2 seems a bit harsh.
> 
> On the gripping hand, reading PEP 0394, I see it doesn't actually require that
> 'python' exist at all, so I guess changing the shebang as you suggest is the
> right thing to do.

Is it not perhaps time to switch python from EOL python2 to python3, as there
are only 183 python2, 125 python27 to 199 python3, 129 python37 packages.

We are deemphasising Cygwin 32 and no longer promote it as equal to Cygwin 64,
but are far from calling it EOL, whereas not even security or severe bug fixes
will be considered, never mind distributed, for python2: its death was announced
10 years ago, confirmed 5 years ago, complete 4 months ago, it is now static and
potentially unsafe at 2.7.18, and its estimate of Napier's constant e is as
accurate as it will ever get! ;^>

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in IEC units and prefixes, physical quantities in SI.]