From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752859AbcFJORV (ORCPT ); Fri, 10 Jun 2016 10:17:21 -0400 Received: from mga09.intel.com ([134.134.136.24]:2552 "EHLO mga09.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750848AbcFJORU (ORCPT ); Fri, 10 Jun 2016 10:17:20 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.26,450,1459839600"; d="scan'208";a="999326640" From: Jani Nikula To: Jonathan Corbet Cc: Jani Nikula , Markus Heiser , Daniel Vetter , Grant Likely , Mauro Carvalho Chehab , Keith Packard , LKML , linux-doc@vger.kernel.org, Hans Verkuil Subject: [docs-next PATCH 0/9] Documentation/sphinx follow-up Date: Fri, 10 Jun 2016 17:16:54 +0300 Message-Id: X-Mailer: git-send-email 2.1.4 Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi Jon - Thanks for merging the main Sphinx series! I greet you with another set of patches on top. ;) The main things here are reducing the noise on duplicate sections and adding better support for extracting exported symbols when EXPORT_SYMBOLs and kernel-doc are in separate files. And then there are some drive-by cleanups and fixes on top. I'm still working on rewriting Documentation/kernel-doc-nano-HOWTO.txt to reflect all the changes, but didn't want to let these wait for that. BR, Jani. PS. One wrinkle I spotted is that in the kernel-doc directive, :functions: and :internal: also match structs and other types. This is just kernel-doc the script shining its awesomeness through to the upper layer; I just totally missed this earlier. I added :doc: to make the distinction for documents, even though internally that uses kernel-doc -function parameter as well. Should we rename :functions: to, mmh, maybe :symbols: (for want of a better word) while we still can, or leave that in as a historical curiosity? I'm not sure there's much value in adding a separate :types: (or something) for non-functions either? And should :internal: keep returning non-functions as well? Or make that return just functions and have another argument to get the types? Thoughts? Jani Nikula (9): kernel-doc: remove old debug cruft from dump_section() kernel-doc: do not warn about duplicate default section names kernel-doc: add missing semi-colons in option parsing kernel-doc: abstract filename mapping kernel-doc: add support for specifying extra files for EXPORT_SYMBOLs kernel-doc: unify all EXPORT_SYMBOL scanning to one place Documentation/sphinx: remove unnecessary temporary variable Documentation/sphinx: use a more sensible string split in kernel-doc extension Documentation/sphinx: add support for specifying extra export files Documentation/sphinx/kernel-doc.py | 18 +++++--- scripts/kernel-doc | 88 +++++++++++++++++++++++++++----------- 2 files changed, 75 insertions(+), 31 deletions(-) -- 2.1.4