LKML Archive mirror
 help / color / mirror / Atom feed
* [PATCH v2] docs: document python version used for compilation
@ 2024-05-11 22:32 Dmitry Baryshkov
  2024-05-11 23:52 ` Abhinav Kumar
  0 siblings, 1 reply; 3+ messages in thread
From: Dmitry Baryshkov @ 2024-05-11 22:32 UTC (permalink / raw
  To: Jonathan Corbet, Rob Clark, Abhinav Kumar, Sean Paul,
	Marijn Suijten
  Cc: workflows, linux-doc, linux-kernel, Masahiro Yamada,
	linux-arm-msm, dri-devel, freedreno, Jon Hunter

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(+)

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
 ****************
 

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

Best regards,
-- 
Dmitry Baryshkov <dmitry.baryshkov@linaro.org>


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [PATCH v2] docs: document python version used for compilation
  2024-05-11 22:32 [PATCH v2] docs: document python version used for compilation Dmitry Baryshkov
@ 2024-05-11 23:52 ` Abhinav Kumar
  2024-05-13  8:50   ` Jon Hunter
  0 siblings, 1 reply; 3+ messages in thread
From: Abhinav Kumar @ 2024-05-11 23:52 UTC (permalink / raw
  To: Dmitry Baryshkov, Jonathan Corbet, Rob Clark, Sean Paul,
	Marijn Suijten
  Cc: workflows, linux-doc, linux-kernel, Masahiro Yamada,
	linux-arm-msm, dri-devel, freedreno, Jon Hunter



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>

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH v2] docs: document python version used for compilation
  2024-05-11 23:52 ` Abhinav Kumar
@ 2024-05-13  8:50   ` Jon Hunter
  0 siblings, 0 replies; 3+ messages in thread
From: Jon Hunter @ 2024-05-13  8:50 UTC (permalink / raw
  To: Abhinav Kumar, Dmitry Baryshkov, Jonathan Corbet, Rob Clark,
	Sean Paul, Marijn Suijten
  Cc: workflows, linux-doc, linux-kernel, Masahiro Yamada,
	linux-arm-msm, dri-devel, freedreno


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

-- 
nvpublic

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2024-05-13  8:50 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-05-11 22:32 [PATCH v2] docs: document python version used for compilation Dmitry Baryshkov
2024-05-11 23:52 ` Abhinav Kumar
2024-05-13  8:50   ` Jon Hunter

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).