From 5968b8a85603d93efba7f6797eedbd9496bf7ca6 Mon Sep 17 00:00:00 2001
From: Lars Kruse <devel@sumpfralle.de>
Date: Tue, 24 Nov 2020 19:56:10 +0100
Subject: [PATCH] Update python references to python3

Python2 is end-of-life [1] since the 1st of January 2020.

Some distributions (most notably: Debian and its derivatives) will stop
providing a `python` executable in order to encourage users to specify
the interpreter language of local scripts explicitly.  Users of such
environments will be forced to work around this in one of these ways:

* create a virtual environment or
* manipulate the shebangs of the scripts or
* install the python2 package (as long as it is provided by distributions)

All currently maintained distribution releases provide python3.
In the near future distributions will need to remove python2, since it
is not maintained anymore.

PEP-394 [2] recommends to reference a specific python version
(python2 or python3), if the script is not expected to run in a virtual
environment.

Closes: #1265

[1] https://www.python.org/dev/peps/pep-0373/#update-april-2014
[2] https://www.python.org/dev/peps/pep-0394/#for-python-script-publishers

Amended-by: Karl Palsson <karlp@tweak.net.au>
* moved lpc43xx scripts to explicitly call python2, they have not been
  ported, and are effectively unmaintained, but switching them to
  python3 unconditionally would be unhelpful.
---
 README.md                        | 6 +++---
 scripts/data/lpc43xx/csv2yaml.py | 2 +-
 scripts/data/lpc43xx/gen.py      | 2 +-
 scripts/gendoxylayout.py         | 2 +-
 scripts/genlink.py               | 2 +-
 scripts/irq2nvic_h               | 2 +-
 scripts/lpcvtcksum               | 2 +-
 7 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index b0a42619..ba9819dc 100644
--- a/README.md
+++ b/README.md
@@ -62,12 +62,12 @@ Building requires Python (some code is generated).
  Download and install:
 
  - msys - http://sourceforge.net/projects/mingw/files/MSYS/Base/msys-core/msys-1.0.11/MSYS-1.0.11.exe
- - Python - http://www.python.org/ftp/python/2.7/python-2.7.msi (any 2.7 release)
+ - Python - https://www.python.org/downloads/windows/ (any release)
  - arm-none-eabi/arm-elf toolchain (for example this one https://launchpad.net/gcc-arm-embedded)
 
-Run msys shell and set the path without standard Windows paths, so Windows programs such as 'find' won't interfere:
+Run msys shell and set the path without standard Windows paths (adjusting to your version of Python), so Windows programs such as 'find' won't interfere:
 
-    export PATH="/c//Python27:/c/ARMToolchain/bin:/usr/local/bin:/usr/bin:/bin"
+    export PATH="/c//Program Files/Python 3.9:/c/ARMToolchain/bin:/usr/local/bin:/usr/bin:/bin"
 
 After that you can navigate to the folder where you've extracted libopencm3 and build it.
 
diff --git a/scripts/data/lpc43xx/csv2yaml.py b/scripts/data/lpc43xx/csv2yaml.py
index 7b2f8c6d..f8918012 100755
--- a/scripts/data/lpc43xx/csv2yaml.py
+++ b/scripts/data/lpc43xx/csv2yaml.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python
+#!/usr/bin/env python2
 
 import sys
 import yaml
diff --git a/scripts/data/lpc43xx/gen.py b/scripts/data/lpc43xx/gen.py
index af253ddc..286b01ec 100755
--- a/scripts/data/lpc43xx/gen.py
+++ b/scripts/data/lpc43xx/gen.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python
+#!/usr/bin/env python2
 
 import sys
 import yaml
diff --git a/scripts/gendoxylayout.py b/scripts/gendoxylayout.py
index 24154958..5ae63ebb 100755
--- a/scripts/gendoxylayout.py
+++ b/scripts/gendoxylayout.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
 # This python program generates parameters for the linker script generator feature.
 
 # This file is part of the libopencm3 project.
diff --git a/scripts/genlink.py b/scripts/genlink.py
index 96c27e08..9975b132 100755
--- a/scripts/genlink.py
+++ b/scripts/genlink.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
 # This python program generates parameters for the linker script generator feature.
 
 # This file is part of the libopencm3 project.
diff --git a/scripts/irq2nvic_h b/scripts/irq2nvic_h
index 8a1c355c..dbd62018 100755
--- a/scripts/irq2nvic_h
+++ b/scripts/irq2nvic_h
@@ -1,4 +1,4 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 # This file is part of the libopencm3 project.
 # 
diff --git a/scripts/lpcvtcksum b/scripts/lpcvtcksum
index 27dc8a77..85dfe8b1 100755
--- a/scripts/lpcvtcksum
+++ b/scripts/lpcvtcksum
@@ -1,4 +1,4 @@
-#!/usr/bin/python
+#!/usr/bin/env python2
 #
 # Compute and insert the vector table checksum required for booting the
 # LPC43xx and some other NXP ARM microcontrollers.