diff mbox series

[v2] docs: document python version used for compilation

Message ID 20240512-python-version-v2-1-382870a1fa1d@linaro.org (mailing list archive)
State New, archived
Headers show
Series [v2] docs: document python version used for compilation | expand

Commit Message

Dmitry Baryshkov May 11, 2024, 10:32 p.m. UTC
The drm/msm driver had adopted using Python3 script to generate register
header files instead of shipping pre-generated header files. Document
the minimal Python version supported by the script. Per request by Jon
Hunter, the script is required to be compatible with Python 3.5.

Python is documented as an optional dependency, as it is required only
in a limited set of kernel configurations (following the example of
other optional dependencies).

Cc: Jon Hunter <jonathanh@nvidia.com>
Signed-off-by: Dmitry Baryshkov <dmitry.baryshkov@linaro.org>
---
Depends: https://lore.kernel.org/dri-devel/20240507230440.3384949-1-quic_abhinavk@quicinc.com/
---
Changes in v2:
- Expanded documentation for the Python usage.
- Link to v1: https://lore.kernel.org/r/20240509-python-version-v1-1-a7dda3a95b5f@linaro.org
---
 Documentation/process/changes.rst | 8 ++++++++
 1 file changed, 8 insertions(+)


---
base-commit: e8bd80985f8ed4c04e36209228163fcf06496763
change-id: 20240509-python-version-a8b6ca2125ff

Best regards,

Comments

Abhinav Kumar May 11, 2024, 11:52 p.m. UTC | #1
On 5/11/2024 3:32 PM, Dmitry Baryshkov wrote:
> The drm/msm driver had adopted using Python3 script to generate register
> header files instead of shipping pre-generated header files. Document
> the minimal Python version supported by the script. Per request by Jon
> Hunter, the script is required to be compatible with Python 3.5.
> 
> Python is documented as an optional dependency, as it is required only
> in a limited set of kernel configurations (following the example of
> other optional dependencies).
> 
> Cc: Jon Hunter <jonathanh@nvidia.com>
> Signed-off-by: Dmitry Baryshkov <dmitry.baryshkov@linaro.org>
> ---
> Depends: https://lore.kernel.org/dri-devel/20240507230440.3384949-1-quic_abhinavk@quicinc.com/
> ---
> Changes in v2:
> - Expanded documentation for the Python usage.
> - Link to v1: https://lore.kernel.org/r/20240509-python-version-v1-1-a7dda3a95b5f@linaro.org
> ---
>   Documentation/process/changes.rst | 8 ++++++++
>   1 file changed, 8 insertions(+)
> 


Reviewed-by: Abhinav Kumar <quic_abhinavk@quicinc.com>
Jon Hunter May 13, 2024, 8:50 a.m. UTC | #2
On 12/05/2024 00:52, Abhinav Kumar wrote:
> 
> 
> On 5/11/2024 3:32 PM, Dmitry Baryshkov wrote:
>> The drm/msm driver had adopted using Python3 script to generate register
>> header files instead of shipping pre-generated header files. Document
>> the minimal Python version supported by the script. Per request by Jon
>> Hunter, the script is required to be compatible with Python 3.5.
>>
>> Python is documented as an optional dependency, as it is required only
>> in a limited set of kernel configurations (following the example of
>> other optional dependencies).
>>
>> Cc: Jon Hunter <jonathanh@nvidia.com>
>> Signed-off-by: Dmitry Baryshkov <dmitry.baryshkov@linaro.org>
>> ---
>> Depends: 
>> https://lore.kernel.org/dri-devel/20240507230440.3384949-1-quic_abhinavk@quicinc.com/
>> ---
>> Changes in v2:
>> - Expanded documentation for the Python usage.
>> - Link to v1: 
>> https://lore.kernel.org/r/20240509-python-version-v1-1-a7dda3a95b5f@linaro.org
>> ---
>>   Documentation/process/changes.rst | 8 ++++++++
>>   1 file changed, 8 insertions(+)
>>
> 
> 
> Reviewed-by: Abhinav Kumar <quic_abhinavk@quicinc.com>


Thanks! I made a request to update some of our legacy builders and so 
hopefully they might be upgraded to a newer version. Anyway ...

Reviewed-by: Jon Hunter <jonathanh@nvidia.com>

Cheers
Jon
diff mbox series

Patch

diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst
index 5685d7bfe4d0..30f17e3f954f 100644
--- a/Documentation/process/changes.rst
+++ b/Documentation/process/changes.rst
@@ -63,6 +63,7 @@  cpio                   any              cpio --version
 GNU tar                1.28             tar --version
 gtags (optional)       6.6.5            gtags --version
 mkimage (optional)     2017.01          mkimage --version
+Python (optional)      3.5.x            python3 --version
 ====================== ===============  ========================================
 
 .. [#f1] Sphinx is needed only to build the Kernel documentation
@@ -198,6 +199,13 @@  platforms. The tool is available via the ``u-boot-tools`` package or can be
 built from the U-Boot source code. See the instructions at
 https://docs.u-boot.org/en/latest/build/tools.html#building-tools-for-linux
 
+Python
+------
+
+Python is required to generate register headers for the drm/msm driver or to
+build the linker script if the kernel is built using Clang compiler if LTO
+(Link Time Optimisation) is enabled.
+
 System utilities
 ****************