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=-3.8 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED 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 C1873C388F7 for ; Thu, 29 Oct 2020 00:55:42 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 7661220790 for ; Thu, 29 Oct 2020 00:55:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1603932942; bh=4Sd9H0iyDibm66VtOY/tpVPi01ikmzIRBw+3lZNBRkA=; h=Date:From:To:Cc:Subject:References:In-Reply-To:List-ID:From; b=V3XwtoAS5PJBxtwYvoMWzw7+ajBI7rInB1pfIVq2xQQBm4crNEOxlh4isaYhP3Z5Y Y4ZdpaPa7j5LX2lCtLj+KJQ0bXV5Zcr8Z62870aH1YmtYBG8vv7EnTuZpfp7PyggSY QTbEXWT1HBP+0HBwmnwz2Kaghw6JrqZvs0AjcD9g= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731805AbgJ2AzO (ORCPT ); Wed, 28 Oct 2020 20:55:14 -0400 Received: from mail.kernel.org ([198.145.29.99]:60546 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1731643AbgJ1WRk (ORCPT ); Wed, 28 Oct 2020 18:17:40 -0400 Received: from localhost (83-86-74-64.cable.dynamic.v4.ziggo.nl [83.86.74.64]) (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 087402479D; Wed, 28 Oct 2020 14:38:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1603895925; bh=4Sd9H0iyDibm66VtOY/tpVPi01ikmzIRBw+3lZNBRkA=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=KGaDEITLa8T0x4V05EzNRarwdt3hxDWgQN16RmuXdjF4BTMRJajQ15BfJiUQuWvRX bfgLI66sIN0EZ4e5bsVenI23KFXFIXacm5HLwS0ZkZEcZUkFJa32//fy0c8DRq6Uee gxnN2jsoqzmFbwr0eRv5CHpXSJPolbpj1y6kw8z0= Date: Wed, 28 Oct 2020 15:39:37 +0100 From: Greg Kroah-Hartman To: Mauro Carvalho Chehab 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 Subject: Re: [PATCH 00/33] ABI: add it to the documentation build system Message-ID: <20201028143937.GA2302095@kroah.com> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org 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. After applying the first 10 patches, and running it, I see a bunch of these types of warnings: Use of uninitialized value $kernelversion in substitution (s///) at ./scripts/get_abi.pl line 444. Use of uninitialized value $users in substitution (s///) at ./scripts/get_abi.pl line 446. Use of uninitialized value $users in substitution (s///) at ./scripts/get_abi.pl line 447. When doing something like: $ ./scripts/get_abi.pl search usb --dir Documentation/ABI/stable/ Is that expected? thanks, greg k-h