From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757968AbdACJ5w (ORCPT ); Tue, 3 Jan 2017 04:57:52 -0500 Received: from mga01.intel.com ([192.55.52.88]:58124 "EHLO mga01.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750879AbdACJ5l (ORCPT ); Tue, 3 Jan 2017 04:57:41 -0500 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.33,451,1477983600"; d="scan'208";a="804569571" From: Jani Nikula To: Paolo Bonzini , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Cc: corbet@lwn.net Subject: Re: [PATCH 0/5] kernel-doc tweaks and cleanup of rST vs. non-rST backends In-Reply-To: <20170102152227.9446-1-pbonzini@redhat.com> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <20170102152227.9446-1-pbonzini@redhat.com> Date: Tue, 03 Jan 2017 11:57:39 +0200 Message-ID: <87bmvoihyk.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 02 Jan 2017, Paolo Bonzini wrote: > Hi, > > these patches are the result of my experiments with using kernel-doc > for QEMU's documentation. Patches 1 and 2 should be relatively > straightforward, as they are simple bugfixes. Patches 3 to 5, instead, > are making the docbook backend (and the others too) more consistent with > the input and output of the rST backend. I did not test the patches, and for sure I will not attempt reviewing perl, but at a high level the changes seem sensible. Acked-by: Jani Nikula > I am not sure what is the state of the kernel-doc non-rST backends; > but there are still several books using the docbook workflow, so I'm > trying my luck and sending the patches anyway. :) Obviously reStructuredText is the main output now and has to work, and DocBook is still used as you say, but hopefully you sneaked in regressions for the other formats so we can gauge if anyone cares! ;) BR, Jani. > > Paolo > > Paolo Bonzini (5): > kernel-doc: cleanup parameter type in function-typed arguments > kernel-doc: strip attributes even if they have an argument > kernel-doc: include parameter type in docbook output > kernel-doc: make member highlighting available in all backends > kernel-doc: make highlights more homogenous for the various backends > > scripts/kernel-doc | 99 ++++++++++++++++++++++++++++++++++++++++-------------- > 1 file changed, 74 insertions(+), 25 deletions(-) -- Jani Nikula, Intel Open Source Technology Center