From nobody Sat Feb 7 17:20:53 2026 Received: from mail-pf1-f171.google.com (mail-pf1-f171.google.com [209.85.210.171]) (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 D52F9311C13 for ; Fri, 24 Oct 2025 10:39:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.171 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761302386; cv=none; b=rHcQuyBKxhSFzd2tgH7FeKn60plyGUCyvUNh1wVvmC3FCi3g3SEK/Z7o9eaOKMkQ9vQPaAfB3Q0gyGxh5IsQuR7G4FwgZZSFsDRyiokoXmW2Ba7Y/S2ANO+6PlnpOwqVKzuyhDGEC++IGkxqiX/AsuL2dqIAydfrJsLcnEjgfBY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761302386; c=relaxed/simple; bh=1nfGRu+cQpdVI1u/u8x180bJnux/Aad+7XEoPErLSSQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=R8XK6tkvuxmx/0GkhMNTMegz18agxLts+qEsGMBgZVk76SwCVXAGeTLG7JRE73JXj7BdDEI9Zk3iaOD25kl6n1SAXFh5vBktZlwidppVYnoexQGEh7JBY1II3Dbs3mojwZcSUWwNmcva4Jvi9tts6k7yhBJVImdBbJqNSMa0zQ8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=PgcxY7St; arc=none smtp.client-ip=209.85.210.171 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="PgcxY7St" Received: by mail-pf1-f171.google.com with SMTP id d2e1a72fcca58-7811a02316bso1437396b3a.3 for ; Fri, 24 Oct 2025 03:39:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761302384; x=1761907184; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=MWxMkV9WkPnFS2UeBbKIDfqnrrcA5FBPCACezmc2M+g=; b=PgcxY7StUt51s63WVQdehNhrOfL9B0i2DztlDlDJQ+4r1b5ghB7R7GhCWZpXZJ6UF0 HfRUtrJwbKFKAmy59Jmkiz1Jr7uMHzvJzQEezaGEzf5fs1mtL4wyurHaLVtATuKct1wb s1CTISWIt094EvZcoHm57qLuzPpiUbkouSghne3Pm3lPNR5fB8agcHxks9H0tSoDhIIC PfUScCqm5x/wKX2or0uV3IjoXrLSSJdWWLQ9BUP4UVS8temLEF9lkzB+JHWTRF7STB6G W7dOEG95kja30Bui78foFfBMf56FxsFJ6eZ4COEHHLMYrZ1COfYKTt1Aboypbii9vmgU Je5A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761302384; x=1761907184; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=MWxMkV9WkPnFS2UeBbKIDfqnrrcA5FBPCACezmc2M+g=; b=TzkvkEHS1zb3PcRddfKyHxEIo1WMRREMzzhnJ0/kSpQSMSne8L7hlfln9+JFr5/xHR 0nXZZQRYdb4tdNDZRNhm4m3U+Vk2Ygywr7TYWVpgSLKeeGnVaPlDXRolmClp+qLjd9+j QlR4AXO3GB1qy0g8J1Jwd8i6Vko3KwrGXmJ57SoF0aiKZMD9wxFfB9+owy5M8Q15s5+J GGTSQ3Esb3/tQzLBpZBMub4ua6eqXlfXxm21jl4gegYm9kK1LuEPiM7/UpEVrLWV+FYw YNeAadmXm6PBrLn2DEm1YR7YZnE9+VOellHZdMtYkxsyr/xW7/Z22cIqqZRU05ZJJ+3o qRuQ== X-Gm-Message-State: AOJu0YwPzLSvbzhjMBACSbhicgzbxxrHEaBn2tgjUlnEH4vlrhC3ILly 9tabsKd4atm07YqbB368GpuOJRrNtRQWzQw1LIj55mKi/wcLVL4O2mz7 X-Gm-Gg: ASbGncuQQnGcbDIgvHc1Kw7R2j7Sr4piE/KNXEjaQhrl5wIeOr/WUqjtlrcO2E8w9Mv PEHC/Kq9+ir4ZY5PTXCMw817Lq3Ew25LPY7gfw7k3R57F7DgmH4CDiZGvtAf4SqkjoITHYB8y1K D3QvGMJSiEuZ0pFGzA4tC0f/E5fwFDpYzNnfu+HkmNdUR6wRlFcuyfKXsrIGERAUJmfKhMIufAL xMfQs8aWXGrBT90++wrcrAQTiyTBr/3FWpIuHxsxngIF2P6ZFjtNYohYp1ZLk88p1GKND2nqHM7 r+bymuKs8SFcP1t/RdMkjRf/3NdV93A8oNimGtZZrgZnZGmcWR2bX/iAFuQxrAl+EfT9DxnStGD 6vC8PS5CE5s8ynzPLIxrR/j1yuL6ZT7jn2ru4bLYhw0b9+MH7qyBdJ/KAJ/xk8ARGR6sxxXMu/1 m6lT2jtpVF4yc= X-Google-Smtp-Source: AGHT+IHEpl3TWDi9ZPhQso4ALduIvZe4iZeYs/TaKEmgdcaL9V+ffUdhwOZmNlpvsTLhO8POUDfQVw== X-Received: by 2002:a17:902:c942:b0:26a:8171:daf7 with SMTP id d9443c01a7336-290c9cbc096mr4811285ad.16.1761302384008; Fri, 24 Oct 2025 03:39:44 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2946dfc1cb8sm51175635ad.53.2025.10.24.03.39.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 24 Oct 2025 03:39:43 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id A81AE4209E4A; Fri, 24 Oct 2025 17:39:36 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Input Devices Cc: Jiri Kosina , Benjamin Tissoires , Jonathan Corbet , Masaki Ota , George Anthony Vernon , Bagas Sanjaya Subject: [PATCH 1/2] Documentation: hid-alps: Fix packet format section headings Date: Fri, 24 Oct 2025 17:39:33 +0700 Message-ID: <20251024103934.20019-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1.dirty In-Reply-To: <20251024103934.20019-1-bagasdotme@gmail.com> References: <20251024103934.20019-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1179; i=bagasdotme@gmail.com; h=from:subject; bh=1nfGRu+cQpdVI1u/u8x180bJnux/Aad+7XEoPErLSSQ=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBm/w0665IjY3ynzumWjmFlU9WajRq/nxTturx8uSVz+5 VahSdfVjlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAEwk6DHD//TLjxf7ybqqsfzR sJX32i/WLXVh1XyRC2GV6gH2zgvm2DEy7N2VLVElw9ql2TLXOE6DM1Xm67zIj2YWa1fuuTiB72I IJwA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" In "Packet Format" section, only "StickPointer data byte" subsection heading is shown as such in htmldocs output; "Touchpad data byte" one is in normal paragraph on the other hand. Properly format the headings to be consistent. Fixes: 2562756dde55 ("HID: add Alps I2C HID Touchpad-Stick support") Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/hid/hid-alps.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Documentation/hid/hid-alps.rst b/Documentation/hid/hid-alps.rst index 94382bb0ada4d8..3a22254e43464f 100644 --- a/Documentation/hid/hid-alps.rst +++ b/Documentation/hid/hid-alps.rst @@ -104,8 +104,10 @@ Read value is stored in Value Byte. =20 =20 Packet Format +------------- + Touchpad data byte ------------------- +~~~~~~~~~~~~~~~~~~ =20 =20 =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D= =3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D= =3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D @@ -156,7 +158,7 @@ Zsn_6-0(7bit): =20 =20 StickPointer data byte ----------------------- +~~~~~~~~~~~~~~~~~~~~~~ =20 =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D= =3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D= =3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D - b7 b6 b5 b4 b3 b2 b1 b0 --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Feb 7 17:20:53 2026 Received: from mail-pg1-f174.google.com (mail-pg1-f174.google.com [209.85.215.174]) (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 D21DC311C1D for ; Fri, 24 Oct 2025 10:39:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.174 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761302387; cv=none; b=Rn7EIR/egCaS4taI+R4KEX815Cusm4gHOl23HKSYfYg40RZ2Uz+1Ced69gRiLvEvwAihp3EtFgYqIaTGM5nbkB8HJigJvuRt9jqFK1xR06lftyh+TKZ2Yv2M8oYkVrQPKXSReDFJkCqE2D1O9/7PzJR+mnulhbv0Zvtc84v/qh4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761302387; c=relaxed/simple; bh=ihqHHh8OwZRzTv3PuAINRB9Afj/GqQ8V0nU3GCwr6d8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=PbLNYS1753aqssotwDR/sq3C71NY9AlkMGq2L7vT2zIGerrTqQtmZiHwTFh6twxjNJ6rjDGmpqQ1Paq1WoFNQc6WjtxoZ5vIXBWrAT5pUMFiYmidHQsvoOuLfO04w42+JgLME77m+SawncWg4hw3MwC7+Q939FzvLfjZHtQ9R4w= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=dMXydhC+; arc=none smtp.client-ip=209.85.215.174 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="dMXydhC+" Received: by mail-pg1-f174.google.com with SMTP id 41be03b00d2f7-b6ceb3b68eeso1445950a12.2 for ; Fri, 24 Oct 2025 03:39:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761302385; x=1761907185; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=TOQO5XhSta2OZ/LTSNvp9XgOSuMjTdgxONSnBp+ZzJ0=; b=dMXydhC+bv7DFf5dETUmhQvD/myNbj47qgrI80BgNU+vFwKathWKIZQkk/FPi768sB BTLEbaTeaCKzvrkgAZ9e02nV0HO5eCtf9mqfnSmEMe1UdUW9VkyorEkhdVhLeFbt9FV5 Vq/Hro3iLW2+0gUU5x+Xgv/k8u03W62jetQY4Ux1fL/ELeWcXQOxS0LGYiH6vvHLGSWS V1e0mKnfqyi/4KCOlkgsBZ6nOK/MtVnP+2cR7KCJTsWUy6iaR0b1sX/XAKCmlXqU19+N JM0FapwrumV5Df3YFwKr4igylvDc5lpjf0PVlXc7i+ZyQwBj3D7sSx/IVACNLafIDMGz WFoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761302385; x=1761907185; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=TOQO5XhSta2OZ/LTSNvp9XgOSuMjTdgxONSnBp+ZzJ0=; b=dcOUXcXr464bvfiFRL8ZEj1Z5hZQHhEhj3+vswkFF9JUppMkZzzg83dugdlA1JDs+u PA+qJKychmS6FPSlUQJj5OS1TlYdvHzpsh7Ubk/5UnOq2wwPZhLq0DqBHoXHK13GAdm7 kbT+JksBm/QvItQjW8lbu4WI02tEfGerfklLbHBLVsUXDcYv+2lnG4U237F9VBAPoo7t 7Xv7rlBNGHcVBpU2nY0JWVi2nE65rr9lR+27t6abO36IlSdwbWg2YaxVR6zNBO39qg9o pPoZ3Z68V7HB7xkoFuPadPEzRn2QUUm8j+CQYDFcWzlDDFLVcdBG0jtZ0gQloRda5OvU VCoQ== X-Gm-Message-State: AOJu0YyXtJDDzY/N1Z81xNYIRRV1viKcUxrlwNgN5RQ7PyxFiHS+tCbs lzXbk4ddzKV6bnJWwovj6XYepm6fPFeD8HVoGBMaQRAb7NepPchbG0FvH/TSuaKT X-Gm-Gg: ASbGncst25vI3lAHwB3Up/es26Snw8AXNzeVZAV3CPncjom60GwdfwrPFy1/WcTMl6z KCUiWynGBA/iGXQfCZcdUgxIutNj75asN3H92nu+S9PSRIa7Nk2PEmW9Fs/qqmto06lIbXcA7nG VAiDKSZyytQTzIfuNQ9FStG1TX4wa7wGOHzcaZAuZ3bE5V2fjNOd8oILVNDGauryLnnwkZpMivp P3Ooctfy3Z1uYJnyL346zS9C1j0pTAksz99HqSatNPkRu7Ipqo2clcvQ60Hb2jI0cUKkvj0tt7+ lJQMuSyhN5zr5ccux3AF86LBHHSMP6ZMNf2WAz/GCyDg7tKu5tVAVv9Vx2UiIM3MjBwCDFr8RXR INyzEsdLY760Kjl0vcBNdufuy4DhZeR460aCx3g3b+gL00JSALrjRM4RjJD/ZoglR+On66NYFgj 0p8vGRe2YJ8IM= X-Google-Smtp-Source: AGHT+IEVkwqrjTWCnBpVreVh6mTv++RFn66C5H23Cshuzgm7R8r/2peZvlKSHirNuI9LIOVlcF6vLQ== X-Received: by 2002:a17:902:d544:b0:261:6d61:f28d with SMTP id d9443c01a7336-290cc9bf243mr346647515ad.50.1761302384865; Fri, 24 Oct 2025 03:39:44 -0700 (PDT) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2946dddbfd8sm52919845ad.2.2025.10.24.03.39.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 24 Oct 2025 03:39:43 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id C38CD4209E90; Fri, 24 Oct 2025 17:39:36 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Input Devices Cc: Jiri Kosina , Benjamin Tissoires , Jonathan Corbet , Masaki Ota , George Anthony Vernon , Bagas Sanjaya Subject: [PATCH 2/2] Documentation: hid-alps: Format DataByte* subsection headings Date: Fri, 24 Oct 2025 17:39:34 +0700 Message-ID: <20251024103934.20019-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.1.dirty In-Reply-To: <20251024103934.20019-1-bagasdotme@gmail.com> References: <20251024103934.20019-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=979; i=bagasdotme@gmail.com; h=from:subject; bh=ihqHHh8OwZRzTv3PuAINRB9Afj/GqQ8V0nU3GCwr6d8=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBm/w04emqpwcP39tt3WXpUym62CzyVwXJ9Q2lZuwN+sU dZ78K9NRykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACainc/IMNFqr62r5c8U9oQz 7910RFb83Hhz/ldDFjPeh3sWm6uw3WNkmNLhdTWuwENx5/Qrpy8ceLj1jeeV7KSbe997TJDR1J0 pyQYA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" "Command Read/Write" section has two DataByte* subsections describing command bytes format. Add markup to these subsection heading texts. Signed-off-by: Bagas Sanjaya Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/hid/hid-alps.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/hid/hid-alps.rst b/Documentation/hid/hid-alps.rst index 3a22254e43464f..4a22a357f00c02 100644 --- a/Documentation/hid/hid-alps.rst +++ b/Documentation/hid/hid-alps.rst @@ -69,6 +69,7 @@ To read/write to RAM, need to send a command to the devic= e. The command format is as below. =20 DataByte(SET_REPORT) +~~~~~~~~~~~~~~~~~~~~ =20 =3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D Byte1 Command Byte @@ -89,6 +90,7 @@ Value Byte is writing data when you send the write comman= ds. When you read RAM, there is no meaning. =20 DataByte(GET_REPORT) +~~~~~~~~~~~~~~~~~~~~ =20 =3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D Byte1 Response Byte --=20 An old man doll... just what I always wanted! - Clara