From nobody Tue Nov 26 00:21:57 2024 Received: from mail-wr1-f43.google.com (mail-wr1-f43.google.com [209.85.221.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9A58A15B551 for ; Wed, 23 Oct 2024 08:36:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.43 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729672563; cv=none; b=nq+atja9YpNPumcqD+tLUGItylPmoL9SUvmRF1nUPZy1Z9Y1jCf/GNIe4OIyaZylnYKdsnjE5NhLwz92cAttKjErUEV+ovVpL72Lm48HO9UCQsKjPThj0kXNmGSxGQNjPjr3y9CeReHqjKCPAnqMHIcxNDJAhsaDxB9/r+pPSUs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729672563; c=relaxed/simple; bh=22PUekDJ/BZBChqezFLIbZo+HIfdrQs6Vn6KTsob18Q=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=JxDLlePwQDRFyrNIOa0LtFmfHQd/fIAw/HmJNyaXitzL29ksrP+GChUqZUhmFUa0nlpa+5cbN3r5OLcAYGM1Cx2YoKLCI56Ws6IX6EO81bmNw41HQNTh/5dN6w2VbrIDAJe6X5h5bAh2jA1t9ExD2eCQBlsxPCEkB9cFW6Fe8C0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=0Z7cL3s/; arc=none smtp.client-ip=209.85.221.43 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="0Z7cL3s/" Received: by mail-wr1-f43.google.com with SMTP id ffacd0b85a97d-37d5689eea8so4332781f8f.1 for ; Wed, 23 Oct 2024 01:36:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1729672560; x=1730277360; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=HN0qSodm0TbBEMpCbusTzit2AiGW6RcmHnZPYHSxahg=; b=0Z7cL3s/H77zlZfn/Ewr4EU8GqigBBoYW7a7b8z/TzCGo1I6iJo5LKzhqBarcddSgP 0CaFkexbhS4zgGO1Ig6NBQ5o6To4evv4mdr8N9CAzcfykGk47v5UYZjP/yfQWRKY/AZU KfI90QVFq8v+PSZb0WmpxmInRlGsftdnF4bIqpDLJCCIHF1f7KoRv0ZE9k/mV69hNtvD wH5pJ6HDS+l/0M1TZbIQSlbL/lybrzkv8a9pbZltSRBC4/6Z8vnjnPoMw2mgKAHDdz5q DlDVda4Hc910+NzxSHT6RZwl/BLZ6sm6Jl5oPjOIPUooWX+O4Si+PztChhdQ25M069S7 U1DQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1729672560; x=1730277360; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=HN0qSodm0TbBEMpCbusTzit2AiGW6RcmHnZPYHSxahg=; b=V1rSBoO7S3QjzCv7M4AYbsvzYuvFRjpPnoDwTeFrDRhm7j32AHAuCUL19SSPEIT7ZD 8yDZmHkjf5wWNIns9Ft+LUpO5his1+ECK1/04aBwVjTms/PrqXIJ1W4j1eXlk8vXjyml 7k2ZJZg/Q30m9qfz5/pj10ltdNE0N27NYd1WHZke8MOXdaBKW5v44yVXJNiXy4hEQepK P64e0IwPohH28x/pUSGZKFjdgCLiNYxNLw7FtZJ0564LP+utqXux4DVhs23JattM2fQD NUBFLrXEZfVuW0RGzAhzJK73ePKeyvbeVscZzH0NuqtXTVjPcMrmpRR2Rdw/vThulAWb 08cw== X-Gm-Message-State: AOJu0Yzk2Vw3JZ8dxrAWztuo+XYmauSKWjH4jtv97ey/zY9KZkUhjj92 iOfEQzgGBKQ7NRodtp46B15bPhiQtfbIItbL9Aw/5h5OxuptRFsE+aGTa/XDE9PpOz57LlzKJpx e7G0= X-Google-Smtp-Source: AGHT+IHHDep2W2DCwAiMlF/ZOG/3YJ2WQ8a3O7hrRncH4b83mpdG2ukmOottDIDvc3PTv2I2vz3c8A== X-Received: by 2002:adf:ea47:0:b0:374:c92e:f6b1 with SMTP id ffacd0b85a97d-37efcf0621bmr1374359f8f.23.1729672559941; Wed, 23 Oct 2024 01:35:59 -0700 (PDT) Received: from toaster.baylibre.com ([2a01:e0a:3c5:5fb1:ee3f:9900:c4e6:69d9]) by smtp.googlemail.com with ESMTPSA id ffacd0b85a97d-37ee0b94363sm8435736f8f.73.2024.10.23.01.35.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 23 Oct 2024 01:35:59 -0700 (PDT) From: Jerome Brunet Date: Wed, 23 Oct 2024 10:35:43 +0200 Subject: [PATCH 1/2] regulator: doc: add missing documentation for init_cb Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20241023-regulator-doc-fixup-v1-1-ec018742ad73@baylibre.com> References: <20241023-regulator-doc-fixup-v1-0-ec018742ad73@baylibre.com> In-Reply-To: <20241023-regulator-doc-fixup-v1-0-ec018742ad73@baylibre.com> To: Liam Girdwood , Mark Brown , Stephen Rothwell Cc: linux-kernel@vger.kernel.org, Jerome Brunet X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1562; i=jbrunet@baylibre.com; h=from:subject:message-id; bh=22PUekDJ/BZBChqezFLIbZo+HIfdrQs6Vn6KTsob18Q=; b=owEBbQKS/ZANAwAKAeb8Dxw38tqFAcsmYgBnGLVsOIt2Ry316NUNahy3C3/vrL5BMLuGE/tz8 PeniTuKBwOJAjMEAAEKAB0WIQT04VmuGPP1bV8btxvm/A8cN/LahQUCZxi1bAAKCRDm/A8cN/La hX7vEACSV9lPfyllOR2FreSOn8rItQlQDpK+mLbecc6ndhBIr41RyTZ0TnVRbFCZHPcsq1pICj7 OYyCscZe6/JlbNXhcK6Xsz5elO590saCkg2u1W+eE/zfwD61SqCW2AGWTueprGmy72A8r7ymBAE 4aJZGTX6VP3kj+ADJVXhWk54JckFo2G/0wb1XZUOSZ5bMrV50mez6YCe7WmGOw/0zKFJkSK8YKe xBZxKAok8rgMOhjlf+XsqgnY3+6Z6Nd2YsSfiT+0frba1HNX8Ft0a0hjmS8msBhOszOl8AkZjXb xEXE8Au9xP0umjpC0gZrnl5SUmXBVMaONIXQw10yLaL8CPIRTf0w2fZvv1xoFu0FM8oZYmtlh4Z sYRgkeBhx74B/4zlnicbGX5p95YFR8/I0E5kcJEI/2JK7hvAzw5IFYM2XHfJJ4z/OUqtAwGNy9K l+N/i+e5WPun6vQV4lps538wN+tGHD658fyHfpSa30cyo7s0YpLu7+465p1Yw920ZLHkjnobOxV 8NPkGUWBrtf9KzCAJ/5Vm5A93BO0Dya/F4OpZqXT7M+5WAuvoxFFBwgX7taXwin0gE2JOuhmPl9 trEyXnOaMoyp4n4IhiopB3pycG9e48eCWQ5WhWewQjOUakjrNFncvf/dR/cA4+vabP2924ostp6 BCwSU4Jd4kuclZw== X-Developer-Key: i=jbrunet@baylibre.com; a=openpgp; fpr=F29F26CF27BAE1A9719AE6BDC3C92AAF3E60AED9 Add comment documenting introduced init_cb. This solves the following warning when building the kernel documentation: ./include/linux/regulator/driver.h:435: warning: Function parameter or stru= ct member 'init_cb' not described in 'regulator_desc' Fixes: cfcdf395c21e ("regulator: core: add callback to perform runtime init= ") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/lkml/20241023155120.6c4fea20@canb.auug.org.= au/ Signed-off-by: Jerome Brunet --- include/linux/regulator/driver.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/include/linux/regulator/driver.h b/include/linux/regulator/dri= ver.h index d2f4427504f081e28a0c5102f329eda48324f163..5b66caf1695db2ad27ed78cf6be= b8ae55052b5b7 100644 --- a/include/linux/regulator/driver.h +++ b/include/linux/regulator/driver.h @@ -269,6 +269,11 @@ enum regulator_type { * config but it cannot store it for later usage. * Callback should return 0 on success or negative ERRNO * indicating failure. + * @init_cb: Optional callback called after the parsing of init_data. + * Allows the regulator to perform runtime init if necessary, + * such as synching the regulator and the parsed constraints. + * Callback should return 0 on success or negative ERRNO + * indicating failure. * @id: Numerical identifier for the regulator. * @ops: Regulator operations table. * @irq: Interrupt number for the regulator. --=20 2.45.2 From nobody Tue Nov 26 00:21:57 2024 Received: from mail-wr1-f42.google.com (mail-wr1-f42.google.com [209.85.221.42]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 3774C165F1F for ; Wed, 23 Oct 2024 08:36:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.42 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729672564; cv=none; b=AkUIvWzwqSha/kkgq1C2zO8pquh9wlDQeU3C9SzFizxOts9X9zMGfLRgwSS61pLaX3Y8/Y+NHP5y2DN4Puw3m9jInWINfsm/WuD85FVf2hr5vcwIBxS7u+PVEZMNZ9bSFUPCtxYwqnjz1+QtIkkRFPUrHsRWUEGGW5XD6zCIZF8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729672564; c=relaxed/simple; bh=C0ofzRLHUjnO1N29L93VIpCDVoP5kG3rbslvEMd6Yls=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=S0k2uZUKVaUEz6pTsJGj6B2CGgUH6VawMvhDzNnFts1lU9nxlWBFsqg83eDNG2Ta/S3hAEFXUMQGOOFvBhm15P3Dkd5UBrS0p/ydZ3Z1V64EBGQECdMUFo3lwbXZiUwIetqTVd6WhbqZZaE+eCshkIWprD3MF+nCKbAuEhShCPw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=tcxhkOBX; arc=none smtp.client-ip=209.85.221.42 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="tcxhkOBX" Received: by mail-wr1-f42.google.com with SMTP id ffacd0b85a97d-37d41894a32so420690f8f.1 for ; Wed, 23 Oct 2024 01:36:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1729672560; x=1730277360; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=Zb3NhR3iOWSFx2LHTN/vlZTx5Yzwk+aCcenmMYG6qoM=; b=tcxhkOBXdrOr9TRlJ6gbTWQeg3l/dq6A22/lf7YzRX9msmUVfxHZStMlwYv0MG6+yK QAqx7G4V6WqP9RkF5cjBd09Q8vTG62ziEb6gOeZc0th+uImIoZznIQJSfOvX15Q1V/6O V6kKETlXmHc7iL+jT8DPcmB7QiHYs7jqjPpweoMmFit07SRcMHkyKkCwOKXsjZig7IMc HkLnNlzGpT7KTNEOruwi4RaGiPLVB/+N3cTrqiHQE4hyeoFn3B5BtFHSMZmqXD7YJKfh XoTJKfer1QbBnJvTfAP4DIL6XHEpI+VzAIFLrRMGVSEn7DymzO0Lap6celLXVcdc49ZC pwsg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1729672560; x=1730277360; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Zb3NhR3iOWSFx2LHTN/vlZTx5Yzwk+aCcenmMYG6qoM=; b=rpKm1cxocu06EjUgrUxOU7sikyxgs0x/upKUwI/quCC7NLLYnAv7maSaVQZlNufAmI tY/p82i5qFIRE7K83Hcyj3ta5V6Qv1V8IIs2ylzFG5FETJJKNIt5mu7DzYH/tZl/CJmx Ge64pkNMRoaXV+A/xLPX4n/Hr6bDE9Bk2ZRrg3iILz2ANY0pXxlBNls9wEJsgHAEqJQk nJVgWByhewLuCZCqnvU1UVeHsWnN9MfofnEM7tN3qS3pCUTiuH+8lyLZs9I5Kkj5k+g2 2abPK+v1fhtaCIFp1mfuQg0xfiK6zi5BIUmS9rAm7Tc34vnGdNm2sGwiy+BID5LDyO2o I2Sg== X-Gm-Message-State: AOJu0Yy2jrWn9PuRuimwASgoLlOTW8yuwiZtAsd3M8RSiTrz7A1WKTax Bs+FoFX6K9+1Y0XC/NF4Sp60dGRkrzUiGg8bsMr/vRIUMcDqp9xsYdmoEpmBsCU= X-Google-Smtp-Source: AGHT+IFWVcJDijZb3OwIOwIt8AYR5eAsFE3GY8DX8Lse58wemtB27SFLO/TB7EwfetuLQFYX3zFIUA== X-Received: by 2002:adf:e951:0:b0:377:94b:4f51 with SMTP id ffacd0b85a97d-37efc62c8e5mr1006798f8f.22.1729672560604; Wed, 23 Oct 2024 01:36:00 -0700 (PDT) Received: from toaster.baylibre.com ([2a01:e0a:3c5:5fb1:ee3f:9900:c4e6:69d9]) by smtp.googlemail.com with ESMTPSA id ffacd0b85a97d-37ee0b94363sm8435736f8f.73.2024.10.23.01.36.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 23 Oct 2024 01:36:00 -0700 (PDT) From: Jerome Brunet Date: Wed, 23 Oct 2024 10:35:44 +0200 Subject: [PATCH 2/2] regulator: doc: remove documentation comment for regulator_init Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20241023-regulator-doc-fixup-v1-2-ec018742ad73@baylibre.com> References: <20241023-regulator-doc-fixup-v1-0-ec018742ad73@baylibre.com> In-Reply-To: <20241023-regulator-doc-fixup-v1-0-ec018742ad73@baylibre.com> To: Liam Girdwood , Mark Brown , Stephen Rothwell Cc: linux-kernel@vger.kernel.org, Jerome Brunet X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1287; i=jbrunet@baylibre.com; h=from:subject:message-id; bh=C0ofzRLHUjnO1N29L93VIpCDVoP5kG3rbslvEMd6Yls=; b=owEBbQKS/ZANAwAKAeb8Dxw38tqFAcsmYgBnGLVtxcYbNnO59vrsvGB+mxT8/ZfIncALv+eoB LfW4hyfdgqJAjMEAAEKAB0WIQT04VmuGPP1bV8btxvm/A8cN/LahQUCZxi1bQAKCRDm/A8cN/La hQ6OEACsE65onvt50y86aGuQZpkTRHE7TAS32//RKXMFI6lFHwKen80B+5pMFweFCXtyTgqo/4H fJzMhPEXFDHBkMQMjo0wWcZUY/5BR6MplviVA2/fKPHG1xCaJbpspQWVeW7RcvNW5Zsl4R5LiTT Y6qd3faMQn10ZcUMd11y36jDyrunKqiUv8skVBKyTG/Pgt7fL/gtYg0uVcTrMsZG/5NOzmOIEOE M09mgChIAkF4S6wtvQIaPRKsXfohA2eHurO7oBMA1pbAsg67Cs9TO7VvyGUIeUHeR7GeI/L3EKj hkT+MbngSbNQzWIh8X8ouFnXy7KsfWtMzo9Ou1nR79JoSw0Wp3+5QCPeduo4eVaEWvBCSWy5Uu2 vnb4DAIwFQ8JdcJrQZODJmhw+c/iAFDUJ20tKG1tUn9eWQ1sAaXQjc2FFiBBrcvb0iDVXREh4/o SJtUrTsQKPgO3qrxw4LU4hnK5ZHTCeChY5e0MD9eteomCrs2zjNiYmK8c24t6gc9yN4B9r5DzOh 4Pm7t2PWoExPUtfOcdLKuosNsWfcX778qH7jXohLU54KKzAh+9qLsyfnWG+uUgmpkbuqjGY96mG X486KQLI9ceEytFv7CXXO8hrkvUc8bfXVAPzUVjqWq0Iw6QrAHpEhxh92hmOx3e9Ud/jVsgSa4L nYXT7pBMnoYly8Q== X-Developer-Key: i=jbrunet@baylibre.com; a=openpgp; fpr=F29F26CF27BAE1A9719AE6BDC3C92AAF3E60AED9 Remove documentation comment related to regulator_init callback. This solves the following warning when building the kernel documentation: ./include/linux/regulator/machine.h:290: warning: Excess struct member 'reg= ulator_init' description in 'regulator_init_data' Fixes: 602ff58ae4fe ("regulator: core: remove machine init callback from co= nfig") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/lkml/20241023155257.0fa7211d@canb.auug.org.= au/ Signed-off-by: Jerome Brunet --- include/linux/regulator/machine.h | 2 -- 1 file changed, 2 deletions(-) diff --git a/include/linux/regulator/machine.h b/include/linux/regulator/ma= chine.h index d0d700ff337af119636bf993114c6d2247f6b291..b3db09a7429beeb64a413a0ba2f= 785a4c877c018 100644 --- a/include/linux/regulator/machine.h +++ b/include/linux/regulator/machine.h @@ -273,8 +273,6 @@ struct regulator_consumer_supply { * be usable. * @num_consumer_supplies: Number of consumer device supplies. * @consumer_supplies: Consumer device supply configuration. - * - * @regulator_init: Callback invoked when the regulator has been registere= d. * @driver_data: Data passed to regulator_init. */ struct regulator_init_data { --=20 2.45.2