From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-oi1-f176.google.com (mail-oi1-f176.google.com [209.85.167.176]) (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 E26D62D1302; Sat, 14 Jun 2025 13:30:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.167.176 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1749907806; cv=none; b=QoK8CUsocVXuLwGWr4JINsuc49p/H+fNToKEOngPZi+313R2Z3UidyaSzgxzwnlEjfJ7vmNoUhkp+XQ6hsntBTycRZsLFCXNYx0uK3YTJMAZMz888AaMkLUA2sRFvFRa3aZ54IgXG2x0VU0/ALceQNsk83WrH1dWDVCEGV0OU+g= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1749907806; c=relaxed/simple; bh=a4+RnhGxiQVnAjxqCAjlsrCrgJ9m6DH1744AYL0N99M=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=QLah13NC1uvYaD1bk40qkw7QvFEf+EOOLSppZFprzbglAdiQGPEUAWvnAKxVQCqD4+Bs0NWMd+hZBiqGWcxnTpwvBYxwZwS7PHhmNocYflpjZEkYfxa0L1btl8DqDzczG4eXp33DCMhb2Y5XSVctFokSUE3WNKtPKludhDq74qU= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=mpmQn5fw; arc=none smtp.client-ip=209.85.167.176 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com 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="mpmQn5fw" Received: by mail-oi1-f176.google.com with SMTP id 5614622812f47-4066a0d0256so1978231b6e.3; Sat, 14 Jun 2025 06:30:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1749907804; x=1750512604; darn=vger.kernel.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=gpxLAeD+HVolSZVyFVghlR1xvl2/NKfSFQXQsuCC2t8=; b=mpmQn5fwaBvXK3l8w5lHsb6HOwuam6WXJcR7feQccXrkosYcAm2HpemVF+FcnoB78F Rpa1Hjc2kwzQZOPLGFz4U1XsELTHE/IbAxJ9vZVYKZpZjQjf5GF1DW2hYYP3GwVr9d1P Q22to/iO0PxWMIEOCti/hdswiZfjRs5tNIR0b84j1NOFvlQLZyf4WIfPvh6+Pag/WOdY p4GLefZvJcwnSsSAA0YX1+NaCVUDIyxrDyBRoFEIqTqksfPWivtY60/fNIbiEZ4j2H1j sIIOrDoV3ySNbs4k7KW0IW8B4hd6hxm8K67va/HzsAqCdOODktCJF/4f/ERjo0yyEri8 AM1w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1749907804; x=1750512604; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=gpxLAeD+HVolSZVyFVghlR1xvl2/NKfSFQXQsuCC2t8=; b=iADKjewHn7Y0BnPsnbbbpLe7MR0Euf4NmNRYtGeo6VX3EyKqRwru99qzDEqwA/ft8x YJZFgVHJa9Nm1MQ0jVJd/sWdhGDE/kbP4z15RvOdV2KQIho4P4kmjXyBuWi5YkzuLIjE gtJnRZXpRCFjBI76dCmkTOpoziqaYaH5kefAvIlzkfMpN3PZ0j4XF/pPMrtj7As7AlEi EV/uEAZHazejeHi2AvHr18iv7YEja82Ky9N4GEYknDM0f2H0Zniwwn5AKd1Lvnve1Zfg kvb/lznXPjVmVm8B8AG+pNln/QYCbfhqRHh2zLrRruPmlpE36C9diXYd+pCFhDdV009Z 41lg== X-Forwarded-Encrypted: i=1; AJvYcCUVJCJyHoI74IN2MuKo5JxNMLT3vHwd9VqZJfkE8rWmzGGnj0XiYbrm51WzHl1a41T8/2ZaELAI@vger.kernel.org, AJvYcCVnSfFKCO+EGO+PbRe+IqLOwhI4k3Dex2NTDoLnEaUZzyp9rvI7YvTpFBpUSTMOwh6MkAP9LXjV+banu6o=@vger.kernel.org X-Gm-Message-State: AOJu0YxgvE86eqGaVOqSFcI6koBJ3QZtw2XELA8n5q15236lUKw+lkJs ifC4Kas4S49wPFZatdYsnanTzF/Cdb0HVII5uS7db1nJ3BV+eBb/+qVpkjzt57HcOBJIDvKAzh8 hplZEw2FGZjSATCmSGef0RkRnltpZd9c= X-Gm-Gg: ASbGncvUIpK8zbi1BHJMICGZEkeIrttlmqa6BoW+7f6MW7Pakb/uyUX3Da0UbGzlU5+ x88wmKoZz0ZnROXCq7lTDzvyqy8//aH5hDd7GWqiNsr2q0yymbahVmtuWaxgaWjLXYh4aWmGh+e FkHr9woAo6nTSSA4ye1RQNQtf7Ji/GECm9JenJ77Ow6Pec22gW3Ngi+TaJYVHAC8wcpasClGx2I A== X-Google-Smtp-Source: AGHT+IGTVlBMWe1jUtHr/9UxJLQLB7fTFlDVLqP+v2cbZPfJZOQCuTo318T7Bp2vjunGuEb33YuFW6h9rg9YFZ3d2OQ= X-Received: by 2002:a05:6808:1b2c:b0:406:6e31:18a1 with SMTP id 5614622812f47-40a7c1b1ea5mr2201254b6e.2.1749907803915; Sat, 14 Jun 2025 06:30:03 -0700 (PDT) Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20250613141355.1bba92fc@foz.lan> In-Reply-To: <20250613141355.1bba92fc@foz.lan> From: Donald Hunter Date: Sat, 14 Jun 2025 14:29:52 +0100 X-Gm-Features: AX0GCFuxx8riQsYcwnktkvT2HBgg8dodkVLgKdtxUeyINtr1KrOWe6fVqRSEbVM Message-ID: Subject: Re: [PATCH v2 00/12] Don't generate netlink .rst files inside $(srctree) To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Jonathan Corbet , linux-kernel@vger.kernel.org, Akira Yokosawa , "David S. Miller" , Ignacio Encinas Rubio , Marco Elver , Shuah Khan , Eric Dumazet , Jan Stancek , Paolo Abeni , Ruben Wauters , joel@joelfernandes.org, linux-kernel-mentees@lists.linux.dev, lkmm@lists.linux.dev, netdev@vger.kernel.org, peterz@infradead.org, stern@rowland.harvard.edu, Breno Leitao Content-Type: text/plain; charset="UTF-8" On Fri, 13 Jun 2025 at 13:14, Mauro Carvalho Chehab wrote: > > > > > docs: netlink: don't ignore generated rst files > > > > Maybe leave this patch to the end and change the description to be a > > cleanup of the remants of the old approach. > > Ok for me, but I usually prefer keeping one patch per logical change. > In this case, one patch adding support at the tool; the other one > improving docs to benefit from the new feature. My point is that "don't ignore generated rst files" is not a step on the way from the old method towards the new method. The new method does not involve generating any .rst files so the patch is something more like "remove obsolete .gitignore from unused directory".