From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S968385AbdADPPZ (ORCPT ); Wed, 4 Jan 2017 10:15:25 -0500 Received: from mail-wm0-f67.google.com ([74.125.82.67]:35432 "EHLO mail-wm0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S968331AbdADPNw (ORCPT ); Wed, 4 Jan 2017 10:13:52 -0500 Subject: Re: [PATCH 0/5] kernel-doc tweaks and cleanup of rST vs. non-rST backends To: Jani Nikula , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org References: <20170102152227.9446-1-pbonzini@redhat.com> <87bmvoihyk.fsf@intel.com> Cc: corbet@lwn.net From: Paolo Bonzini Message-ID: <9b78f94a-e27d-b463-2fe4-a307d8c008b8@redhat.com> Date: Wed, 4 Jan 2017 16:13:32 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.5.1 MIME-Version: 1.0 In-Reply-To: <87bmvoihyk.fsf@intel.com> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 03/01/2017 10:57, Jani Nikula wrote: > 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 Thanks---Perl's not that bad, come on! :) >> 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! ;) Couldn't expect any other deprecation plan from a graphics guy! FWIW I tested building the Sphinx and DocBook books and eyeballed the output for both of them. I also tested manually the list backend on toy testcases, and of course it is used by docproc when building DocBook manuals. I didn't test the other backends. Paolo