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 76B7FC433DB for ; Wed, 24 Mar 2021 17:36:05 +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 E29CC61A15 for ; Wed, 24 Mar 2021 17:36:04 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org E29CC61A15 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=PoI153yyXPl6tJFrZZdZdTP01 J4WL8vIAzJtkqTFLqumA4oyrSrXhBsopPKxQFfnA4IA3kW+1bbrQ/8mnjRqwt9a42aM0/4xUdLMkk h9b9dd+CC8o22NDzXTRY3ZB8iCS3P5MYuWo8czO7026Pl1qhGMEtIG/iiXIpIVrmkqS7jZ2lFS+ke f5bz+ik7tran0ZQhrc5AsenGJnhcxGO1+8yN//q16lgsHnkI7VYptTbvIRCn7ggS6a/srlA7PPitY XE39zy39hzcYpEgRVA+3GqVS7eUZJU44uBFKD6T/p6fSHezDRESU8g5tJRepfOJxAwdozgpCBAHYK C8mYeddxA==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94 #2 (Red Hat Linux)) id 1lP7Ot-00HX32-BE; Wed, 24 Mar 2021 17:34:35 +0000 Received: from mail-ej1-x62d.google.com ([2a00:1450:4864:20::62d]) by desiato.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lP7Op-00HX2N-3q for linux-arm-kernel@lists.infradead.org; Wed, 24 Mar 2021 17:34:32 +0000 Received: by mail-ej1-x62d.google.com with SMTP id hq27so34235793ejc.9 for ; Wed, 24 Mar 2021 10:34:30 -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=PISlI40CQm3nn/6AYfPh4VAEVaX46+vrAoFPGv+FIfCNbX/dfRhw301twvFcF1W7fp tJIZiI1/hYX5yIk8M4FF7wWW6kjhjE6qnW1AWg0BpiQ2WfxcHRiN92YdT2Al5w+8qgZI TOIeIxu7+z5JK86KZppnoQWi6aoUzAe27/XauJtm3RZE5TcoBeTV1zPaXGJbVFx1SVq9 cXpzQRQbpPs/CLRZzi8A/DR37PBtQQklruvPt3JBN53GYwHWBdtQL0S1CPqxyW9xWR+c 7LGEsPWhvyo5jil0JJA9C0QS0S4je/Ks+68bJ/U8S3LwVbMiTPp+8B9W0qD/vVM6DPa8 03pw== 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=isud1AsRbWAYlvIDynCCRIpFYOF/TDc+tKUV0bxnTy6OvAVtA7K6WJy2VhV07MFmPS n6n+OGdC3ySuRDi5/bxSlR1486bHAqRdj3FTp12hm1rGHzRFturqimk20/NSsF5azaxJ D/cYvk+1UKO8o7neccZTHxXTn9hzx15QsIlNdPnOyO+KjiJ9Ej7CpAf9fjbXEPVUmVQl UPYEJMXMUk5tVxaAI0796a6AH7dFrAtjwmVV5/NCH1oCSJ9v4+Li2GWtGnLQKrs3nN6I jRpyR7FpzOmMTagtRQ1Nrf5AfW7XWjxfLAPNI8LrZT6RZBypGedybgSJ5wF9TfaZcAwg p5eA== X-Gm-Message-State: AOAM531WxbdkRP7IDwZX7xpc+UM8ehG/B+Ajhl6Ytr5UIwe3gQSE2gfo j7co+oMy1mNfnTM/P+sflrUSJ46abuqixQ== X-Google-Smtp-Source: ABdhPJwoWLddMYQprFC2QnlJ4CHKIY3FK362cwfc9slhyDWW/PZ3XNOqAY34ntweYwyIWvqZBmovqw== X-Received: by 2002:a17:906:51c3:: with SMTP id v3mr4959484ejk.497.1616607270465; Wed, 24 Mar 2021 10:34:30 -0700 (PDT) Received: from dell.default ([91.110.221.180]) by smtp.gmail.com with ESMTPSA id p19sm1466367edr.57.2021.03.24.10.34.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 24 Mar 2021 10:34:26 -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: Wed, 24 Mar 2021 17:33:57 +0000 Message-Id: <20210324173404.66340-19-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210324173404.66340-1-lee.jones@linaro.org> References: <20210324173404.66340-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-20210324_173431_219944_89BBE3E9 X-CRM114-Status: GOOD ( 22.30 ) 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==