From nobody Thu Apr 2 20:25:29 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 DB2071B7F4 for ; Fri, 13 Feb 2026 00:12:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1770941535; cv=none; b=f8zY2dLi5oE1JAVtHEfF7hYhQqoLwFmpiB8xLsnfXAn3rd8Gscf9DIsG14ZcLaMVEByJoWr78JeRcb/2/FxVxkkpXMNTsmjM2cTgeS784r2H+71yRT0v7r74tnONyHZhaZVozcLHErhJfzZPJNeCdTO/vf7wHHCC6HlpqdngK4Q= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1770941535; c=relaxed/simple; bh=U3tavmgXcnY4Pjr0GO6n6q2Xz6lSo6uPdhYZV8RXi9A=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:To:Cc; b=IBGblbpK3WiZt5FBV1ckim6hm41/SjlDzc1/ruPoIT4p+27JalGb8m7Q3+GpmZTqU7QjUoMZFqdf6EDAKINZmW/PAJqZ74U4WT1OjS8f45QPbkre9w/JfY+1zcaeojfPE22iga0nYjQZaQ5rDqGtNqpcEciFcRxOTpSLw6KzhN8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=RZmsGjsN; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="RZmsGjsN" Received: by smtp.kernel.org (Postfix) with ESMTPS id 8B15AC2BC87; Fri, 13 Feb 2026 00:12:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1770941535; bh=U3tavmgXcnY4Pjr0GO6n6q2Xz6lSo6uPdhYZV8RXi9A=; h=From:Date:Subject:To:Cc:Reply-To:From; b=RZmsGjsNHFFuGe5C9QIOcCYbUo68ZYNlh+WJCWHaHKco/FoJzEYPTq0lV6nbk953v rUE/H62b7TsASnuZceJ3XX4rN8Dt3A2PcqA6xHO/HBfDl3Wrij7YfeYwElxVagOqGb 4wcr1xd91T4Qo/fSaui7+VRK4dAk9fZ2HITMJGxHJN7lIDD9SC/2R/hD6lw7toYe4t 4lo95ejKO0HgkO7uk6cUO+p7+qOYV1zo840cOxEjwsl7JJliKaLt4kgs3xoLAXIw8H GMRPTC4XTFMgQdRok7p/sXd6WChgpASU5Kwcu/BdhzeaD6iYre3IrSZF66HADgi/v4 BVlCL71zQ4cpw== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 76408EEA853; Fri, 13 Feb 2026 00:12:15 +0000 (UTC) From: =?utf-8?q?Bence_Cs=C3=B3k=C3=A1s_via_B4_Relay?= Date: Fri, 13 Feb 2026 01:12:07 +0100 Subject: [PATCH v2] Documentation: sysfs-pps: Fix `Description:`s 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: <20260213-sysfs-pps-doc-re-v2-1-044cba5715e1@sch.bme.hu> X-B4-Tracking: v=1; b=H4sIAAAAAAAC/13MQQ7CIBBA0as0rB1TKDTqynsYF0AHS6JAZmqja Xp3qYkbl3/x3yIYKSKLU7MIwjlyzKmG2jXCjzbdEOJQW6hW9a2SCvjNgaEUhiF7IIS+O6LW0mj ne1G3Qhji60terrUD5QdMI6H9QaY9SANO/1mzBAm9HDpp0Abn7blQvtu0H5+b6ywjOLLJj5vzs DwhiXX9AKz79zrDAAAA X-Change-ID: 20260212-sysfs-pps-doc-re-639e44154bc6 To: Rodolfo Giometti Cc: linux-kernel@vger.kernel.org, =?utf-8?q?Bence_Cs=C3=B3k=C3=A1s?= , Rodolfo Giometti X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1770941534; l=4183; i=bence98@sch.bme.hu; s=20260213; h=from:subject:message-id; bh=NDSyGXtsT/QAd57UBSLhgXDguFZiMPZ+GFjvlQWLn4w=; b=YBNDcndyBnstItj3XeujA/660RgesvucRvalhiwOvQV1cPjwwejam2C66ry0XCtYlSIG111Ld mIZi3otCbceD9v+bGmwtSBITGXTYarsM6o4dFryS7SvipUD597E3iB5 X-Developer-Key: i=bence98@sch.bme.hu; a=ed25519; pk=rtWE8PtqZ5ZMyUVCckDq8i1ASLxgUbV2fwDA8KaOli8= X-Endpoint-Received: by B4 Relay for bence98@sch.bme.hu/20260213 with auth_id=636 X-Original-From: =?utf-8?q?Bence_Cs=C3=B3k=C3=A1s?= Reply-To: bence98@sch.bme.hu From: Bence Cs=C3=B3k=C3=A1s It is unnecessary to duplicate `What:` content in the description. It makes it harder to both read and maintain. Also, the uapi header no longer lives at `linux/include/linux/pps.h`. Acked-by: Rodolfo Giometti Signed-off-by: Bence Cs=C3=B3k=C3=A1s --- Changes in v2: * rebased on current master * updated email from mailmap Link to v1: * https://lore.kernel.org/lkml/20250815-b4-sysfs-pps-doc-v1-1-61d315eafbca@= prolan.hu --- Documentation/ABI/testing/sysfs-pps | 29 ++++++++++++----------------- Documentation/ABI/testing/sysfs-pps-gen | 2 +- 2 files changed, 13 insertions(+), 18 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-pps b/Documentation/ABI/testin= g/sysfs-pps index 25028c7bc37d..b8034ead5ae5 100644 --- a/Documentation/ABI/testing/sysfs-pps +++ b/Documentation/ABI/testing/sysfs-pps @@ -10,16 +10,16 @@ What: /sys/class/pps/ppsX/ Date: February 2008 Contact: Rodolfo Giometti Description: - The /sys/class/pps/ppsX/ directory is related to X-th - PPS source into the system. Each directory will - contain files to manage and control its PPS source. + This directory represents the X-th PPS source in the system. + Each directory will contain files to manage and control its + PPS source. =20 What: /sys/class/pps/ppsX/assert Date: February 2008 Contact: Rodolfo Giometti Description: - The /sys/class/pps/ppsX/assert file reports the assert events - and the assert sequence number of the X-th source in the form: + This file reports the assert events and the assert sequence + number in the form: =20 .# =20 @@ -30,8 +30,8 @@ What: /sys/class/pps/ppsX/clear Date: February 2008 Contact: Rodolfo Giometti Description: - The /sys/class/pps/ppsX/clear file reports the clear events - and the clear sequence number of the X-th source in the form: + This file reports the clear events and the clear sequence + number in the form: =20 .# =20 @@ -42,32 +42,27 @@ What: /sys/class/pps/ppsX/mode Date: February 2008 Contact: Rodolfo Giometti Description: - The /sys/class/pps/ppsX/mode file reports the functioning - mode of the X-th source in hexadecimal encoding. + This file reports the mode bits in hexadecimal encoding. =20 - Please, refer to linux/include/linux/pps.h for further - info. + Please refer to for further info. =20 What: /sys/class/pps/ppsX/echo Date: February 2008 Contact: Rodolfo Giometti Description: - The /sys/class/pps/ppsX/echo file reports if the X-th does - or does not support an "echo" function. + Whether this source supports an "echo" function. =20 What: /sys/class/pps/ppsX/name Date: February 2008 Contact: Rodolfo Giometti Description: - The /sys/class/pps/ppsX/name file reports the name of the - X-th source. + The name of the PPS source. =20 What: /sys/class/pps/ppsX/path Date: February 2008 Contact: Rodolfo Giometti Description: - The /sys/class/pps/ppsX/path file reports the path name of - the device connected with the X-th source. + The path name of the device connected to this source. =20 If the source is not connected with any device the content of this file is empty. diff --git a/Documentation/ABI/testing/sysfs-pps-gen b/Documentation/ABI/te= sting/sysfs-pps-gen index 2519207b88fd..c36bac37a883 100644 --- a/Documentation/ABI/testing/sysfs-pps-gen +++ b/Documentation/ABI/testing/sysfs-pps-gen @@ -12,7 +12,7 @@ Date: February 2025 KernelVersion: 6.13 Contact: Rodolfo Giometti Description: - The /sys/class/pps-gen/pps-genX/ directory is related to X-th + This directory represents the X-th PPS generator in the system. Each directory contain files to manage and control its PPS generator. =20 --- base-commit: 136114e0abf03005e182d75761ab694648e6d388 change-id: 20260212-sysfs-pps-doc-re-639e44154bc6 Best regards, --=20 Bence Cs=C3=B3k=C3=A1s