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 X-Spam-Level: X-Spam-Status: No, score=-17.0 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id D7989C433DB for ; Fri, 26 Mar 2021 14:38:00 +0000 (UTC) Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 77678619F2 for ; Fri, 26 Mar 2021 14:38:00 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 77678619F2 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linaro.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=desiato.20200630; h=Sender:Content-Transfer-Encoding :Content-Type:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:Cc:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=0yyvZUytYUo4MVPmCdvH0RZRTIMLwEPO+RSBfhHeMo4=; b=jj0cThzoSos1QHgntN0ZJj27i 6i/A9QsCceAHHcwP0UMGKpRu2MBJeeXJ3oXUxIUpWAB1HSC7gxa0ddnyqb01pyPLlplm/wnR/W5Oa 4VMbXJnFceq29UGphyBaRAVsnSbOYmR6vmHwi5GOOIIKxRbGalNYzgwtjQ34tEn5fgbNk4XZXuHWI hsxCkXJ00XSP8uM5Vped5u3Rv2PD3naybT5VSfE5rxDibV0/1pnxM9koQuGE7GwBxvvQ6tIb5K0J7 PBm+G6pGlbEUlRf1dirrC23rCOdG1dZtp+ziiMlaGwjJKmdOhP9BNw+a6cqnMfbzY8lybCYRMWHDA nNmtRR69A==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94 #2 (Red Hat Linux)) id 1lPnYa-003nDr-GB; Fri, 26 Mar 2021 14:35:25 +0000 Received: from mail-wr1-x432.google.com ([2a00:1450:4864:20::432]) by desiato.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lPnYW-003nCo-CP for linux-arm-kernel@lists.infradead.org; Fri, 26 Mar 2021 14:35:22 +0000 Received: by mail-wr1-x432.google.com with SMTP id o16so5921069wrn.0 for ; Fri, 26 Mar 2021 07:35:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=5ncqrjTAWBMAuIT+QNk4MgUhfbKLtj8kt+uo2wlM/dg=; b=weMDUSGRSCQGL4pgXx8iQgbzg5Nye4DqunH91ALPfVpL5kE61ywzM7VTxlg2W7Es4D oNQa61mKg+gtrY4ryXcuLjSNGXUo582RhCNDzKcAWTNYnZqo+iEGaTZB7ODutah3VICz +ev6t1uq/xB+BZt0yxA4rdMu4uEmmHNJS57KeVoZc+ZBZsfg1oYGKCBVStk7iWMD2no/ 0gFlTPKYmzJ6xHMKfMj+hVG4nuYcjMFnEMqeDwgoqa5NpL46gHUhKu04TXjeijAwJaaR 7EMiJjqTZBorv+b5NJvNcnTGRJA4riENhLqjOa0iZosr5fYSrUcJlh13WbZxUGjW+fLz Pbrw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=5ncqrjTAWBMAuIT+QNk4MgUhfbKLtj8kt+uo2wlM/dg=; b=qqizXVddjcdYv7I2G1dALGJ9A32HzpPPDK0S/UJQ2LF2u/28cixcqFdWpMTRaUylBb eJuxF2/XH37RUhhUmDPvL484TjgnMSsxjlAhiCThExjd3He4rC3Nhy/QcxB1fNe/Suaj AcwvdCxJzF/3Wq3h2cd8eD4hN1WAHz90O//1zLuJD17R7TYBF/xzS1WS3nbfw+VOj3jl VRTjDLkjj3bcu4YQ8OQRR9bQ9gA9zsxyFgPBsK52nVDTJxuM/j7VL1a7zQe1kDXscRVq BWrkTBNPO/IVOC06jeJZAcJkIbBh/er+vXxXPXMftKw1Eawscn6OX42xi6LZpfEvkQ5d YA7g== X-Gm-Message-State: AOAM531Hcqj383nfDu+yjRB4F1kOElj2p4jAyg4ctDi2sIKZmGIr+0YP tw7ktaFb24aoBliIT9dc1ssyUA== X-Google-Smtp-Source: ABdhPJxmQkgaSlZ6BYyWv6tZwjthp9lMrPlua6NXOhA6VZmavOYOxv6tr/znawI4FNqHcL2lE7SBRQ== X-Received: by 2002:a5d:6307:: with SMTP id i7mr15081805wru.305.1616769319829; Fri, 26 Mar 2021 07:35:19 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id j26sm12878225wrh.57.2021.03.26.07.35.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 26 Mar 2021 07:35:19 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Jiri Kosina , Benjamin Tissoires , Maxime Coquelin , Alexandre Torgue , Dario Pagani , Kim Kuparinen , linux-input@vger.kernel.org, linux-stm32@st-md-mailman.stormreply.com, linux-arm-kernel@lists.infradead.org Subject: [PATCH 18/25] HID: hid-thrustmaster: Demote a bunch of kernel-doc abuses Date: Fri, 26 Mar 2021 14:34:51 +0000 Message-Id: <20210326143458.508959-20-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210326143458.508959-1-lee.jones@linaro.org> References: <20210326143458.508959-1-lee.jones@linaro.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210326_143520_502691_8C82ACCE X-CRM114-Status: GOOD ( 22.02 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Rml4ZXMgdGhlIGZvbGxvd2luZyBXPTEga2VybmVsIGJ1aWxkIHdhcm5pbmcocyk6CgogZHJpdmVy cy9oaWQvaGlkLXRocnVzdG1hc3Rlci5jOjIzOiB3YXJuaW5nOiBJbmNvcnJlY3QgdXNlIG9mIGtl cm5lbC1kb2MgZm9ybWF0OiAgKiBUaGVzZSBpbnRlcnJ1cHRzIGFyZSB1c2VkIHRvIHByZXZlbnQg YSBuYXN0eSBjcmFzaCB3aGVuIGluaXRpYWxpemluZyB0aGUKIGRyaXZlcnMvaGlkL2hpZC10aHJ1 c3RtYXN0ZXIuYzoyNjogd2FybmluZzogY2Fubm90IHVuZGVyc3RhbmQgZnVuY3Rpb24gcHJvdG90 eXBlOiAnY29uc3QgdTggc2V0dXBfMFtdID0gJwogZHJpdmVycy9oaWQvaGlkLXRocnVzdG1hc3Rl ci5jOjQ5OiB3YXJuaW5nOiBjYW5ub3QgdW5kZXJzdGFuZCBmdW5jdGlvbiBwcm90b3R5cGU6ICdz dHJ1Y3QgdG1fd2hlZWxfaW5mbyAnCiBkcml2ZXJzL2hpZC9oaWQtdGhydXN0bWFzdGVyLmM6NjI6 IHdhcm5pbmc6IHdyb25nIGtlcm5lbC1kb2MgaWRlbnRpZmllciBvbiBsaW5lOgogZHJpdmVycy9o aWQvaGlkLXRocnVzdG1hc3Rlci5jOjg0OiB3YXJuaW5nOiBjYW5ub3QgdW5kZXJzdGFuZCBmdW5j dGlvbiBwcm90b3R5cGU6ICdzdHJ1Y3QgX19wYWNrZWQgdG1fd2hlZWxfcmVzcG9uc2UgJwogZHJp dmVycy9oaWQvaGlkLXRocnVzdG1hc3Rlci5jOjE0Mzogd2FybmluZzogd3Jvbmcga2VybmVsLWRv YyBpZGVudGlmaWVyIG9uIGxpbmU6CiBkcml2ZXJzL2hpZC9oaWQtdGhydXN0bWFzdGVyLmM6MjAy OiB3YXJuaW5nOiBGdW5jdGlvbiBwYXJhbWV0ZXIgb3IgbWVtYmVyICd1cmInIG5vdCBkZXNjcmli ZWQgaW4gJ3RocnVzdG1hc3Rlcl9tb2RlbF9oYW5kbGVyJwogZHJpdmVycy9oaWQvaGlkLXRocnVz dG1hc3Rlci5jOjIwMjogd2FybmluZzogZXhwZWN0aW5nIHByb3RvdHlwZSBmb3IgQ2FsbGVkIGJ5 IHRoZSBVU0Igc3Vic3lzdGVtIHdoZW4gdGhlIHdoZWVsIHJlc3BvbnNlcyB0byBvdXIgcmVxdWVz dCgpLiBQcm90b3R5cGUgd2FzIGZvciB0aHJ1c3RtYXN0ZXJfbW9kZWxfaGFuZGxlcigpIGluc3Rl YWQKIGRyaXZlcnMvaGlkL2hpZC10aHJ1c3RtYXN0ZXIuYzoyNjU6IHdhcm5pbmc6IHdyb25nIGtl cm5lbC1kb2MgaWRlbnRpZmllciBvbiBsaW5lOgoKQ2M6IEppcmkgS29zaW5hIDxqaWtvc0BrZXJu ZWwub3JnPgpDYzogQmVuamFtaW4gVGlzc29pcmVzIDxiZW5qYW1pbi50aXNzb2lyZXNAcmVkaGF0 LmNvbT4KQ2M6IE1heGltZSBDb3F1ZWxpbiA8bWNvcXVlbGluLnN0bTMyQGdtYWlsLmNvbT4KQ2M6 IEFsZXhhbmRyZSBUb3JndWUgPGFsZXhhbmRyZS50b3JndWVAZm9zcy5zdC5jb20+CkNjOiBEYXJp byBQYWdhbmkgPGRhcmlvLnBhZ2FuaS4xNDYrbGludXhrQGdtYWlsLmNvbT4KQ2M6IEtpbSBLdXBh cmluZW4gPGtpbWkuaC5rdXBhcmluZW5AZ21haWwuY29tPgpDYzogbGludXgtaW5wdXRAdmdlci5r ZXJuZWwub3JnCkNjOiBsaW51eC1zdG0zMkBzdC1tZC1tYWlsbWFuLnN0b3JtcmVwbHkuY29tCkNj OiBsaW51eC1hcm0ta2VybmVsQGxpc3RzLmluZnJhZGVhZC5vcmcKU2lnbmVkLW9mZi1ieTogTGVl IEpvbmVzIDxsZWUuam9uZXNAbGluYXJvLm9yZz4KLS0tCiBkcml2ZXJzL2hpZC9oaWQtdGhydXN0 bWFzdGVyLmMgfCAyNCArKysrKysrKysrKystLS0tLS0tLS0tLS0KIDEgZmlsZSBjaGFuZ2VkLCAx MiBpbnNlcnRpb25zKCspLCAxMiBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9kcml2ZXJzL2hp ZC9oaWQtdGhydXN0bWFzdGVyLmMgYi9kcml2ZXJzL2hpZC9oaWQtdGhydXN0bWFzdGVyLmMKaW5k ZXggYmZjZDA4NzU5YmEwOS4uNGY5YzA2NDJlODE2YiAxMDA2NDQKLS0tIGEvZHJpdmVycy9oaWQv aGlkLXRocnVzdG1hc3Rlci5jCisrKyBiL2RyaXZlcnMvaGlkL2hpZC10aHJ1c3RtYXN0ZXIuYwpA QCAtMSw1ICsxLDUgQEAKIC8vIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBHUEwtMi4wCi0vKioK Ky8qCiAgKiBXaGVuIGNvbm5lY3RlZCB0byB0aGUgbWFjaGluZSwgdGhlIFRocnVzdG1hc3RlciB3 aGVlbHMgYXBwZWFyIGFzCiAgKiBhIMKrZ2VuZXJpY8K7IGhpZCBnYW1lcGFkIGNhbGxlZCAiVGhy dXN0bWFzdGVyIEZGQiBXaGVlbCIuCiAgKgpAQCAtMTksNyArMTksNyBAQAogI2luY2x1ZGUgPGxp bnV4L3NsYWIuaD4KICNpbmNsdWRlIDxsaW51eC9tb2R1bGUuaD4KIAotLyoqCisvKgogICogVGhl c2UgaW50ZXJydXB0cyBhcmUgdXNlZCB0byBwcmV2ZW50IGEgbmFzdHkgY3Jhc2ggd2hlbiBpbml0 aWFsaXppbmcgdGhlCiAgKiBUMzAwUlMuIFVzZWQgaW4gdGhydXN0bWFzdGVyX2ludGVycnVwdHMo KS4KICAqLwpAQCAtMzYsNyArMzYsNyBAQCBzdGF0aWMgY29uc3QgdW5zaWduZWQgaW50IHNldHVw X2Fycl9zaXplc1tdID0gewogCUFSUkFZX1NJWkUoc2V0dXBfMyksCiAJQVJSQVlfU0laRShzZXR1 cF80KQogfTsKLS8qKgorLyoKICAqIFRoaXMgc3RydWN0IGNvbnRhaW5zIGZvciBlYWNoIHR5cGUg b2YKICAqIFRocnVzdG1hc3RlciB3aGVlbAogICoKQEAgLTQ5LDcgKzQ5LDcgQEAgc3RhdGljIGNv bnN0IHVuc2lnbmVkIGludCBzZXR1cF9hcnJfc2l6ZXNbXSA9IHsKIHN0cnVjdCB0bV93aGVlbF9p bmZvIHsKIAl1aW50MTZfdCB3aGVlbF90eXBlOwogCi0JLyoqCisJLyoKIAkgKiBTZWUgd2hlbiB0 aGUgVVNCIGNvbnRyb2wgb3V0IHBhY2tldCBpcyBwcmVwYXJlZC4uLgogCSAqIEBUT0RPIFRoZSBU TVggc2VlbXMgdG8gcmVxdWlyZSBtdWx0aXBsZSBjb250cm9sIGNvZGVzIHRvIHN3aXRjaC4KIAkg Ki8KQEAgLTU4LDcgKzU4LDcgQEAgc3RydWN0IHRtX3doZWVsX2luZm8gewogCWNoYXIgY29uc3Qg KmNvbnN0IHdoZWVsX25hbWU7CiB9OwogCi0vKioKKy8qCiAgKiBLbm93biB3aGVlbHMuCiAgKiBO b3RlOiBUTVggZG9lcyBub3Qgd29yayBhcyBpdCByZXF1aXJlcyAyIGNvbnRyb2wgcGFja2V0cwog ICovCkBAIC03Miw3ICs3Miw3IEBAIHN0YXRpYyBjb25zdCBzdHJ1Y3QgdG1fd2hlZWxfaW5mbyB0 bV93aGVlbHNfaW5mb3NbXSA9IHsKIAogc3RhdGljIGNvbnN0IHVpbnQ4X3QgdG1fd2hlZWxzX2lu Zm9zX2xlbmd0aCA9IDQ7CiAKLS8qKgorLyoKICAqIFRoaXMgc3RydWN0cyBjb250YWlucyAoaW4g bGl0dGxlIGVuZGlhbikgdGhlIHJlc3BvbnNlIGRhdGEKICAqIG9mIHRoZSB3aGVlbCB0byB0aGUg cmVxdWVzdCA3MwogICoKQEAgLTgyLDcgKzgyLDcgQEAgc3RhdGljIGNvbnN0IHVpbnQ4X3QgdG1f d2hlZWxzX2luZm9zX2xlbmd0aCA9IDQ7CiAgKi8KIHN0cnVjdCBfX3BhY2tlZCB0bV93aGVlbF9y ZXNwb25zZQogewotCS8qKgorCS8qCiAJICogU2VlbXMgdG8gYmUgdGhlIHR5cGUgb2YgcGFja2V0 CiAJICogLSAweDAwNDkgaWYgaXMgZGF0YS5hICgxNSBieXRlcykKIAkgKiAtIDB4MDA0NyBpZiBp cyBkYXRhLmIgKDcgYnl0ZXMpCkBAIC05Myw3ICs5Myw3IEBAIHN0cnVjdCBfX3BhY2tlZCB0bV93 aGVlbF9yZXNwb25zZQogCQlzdHJ1Y3QgX19wYWNrZWQgewogCQkJdWludDE2X3QgZmllbGQwOwog CQkJdWludDE2X3QgZmllbGQxOwotCQkJLyoqCisJCQkvKgogCQkJICogU2VlbXMgdG8gYmUgdGhl IG1vZGVsIGNvZGUgb2YgdGhlIHdoZWVsCiAJCQkgKiBSZWFkIHRhYmxlIHRocnVzdG1hc3Rlcl93 aGVlbHMgdG8gdmFsdWVzCiAJCQkgKi8KQEAgLTEyMiw3ICsxMjIsNyBAQCBzdHJ1Y3QgdG1fd2hl ZWwgewogCXN0cnVjdCB1c2JfY3RybHJlcXVlc3QgKmNoYW5nZV9yZXF1ZXN0OwogfTsKIAotLyoq IFRoZSBjb250cm9sIHBhY2tldCB0byBzZW5kIHRvIHdoZWVsICovCisvKiBUaGUgY29udHJvbCBw YWNrZXQgdG8gc2VuZCB0byB3aGVlbCAqLwogc3RhdGljIGNvbnN0IHN0cnVjdCB1c2JfY3RybHJl cXVlc3QgbW9kZWxfcmVxdWVzdCA9IHsKIAkuYlJlcXVlc3RUeXBlID0gMHhjMSwKIAkuYlJlcXVl c3QgPSA3MywKQEAgLTEzOSw3ICsxMzksNyBAQCBzdGF0aWMgY29uc3Qgc3RydWN0IHVzYl9jdHJs cmVxdWVzdCBjaGFuZ2VfcmVxdWVzdCA9IHsKIAkud0xlbmd0aCA9IDAKIH07CiAKLS8qKgorLyoK ICAqIE9uIHNvbWUgc2V0dXBzIGluaXRpYWxpemluZyB0aGUgVDMwMFJTIGNyYXNoZXMgdGhlIGtl cm5lbCwKICAqIHRoZXNlIGludGVycnVwdHMgZml4IHRoYXQgcGFydGljdWxhciBpc3N1ZS4gU28g ZmFyIHRoZXkgaGF2ZW4ndCBjYXVzZWQgYW55CiAgKiBhZHZlcnNlIGVmZmVjdHMgaW4gb3RoZXIg d2hlZWxzLgpAQCAtMTkxLDcgKzE5MSw3IEBAIHN0YXRpYyB2b2lkIHRocnVzdG1hc3Rlcl9jaGFu Z2VfaGFuZGxlcihzdHJ1Y3QgdXJiICp1cmIpCiAJCWhpZF93YXJuKGhkZXYsICJVUkIgdG8gY2hh bmdlIHdoZWVsIG1vZGUgc2VlbXMgdG8gaGF2ZSBmYWlsZWQgd2l0aCBlcnJvciAlZFxuIiwgdXJi LT5zdGF0dXMpOwogfQogCi0vKioKKy8qCiAgKiBDYWxsZWQgYnkgdGhlIFVTQiBzdWJzeXN0ZW0g d2hlbiB0aGUgd2hlZWwgcmVzcG9uc2VzIHRvIG91ciByZXF1ZXN0CiAgKiB0byBnZXQgW3doYXQg aXQgc2VlbXMgdG8gYmVdIHRoZSB3aGVlbCdzIG1vZGVsLgogICoKQEAgLTI2MSw3ICsyNjEsNyBA QCBzdGF0aWMgdm9pZCB0aHJ1c3RtYXN0ZXJfcmVtb3ZlKHN0cnVjdCBoaWRfZGV2aWNlICpoZGV2 KQogCWhpZF9od19zdG9wKGhkZXYpOwogfQogCi0vKioKKy8qCiAgKiBGdW5jdGlvbiBjYWxsZWQg YnkgSElEIHdoZW4gYSBoaWQgVGhydXN0bWFzdGVyIEZGQiB3aGVlbCBpcyBjb25uZWN0ZWQgdG8g dGhlIGhvc3QuCiAgKiBUaGlzIGZ1bmN0aW9uIHN0YXJ0cyB0aGUgaGlkIGRldiwgdHJpZXMgdG8g YWxsb2NhdGUgdGhlIHRtX3doZWVsIGRhdGEgc3RydWN0dXJlIGFuZAogICogZmluYWxseSBzZW5k IGFuIFVTQiBDT05UUk9MIFJFUVVFU1QgdG8gdGhlIHdoZWVsIHRvIGdldCBbd2hhdCBpdCBzZWVt cyB0byBiZV0gaXRzCi0tIAoyLjI3LjAKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fXwpsaW51eC1hcm0ta2VybmVsIG1haWxpbmcgbGlzdApsaW51eC1hcm0t a2VybmVsQGxpc3RzLmluZnJhZGVhZC5vcmcKaHR0cDovL2xpc3RzLmluZnJhZGVhZC5vcmcvbWFp bG1hbi9saXN0aW5mby9saW51eC1hcm0ta2VybmVsCg==