Received: by 10.223.185.116 with SMTP id b49csp1033530wrg; Fri, 16 Feb 2018 11:10:46 -0800 (PST) X-Google-Smtp-Source: AH8x226L+mXR9cSvq2XBhCDSE+LpVAB3LokZ7V3u/B7++bxB9FUlO0UV+KnLd8kuM6adE9U5CIr2 X-Received: by 10.98.72.204 with SMTP id q73mr6582096pfi.48.1518808246293; Fri, 16 Feb 2018 11:10:46 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518808246; cv=none; d=google.com; s=arc-20160816; b=Q482yA5WZMx88PLILk/U/KkDcbEV2A6lOjWVR7gE1FF9WezUf2sWCbfT+5fhu7gsMS 7p4wklhLGPIGXve7uy3oDn/quxEd/ikBErP8TrEKpvI1x3owp+rCqpzXSmqqynU1jHyT hS/HpfTipVLCF3vg1sT0UkmI0Kq0WEbw/ex6PkcVxwGXhNyLsvB3xOT5hZmlF19VsxDL u1BL0g19qliVSwNd6YSh9S/Wo/jCcTgmg4diCBbtR2WmUIIXa6AMa80b+F9FY4V5csVr yY83fC60DtoujSoUAayhFWuHyI+avbjlhb277sm3yw3AlM2QSwYQyXKf1J556yJTvGsR 7GJw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :arc-authentication-results; bh=jGDIrMiZOPzqHOmncSHLW4EOZJWyE1l+pSI1T49McYc=; b=NqGdNrTAffXrP9Lla+4vtUccQlenMs5zruFV7S2P1Y1oWdDZBCejKpV1KxEPwP2Z4K r/8iGHDWwYQJY1FRhkTEpYj4BHN0Y2cpA58dkorhoo4bafndAYY7BfyWS44ECRF/MVPG MDd0MkoA3bLN3nL7AcBMJw0N8trHVp1g8e9aym+jNW+1yEKHLA5gSJ82Bd9BKJufE7cp quNtdcSfV3TtIgPG8o5ARz8BOQUK43MkB/547m4mafCE+WebwvyGhpiUhSW/q5NyWUeO uENjZJd1bvwMgTwGtY54hvTq97+4YXdALAfqGTCiHTqrVVWf2ZFppWBlxdvR/d25/mmv HN2g== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id s88si389839pfa.235.2018.02.16.11.10.31; Fri, 16 Feb 2018 11:10:46 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1032457AbeBPNsf (ORCPT + 99 others); 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 Received: from localhost (localhost [127.0.0.1]) by osg.samsung.com (Postfix) with ESMTP id 7664E3466D; Fri, 16 Feb 2018 05:48:31 -0800 (PST) X-Virus-Scanned: Debian amavisd-new at dev.s-opensource.com Received: from osg.samsung.com ([127.0.0.1]) by localhost (localhost [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id GwdblSBxglNn; Fri, 16 Feb 2018 05:48:30 -0800 (PST) Received: from smtp.s-opensource.com (177.17.248.146.dynamic.adsl.gvt.net.br [177.17.248.146]) by osg.samsung.com (Postfix) with ESMTPSA id 76BDA3462D; Fri, 16 Feb 2018 05:48:27 -0800 (PST) Received: from mchehab by smtp.s-opensource.com with local (Exim 4.89) (envelope-from ) id 1emgNE-0002xM-Sb; Fri, 16 Feb 2018 11:48:24 -0200 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 Precedence: bulk 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