Received: by 10.223.185.116 with SMTP id b49csp1033657wrg; Fri, 16 Feb 2018 11:10:54 -0800 (PST) X-Google-Smtp-Source: AH8x226iRH78yowJIwgx3iDnAKxHA31DtQ5QIGHg2fOwgglgiDvSP26rAmoBIgtFmz3kKoMpv6h8 X-Received: by 10.99.100.196 with SMTP id y187mr5996891pgb.362.1518808254009; Fri, 16 Feb 2018 11:10:54 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518808253; cv=none; d=google.com; s=arc-20160816; b=AgFrM2xFyAISaPcdXlLw1Qe1tR8dQE/epw0zz0Zf3gOwsW9FLBlhUARoCnuu0ekfOs zIBZhZjOjG7W2grTlttrk7cVJoRqIU8n9ZgeBrxhOEUTHZ8xN+s7roKDFgckc1kKU67N tcSKZOES/uOgTm/WYM4Lc5coDmOqx1rYCXqoNmgJBPzncqnQKUI5y4xPzO+Y4AxAG95j UP7AIW9GKgrkEWq1+8wI6SGk3Knr97bChbVBxXVg25ZwGU5Q1L3xzLKO/B9F5Vd9NMkf nzL6rbku1QowtMsJk/AS5ZMzAdv1lPwJlFVbYTYvDS7nhmmJWts4pSq22anjt/W0vHgs nAdQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:references :in-reply-to:message-id:date:subject:cc:to:from :arc-authentication-results; bh=tCAgznQ2yNK+pa5++JvccdJIMCoD6CAlKAvAPKk3QkQ=; b=iM8b9wbFFYs4+rOQji0Dqk0QdXgjDicZ8L5IWctYV538t97BA0qDZ0wGM0EgJpwhWm ERk7k/Nnk/MukvlYNJS70Ran31iEI/LFBZZwlKtFbW2CRcrBY095y2IO/dZJzYsfU7F/ nO9MfZkfral4BaejLsHEHO92Xcahypsoqkw41hwSCgHfMt7pEYk8Vj9xpzCdEnVTkHbu ZsWMcSKgtKnR6tG6LFo0xvA+SXKxSpB1eJ2i7+j1YeoVcqVI8kaNYo5SE4Nj0D4jqnKY XIAhlooB4Y6F9Nk2608pI8BqN4fgxSaHvRRC9BSS6GJj0Vus3LuKAm8OeXei9SBYR/wS gKrg== 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 q13si4635367pgt.6.2018.02.16.11.10.39; Fri, 16 Feb 2018 11:10:53 -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 S1032720AbeBPNtl (ORCPT + 99 others); Fri, 16 Feb 2018 08:49:41 -0500 Received: from osg.samsung.com ([64.30.133.232]:62478 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1032300AbeBPNsa (ORCPT ); Fri, 16 Feb 2018 08:48:30 -0500 Received: from localhost (localhost [127.0.0.1]) by osg.samsung.com (Postfix) with ESMTP id A086234647; Fri, 16 Feb 2018 05:48:29 -0800 (PST) X-Virus-Scanned: Debian amavisd-new at dev.s-opensource.com X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References" Received: from osg.samsung.com ([127.0.0.1]) by localhost (localhost [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id HIw0qQLZ08DV; Fri, 16 Feb 2018 05:48:27 -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 455D134628; 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-0002xj-Vv; 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 , Joonas Lahtinen , Rodrigo Vivi , David Airlie , intel-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org Subject: [PATCH 6/6] drm: intel_dpio_phy: fix kernel-doc comments at nested struct Date: Fri, 16 Feb 2018 11:48:20 -0200 Message-Id: <9ba9ac773f4f9e60770bd9169b0e46ac974d858a.1518788761.git.mchehab@s-opensource.com> X-Mailer: git-send-email 2.14.3 In-Reply-To: References: In-Reply-To: References: Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The in-lined comments for channel.port doesn't follow the syntax described at kernel-doc document, causing the following warning: $ ./scripts/kernel-doc -none drivers/gpu/drm/i915/intel_dpio_phy.c drivers/gpu/drm/i915/intel_dpio_phy.c:154: warning: Function parameter or member 'channel.port' not described in 'bxt_ddi_phy_info' While the best would be for the Kernel to deduce that from the context, supporting it is not trivial. So, let's just stick with the existing syntax. Reported-by: Jani Nikula Tested-by: Jani Nikula Signed-off-by: Mauro Carvalho Chehab --- drivers/gpu/drm/i915/intel_dpio_phy.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/gpu/drm/i915/intel_dpio_phy.c b/drivers/gpu/drm/i915/intel_dpio_phy.c index 76473e9836c6..c8e9e44e5981 100644 --- a/drivers/gpu/drm/i915/intel_dpio_phy.c +++ b/drivers/gpu/drm/i915/intel_dpio_phy.c @@ -147,7 +147,7 @@ struct bxt_ddi_phy_info { */ struct { /** - * @port: which port maps to this channel. + * @channel.port: which port maps to this channel. */ enum port port; } channel[2]; -- 2.14.3