From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mauro Carvalho Chehab Subject: [PATCH 0/6] Add support for in-line nested struct comments Date: Fri, 16 Feb 2018 11:48:14 -0200 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: Linux Doc Mailing List Cc: Matthew Wilcox , Jonathan Corbet , Jani Nikula , intel-gfx@lists.freedesktop.org, Tom Saeger , linux-kernel@vger.kernel.org, Mauro Carvalho Chehab , Mauro Carvalho Chehab , David Airlie , dri-devel@lists.freedesktop.org, Rodrigo Vivi List-Id: dri-devel@lists.freedesktop.org VGhpcyBzZXJpZXMgZml4IHR3byBidWdzIGF0IGtlcm5lbC1kb2MucnN0IGV4YW1wbGVzIGFuZCBh ZGQgc3VwcG9ydApmb3IgaW4tbGluZSBuZXN0ZWQgc3RydWN0IGNvbW1lbnRzLgoKSXQgYWxzbyBj b252ZXJ0cyBvbmUgZG9jdW1lbnRhdGlvbiBhdCBpbnRlbF9kcGlvX3BoeSB0byB1c2UgaXQsCmlu IG9yZGVyIHRvIGdpdmUgYSBwcmFjdGljYWwgZXhhbXBsZSBhYm91dCBob3cgdG8gdXNlIGl0LgoK TWF1cm8gQ2FydmFsaG8gQ2hlaGFiICg2KToKICBkb2MtZ3VpZGU6IGtlcm5lbC1kb2M6IGZpeCBl eGFtcGxlIGZvciBuZXN0ZWRfZm9vYmFyIHN0cnVjdAogIGRvYy1ndWlkZToga2VybmVsLWRvYzog Zml4IGV4YW1wbGUgZm9yIGlubGluZWQgY29tbWVudHMKICBkb2MtZ3VpZGU6IGtlcm5lbC1kb2M6 IG1vdmUgaW4tbGluZSBzZWN0aW9uIHRvIGJlIGFmdGVyIG5lc3RlZCBzdHJ1Y3QKICBzY3JpcHRz OiBrZXJuZWwtZG9jOiBzdXBwb3J0IGluLWxpbmUgY29tbWVudHMgb24gbmVzdGVkIHN0cnVjdHMv dW5pb25zCiAgZG9jLWd1aWRlOiBrZXJuZWwtZG9jOiBhZGQgZXhhbXBsZXMgYWJvdXQgbmVzdGVk IHVuaW9uL3N0cnVjdHMKICBkcm06IGludGVsX2RwaW9fcGh5OiBmaXgga2VybmVsLWRvYyBjb21t ZW50cyBhdCBuZXN0ZWQgc3RydWN0CgogRG9jdW1lbnRhdGlvbi9kb2MtZ3VpZGUva2VybmVsLWRv Yy5yc3QgfCA2OSArKysrKysrKysrKysrKysrKysrKy0tLS0tLS0tLS0tLS0tCiBkcml2ZXJzL2dw dS9kcm0vaTkxNS9pbnRlbF9kcGlvX3BoeS5jICB8ICAyICstCiBzY3JpcHRzL2tlcm5lbC1kb2Mg ICAgICAgICAgICAgICAgICAgICB8ICAyICstCiAzIGZpbGVzIGNoYW5nZWQsIDQzIGluc2VydGlv bnMoKyksIDMwIGRlbGV0aW9ucygtKQoKLS0gCjIuMTQuMwoKCl9fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fCkludGVsLWdmeCBtYWlsaW5nIGxpc3QKSW50ZWwt Z2Z4QGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9t YWlsbWFuL2xpc3RpbmZvL2ludGVsLWdmeAo= From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1032471AbeBPNsf (ORCPT ); Fri, 16 Feb 2018 08:48:35 -0500 Received: from osg.samsung.com ([64.30.133.232]:39685 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1032355AbeBPNsb (ORCPT ); Fri, 16 Feb 2018 08:48:31 -0500 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Jani Nikula , Jani Nikula , Tom Saeger , Joonas Lahtinen , Matthew Wilcox , intel-gfx@lists.freedesktop.org, David Airlie , Rodrigo Vivi , dri-devel@lists.freedesktop.org Subject: [PATCH 0/6] Add support for in-line nested struct comments Date: Fri, 16 Feb 2018 11:48:14 -0200 Message-Id: X-Mailer: git-send-email 2.14.3 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org This series fix two bugs at kernel-doc.rst examples and add support for in-line nested struct comments. It also converts one documentation at intel_dpio_phy to use it, in order to give a practical example about how to use it. Mauro Carvalho Chehab (6): doc-guide: kernel-doc: fix example for nested_foobar struct doc-guide: kernel-doc: fix example for inlined comments doc-guide: kernel-doc: move in-line section to be after nested struct scripts: kernel-doc: support in-line comments on nested structs/unions doc-guide: kernel-doc: add examples about nested union/structs drm: intel_dpio_phy: fix kernel-doc comments at nested struct Documentation/doc-guide/kernel-doc.rst | 69 ++++++++++++++++++++-------------- drivers/gpu/drm/i915/intel_dpio_phy.c | 2 +- scripts/kernel-doc | 2 +- 3 files changed, 43 insertions(+), 30 deletions(-) -- 2.14.3