From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S971471AbdDTVkE (ORCPT ); Thu, 20 Apr 2017 17:40:04 -0400 Received: from ms.lwn.net ([45.79.88.28]:47610 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S971351AbdDTVkD (ORCPT ); Thu, 20 Apr 2017 17:40:03 -0400 Date: Thu, 20 Apr 2017 15:40:00 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Markus Heiser , Mauro Carvalho Chehab , LKML , Greg Kroah-Hartman , Kees Cook , Anton Vorontsov , Colin Cross , Tony Luck Subject: Re: [PATCH v2 00/11] Documentation: Add ABI to the admin guide Message-ID: <20170420154000.3a5fc945@lwn.net> In-Reply-To: References: Organization: LWN.net X-Mailer: Claws Mail 3.14.1 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, 13 Apr 2017 07:08:43 -0300 Mauro Carvalho Chehab wrote: > That's the third attempt to add support for the Kernel ABI > at the Documentation's admin guide. > > The first approach was based on a generic extension that > calls a random script. This one is based on a new Sphinx > extension with adds a symbol specific for parsing ABI > symbols. > > It adds a new script (scripts/get_abi.pl) with can either > search for ABI symbols that match a regular expression or > outputs the entire documentation found inside a directory > as a ReST book. So I've finally taken a quick look at this. I'm not quite ready to take it for 4.12 at this point, but I guess I'm running out of reasons to block it in general..:) One question, though: is there a reason for the split between the sphinx extension and the Perl script that does the work? Could it all happen in the extension directly instead? It seems like a lot of moving parts. Thanks, jon