Received: by 2002:a05:6a10:16a7:0:0:0:0 with SMTP id gp39csp4337310pxb; Tue, 10 Nov 2020 13:58:42 -0800 (PST) X-Google-Smtp-Source: ABdhPJyTX4hS1u+YYfRsTKajXXnZ8MHN0KkgPKsxYqXFBkwAGx/8o31cdvVEqw54o5HYxgX0HvsZ X-Received: by 2002:a05:6402:1585:: with SMTP id c5mr1558064edv.372.1605045521871; Tue, 10 Nov 2020 13:58:41 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605045521; cv=none; d=google.com; s=arc-20160816; b=025uKfSDKnt0xmty4aGIfQD4lOVxbOprDfgfAxxu0cxkuySxl39FvOLAKCTKVFRZkh hoPxITjIrvxF6sdA2+FEpTxaNEz12hkFZIEptPiSLJ+Q4H+NhvSMQyAMZgV7lrnSy6og uaYFaNzPxzuhgjMqiGy6XXpcLidD3HMkbWQm4IiD5vbpfz2xexql49rh7h391ZN2jifT 8YQkSGsnvQIw0H71PSK3GPgDWgy0KVZoe7tlhuJt6c3fSsb5UpSSFlAU20QP0IKSO3YP qVmXstNjv+DKlDJ9AJxXXz4kshs06Fa7pLUGfndY6Y1OR/NtEmJMi2g7fJSow1NQBw84 7AeQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:cc:to:subject :message-id:date:from:in-reply-to:references:mime-version :dkim-signature; bh=40omrK6jwVC+aGDjc/p56ppv0VGpUdQ0A5+JFg7+4BU=; b=iASl/IhfR7dhj6BFYHlQXdm4ukKcr8iz/ZlW9dmkqCOyZ6PeuDtfjPd9q44qknMh/i BCj1uBB8JDan2/pCp/oI39NPUKoyPYZVBalsxi/QYCpxP6JHwVj1lDrQkx+B1ZOM55bE xW3sJfyZBbduxw5ommcMiYFoObMwZMr4Ec8AYvs5ISWdST+2F/vBCR/XcLXxX7olcCvZ vzwkFFls/D0+UmgdXEkp9aqRsN9zC/hZClrwhxNAeFDg3sjCztmdaVicpVsWcz47iObg FKPAAI/k4b+cci2yoovPADou8Pl7Xt4GsAhGL1eplbRj+KXZl7KSiz55quD6Hparq+Mb 9doQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=M352Gzv0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id z9si10255656eje.29.2020.11.10.13.58.17; Tue, 10 Nov 2020 13:58:41 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=M352Gzv0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731951AbgKJV4u (ORCPT + 99 others); Tue, 10 Nov 2020 16:56:50 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46004 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726737AbgKJV4t (ORCPT ); Tue, 10 Nov 2020 16:56:49 -0500 Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E2F03C0613D1 for ; Tue, 10 Nov 2020 13:56:48 -0800 (PST) Received: by mail-wr1-x443.google.com with SMTP id k2so10989980wrx.2 for ; Tue, 10 Nov 2020 13:56:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=40omrK6jwVC+aGDjc/p56ppv0VGpUdQ0A5+JFg7+4BU=; b=M352Gzv0QFRwWiCLRwUwno3Jg8Xz7FeRCTZVmlV/O/l73Iy4IHTrK26aGfaVEGKdH0 3JcMPIYM+ycOaq7AZtFqSMFyvwH5L/6tLuJgQqUO8OxjH7C/eweuJaKi/Q5vBamhW95h x1WXVzTDGvpX1cSHlfOh6n9AEEQLrt67YRyd6i25HbWvF3NYkrKNedhIrUFmpH/FV8si ySRZVtT723W+dsFnPtUUvfI7wCd4RhGjO7J4Yh2gTDycOpZKLn60ggtZp56uOH7V1enC FxJRrIkV6hM64e5F+tiIQH7QPh6RkbSdRy/DDXBlK03vozbBt1Ox0Ja2RawvhrGHlijA FpVw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=40omrK6jwVC+aGDjc/p56ppv0VGpUdQ0A5+JFg7+4BU=; b=jNofXsCTlqnI3IQ/0OrVWPFTcDiofV05LoBf4KJPx/IlkL6LJ72ll5iwf/1bx4IpMa oLFjqmPjPlX4XIjEnTcPxjUW1+/IuOiJov778NgHzQ7NPQb4VBqZEnLfVTUnIWZqyXJ9 YsJZrcUwZ0g2yv/lWqnvrOgs6hVLZMf9fCnLI4YOmxGmaOf3a4VD9JYq7XtoAveucXHV 9k1+o7KYsXeuuD8iZFzXR7a5iAgG5jdEj/j/61ll/mRj9fPJslm/F0UACmPvOC/Nydoe jYK8gtjyr9f1wuwh8xhtJPjSi+6JQbmLAR4ko/zdDe/h3lczo8Yay7uNQfAHw4fgFlmd 2sZg== X-Gm-Message-State: AOAM531FjZ4uRCmFR2HqcLIFlMxlx1zlnGVsyJ0TYX3mLkv+DGSPRzA8 RTwXyU1kUGiJTTeTkKhiF0OoN09ko/O19UGwAM0= X-Received: by 2002:adf:e9c9:: with SMTP id l9mr27739118wrn.124.1605045407718; Tue, 10 Nov 2020 13:56:47 -0800 (PST) MIME-Version: 1.0 References: <20201106214949.2042120-1-lee.jones@linaro.org> <20201106214949.2042120-12-lee.jones@linaro.org> In-Reply-To: <20201106214949.2042120-12-lee.jones@linaro.org> From: Alex Deucher Date: Tue, 10 Nov 2020 16:56:31 -0500 Message-ID: Subject: Re: [PATCH 11/19] drm/radeon/radeon_drv: Source file headers are not good candidates for kernel-doc To: Lee Jones Cc: David Airlie , LKML , amd-gfx list , Maling list - DRI developers , Alex Deucher , Gareth Hughes , =?UTF-8?Q?Christian_K=C3=B6nig?= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Nov 6, 2020 at 4:50 PM Lee Jones wrote: > > Fixes the following W=3D1 kernel build warning(s): > > drivers/gpu/drm/radeon/radeon_drv.c:2: warning: Cannot understand * fil= e radeon_drv.c > > Cc: Alex Deucher > Cc: "Christian K=C3=B6nig" > Cc: David Airlie > Cc: Daniel Vetter > Cc: Gareth Hughes > Cc: amd-gfx@lists.freedesktop.org > Cc: dri-devel@lists.freedesktop.org > Signed-off-by: Lee Jones Applied. Thanks! Alex > --- > drivers/gpu/drm/radeon/radeon_drv.c | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/drivers/gpu/drm/radeon/radeon_drv.c b/drivers/gpu/drm/radeon= /radeon_drv.c > index 560267cc25892..bb7b33e535f81 100644 > --- a/drivers/gpu/drm/radeon/radeon_drv.c > +++ b/drivers/gpu/drm/radeon/radeon_drv.c > @@ -1,4 +1,4 @@ > -/** > +/* > * \file radeon_drv.c > * ATI Radeon driver > * > -- > 2.25.1 > > _______________________________________________ > dri-devel mailing list > dri-devel@lists.freedesktop.org > https://lists.freedesktop.org/mailman/listinfo/dri-devel