From patchwork Sun Nov 21 15:54:52 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 12630913 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 32F28C433F5 for ; Sun, 21 Nov 2021 15:55:00 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id E43876E5B2; Sun, 21 Nov 2021 15:54:59 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:e::133]) by gabe.freedesktop.org (Postfix) with ESMTPS id 148FA6E58E for ; Sun, 21 Nov 2021 15:54:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:MIME-Version:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-ID:Content-Description:In-Reply-To:References; bh=cYs06rCiSJLo2niacctZbBcCGz2tP/7rUUeqqAAMX2s=; b=LjbEPYNRSnQ5ZwW6TsejV4Hbpg 9y+GLeHwmsA/BgeIFUQ+RPL1FKb+gG/cpC++l3WYTND426O3jGapRWr8RI7zd0uS9RjWfl1zkO6nj kBARsDwbqHH7P+RdSsAu+Dy7aG/x9vnibEJUVqqA3klqALhcXBxDQb0bOt/4zgi07K38XEuolDmW0 v2AzKLCs6e0WEd7VyG2+nRVMFVkuyWXIQGHNn8W5XDGJKeIIZfvzXrgrBM3FkGF5+RJGBx+b+yi0U hfqsy7Y+4k4PYQmhTz3o8/KwUoXqHsL5mAAsDPkdn+iu97eeEhiyL5GjQVzzOJpAuyhdzTTlHJDLL 5SomG9/w==; Received: from [2601:1c0:6280:3f0::aa0b] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1mopB8-00Ds9r-Go; Sun, 21 Nov 2021 15:54:54 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Subject: [PATCH] drm: ttm: correct ttm_range_manager kernel-doc notation Date: Sun, 21 Nov 2021 07:54:52 -0800 Message-Id: <20211121155453.29736-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Randy Dunlap , Huang Rui , kernel test robot , dri-devel@lists.freedesktop.org, =?utf-8?q?Christian_K=C3=B6nig?= Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Fix kernel-doc warnings in ttm_range_manager.c: drivers/gpu/drm/ttm/ttm_range_manager.c:144: warning: expecting prototype for ttm_range_man_init(). Prototype was for ttm_range_man_init_nocheck() instead drivers/gpu/drm/ttm/ttm_range_manager.c:178: warning: expecting prototype for ttm_range_man_fini(). Prototype was for ttm_range_man_fini_nocheck() instead Also fix subsequent warnings from scripts/kernel-doc. Signed-off-by: Randy Dunlap Reported-by: kernel test robot Cc: Christian König Cc: Huang Rui Cc: dri-devel@lists.freedesktop.org Reviewed-by: Huang Rui Reviewed-by: Christian König and pushed to --- drivers/gpu/drm/ttm/ttm_range_manager.c | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) --- linux-next-20211118.orig/drivers/gpu/drm/ttm/ttm_range_manager.c +++ linux-next-20211118/drivers/gpu/drm/ttm/ttm_range_manager.c @@ -128,15 +128,17 @@ static const struct ttm_resource_manager }; /** - * ttm_range_man_init + * ttm_range_man_init_nocheck - Initialise a generic range manager for the + * selected memory type. * * @bdev: ttm device * @type: memory manager type * @use_tt: if the memory manager uses tt * @p_size: size of area to be managed in pages. * - * Initialise a generic range manager for the selected memory type. * The range manager is installed for this device in the type slot. + * + * Return: %0 on success or a negative error code on failure */ int ttm_range_man_init_nocheck(struct ttm_device *bdev, unsigned type, bool use_tt, @@ -166,12 +168,13 @@ int ttm_range_man_init_nocheck(struct tt EXPORT_SYMBOL(ttm_range_man_init_nocheck); /** - * ttm_range_man_fini + * ttm_range_man_fini_nocheck - Remove the generic range manager from a slot + * and tear it down. * * @bdev: ttm device * @type: memory manager type * - * Remove the generic range manager from a slot and tear it down. + * Return: %0 on success or a negative error code on failure */ int ttm_range_man_fini_nocheck(struct ttm_device *bdev, unsigned type)