Re: [PATCH] scripts: use ':Original:' tag to locate the origin file

From: Akira Yokosawa
Date: Fri Sep 13 2024 - 23:47:52 EST


[+CC: Vegard]

Hi,

On Fri, 13 Sep 2024 08:38:24 -0600, Jonathan Corbet wrote:
> Cheng Ziqiu <chengziqiu@xxxxxxxxxxx> writes:
>
>> Simply substitute path may cause file finding failed
>> if we have a different dir map for translation. The
>> ':Original:' tag could be used to locate the origin
>> file if both the tag and file exist.
>>
>> Signed-off-by: Cheng Ziqiu <chengziqiu@xxxxxxxxxxx>
>> ---
>> scripts/checktransupdate.py | 13 +++++++++++++
>> 1 file changed, 13 insertions(+)
>
> Perhaps we need this, but I would really rather move any files that
> don't conform to the English-language directory structure. Having them
> be anything but the same can only lead to this sort of confusion.

+1

Furthermore, the "translations" extension for htmldocs available since
v6.8 at:
Documentation/sphinx/translations.py
assumes the same structure as the English one.

It might be nice for this script to warn about translation docs
whose positions don't match the assumption.

Thanks, Akira

>
> Thanks,
>
> jon