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 0C736C77B7D for ; Fri, 5 May 2023 10:30:40 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 6211210E5BE; Fri, 5 May 2023 10:30:40 +0000 (UTC) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by gabe.freedesktop.org (Postfix) with ESMTPS id 127ED10E5BE for ; Fri, 5 May 2023 10:30:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1683282638; x=1714818638; h=from:to:cc:subject:in-reply-to:references:date: message-id:mime-version; bh=8dVItnse4cVZ/9pnp65G1NuFdOm4UzGFrA4BI/DsXCg=; b=czPw3e4KppZqamqC0YWeGSoasFD8M72P5QYByISq16OYk7fDmstkqXbU 7AEa8YIl1my5SUHIhRML4In2lZGUCfcgza8sQr64++mD8o9Zhcm5ayg/5 J0J52S3hijAinjsNP863zp2paNfvbOWcpPUhcQQHs7GZ3B24qqqsW09xx t8hX9KEEDUZdFnAePTelSAtGteEJcIVOxteM02sEUmDZKU52zSI//9HDc 9saY4TMU2ULYR03AQ8m0a7SzUFSVTQJKbkq3PrMleUGmjQkjGzilSiEnS cdnOF9ANQDhI1eYduxEKHPSbIk9FKkPRa2tJIFucCN5qtMeLYrLN055I0 Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10700"; a="349217492" X-IronPort-AV: E=Sophos;i="5.99,251,1677571200"; d="scan'208";a="349217492" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 05 May 2023 03:30:37 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10700"; a="1027420302" X-IronPort-AV: E=Sophos;i="5.99,251,1677571200"; d="scan'208";a="1027420302" Received: from jsanche3-mobl1.ger.corp.intel.com (HELO localhost) ([10.252.37.83]) by fmsmga005-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 05 May 2023 03:30:36 -0700 From: Jani Nikula To: Rodrigo Vivi In-Reply-To: Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <87fs8czc46.fsf@intel.com> Date: Fri, 05 May 2023 13:30:33 +0300 Message-ID: <87v8h7xe7q.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Subject: Re: [Intel-gfx] [PATCH 10/24] drm/i915/gem: fix function pointer member 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: intel-gfx@lists.freedesktop.org, mchehab@kernel.org Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" On Thu, 04 May 2023, Rodrigo Vivi wrote: > On Thu, May 04, 2023 at 12:20:41PM +0300, Jani Nikula wrote: >> On Wed, 03 May 2023, Rodrigo Vivi wrote: >> > On Tue, May 02, 2023 at 06:37:27PM +0300, Jani Nikula wrote: >> >> You can't document function pointer member as functions. >> >> >> >> drivers/gpu/drm/i915/gem/i915_gem_region.h:25: warning: Incorrect use of kernel-doc format: * process_obj - Process the current object >> >> drivers/gpu/drm/i915/gem/i915_gem_region.h:35: warning: Function parameter or member 'process_obj' not described in 'i915_gem_apply_to_region_ops' >> >> >> >> Signed-off-by: Jani Nikula >> >> --- >> >> drivers/gpu/drm/i915/gem/i915_gem_region.h | 4 +--- >> >> 1 file changed, 1 insertion(+), 3 deletions(-) >> >> >> >> diff --git a/drivers/gpu/drm/i915/gem/i915_gem_region.h b/drivers/gpu/drm/i915/gem/i915_gem_region.h >> >> index 2dfcc41c0170..8a7650b27cc2 100644 >> >> --- a/drivers/gpu/drm/i915/gem/i915_gem_region.h >> >> +++ b/drivers/gpu/drm/i915/gem/i915_gem_region.h >> >> @@ -22,9 +22,7 @@ struct i915_gem_apply_to_region; >> >> */ >> >> struct i915_gem_apply_to_region_ops { >> >> /** >> >> - * process_obj - Process the current object >> >> - * @apply: Embed this for private data. >> >> - * @obj: The current object. >> >> + * @process_obj: Process the current object >> > >> > hmm... >> > looking to the process_obj itself I wonder if we don't have a better way >> > to document these function pointer arguments that could be acceptable >> > instead of simply removing them. >> >> The alternative is pretty much to document the parameters in plain text >> or some mild rst formatting that's not specifically kernel-doc parameter >> documentation. > > :( something that could be improved in the overall infra since it is a useful > info. > > Anyway, let's move with this then: > > Reviewed-by: Rodrigo Vivi Thanks, pushed to drm-intel-gt-next, as well as the other ones. BR, Jani. > > >> >> BR, >> Jani. >> >> > >> > +Mauro in case he has some idea. >> > >> > and the declaration for reference: >> > >> > int (*process_obj)(struct i915_gem_apply_to_region *apply, >> > struct drm_i915_gem_object *obj); >> > >> >> * >> >> * Note that if this function is part of a ww transaction, and >> >> * if returns -EDEADLK for one of the objects, it may be >> >> -- >> >> 2.39.2 >> >> >> >> -- >> Jani Nikula, Intel Open Source Graphics Center -- Jani Nikula, Intel Open Source Graphics Center