From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751197AbdAWN6f (ORCPT ); Mon, 23 Jan 2017 08:58:35 -0500 Received: from mx1.redhat.com ([209.132.183.28]:54704 "EHLO mx1.redhat.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751137AbdAWN6e (ORCPT ); Mon, 23 Jan 2017 08:58:34 -0500 Subject: Re: [PATCH 0/5] kernel-doc tweaks and cleanup of rST vs. non-rST backends To: Markus Heiser References: <20170102152227.9446-1-pbonzini@redhat.com> <20170104150625.5da36137@lwn.net> Cc: Jonathan Corbet , "linux-kernel@vger.kernel.org List" , "linux-doc@vger.kernel.org List" From: Paolo Bonzini Message-ID: <6fae4fd5-2fa9-c1e6-1177-c85d9aadcd17@redhat.com> Date: Mon, 23 Jan 2017 14:58:29 +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: Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.39]); Mon, 23 Jan 2017 13:58:35 +0000 (UTC) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 23/01/2017 14:42, Markus Heiser wrote: > > Am 04.01.2017 um 23:06 schrieb Jonathan Corbet : > >> On Mon, 2 Jan 2017 16:22:22 +0100 >> Paolo Bonzini wrote: >> >>> 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 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. :) >> >> I've played with them a bit, and they don't seem to break things, so I'll >> go ahead and apply them. > > Hi Paolo ! > > Sorry for my late reply, I'am testing patch 2: > > https://www.mail-archive.com/linux-doc@vger.kernel.org/msg08503.html > > but I can't find any changes in the reST output (even not in include/linux/log2.h > you mentioned). May I'm a bit blind today, so can you give me an example where > the patch takes effect? I found this with QEMU. You need to test with an inline function which has attributes with arguments. Paolo