From patchwork Tue Aug 27 09:55:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chen-Yu Tsai X-Patchwork-Id: 13779208 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 bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 96496C52D6F for ; Tue, 27 Aug 2024 09:57:57 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Reply-To:Content-Type: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Owner; bh=dWyWMS4bQMMjiZgqIsOGZj62aUV29JVjiV75aLUP6TU=; b=eb0l7qLRCZLliiGS7jSTlrRsl0 kfwtu7/F4N/uDtxqUwavGglMujseSZmKXQU8AhOURV1dyd7Vu4ehJTDucLA3ooQwiwrVWtJrn+/FX y62F2fMu0P8kRQF9zziaQyerlurrg0tLu/SHZS4wOAahHiy/yOx5TrqvkxljM0JtuQnDlcmK8nmF6 SWyqagT5h9WIEOhE3uURSR97Sl7fBDfRtxpk0LQ08YY+0YU7lMyU7E0F0jfThTwc//cb27zyF7UCW 7BdjJdE6aSfzGp9PDVPUHJIgXKwrlcSEs69pdJaV1LPV4gP77YKCJHjaDZnhj7zEt/PLAM81qKRTc U7M/wC1g==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1sisxL-0000000Ah3W-2pmm; Tue, 27 Aug 2024 09:57:43 +0000 Received: from mail-pg1-x535.google.com ([2607:f8b0:4864:20::535]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1sisvg-0000000AgWo-0LEZ for linux-arm-kernel@lists.infradead.org; Tue, 27 Aug 2024 09:56:01 +0000 Received: by mail-pg1-x535.google.com with SMTP id 41be03b00d2f7-7c3e1081804so3130168a12.3 for ; Tue, 27 Aug 2024 02:55:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1724752558; x=1725357358; darn=lists.infradead.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=dWyWMS4bQMMjiZgqIsOGZj62aUV29JVjiV75aLUP6TU=; b=oOtZWVDYUjaQQcDbRMKkk23i/VQ/6AaQKUD5D/DjSz1j00JdhkkpdCXK+czYt9YcOp rVWSJ7LxE80fmDfd8HYY5nQOKORHZrq6qop6XQMri5KC6H+7AlH9o14vfS/D/jjCY1Qq Fg83kg4MWBl2XEmQpVMKebh1BisA0OuW2h/Es= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1724752558; x=1725357358; 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=dWyWMS4bQMMjiZgqIsOGZj62aUV29JVjiV75aLUP6TU=; b=xTl4EgZ8284Esr3uGr/Z5g4aFcMhu1xUSoz0quAPghTrjA8LGKsj+vpCw1e5YVTZJ8 ME2y2mS5gmyROcsbiCk9lY+CDQGV+gNY2CvswTRyTqLZoi+DlM1/iQIvNUH0zG4z8tcN bxoWTs+O60wHCjuR7fH+YzHffgdqIzitsEhBgPP0Rz/I5wa7vZ1tC7WCK6Ns7qqNzDW7 QnlE/3WhA8s7Sbhqj+vTpw7KCfqIWpw//iXmVKskh0ZTzy7P0x//OUPaYOpIU7w/uV4y M64lupDCPbR2LD5mSd/s1kuF2Pi70SPynxBDTgYJk+k5ScHtrA4VJUPy0a6t+nBp0XkW 3nrg== X-Forwarded-Encrypted: i=1; AJvYcCXq8hUuTlC79xpmD9ASv3W9i8rH2fxsSioQm/VkWXyCnQ60sAA43XEWJHROccsxMQta+Bd4IChQ7e6EKKPupj/E@lists.infradead.org X-Gm-Message-State: AOJu0YyuTE4EyuQ8oLqXSiSM/BpD64rYjqjaEGnDr3amTXZhSFfdYOgg /scrVmLaKIaGM25UAcbMDLO2paGA03G+lsRYp0Jyv7kGeS9wQLS8eDy2DZ4UEohwQzQmRkLpCfA = X-Google-Smtp-Source: AGHT+IFBa9yFqwsm5uIj/y9e11VaShl5P9Ev1jbWDxZFp5m1LYz5F7uzySdXCkaqXIfI+yemICeHWA== X-Received: by 2002:a05:6a21:8cc5:b0:1ca:cd6d:3a26 with SMTP id adf61e73a8af0-1cc89dbad3dmr12347890637.27.1724752557986; Tue, 27 Aug 2024 02:55:57 -0700 (PDT) Received: from wenstp920.tpe.corp.google.com ([2401:fa00:1:10:3102:657e:87f4:c646]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2038560c2basm80006775ad.222.2024.08.27.02.55.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 27 Aug 2024 02:55:57 -0700 (PDT) From: Chen-Yu Tsai To: Mark Brown , Liam Girdwood Cc: Chen-Yu Tsai , linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, Andy Shevchenko Subject: [PATCH 0/8] regulator: kerneldoc section fixes Date: Tue, 27 Aug 2024 17:55:40 +0800 Message-ID: <20240827095550.675018-1-wenst@chromium.org> X-Mailer: git-send-email 2.46.0.295.g3b9ea8a38a-goog MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240827_025600_362219_4CE0D9DF X-CRM114-Status: GOOD ( 11.97 ) 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: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Hi, Here are a bunch of kerneldoc fixes for the regulator core. This sort of came as a request from Andy to not move code that already had warnings without fixing said warnings. So here I'm fixing them first. The bulk of the fixes are in the regulator core and OF code, but I also fixed up a few bits in common code that were missing "Return" sections. These are purely kerneldoc fixes and don't touch any actual code. I left the devres code and helpers alone for now. Please merge if possible. I will rebase my I2C OF component prober series [1] on top of them. Thanks ChenYu [1] https://lore.kernel.org/all/20240822092006.3134096-1-wenst@chromium.org/ Chen-Yu Tsai (8): regulator: core: Fix short description for _regulator_check_status_enabled() regulator: core: Fix regulator_is_supported_voltage() kerneldoc return value regulator: core: Fix incorrectly formatted kerneldoc "Return" sections regulator: core: Add missing kerneldoc Return sections regulator: of: Fix incorrectly formatted kerneldoc "Return" sections regulator: fixed: Fix incorrectly formatted kerneldoc "Return" section regulator: fixed-helper: Add missing "Return" kerneldoc section regulator: irq_helpers: Add missing "Return" kerneldoc section drivers/regulator/core.c | 175 ++++++++++++++++++++++--------- drivers/regulator/fixed-helper.c | 2 + drivers/regulator/fixed.c | 6 +- drivers/regulator/irq_helpers.c | 4 + drivers/regulator/of_regulator.c | 14 +-- 5 files changed, 141 insertions(+), 60 deletions(-)