Received: by 10.223.185.116 with SMTP id b49csp3891125wrg; Mon, 19 Feb 2018 07:40:41 -0800 (PST) X-Google-Smtp-Source: AH8x224Om6VMSSrGS471ZZQfsU/PXJyX3Ggh6C1cgwl2AaRieQsE5CjVfLsrWJFxTi3nGBj/mGze X-Received: by 10.101.73.141 with SMTP id r13mr5624003pgs.161.1519054841729; Mon, 19 Feb 2018 07:40:41 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1519054841; cv=none; d=google.com; s=arc-20160816; b=Tw8AvMtlGlIGcdoPOdFhf9pjaE5yqVKkP4i8L/pA7YPjAq7diiW+fUXaqCPBpGmDbn COULoZ5MLLxaDRbI9v5v45ZrCp4zBTucXghM+b4ZIZ9xakt2AOR5uqEW9fioBg7DQw7p zMneHcHLSUl58VxDgICP0xmNRFiIyr6+LZbTUqIZ2rjWpmMwWLiCFjhd+ZKaBqxYYhx1 hJriv7/CVpFX9P5elw2HmN0uEmnzl5yoh8nmrDQxNq65V9JrWq9UrP3wBqM5kchEIwh+ cw5/Dgx1F8c0ec3Qv3bixL8+FwiyV1EXs/tdDR4Mq+iPXxf8cCkXmqhiS54e21R8rY7A Krtw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-disposition:mime-version:references:mail-followup-to :message-id:subject:cc:to:from:date:dkim-signature :arc-authentication-results; bh=dGtOCvgukC4A4PP4xfWA0TGrdMxK3zjrmQY0RO4PU2w=; b=Eonqp2KHVHnq6PbT7BHwa7ugtSnzqt01flgwRLYsZ0dg5V6pntscF4yIZEglrCxMCa ub2Wnku6hqXGWG7BoBwgK5i3LXyWQvKuvKRPpLMzmg5O0wr0nlEIVg1/y8AFuPV4iW75 4ruyKXiHx47nIlsl3lwOcsWJleZiBKrhoF9Q/l4QIzX/75md0yoV3dYCgdWZZRVGyNE1 q4TyWEtK+TTdfb/SdhEA1nu0LWP/w+1akhmcDoK0kk8J/+b63KOkrKt6b+DdJNfuA0rF JhXoaKDCT2S0iV9qpmn9eopEj8FHINoWQIKrmpWndHRhT+RMXg87yfO3wQcuUlMS5A9j ViZQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@ffwll.ch header.s=google header.b=O7pyY7C9; 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 c17si2522259pfi.259.2018.02.19.07.40.27; Mon, 19 Feb 2018 07:40:41 -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; dkim=fail header.i=@ffwll.ch header.s=google header.b=O7pyY7C9; 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 S1753130AbeBSPjU (ORCPT + 99 others); Mon, 19 Feb 2018 10:39:20 -0500 Received: from mail-wm0-f65.google.com ([74.125.82.65]:33076 "EHLO mail-wm0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753016AbeBSPjS (ORCPT ); Mon, 19 Feb 2018 10:39:18 -0500 Received: by mail-wm0-f65.google.com with SMTP id x4so15829544wmc.0 for ; Mon, 19 Feb 2018 07:39:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=sender:date:from:to:cc:subject:message-id:mail-followup-to :references:mime-version:content-disposition:in-reply-to:user-agent; bh=dGtOCvgukC4A4PP4xfWA0TGrdMxK3zjrmQY0RO4PU2w=; b=O7pyY7C9J19SncOwBgaQnxK0oY6FYqC0UmsB7GlKrLzZdNVNlMF3dnp/4KGdh581OM MA85A0NGpIElYhvn+E2786YEoJywoq2KUB3ffjEjFjU4+gCEwCaw+ShLbU09J9xGr3Sz b4XxJIIzoJyXMz44QSXUujNw/tOjhLoFEnTKI= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:date:from:to:cc:subject:message-id :mail-followup-to:references:mime-version:content-disposition :in-reply-to:user-agent; bh=dGtOCvgukC4A4PP4xfWA0TGrdMxK3zjrmQY0RO4PU2w=; b=IqzNcWWzw79Xw+lgidCx9FLOrMvDwHbwE22tHHY4y4unjMd3XK+gPerg6022ZyURZJ hP8B3ggZIOt3Nru6dpytqFK3a5MJ6XhQrzT/wXj3mrdWSoR5LIfz7iU5dyuRmweLZkGs vH4vpjztLMkKoq+VexE+htbvhNuftZYI+/qEU5yMWiSbBCWanG9iCpN5XtzZL869ZRzc 4mZmf7Yz0Qhs38+nc8gQThhBV0Vo+YrmEzUhbx7VxTk8H2SxnF8aNJKVWo69x3DOxDya y9ZOGb8lana//AYVEigZb4VTeWONuAa4MCct7ve3/Vn4S85VnIHOfvBPUuSv7T2/PS0R UFcA== X-Gm-Message-State: APf1xPCuSfDjiEG/3aEvkUXsp3b+vo9jjomvbqZJi5vJBlxI2UbZiJvX ut7JMRXRRUPdJT33a+mkDW8bPw== X-Received: by 10.80.195.7 with SMTP id a7mr5458754edb.178.1519054756837; Mon, 19 Feb 2018 07:39:16 -0800 (PST) Received: from phenom.ffwll.local (212-51-149-109.fiber7.init7.net. [212.51.149.109]) by smtp.gmail.com with ESMTPSA id o47sm20602012edc.10.2018.02.19.07.39.15 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 19 Feb 2018 07:39:15 -0800 (PST) Date: Mon, 19 Feb 2018 16:39:13 +0100 From: Daniel Vetter To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Matthew Wilcox , Jonathan Corbet , Jani Nikula , intel-gfx@lists.freedesktop.org, Tom Saeger , linux-kernel@vger.kernel.org, Mauro Carvalho Chehab , David Airlie , dri-devel@lists.freedesktop.org, Rodrigo Vivi Subject: Re: [Intel-gfx] [PATCH 0/6] Add support for in-line nested struct comments Message-ID: <20180219153913.GU22199@phenom.ffwll.local> Mail-Followup-To: Mauro Carvalho Chehab , Linux Doc Mailing List , Matthew Wilcox , Jonathan Corbet , Jani Nikula , intel-gfx@lists.freedesktop.org, Tom Saeger , linux-kernel@vger.kernel.org, Mauro Carvalho Chehab , David Airlie , dri-devel@lists.freedesktop.org, Rodrigo Vivi References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: Linux phenom 4.14.0-3-amd64 User-Agent: Mutt/1.9.3 (2018-01-21) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Feb 16, 2018 at 11:48:14AM -0200, Mauro Carvalho Chehab wrote: > 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 Oh, this is cool. Thanks a lot for doing this. -Daniel > > 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 > > > _______________________________________________ > Intel-gfx mailing list > Intel-gfx@lists.freedesktop.org > https://lists.freedesktop.org/mailman/listinfo/intel-gfx -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch