From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.6 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,SPF_HELO_NONE, SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_2 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 73A31C2D0A3 for ; Thu, 29 Oct 2020 09:07:38 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 0D05F2072C for ; Thu, 29 Oct 2020 09:07:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1603962458; bh=Gla487go1VrkmhiLWBVHX3FdQtKupPqvUz9Fe4VLBlw=; h=Date:From:To:Cc:Subject:In-Reply-To:References:List-ID:From; b=OWkeK8yFafNrRzRVpa8eWWLGE0TXiCBz871tXRwkMS8XDoVknkzFeUbYV6SNBe/BI UmV40JVBUpB62Pu8LkrFQI/Fg6hR76xTKzxETN12YVnSOoa4bep0OhftZ3Ry+eLP7q 6rSQYm7MQuxyH8YDPPpmL/vWoLVNhZqqJ7RoccRs= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1725613AbgJ2JHh (ORCPT ); Thu, 29 Oct 2020 05:07:37 -0400 Received: from mail.kernel.org ([198.145.29.99]:52396 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725372AbgJ2JHh (ORCPT ); Thu, 29 Oct 2020 05:07:37 -0400 Received: from coco.lan (ip5f5ad5de.dynamic.kabel-deutschland.de [95.90.213.222]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id E3E64206D9; Thu, 29 Oct 2020 09:07:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1603962456; bh=Gla487go1VrkmhiLWBVHX3FdQtKupPqvUz9Fe4VLBlw=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=E9tz59pEzlwn2SAmW0HovgPF33m/qtgLVhGRLFLo5Mkec9wlPtmF/oPqD7fNr9trZ GlCnF+ra0M41d7UBDnnj90bfNUUIY408OZk0K6CHeP41K3BYx4B2/9xnkQsEImpdE8 S54iav4Sm1Sap+e+zNcQ16Aw7/AVCaIXGO0QnGx8= Date: Thu, 29 Oct 2020 10:07:21 +0100 From: Mauro Carvalho Chehab To: Greg Kroah-Hartman Cc: Linux Doc Mailing List , linux-kernel@vger.kernel.org, Jonathan Corbet , Alexandre Torgue , Andreas Klinger , Anton Vorontsov , Baolin Wang , Bartosz Golaszewski , Benson Leung , Bjorn Andersson , Boris Brezillon , Chao Yu , Chunyan Zhang , Colin Cross , Daniel Thompson , Enric Balletbo i Serra , Fabrice Gasnier , Heikki Krogerus , Jaegeuk Kim , Jingoo Han , Johan Hovold , Johannes Berg , Jonathan Cameron , Kees Cook , Lee Jones , Linus Walleij , Mathieu Poirier , Maxime Coquelin , Mike Kravetz , Ohad Ben-Cohen , Orson Zhai , Peter Rosin , Richard Cochran , Richard Gong , Sebastian Reichel , Srinivas Kandagatla , Stefan Achatz , Tony Luck , Wu Hao , Divya Bharathi , platform-driver-x86@vger.kernel.org, Divya Bharathi , Hans de Goede , Andy Shevchenko , mark gross , Mario Limonciello , Prasanth KSR Subject: Re: [PATCH 00/33] ABI: add it to the documentation build system Message-ID: <20201029100721.0fe83761@coco.lan> In-Reply-To: <20201028144321.GA2302351@kroah.com> References: <20201028144321.GA2302351@kroah.com> X-Mailer: Claws Mail 3.17.8 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Em Wed, 28 Oct 2020 15:43:21 +0100 Greg Kroah-Hartman escreveu: > On Wed, Oct 28, 2020 at 03:22:58PM +0100, Mauro Carvalho Chehab wrote: > > Hi Greg, > > > > As requested, this is a rebased version on the top of v5.10-rc1 > > adding support for having the Linux ABI documentted inside > > the Linux admin manual. > > > > When compared with the version I sent years ago, this > > version has: > > > > - a logic to detect duplicated ABI symbols; > > - it auto-generate cross-reference markups for ABI symbols, > > ABI files and .rst files; > > - Other files from 5.10-rc1 required adjustments in order > > to be accepted by the script in rst-source mode; > > - Some bug fixes. > > > > PS.: I didn't try to merge it against linux-next yet. So, > > I won't doubt that applying it could cause some conflicts. > > > > Feel free to review it. > > In general, I like it. > > If there's no complaints, I'd like to take all of the Documentation/ABI/ > updates in for 5.10-rc2 at the least, to make it easier to build on top > of and to keep these types of mistakes from living longer than they > should be. And make merging easier with other trees over time. I rebased today on the top of linux-next. All patches applied as-is. There's just a few new warnings due to a single patch, added via platform-driver-x86: [PATCH v7] Introduce support for Systems Management Driver over WMI for Dell Systems (plus, it generated a get_abi.pl warning, due to a description added there without Description:) The ReST warnings are: /devel/v4l/docs/Documentation/ABI/testing/sysfs-class-firmware-attributes:2: WARNING: Title underline too short. Dell specific class extensions -------------------------- /devel/v4l/docs/Documentation/ABI/testing/sysfs-class-firmware-attributes:2: WARNING: Unexpected indentation. /devel/v4l/docs/Documentation/ABI/testing/sysfs-class-firmware-attributes:2: WARNING: Unexpected indentation. /devel/v4l/docs/Documentation/ABI/testing/sysfs-class-firmware-attributes:2: WARNING: Block quote ends without a blank line; unexpected unindent. /devel/v4l/docs/Documentation/ABI/testing/sysfs-class-firmware-attributes:173: WARNING: Unexpected indentation. /devel/v4l/docs/Documentation/ABI/testing/sysfs-class-firmware-attributes:173: WARNING: Unexpected indentation. /devel/v4l/docs/Documentation/ABI/testing/sysfs-class-firmware-attributes:173: WARNING: Block quote ends without a blank line; unexpected unindent. /devel/v4l/docs/Documentation/ABI/testing/sysfs-class-firmware-attributes:111: WARNING: Inline emphasis start-string without end-string. Without looking at the file, from the warnings, I suspect that adding a few blank before/after indented lines should be enough to fix them. I'll prepare a separate patch to the file author, fixing those, to be merged via the platform-driver-x86 git tree. Thanks, Mauro