From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 4962CC433F5 for ; Tue, 23 Nov 2021 09:29:50 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id DB2726EB45; Tue, 23 Nov 2021 09:29:49 +0000 (UTC) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by gabe.freedesktop.org (Postfix) with ESMTPS id B66B16EB45; Tue, 23 Nov 2021 09:29:48 +0000 (UTC) X-IronPort-AV: E=McAfee;i="6200,9189,10176"; a="321221779" X-IronPort-AV: E=Sophos;i="5.87,257,1631602800"; d="scan'208";a="321221779" Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Nov 2021 01:29:48 -0800 X-IronPort-AV: E=Sophos;i="5.87,257,1631602800"; d="scan'208";a="650013527" Received: from tmarkand-mobl.ger.corp.intel.com (HELO [10.252.21.82]) ([10.252.21.82]) by fmsmga001-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Nov 2021 01:29:46 -0800 Message-ID: <18b56030-607b-c9dc-b123-d4023b2926ee@intel.com> Date: Tue, 23 Nov 2021 09:29:44 +0000 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.2.0 Content-Language: en-GB To: Randy Dunlap , dri-devel@lists.freedesktop.org References: <20211123050928.20434-1-rdunlap@infradead.org> From: Matthew Auld In-Reply-To: <20211123050928.20434-1-rdunlap@infradead.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Subject: Re: [Intel-gfx] [PATCH] drm/i915/gem: placate scripts/kernel-doc X-BeenThere: intel-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Intel graphics driver community testing & development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: =?UTF-8?Q?Thomas_Hellstr=c3=b6m?= , intel-gfx@lists.freedesktop.org Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" On 23/11/2021 05:09, Randy Dunlap wrote: > Correct kernel-doc warnings in i915_drm_object.c: > > i915_gem_object.c:103: warning: expecting prototype for i915_gem_object_fini(). Prototype was for __i915_gem_object_fini() instead > i915_gem_object.c:110: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst > * Mark up the object's coherency levels for a given cache_level > i915_gem_object.c:110: warning: missing initial short description on line: > * Mark up the object's coherency levels for a given cache_level > i915_gem_object.c:457: warning: No description found for return value of 'i915_gem_object_read_from_page' > > Signed-off-by: Randy Dunlap > Reported-by: kernel test robot > Cc: Thomas Hellström > Cc: Matthew Auld > Cc: Jani Nikula > Cc: Joonas Lahtinen > Cc: Rodrigo Vivi > Cc: Tvrtko Ursulin > Cc: intel-gfx@lists.freedesktop.org Reviewed-by: Matthew Auld