Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Message-ID: <0d6fc9fb-b875-e3fa-fe89-c40dab63fa91@amd.com>
Date:   Fri, 2 Dec 2022 10:30:45 -0600
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.4.2
Subject: Re: [PATCH] docs: Integrate rustdoc into Rust documentation
Content-Language: en-US
To:     Miguel Ojeda <miguel.ojeda.sandonis@gmail.com>
Cc:     corbet@lwn.net, ojeda@kernel.org, bilbao@vt.edu,
        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
        konstantin@linuxfoundation.org, Akira Yokosawa <akiyks@gmail.com>
References: <20221130220825.1545758-1-carlos.bilbao@amd.com>
 <CANiq72nMY5f85tJJFg7AFsh4YRrKObhurhT8TVawYqoZU+J-Fg@mail.gmail.com>
 <15942593-5ec7-77a6-8637-61ca495d7528@amd.com>
 <CANiq72kkkbhYn44Mxn=55SLNHgqoAyiEadOAkprNpQOMaNAHUg@mail.gmail.com>
From:   Carlos Bilbao <carlos.bilbao@amd.com>
In-Reply-To: <CANiq72kkkbhYn44Mxn=55SLNHgqoAyiEadOAkprNpQOMaNAHUg@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?SEFkY1ptaFpHcDBPbEl2RHFNM3BCQnIwenJHSUFiVXBYdVhRWlJralhyNnor?=
 =?utf-8?B?YVp6NmpST0pWdG1ZOHpmZmZCUk04bDYvc3UzRkp3b3VNME1yVDF2QmJ0R3JR?=
 =?utf-8?B?V3RFRVl0dVlTbWZ2Nk51NFF4Wmh2WHR1OElaZFhJTWNCOVEvOGpqbnI3ODZL?=
 =?utf-8?B?VEd6d2dGTkVxdEJ2MXFVNmEzdXpLZUd2OEhJbVBENzgxSGxrdXYrNmJBWWdN?=
 =?utf-8?B?ckwzNlJ0WlUvbzVjaGhRSzJvRHN5VG52YkRudERyT0xId1IxWTJTZjR6WFpP?=
 =?utf-8?B?RWZmRjlodCtpT0ZmM0ZCbWhxWFVlSHRyT21rR2dqL1VMcEwzOWJVd2ZoQita?=
 =?utf-8?B?dEVRK2NUcGFNS2txNDRoVWJ5eGh2MkQ5aEZqb0o4d3A4ZWVvTDdwT21lNlZT?=
 =?utf-8?B?UDNMNGplNGNUKzZYZ0k3am1RSUlTbEVEYk9aaUZhamZIS1hHTHRuaHVpeSta?=
 =?utf-8?B?THZ3OWcwNTdaaW04Y2p3TGRURnprN01BZGFMYXdHY3pBLyt4WkJDNHpBTlZM?=
 =?utf-8?B?aG05Y3BLMi85RGlqWXhmWmlJOEpkcXR4dzJ6TWNwUm81cHJEQm1zSzdzNzYw?=
 =?utf-8?B?M3N3RTlhcXVPdmZWOWNVcUtOcDJEN2hiKzZFMFZhMytTaE1vc0NTZWhLY25l?=
 =?utf-8?B?d1dvWjVDbkZQLzNmbjZCMFNzenZyQ0FnTWp6RC9SQkVFMXZuUFp3LzBhS2pa?=
 =?utf-8?B?dFpkcWcxNnV0aHJVSmF3Tk1BRUROL1JiT2wzUHpFNW5pb3NhYVpRTzV0aEZS?=
 =?utf-8?B?bVpUTXMrRHUzQlBGbU1ZcE9MTG9BWUJaVkxXWWF5Y0kxNkQ2VkxNOFljTWhp?=
 =?utf-8?B?aHIrUGIzc3VVQVFHNUlJbjVpRUxQN1cvYmNwbXpTdHozZ0lrSERoclFOVUxD?=
 =?utf-8?B?NFJqL24vd05MaEtsVXJ6dnMzRjM3bjlJaGpjTlJwRWF0UlZKeUtOT0xqOWN1?=
 =?utf-8?B?OVgxTjFFTjBkNlMzSHBlb1lCd3FsbVd0cHF2OWM2bXh5ODY0TU9WWlFQRnhH?=
 =?utf-8?B?cU5BeDA0dU9PWElNTlE1UjJOMy9LNk1oZFRXU0xycW5pd0VMU1NPODV0T0V0?=
 =?utf-8?B?OHFTUC93Q1JnbmVZa3Y3WXBycFhzZTVVb0orakZFcWRvbWhNQlhEQ3REYzVR?=
 =?utf-8?B?L0xhRlc4UHRrMkd2YXZtdnVvY1ZUYUx3U1VOUy81NVRLTTlwS2JKRDlOZ2RH?=
 =?utf-8?B?YjdTOXdzSFlRQzVaenY2blp1RVVxaXRkSS9ydWt4MEVJKzJJMDdueTJGdGp0?=
 =?utf-8?B?aXRQN05tSDF5V3FNREdwTktOOTFDU09lV1d0TFpXNXR6aTl0bXFoSnE4STFE?=
 =?utf-8?B?QUZCM1AwWUNPRWRQWHFPU3N2SjBnZ0dUUXNWVUNoYzBVcklETGs5K3R0Mmsv?=
 =?utf-8?B?WU03RWFML2Q5bXNIMW9aVWZYZXQ0b2ozb2JxbU1SL0ZmcGRTUmVBeU1Wano1?=
 =?utf-8?B?V2dKRXc0MHgrRy9xQWhBaCtabHIwbTRjU1dvR2I3cFhpaUxVVTF1MmN1TUhR?=
 =?utf-8?B?TWlITG44ejZYZjRrRTdXWTllZmVLZWhLc1ljTHRId2EzbWhSRUNOcTJsaEE2?=
 =?utf-8?B?RmpSa2tyNTRKSk5TMTZ1Uk1VODAvZFl5ZjFwZGVWZTQ2SFZ0T1VsSVQxcGFT?=
 =?utf-8?B?VFJnUzBtNlBFRGVITjhIK3NHZGMwT3JNck0yOVZEeGVkeE5XN2Q3RmdOWjVT?=
 =?utf-8?B?MTZkUVltTjNTNDk5UlJYSW8zSHl6N1dOalQ3UXFkYVhDZVJBOHBiVUZYeTBR?=
 =?utf-8?B?OTlUK211ZCt2T01GM3hJemxVOWJaZ1JVRkRjWFArVTgvWk9WUmRtWldsVFBJ?=
 =?utf-8?B?cndMT1NrS0R4Yis0T2p3T2VTZVIxVXlSb3M3ZythQnlpVy9tS1dScld3N2l3?=
 =?utf-8?B?Vm9pUFovdm1zNEN6Q1gyYjdOUmllK1V5V2wwb2M5bGREK3BXSEhQeC83UFds?=
 =?utf-8?B?aTdZTGNzZ2JpNklEM0hPZjdhYUd6L3djaHlVbEdBbHZmYWhMMjVPeVJUaWIv?=
 =?utf-8?B?eG1VT3JSVnNidkNrM0xwSEl2NnJab1dtcVNuVjRhTjJ5RG5jZE5SYWZDWlJN?=
 =?utf-8?B?VmkwNFUzbEhtS2RQZklhaUpIUy9vMzAyNmZBN2kvbE5lZVpzNENlMzN0N3Bl?=
 =?utf-8?Q?KqQtYfZH6Lg5Y8fNDO10D8g2T?=
