[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH] kconfig: remove references to docs/misc/kconfig{,-language}.txt files
- To: Jan Beulich <jbeulich@xxxxxxxx>
- From: Dmytro Prokopchuk1 <dmytro_prokopchuk1@xxxxxxxx>
- Date: Fri, 31 Oct 2025 12:04:18 +0000
- Accept-language: en-US, uk-UA, ru-RU
- Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=epam.com; dmarc=pass action=none header.from=epam.com; dkim=pass header.d=epam.com; arc=none
- Arc-message-signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=b1ws0XCJrVo2C6Slku35u4NK+hyY9C9/vymcCOHaMA0=; b=XWYdPdbDtkbNTrQcnxSUjIi79Ll1x+fpuAvuahbVnrdlt+fjG39aXZXpltlHt90KuU86Qg3Qzx3ui9iUtZcbxKBP+4LCmanoj9y9HkBmtTs+NjwcJEgLa8ueN+Cv+wLisdXsXLoFo2KMeXv6NHZckbdl6wnwrEhaphusbXF78DJ59SYatrG5mwXpC7WFxGqxYGZbAM7/fAyCmdE1r0EYKAKMqclIQ6CMT0vWxaT1LJGD6z1bD17TEYJk8NjoZkngN+iwk1We+VQZeasWyuN8Y2odEkU+NkQFmshupYnPV7yXE0xock/gIZGWicGNcdJ+3ypKCskZtirMd+DF2+LKsA==
- Arc-seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=ahUmKpIYlJOKck9iq5fMGfFckzvcDfOXSzB8cq9aaiHg9naSO0vd6eai4EoKBiyQO4Kh28rzvOaIJ3kfY2Nvv1VI3dr18pOHKUh+mlNnS2z3bNrTC9SqdB9atfd5kPVZIgleMQOdSmd6wuw9cToPIop0GUZXWaQs2Fg/6m69URMeuWArW6ai9OM6g7afa0UFaSj0AMtYgp3RFwf5Dm2pN/swgxg/0J28eyT5tmOg82j1mZm46Ge9cZELN3uFSTEFbhhJYpsmHx1hzmqXdEyCYdnUN1jMy8h/gya1orUxNaCLY1wofYW3TkAQ113XV89o06er0QrZap3cj5rYmTOrGg==
- Authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=epam.com;
- Cc: Andrew Cooper <andrew.cooper3@xxxxxxxxxx>, Anthony PERARD <anthony.perard@xxxxxxxxxx>, Michal Orzel <michal.orzel@xxxxxxx>, Julien Grall <julien@xxxxxxx>, Roger Pau Monné <roger.pau@xxxxxxxxxx>, Stefano Stabellini <sstabellini@xxxxxxxxxx>, "xen-devel@xxxxxxxxxxxxxxxxxxxx" <xen-devel@xxxxxxxxxxxxxxxxxxxx>
- Delivery-date: Fri, 31 Oct 2025 12:04:31 +0000
- List-id: Xen developer discussion <xen-devel.lists.xenproject.org>
- Thread-index: AQHcSNlQlJpHEC5jN02048Fc+YbRObTZJjcAgAMFDIA=
- Thread-topic: [PATCH] kconfig: remove references to docs/misc/kconfig{,-language}.txt files
On 10/29/25 15:57, Jan Beulich wrote:
> On 29.10.2025 14:38, Dmytro Prokopchuk1 wrote:
>> These files 'docs/misc/kconfig{,-language}.txt' were deleted, but
>> references are still present in Xen. Remove them to clean-up.
>>
>> Fixes: f80fe2b34f08 ("xen: Update Kconfig to Linux v5.4")
>
> Hmm, that commit replaced the .txt files with .rst ones, so maybe you want a
> 2nd tag here referencing 044503f61c95 ("docs: Delete kconfig docs to fix
> licensing violation")?
Well, I saw that commit, but intentionally selected first one.
Looks like commit 044503f61c95 is more appropriate.
>
>> --- a/INSTALL
>> +++ b/INSTALL
>> @@ -23,7 +23,7 @@ Xen Hypervisor
>> ==============
>>
>> Xen itself is configured via a `kconfig' system borrowed from Linux.
>> -See docs/misc/kconfig.txt.
>> +See https://www.kernel.org/doc/html/latest/kbuild/.
>
> Is linking to "latest" doc really appropriate, when we don't even try to stay
> up-to-date? That's what Andrew's commit suggests, but I dare to question this.
If the kconfig directory was imported from the Linux kernel v5.4, I
think the following link is OK:
https://www.kernel.org/doc/html/v5.4/kbuild/
>
>> --- a/xen/Kconfig
>> +++ b/xen/Kconfig
>> @@ -1,6 +1,6 @@
>> #
>> # For a description of the syntax of this configuration file,
>> -# see docs/misc/kconfig-language.txt
>> +# see https://www.kernel.org/doc/html/latest/kbuild/
>
> Maybe more specifically
> https://www.kernel.org/doc/html/latest/kbuild/kconfig-language.html
> at least here (with latest possibly replaced as per above)?
>
> Jan
and here:
https://www.kernel.org/doc/html/v5.4/kbuild/kconfig-language.html
Dmytro.
|
