From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DB1B3258EDA for ; Tue, 12 May 2026 01:35:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=170.10.133.124 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778549741; cv=none; b=tPGm4haP5VvItMyxdYbr/xswqxapP3vf3v/v3/hzhDxj9Kx50/a4d+4ou2Y35PpWv9XlUBXwTKwyIDHPw8TBv6r53y6eH+gASbeopzBqun+nabYCe7c5BbJ42NXO/hGAhLs0CFXiBsb5vDo/BQzsjsL2JPcRDUWsPeXQMNhGcBY= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778549741; c=relaxed/simple; bh=OXLbc8oa7LK5j+UoK7PYojQxNt6tMdSaWmLDVwmy6fY=; h=From:Subject:Date:Message-Id:MIME-Version:Content-Type:To:Cc; b=Wf7+V/3B4m8LtW9bj9OMRA0Ji5IQ+aqXuJjSWR+zUTKB95pWRW5mbJR1IFXA29t6VX9aIIgSRInsxIeVjSFWuHlWA09Tmcm4ZjTdUwkCl+gUQkdoxc9IkPC7eOl1oh9loeNPSF3x9iJGDaYGkPGPsWJ1W1kAT7xmCl66O3evG4A= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com; spf=pass smtp.mailfrom=redhat.com; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b=PK7Vk9Nc; dkim=pass (2048-bit key) header.d=redhat.com header.i=@redhat.com header.b=bua3LGJ/; arc=none smtp.client-ip=170.10.133.124 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=redhat.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="PK7Vk9Nc"; dkim=pass (2048-bit key) header.d=redhat.com header.i=@redhat.com header.b="bua3LGJ/" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1778549739; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hDM81GL78FREZS+LEcr682BVOat2yXDAdlE/kgG+9Ak=; b=PK7Vk9NcWSMhOUP9X3AD7zupfg92pvC83rxAimQiQzL3BxaEDtiI0hA3PX2ORO/UVdAvp/ KCxQgWhBmjy0hHnd/6tvj6W5C4iEQZaald6hQe4rx4I8i2fuEpcj1NxGVdKNk/+V1kvjZl edrzVK8LURV2yxEqhkPyWjjfjTMDKZA= Received: from mail-qt1-f200.google.com (mail-qt1-f200.google.com [209.85.160.200]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-198-tLxbhP-nPUutmkAElookmQ-1; Mon, 11 May 2026 21:35:37 -0400 X-MC-Unique: tLxbhP-nPUutmkAElookmQ-1 X-Mimecast-MFC-AGG-ID: tLxbhP-nPUutmkAElookmQ_1778549737 Received: by mail-qt1-f200.google.com with SMTP id d75a77b69052e-514ae0edeb6so55448611cf.1 for ; Mon, 11 May 2026 18:35:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=google; t=1778549737; x=1779154537; darn=vger.kernel.org; h=cc:to:content-transfer-encoding:mime-version:message-id:date :subject:from:from:to:cc:subject:date:message-id:reply-to; bh=hDM81GL78FREZS+LEcr682BVOat2yXDAdlE/kgG+9Ak=; b=bua3LGJ/G0JvzPn44dIDD1bltMl6WOGtAzek+ypdj19WcKhhE9qVdYJKh8G9NU7ZTU 2wpL/cQubpcRCvMPNadHttQ+TkmMg7kv9MTLeE+4IpfAIbtof1BxacX6BgAXhkE/pg1y Bli+BVrl/T3wrO/yBO80Z1nijkSP9wq/rJD94j9B1m5hDnEQCFfWW2m6QJUMEhU7oFfQ uEZQpz/HvMIEVDSBAtjGO9mDrrHQye5xZZ7pLKp1KcqD3UADxQ1bnralIK1HqBrtQLY3 GwXvsGG6HJ3MgkF9KWwEMguK/aOJEtOHRY1gd0bCYP4cV8u6VizqFbDN3bltmFJBZwk/ UPSg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1778549737; x=1779154537; h=cc:to:content-transfer-encoding:mime-version:message-id:date :subject:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=hDM81GL78FREZS+LEcr682BVOat2yXDAdlE/kgG+9Ak=; b=XZQi5UmoNoSCqAmAHG/ljRysPUE75pTTOLttyo/4PNhQSwYObWC34bpfBui3B4Fu+7 eqGFZVBqmQRPedfvrHZejN90ow7aNrsBuE/0hYKDJ1v2Q+J+NVDPeKM8odYhphmbKEbB 93QGVIWBGWjm8NZOwXjvTKvuJnzQtdT59qbzbhXU/uRBzaWseauld8HR9z49qjgOXwv/ DYnpYgxEls3XZaFhbluM6iXnSwhos68qSFoC0/ir/qEhDWvSnf34ML8tJEG2NGu7NSA2 XQTzEbILIm8N+WI/EiZTZnre9HQDaKoBvxiXyJPc1t/D3Z2P8dxYbpq9LpGoV1h1dAjP zDDw== X-Forwarded-Encrypted: i=1; AFNElJ8bYSh19W9Y38EmsLph/1jgaMt/LvVZULnCpbOBLgjvfmQF+jIN2MyqrDwLw1vxTkEHHHiX2tcugPI=@vger.kernel.org X-Gm-Message-State: AOJu0Yy8SBJmjDsaYJ9EYPgWEzTMvAYIPa1Ryh9M+tMNXH3KkR2XA+m9 jcReERuAerKReU/bj2CY3J1f9j9A663QkeViw6mL8aiGHQkOlC3PqhIdnbLlOFj8WmYdGi4UoUJ T5JDhKbXkDHgDnrGoNVVUNhNjVb8vozY8F7uHNy4QB5BfQuMXumXhGf/dvb6K4Q== X-Gm-Gg: Acq92OGOlK4xjYN5Tg+E4NRYBhDCy1rIseSiR7BJD4doGRj3KEwArgHi/Z18PMcjd3e EBSQykChmxAGfpw5LFwaWjqV+p0ExlsGp97Cm7dIdlgyU+ilEj/eR7CGm8cmaK10P/zzCON9eaC Y4SrA91Zwup/pozvdJ0f2zn1VLLBHM6wkG1qI+DHKFqPD7prPvJknWBYthcKML/YlBcuNa5a+WO wwLiLxWcuA/MAiRe9mjLMhXNR5CuGHQ/1W1zshh8YXInBqDF1qqcIWU1nHLQiKxxa6DGfSOAbFf WALvrqkFZ/3a93bydSUWg9jeYT/Og0cQ6/hJwX6O/VBHo400CFE5hYX0j7pWG7knHKMr8G68Dmu 4Y7nJ3bhVfJwMroppzZlYkoXFb0+/+b/CRdtCQK0+KS8U7+Ly/y3j15dj2ZFDmg== X-Received: by 2002:a05:622a:1a85:b0:50d:af03:c9ca with SMTP id d75a77b69052e-514cf02bcabmr26355901cf.38.1778549736889; Mon, 11 May 2026 18:35:36 -0700 (PDT) X-Received: by 2002:a05:622a:1a85:b0:50d:af03:c9ca with SMTP id d75a77b69052e-514cf02bcabmr26355501cf.38.1778549736403; Mon, 11 May 2026 18:35:36 -0700 (PDT) Received: from [192.168.1.15] (c-73-183-52-120.hsd1.pa.comcast.net. [73.183.52.120]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-8bf39c7e2e5sm109704006d6.34.2026.05.11.18.35.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 11 May 2026 18:35:35 -0700 (PDT) From: Brian Masney Subject: [PATCH v3 0/4] clk: update kernel docs Date: Mon, 11 May 2026 21:35:03 -0400 Message-Id: <20260511-clk-docs-v3-0-ed67e1065809@redhat.com> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit X-B4-Tracking: v=1; b=H4sIAAAAAAAC/22MwQ6CMBAFf4Xs2ZptgQqc/A/jgbZbaVRqWtJoC P9u4YSJx3l5MzNECo4idMUMgZKLzo8ZykMBeujHGzFnMoNAIbHEiunHnRmvI0NVnxpbCS4RId9 fgax7b6nLNfPg4uTDZysnvq5/IokzZJaoko1RbWv5OZAZ+umo/RPWShI7U9Q7U2RTaSslEtek6 h9zWZYv+RLjKdsAAAA= X-Change-ID: 20260304-clk-docs-0b578f421600 To: Michael Turquette , Stephen Boyd , Maxime Ripard , Jonathan Corbet , Shuah Khan Cc: linux-clk@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Brian Masney X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=openpgp-sha256; l=2106; i=bmasney@redhat.com; s=20250903; h=from:subject:message-id; bh=OXLbc8oa7LK5j+UoK7PYojQxNt6tMdSaWmLDVwmy6fY=; b=owGbwMvMwCW2/dJd9di6A+2Mp9WSGLKYmu+WFLxrO7vqtcvkBi2RG01afCGq38pVMv6ZCszgk 97y6ceWjlIWBjEuBlkxRZYluUYFEamrbO/d0WSBmcPKBDKEgYtTACayIo2R4fXh5W+V6nnDlwr/ c2W2Dszku5le0Hc+7Ivnw/reosAzoQz/TPUiAnZ8EmSMjnn0fG/W3rK80LfOHHsO9Liz6rzOvtf JBgA= X-Developer-Key: i=bmasney@redhat.com; a=openpgp; fpr=A46D32705865AA3DDEDC2904B7D2DD275D7EC087 Here's a small series that updates the kernel documentation for struct clk_core, adds a doc block for the clk flags, and updates the clk kunit test to use HZ_PER_MHZ. Since I've been doing a lot of work in the clk subsystem lately, I would like to add some more documentation about this subsystem in the future as I have time. There's a lot of other things that I know can be done now, and I'd like to just start with these small changes merged. I tested this by running 'make htmldocs' and opened Documentation/output/driver-api/clk.html in my browser to ensure that it was rendered as expected. Changes in v3: - Remove clk flags enum and replaced with a doc block. - Add separate header for the flags in the rst file. - Rebased onto next-20260508. - Link to v2: https://lore.kernel.org/r/20260325-clk-docs-v2-0-bcf660e1ceb5@redhat.com Changes in v2: - Add clk_core_flags enum, and kernel doc for this. - Update descriptions in clk_core based on feedback from Stephen. - Update clk kernel docs to show some of the new API documentation. - Link to v1: https://lore.kernel.org/r/20260304-clk-docs-v1-0-fee468db99f1@redhat.com Merge Strategy -------------- Given the new doc block, and cross tree dependency, it would be easiest of all of this was merged together in Stephen's tree. Signed-off-by: Brian Masney --- Brian Masney (4): clk: add kernel docs for the core flags clk: add kernel docs for struct clk_core docs: clk: include some identifiers to keep documentation up to date clk: test: convert constants to use HZ_PER_MHZ Documentation/driver-api/clk.rst | 58 +++++++++------------------------------- drivers/clk/clk.c | 51 +++++++++++++++++++++++++++++++++++ drivers/clk/clk_test.c | 7 ++--- include/linux/clk-provider.h | 46 +++++++++++++++++++------------ 4 files changed, 96 insertions(+), 66 deletions(-) --- base-commit: e98d21c170b01ddef366f023bbfcf6b31509fa83 change-id: 20260304-clk-docs-0b578f421600 Best regards, -- Brian Masney