From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dy1-f181.google.com (mail-dy1-f181.google.com [74.125.82.181]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id AEE053D3334 for ; Mon, 4 May 2026 14:11:28 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.181 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777903889; cv=none; b=Ev9MFqzc7GpdCUHvXbSa70yt3V45jd1RTqL3rFCCE9DUhorieSuIxkhzNtXuS3wBoaU8q7kqEMVXebykvpWXncwsNLI12bSHY8v8+RlBtb4+oSU/1vS4YqKmN3W7h24N+yYejh65xc4j9PHhb3Ur6VmA828RHyRn05Xu41LiVGU= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777903889; c=relaxed/simple; bh=wXXpEQc9x30X0qg5Z6HGj0zyIUFo72oFGCUTCaDm7g4=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=FfEIDIWcGFX5vmrPdpHa+4jEMbe1FaOqaMx4tEHq0jAzf2NWWFDs/BK+z0cyHppVEufd50NPtrRzncem0KZxPFjjB9tXVzkoG7MnmFsRYoa/Y/2IBqoczMQG4/fiZwhkYoSR+kCGlAu/irsPl6LKmepXkuiVjv2W9oyaVUNqt24= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=roeck-us.net; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=LkwrJ/SV; arc=none smtp.client-ip=74.125.82.181 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=roeck-us.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="LkwrJ/SV" Received: by mail-dy1-f181.google.com with SMTP id 5a478bee46e88-2b4520f6b32so6216599eec.0 for ; Mon, 04 May 2026 07:11:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777903888; x=1778508688; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:autocrypt:from :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:sender:from:to:cc:subject:date:message-id:reply-to; bh=L+DIvmTgHmOKPTVnBRAWjfnew4V3iUKxG9iUGvSM7d0=; b=LkwrJ/SVai+GGyp0BOr/fH03gMHhlRfQnx7CGWCgWis+QADU8Z0KQi7myck4I/JwWY 20kwfth3erhu7x82YYIY2DPGBBWze4Zy8Vn10yPP1kZD+T6+Evcw7XqHwGRwVh7TlelA gzh8gb08bVstJsKB8UwIs4A+LJkMnvpPLSG9AyX0xZCstpuJgoQLpH9rLLU99mhSZmkk aoC5Xx5Dm+vhOEhoCiteUop7LJhnNOwu9sEIqPDmOLstDd3j89docqc/1AHYvv8L3kdR PtwdBpL+5PQSmgHsrOSk6NcFK4g4z4h3BddXDjd3hipySe1bCYw9vFG/8RSHem9dhDrD mCpw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777903888; x=1778508688; h=content-transfer-encoding:in-reply-to:autocrypt:from :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:sender:x-gm-gg:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=L+DIvmTgHmOKPTVnBRAWjfnew4V3iUKxG9iUGvSM7d0=; b=jTBVNenVR1epxroU/f6YchCqfktUERTpLkKMdWarT8OAsuJVJOlE7NTEt1anMdvy8k hXxXjmEz1zXDjV8ny/csvc2Pu56m092z/qNCafxRh5Pz5UPPYx4pOJ7MNJCGFWyD6cNY NV7ztbZdPEZmUsZzQyS7XE6P/KZ4KdKUouhaoWri27eSwKJkrJ1w3m+YwcgGOOH/g0RY e8pMYSJjeN+NTybPlFHFVAwxVz6EgPExbLCi/lvK7JiXo7tK/aSfQXWKHQlvrtBef7Ft RgsxHqNQngMYB9soeO/A34b5e4DbhIWD+07DxeFQ1zbqGmg1TcOtXSOvwZzuA4lH1VAw 0yEA== X-Forwarded-Encrypted: i=1; AFNElJ+9UAVI/truskS7SOVhH86FQs3ZVFumb8ysDDYCQzi8WBXU+IZRPTo1NqtCjasO0f6apGTYOdDiilY=@vger.kernel.org X-Gm-Message-State: AOJu0Yw1mJFI/W/XvQNrImFQGlAGlREsNUkhPeYA9qtxxN1yt84tLgz6 LFb795WSriSSjtl3LjgoxCT6vtXQBvEk/EBP8/kO8GpymG6ihBubad8HxToGvg== X-Gm-Gg: AeBDietfO222H/3BAzJe+yzEtqIgW8DI0Uk0PKLiP8L0ViQMy+cN+DGhRnoEewwIwgR ervRP1Co97Uk9bIwtjL/L/n2naDxX6cL1YTZr+a6jaP6CfME8+vJRbfKqadmH+EDpMLqdReZBuq kw/aiBz/s4ByfamYnTAeyLCJgI+3P/ZLgI75oox3Vx1APIBeNlFCHmvuZX3KsPDh1yHzDLLo4Ca Ekh8eQsRcNNEoHZ2CU95jEQF5AY3Yx9JqrpE51urSHYB+CI8vtc6YzcpUOuJEVbiU/kW+2ALkJq 3mznGiBsL+9zxJDugnZyNWy4HCAsv1s44mh3r8nNSKM/Nsd70wfPmAR2YFj6rRJv+TmcDvU9j1d 1NZXU+SIlIRKyYmytRhQuaRJvba4gyxxpqGReE35rvwOglHZMzKszX1RiEFSWJru9AGrPyQ+Kz1 Bo4XQEf5wRIi7yQyEsaPSPIq3sYtQQ62J1kAjLnhrJ5ZZPaxp4ksJhpSKWllQq5v/LxCEj4FVOT 6DS13DzhvQ= X-Received: by 2002:a05:7300:7490:b0:2e0:909a:b9c with SMTP id 5a478bee46e88-2efb87a8d28mr3924903eec.15.1777903887557; Mon, 04 May 2026 07:11:27 -0700 (PDT) Received: from ?IPV6:2600:1700:e321:62f0:da43:aeff:fecc:bfd5? ([2600:1700:e321:62f0:da43:aeff:fecc:bfd5]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-2ee3537d300sm19477618eec.0.2026.05.04.07.11.26 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 04 May 2026 07:11:26 -0700 (PDT) Sender: Guenter Roeck Message-ID: <2f3ed933-042e-4797-9baf-0f22eeedc632@roeck-us.net> Date: Mon, 4 May 2026 07:11:25 -0700 Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v2 0/5] Cleanup Linux Watchdog documentation To: Philipp Hahn , Wim Van Sebroeck Cc: Philipp Hahn , linux-watchdog@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org References: Content-Language: en-US From: Guenter Roeck Autocrypt: addr=linux@roeck-us.net; keydata= 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 np3900V20aS7eD9K8GTU0TGC1pyz6IVJwIE= In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit On 5/4/26 06:49, Philipp Hahn wrote: > From: Philipp Hahn > > Hello, > > while reading the documentation on the Linux kernel watchdog > subsystem[1] I noticed some strange looking formatting: `struct`s are > detected automatically by Sphinx and the word **after** it is considered > the name of the structure, but the watchdog documentation puts the name > **before** the word `struct`; this leads to the wrong word being > emphasized. > > Also reorganize the index page to better separate the documentation on > generic infrastructure from specific drivers – which are mostly obsolete > and relevant for historic documentation only. > > Please apply; thank you for all your work. > > Philipp > > [1]: https://docs.kernel.org/watchdog/convert_drivers_to_kernel_api.html From Documentation/process/submitting-patches.rst: However, for a multi-patch series, it is generally best to avoid using In-Reply-To: to link to older versions of the series. This way multiple versions of the patch don't become an unmanageable forest of references in email clients. ... but you did that anyway. It also almost guarantees that new versions of a patch series get lost. Guenter