From patchwork Sat May 28 09:14:01 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 12863957 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 99DB7C433EF for ; Sat, 28 May 2022 09:14:39 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232225AbiE1JOh (ORCPT ); Sat, 28 May 2022 05:14:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56952 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230320AbiE1JOh (ORCPT ); Sat, 28 May 2022 05:14:37 -0400 Received: from mail-pf1-x432.google.com (mail-pf1-x432.google.com [IPv6:2607:f8b0:4864:20::432]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1BF3226A; Sat, 28 May 2022 02:14:34 -0700 (PDT) Received: by mail-pf1-x432.google.com with SMTP id c65so5740573pfb.1; Sat, 28 May 2022 02:14:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=Z1RqzTeW1BAGxPPylhaGGZ1c6ZvnWii5iv9aspactB8=; b=hnsC8bvhVQEneXnjOD8hIdRXhfn8Wy5bKpsD9Q5o3YlAfnNnhMueJbaHnYoSYmaQC7 RLoGnI35KSHpk7Okkdw9SADICr2qYF6shUX64/2kai1UPkHhWK7mv4Wmuj1+fV67KBn4 xUTHkiVLcK/NLqkIe7qZyYNfoVjP4sEGll4uFMe3/cStcibJSj1UJjUZYu0kbShFI7W8 Bpch32PsNAlKj+nt8SNgUZY/EWXGftGHs90XdHxEKkW3wd3tdYpptymqdlWpKddQmu42 8WzK+RCzFdobizDPkVOxZoFmrPpg53d2TpD6dFZnjTB6nH/RMSsyq5kZXf1iEdOFE73N h7Wg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=Z1RqzTeW1BAGxPPylhaGGZ1c6ZvnWii5iv9aspactB8=; b=jgrBZ4ayEVqN/aD2t0y6NDT+UfZEIXjGtoz9l5jPMYlYzn97UxZZVK5Dh0xUCL+8lT I1wDatbJZTIGvxyRPwqBh9miduRbPFmIo9PgruPw4KwyEgUD9hvOGuBVU/RZ+KRsnCBD AQN+2DPrU3jGapIC3t+wEwyUiaOaqN0TNnWDlnPb9ZxwPBlUrHzA4RBX9lipJpx0UIiB o1cmUy8IvcZlrcJ1vtByFjxajwgdBBoLY2tTmht+6aXj2t3vstIjp61QyQ9a42Tkgk0J eP+IUFWO5QpGPaXZsCM0mr22HCRQO++Mi1wy+VnMsCQgsnnIEOmtYYZwUqE6O+UDaK0t EeEg== X-Gm-Message-State: AOAM532xqTbFS9RVy+ZdsKs4+TaYZ+XLD8TDr/3wv8/JS63FWdg9eQ2z Ak+cLDi4Ipr7mfLU1lkF/ivE5hTci7Kd/rVr X-Google-Smtp-Source: ABdhPJy0yRgS91Kx5W6REvKQcbGpfooNjaA/QHpmbeacl/6LtY6SUrfXKOj/470iNJEPSzd2aAFx7w== X-Received: by 2002:a05:6a00:e8e:b0:4fa:a52f:59cf with SMTP id bo14-20020a056a000e8e00b004faa52f59cfmr47726914pfb.84.1653729273229; Sat, 28 May 2022 02:14:33 -0700 (PDT) Received: from debian.me (subs02-180-214-232-83.three.co.id. [180.214.232.83]) by smtp.gmail.com with ESMTPSA id l12-20020a170902f68c00b0016198062800sm5320179plg.161.2022.05.28.02.14.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 28 May 2022 02:14:32 -0700 (PDT) From: Bagas Sanjaya To: linux-doc@vger.kernel.org Cc: Bagas Sanjaya , Nikolai Kondrashov , Jiri Kosina , Benjamin Tissoires , =?utf-8?b?Sm9zw6kgRXhw?= =?utf-8?b?w7NzaXRv?= , llvm@lists.linux.dev, linux-input@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 0/2] HID: uclogic: kernel-doc fixes for uclogic_params_* functions Date: Sat, 28 May 2022 16:14:01 +0700 Message-Id: <20220528091403.160169-1-bagasdotme@gmail.com> X-Mailer: git-send-email 2.36.0 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-input@vger.kernel.org Running kernel-doc script on drivers/hid/hid-uclogic-params.c found these 6 warnings below: drivers/hid/hid-uclogic-params.c:48: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Dump tablet interface pen parameters with hid_dbg(), indented with one tab. drivers/hid/hid-uclogic-params.c:48: warning: missing initial short description on line: * Dump tablet interface pen parameters with hid_dbg(), indented with one tab. drivers/hid/hid-uclogic-params.c:48: info: Scanning doc for function Dump drivers/hid/hid-uclogic-params.c:80: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Dump tablet interface frame parameters with hid_dbg(), indented with two drivers/hid/hid-uclogic-params.c:80: warning: missing initial short description on line: * Dump tablet interface frame parameters with hid_dbg(), indented with two drivers/hid/hid-uclogic-params.c:80: info: Scanning doc for function Dump drivers/hid/hid-uclogic-params.c:105: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Dump tablet interface parameters with hid_dbg(). drivers/hid/hid-uclogic-params.c:105: warning: missing initial short description on line: * Dump tablet interface parameters with hid_dbg(). One of them is reported by kernel test robot at kernel test robot at [1]. [1]: https://lore.kernel.org/linux-doc/202205272033.XFYlYj8k-lkp@intel.com/ Fix these warnings by remove extraneous asterisk on static function comments on patch [1/2] and add missing function name for void function on patch [2/2]. Cc: Nikolai Kondrashov Cc: Jiri Kosina Cc: Benjamin Tissoires Cc: "José Expósito" Cc: llvm@lists.linux.dev Cc: linux-input@vger.kernel.org Cc: linux-kernel@vger.kernel.org Bagas Sanjaya (2): HID: uclogic: remove extraneous asterisk on uclogic_params_* static functions comments HID: uclogic: add missing function name in uclogic_params_hid_dbg() kernel-doc comment drivers/hid/hid-uclogic-params.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) base-commit: bf272460d744112bacd4c4d562592decbf0edf64