X-OriginatorOrg: amd.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 1f0d4c83-6033-40f5-a455-08dad4829158
X-MS-Exchange-CrossTenant-AuthSource: BL1PR12MB5874.namprd12.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Dec 2022 16:30:47.7250
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: bKfrAT848zXWHAJLTEeWKcy6VxkFQLVRtN0Jq2HMPafT4+0JbsQYYgVJ+GtRSdhD89WKCophtoXzft0gEo/59g==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY5PR12MB6153
X-Spam-Status: No, score=-2.4 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS autolearn=ham
        autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On 12/2/22 10:27, Miguel Ojeda wrote:

> On Thu, Dec 1, 2022 at 9:40 PM Carlos Bilbao <carlos.bilbao@amd.com> wrote:
>> I don't understand config sync. Perhaps that, e.g. Documentation/Makefile
>> checks for broken docs, for CONFIG_WARN_MISSING_DOCUMENTS, but we don't
>> do that for rust/Makefile? I'm not sure, but it does sound orthogonal, yes.
> Config sync is what needs to happen to make a bunch of files in
> `include/` up to date with respect to the `.config`. It runs
> automatically for some targets, but not always. For instance, the
> `*docs` targets do not trigger it. So if you enable e.g.
> `CONFIG_WARN_MISSING_DOCUMENTS`, and immediately afterwards run
> `htmldocs`, it will not take it into account.
>
> But don't worry about it: that part of my comment was directed at
> others (e.g. Jon, Akira...) that may know the historical context or
> the reason behind it -- no need to fix it here. I mentioned it here
> since it affects `CONFIG_RUST` if we use it there (in the same way as
> the other `CONFIG_*` used there).


Ah, that makes sense. I appreciate the clarification!


>
> Cheers,
> Miguel


Thanks,
Carlos