Received: by 2002:a05:7412:da14:b0:e2:908c:2ebd with SMTP id fe20csp1287861rdb; Sun, 8 Oct 2023 00:07:03 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHtJUZ7w9gdCXpFiXMcn9seIQuBx8BdreSzyV07gneqt0ZsZqEfbdQXvbRybB7O7GWIbd7G X-Received: by 2002:a05:6358:7208:b0:141:3fd:2441 with SMTP id h8-20020a056358720800b0014103fd2441mr13660528rwa.30.1696748822891; Sun, 08 Oct 2023 00:07:02 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1696748822; cv=none; d=google.com; s=arc-20160816; b=ntQcuOnh3xDeUVcf4KpR4KfgLHykxBYLxwWEQWfaR3zVqZ/Xdqom9AQcf/xOG3yZx5 484ggGg7kEtUaoYkqUcjqUxVe9xPFeBb2zRkQX4XZSiYePynHKzJk3fJjEdKTZRO+116 2DlAJXDG3oFvebdS7S6Ku9H1PwGOAK8c1qo1ePTEExdzNV5a0ztk9FxM7oEcIrGPGOEc +eLyd08b/BW7vvUwukkzqpJnHT4Dfy/Ui6qFbTokKLFV/zapRRtR1CQdDUJ/h20UWxh0 QQ7KQgbFsGzLAPI+h/+9Oklq+dQXob2O9tsrISUdUkiwG3d6meXSc9QOS0/Pjy+95iRo SjEQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=xaaQmfAOdlMr/G3DN8Nw6V4MkQHgrZFbaXHumsVfrFA=; fh=O+9hNYCFolMYuzFE6LManxYQgSKDc7jgF/sOb8OySOg=; b=VufColWEsUGf1a9f0CBl4+nUOdTHnl3OmD7fPpEqvw+Rrz6jCtBOdvtR0/kxzwQQKC CO//TBn9kSyzQqtbwVkuN0V2ysRxKH+r002xQ5JNKVeCWkgvzBA1zSak7xPjRTO+qXSe PbGvW0TgY5YCVaeL6Owym6oHRYFNjtr4LRA4TDqkr8Mb+24V3yFd9F+GD3aUT+GtiUbh G7VJ62S+TQpyJp6plP19fjEZzckV4w2TGeP+e3et8pvIgpWXG+tMjvEk9QhVTzbe/VmM Aw0GsYQrtpQmnRBGpJPcevAkWkvxvayAoxHlnrAORW0+4Z9S/9VbYnSoc2xJcJQuKCQh 59+A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b="mJOB/RyT"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 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 snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id m1-20020a656a01000000b00584ac83e108si8083761pgu.729.2023.10.08.00.07.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 08 Oct 2023 00:07:02 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b="mJOB/RyT"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id DEC0280ADF09; Sun, 8 Oct 2023 00:07:01 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229966AbjJHHG6 (ORCPT + 99 others); Sun, 8 Oct 2023 03:06:58 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46522 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229441AbjJHHG4 (ORCPT ); Sun, 8 Oct 2023 03:06:56 -0400 Received: from mail-oo1-xc2b.google.com (mail-oo1-xc2b.google.com [IPv6:2607:f8b0:4864:20::c2b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 20EA9B6 for ; Sun, 8 Oct 2023 00:06:52 -0700 (PDT) Received: by mail-oo1-xc2b.google.com with SMTP id 006d021491bc7-57bca5b9b0aso1985606eaf.3 for ; Sun, 08 Oct 2023 00:06:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1696748811; x=1697353611; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=xaaQmfAOdlMr/G3DN8Nw6V4MkQHgrZFbaXHumsVfrFA=; b=mJOB/RyTn/cEDGC9hwDEN1qrpGfmoOfj70tY1W8ARpIcbDcRCa84OR2o2oSJbW3itd 0G5v+ui26dkZngQyauvjp+1OjTuqj9yk6TU5q7XpnbhmfD0C0BEv7GjVVnI1jbS/z9DT PbTX0xwAr7H9kipnTmmpQ7nX3YHEwOdw3phFuZkJVjfkCKd6zEmccS627I9PssbO7k+L 3oT/+WS+JRDW/RTWccXJZ3vf/xuP7VQFuQw+nWHaJ5YVC2Qmw9cv6w8gfQNdoFwOk6kP fM6BTOe/JcN9DMWQL3nOKKyGXt3OVByHEuWAcd0DWFkXi9LdcknH7y7oee8vupPPE9zF 9UWQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1696748811; x=1697353611; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=xaaQmfAOdlMr/G3DN8Nw6V4MkQHgrZFbaXHumsVfrFA=; b=PqHW0XlppDE+ugX4bbQjDzT2wUVvr8X/4+Q63/mEx4m+IZtgaiTuNHtQvG1wr16siV DXUc0q9SmfTqomVUCh1G9kyixbMocrnrKmDHcUubdQU+a8gPHde+uvCdpUoMIeZB9f9T eNnJcQ7RBCI4ww+Jg+f3gize6hNfY76x/RdeAt8aYBBxOMBdSAadnNpiZxUaZFJqToQG NDWSggYR38aU+1jWRC39XEfdDF5owtQ5YMSzSs+DBR4HNuf2N1pLfFlc4D+oLqFOEZF/ lYbWAXCia0yGuJ9mugjxcQce40EBp4S5RNClHeJEhd0c47IFLPZbUnARIT8IHjREZt4k 2csg== X-Gm-Message-State: AOJu0Yz1qHb32ogtRqBwSL6xaqdVqBt3Sq03iOzUqQdY2jswwCVnGkKJ oQF7NcO7Olm2w6RFo2eNuBg= X-Received: by 2002:a05:6358:63a7:b0:14b:d9de:3008 with SMTP id k39-20020a05635863a700b0014bd9de3008mr14338878rwh.5.1696748811195; Sun, 08 Oct 2023 00:06:51 -0700 (PDT) Received: from localhost.localdomain ([27.5.160.191]) by smtp.gmail.com with ESMTPSA id c24-20020a637258000000b0055c178a8df1sm2290356pgn.94.2023.10.08.00.06.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 08 Oct 2023 00:06:50 -0700 (PDT) From: Bragatheswaran Manickavel To: kherbst@redhat.com, lyude@redhat.com, dakr@redhat.com, maarten.lankhorst@linux.intel.com, mripard@kernel.org, tzimmermann@suse.de, airlied@gmail.com, daniel@ffwll.ch Cc: Bragatheswaran Manickavel , dri-devel@lists.freedesktop.org, nouveau@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: [PATCH] drm/nouveau: fix kernel-doc warning Date: Sun, 8 Oct 2023 12:36:18 +0530 Message-Id: <20231008070618.20640-1-bragathemanick0908@gmail.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Sun, 08 Oct 2023 00:07:02 -0700 (PDT) Identified below document warning in latest linux-next. ./include/uapi/drm/nouveau_drm.h:49: warning: Cannot understand * @NOUVEAU_GETPARAM_EXEC_PUSH_MAX: on line 49 - I thought it was a doc line Also, on running checkpatch.pl to nouveau_drm.h identified few more warnings/errors and fixing them in this patch Signed-off-by: Bragatheswaran Manickavel --- include/uapi/drm/nouveau_drm.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/include/uapi/drm/nouveau_drm.h b/include/uapi/drm/nouveau_drm.h index eaf9f248619f..a523ca5aa865 100644 --- a/include/uapi/drm/nouveau_drm.h +++ b/include/uapi/drm/nouveau_drm.h @@ -46,7 +46,7 @@ extern "C" { #define NOUVEAU_GETPARAM_HAS_PAGEFLIP 16 /** - * @NOUVEAU_GETPARAM_EXEC_PUSH_MAX + * NOUVEAU_GETPARAM_EXEC_PUSH_MAX: * * Query the maximum amount of IBs that can be pushed through a single * &drm_nouveau_exec structure and hence a single &DRM_IOCTL_NOUVEAU_EXEC @@ -458,15 +458,15 @@ struct drm_nouveau_svm_bind { #define DRM_IOCTL_NOUVEAU_GETPARAM DRM_IOWR(DRM_COMMAND_BASE + DRM_NOUVEAU_GETPARAM, struct drm_nouveau_getparam) #define DRM_IOCTL_NOUVEAU_CHANNEL_ALLOC DRM_IOWR(DRM_COMMAND_BASE + DRM_NOUVEAU_CHANNEL_ALLOC, struct drm_nouveau_channel_alloc) -#define DRM_IOCTL_NOUVEAU_CHANNEL_FREE DRM_IOW (DRM_COMMAND_BASE + DRM_NOUVEAU_CHANNEL_FREE, struct drm_nouveau_channel_free) +#define DRM_IOCTL_NOUVEAU_CHANNEL_FREE DRM_IOW(DRM_COMMAND_BASE + DRM_NOUVEAU_CHANNEL_FREE, struct drm_nouveau_channel_free) #define DRM_IOCTL_NOUVEAU_SVM_INIT DRM_IOWR(DRM_COMMAND_BASE + DRM_NOUVEAU_SVM_INIT, struct drm_nouveau_svm_init) #define DRM_IOCTL_NOUVEAU_SVM_BIND DRM_IOWR(DRM_COMMAND_BASE + DRM_NOUVEAU_SVM_BIND, struct drm_nouveau_svm_bind) #define DRM_IOCTL_NOUVEAU_GEM_NEW DRM_IOWR(DRM_COMMAND_BASE + DRM_NOUVEAU_GEM_NEW, struct drm_nouveau_gem_new) #define DRM_IOCTL_NOUVEAU_GEM_PUSHBUF DRM_IOWR(DRM_COMMAND_BASE + DRM_NOUVEAU_GEM_PUSHBUF, struct drm_nouveau_gem_pushbuf) -#define DRM_IOCTL_NOUVEAU_GEM_CPU_PREP DRM_IOW (DRM_COMMAND_BASE + DRM_NOUVEAU_GEM_CPU_PREP, struct drm_nouveau_gem_cpu_prep) -#define DRM_IOCTL_NOUVEAU_GEM_CPU_FINI DRM_IOW (DRM_COMMAND_BASE + DRM_NOUVEAU_GEM_CPU_FINI, struct drm_nouveau_gem_cpu_fini) +#define DRM_IOCTL_NOUVEAU_GEM_CPU_PREP DRM_IOW(DRM_COMMAND_BASE + DRM_NOUVEAU_GEM_CPU_PREP, struct drm_nouveau_gem_cpu_prep) +#define DRM_IOCTL_NOUVEAU_GEM_CPU_FINI DRM_IOW(DRM_COMMAND_BASE + DRM_NOUVEAU_GEM_CPU_FINI, struct drm_nouveau_gem_cpu_fini) #define DRM_IOCTL_NOUVEAU_GEM_INFO DRM_IOWR(DRM_COMMAND_BASE + DRM_NOUVEAU_GEM_INFO, struct drm_nouveau_gem_info) #define DRM_IOCTL_NOUVEAU_VM_INIT DRM_IOWR(DRM_COMMAND_BASE + DRM_NOUVEAU_VM_INIT, struct drm_nouveau_vm_init) -- 2.34.1