From nobody Sun Feb 8 19:11:20 2026 Received: from out-179.mta0.migadu.com (out-179.mta0.migadu.com [91.218.175.179]) (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 B610113B5B3 for ; Mon, 26 May 2025 14:00:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.179 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268041; cv=none; b=pIX9mlbcDptB8cr0rxTLfWsEbs54ukGAVT4mnTa81U+/xBiL5Zm9PfD4BS5MP0bcMzBCtbNEqoD4DITxZUimMplIUKzl8xkgY/CSIw8/C0VSKK7vdUx7JVDtoO0QIV3DKi2qafV6ArVSRTd335msoFfiPGMDa/AbhuoypYv0bsE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268041; c=relaxed/simple; bh=aNQGcOGLGwzhcIOM8NfPYM0jf7KwNLGhz88QIVgMRM4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=GLNas5acvEODGZrANdx9w0YDfq7o30RmBKV7LQd71HPAsP4saBIDxAP9Z57lDhSEifLJbV9enN3U422Pm746+wiUZVXY7W7GiFjCZPkLdlNYYWQ3gH8BiChxocT2le/gKiRSxcwkoF4Fp9lgSriALNT/eRtJC3ZBJx5GYEiNOjg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com; spf=pass smtp.mailfrom=gvernon.com; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b=LF8Zty1P; arc=none smtp.client-ip=91.218.175.179 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gvernon.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b="LF8Zty1P" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gvernon.com; s=key1; t=1748268037; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ORmLrLq9c8xhomXJo56yAZlyEE/xXLB0zfu2z9O+YZ0=; b=LF8Zty1PSNafiuCuzp3qeQKoFXTYqFxEnstUI2gpqI7prTx/YxUn97yrsLncUH1qtn8BqG qlxy3Zm1f4wZHYgkhNcKnnzi7MN+gaGCgLhT2Uc6Zvkz3WqrMIaZ2KZvynnumaPALqk158 86aqUnv1MPBefEB/ULCFPQsb7nbncaQ9vsjUtJwrt2JYJVPvsd9SbYkd6Da77U2sT/IpBy TmESmwlFjsFuceLp8miIXt9/bjIZGb0BsZ/bKBR0YkfUGbvYyq1VFSGA9RQZ0XfBkpVzVn aZ50AFbGsnwB4+a9eC9LSlrdLBVmaCHMBFiVVsliLBW7Pgdf3cIjSnU/tatjkg== From: George Anthony Vernon To: dmitry.torokhov@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org Cc: George Anthony Vernon , bagasdotme@gmail.com, linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kernel-mentees@lists.linux.dev Subject: [PATCH v2 1/4] input: docs: Fix broken table formatting Date: Mon, 26 May 2025 14:59:49 +0100 Message-ID: <20250526135957.180254-2-contact@gvernon.com> In-Reply-To: <20250526135957.180254-1-contact@gvernon.com> References: <20250526135957.180254-1-contact@gvernon.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Migadu-Flow: FLOW_OUT Content-Type: text/plain; charset="utf-8" Missing '+' led to unintended spanning cell. Correct this. Signed-off-by: George Anthony Vernon Reviewed-by: Bagas Sanjaya --- Documentation/input/devices/amijoy.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/input/devices/amijoy.rst b/Documentation/input/d= evices/amijoy.rst index 8df7b11cd98d..f854ee975247 100644 --- a/Documentation/input/devices/amijoy.rst +++ b/Documentation/input/devices/amijoy.rst @@ -123,7 +123,7 @@ JOY1DAT Y7 Y6 Y5 Y4 Y3 Y2 Y1 Y0 X7 X6 X5= X4 X3 X2 X1 X0 clocked by 2 of the signals input from the mouse serial stream. Starting with first bit received: =20 - +-------------------+-----------------------------------------+ + +--------+----------+-----------------------------------------+ | Serial | Bit Name | Description | +=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+ | 0 | M0H | JOY0DAT Horizontal Clock | --=20 2.49.0 From nobody Sun Feb 8 19:11:20 2026 Received: from out-181.mta0.migadu.com (out-181.mta0.migadu.com [91.218.175.181]) (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 7539C20E023 for ; Mon, 26 May 2025 14:00:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.181 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268046; cv=none; b=JxtEhZfAJIhp6Zjtm4kFIR+n9QLIR5F2dez5DP8d7ymypbYCEojd04Sa4C19PVLQDLTrRBI+dPLG8vhMjhyHFWQ229Az+BDqxGcBG5MkdhHK4I7QCbj35tWjDHXRfr7dkU3f0gWFe0upRDyeNUgDRgNtdL7V1HsuFgitzVzuyc0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268046; c=relaxed/simple; bh=FH+XuZiqedmmbcdx7+ns4Iwr/ePiNYP4RtSE8O61uKE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=SIVo+bzHquRq3FXS1176CmeGWu3lMZ2GP5rtwbwf0ULsbDPxn8H4CC0154ReVUkeov0QVDMb3QJ/WE5SwqgbRN4xcemEXKa82lFm5MloXRIargyUZe8Wzl5GjsD/K3pTKsjxtQrqNCk1+te5M3qBVJzUcxPV0FgOct2Zzp5ABUY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com; spf=pass smtp.mailfrom=gvernon.com; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b=IO0v+y9O; arc=none smtp.client-ip=91.218.175.181 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gvernon.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b="IO0v+y9O" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gvernon.com; s=key1; t=1748268042; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=cQmxapCCbfWgqmAUgREJ3k7qr9htA9/0TELdt2lF078=; b=IO0v+y9ORD++Xj+HZ0d83rIbOOYxxbyWn5y41u4CBYYtsHz23NppYLIuqwyUI8TPx2q1p7 4Ud2iHjgwFsuifJLognJK9Vdl7CqX3m/uj1Q7p+Xobw+rN4iapfZd3HBM0ikVbPsFUuYyn 6iqDHUhtAT4nr/maXdZFe4iBp0SC+4YqchtfukKNvHAvO4ne/LH2jWEuoLqrtCEscokYMa F4r00x+0N9+/eNoQPa/ZKvM4NDxeyamT5qif7+CYl72zfQJ6rtDxGHaiMNK+xsxFEpSUHb zxrnsA767jKR4tUGTp6ex7rRsFqFBidIRLoQFueag1NsbsipHUyQrpeNhd3tGg== From: George Anthony Vernon To: dmitry.torokhov@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org Cc: George Anthony Vernon , bagasdotme@gmail.com, linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kernel-mentees@lists.linux.dev Subject: [PATCH v2 2/4] input: docs: Correct Amiga 4-jstick adapter pinout Date: Mon, 26 May 2025 14:59:50 +0100 Message-ID: <20250526135957.180254-3-contact@gvernon.com> In-Reply-To: <20250526135957.180254-1-contact@gvernon.com> References: <20250526135957.180254-1-contact@gvernon.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Migadu-Flow: FLOW_OUT Content-Type: text/plain; charset="utf-8" Pinout incorrectly duplicated pin 18, correct this. Signed-off-by: George Anthony Vernon --- Documentation/input/devices/amijoy.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/input/devices/amijoy.rst b/Documentation/input/d= evices/amijoy.rst index f854ee975247..ea4de1ac0360 100644 --- a/Documentation/input/devices/amijoy.rst +++ b/Documentation/input/devices/amijoy.rst @@ -17,7 +17,7 @@ Pin Meaning Pin Meaning 4 Left1 8 Left2 5 Right1 9 Right2 13 Fire1 11 Fire2 -18 Gnd1 18 Gnd2 +19 Gnd1 18 Gnd2 =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 =20 Amiga digital joystick pinout --=20 2.49.0 From nobody Sun Feb 8 19:11:20 2026 Received: from out-186.mta0.migadu.com (out-186.mta0.migadu.com [91.218.175.186]) (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 D18DF13C82E; Mon, 26 May 2025 14:00:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.186 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268057; cv=none; b=O72JJWNI6Q2wlF0y+Ol4oEs18W7veufz747MZ9rMBhSr2XItfJyBeq21QHDkCwuD5ZHduNwzB1k/axXw6k8K+E4O34ygAYYu3EckHj+k0kW6DnCbHVqAQJIXr2aqq2kfS4PX31rDjovBcLxWsMDFyJIpvAB0SzWj7pu5RCyYUtk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268057; c=relaxed/simple; bh=wfA0OXfCddUpAyBQw3yxP6zgf6FNxqwcaPO4EqrHQBE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=H7O9gDx0fr/T8rSb0sZo591SQFcTVklz5GdrSxk96gNH68fCTjeN85u2f40rZubIlZaO78IxJ2BaibwTK6oMHy3mLgISjeJOjqFCFliZTYATDNzWqE4oU8n/H/1HDUtl4JAvj0g3LS+RX548IjSyBMvfD89KgeAnKq5pS6bojIE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com; spf=pass smtp.mailfrom=gvernon.com; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b=ERuRzYax; arc=none smtp.client-ip=91.218.175.186 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gvernon.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b="ERuRzYax" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gvernon.com; s=key1; t=1748268053; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=NmM4W7gNtdHHgIXWDPAIbmT8q++dEuBoXaCFg+z7w+A=; b=ERuRzYaxXLHaFmcpUHLNT1LQySJUhyBsdONlEV42p2QyTCB6M9J7ruiS6IkCuxVMSKVDiS wpFrdcUCDYRabeofqjnM+23P3+CUY1pODhzHHNDUxXmE/+dPZioz1weY3KH5gWNX/gDUpJ PhD86ZOTJcLa5/24PgV/nw0ZvnGARdFLOw+eVcPg4i3luOCu5lVVFXvBx4Dl4muJS0s3R9 wwqW1lc9O6dWBpUG/2S6Hn5greW8DVeIyx/VJ4E9gY4UQPWwAWmWvl0DLnrkVG2QAcXJmR /RloKenqCaYNwOPRa9FNNZzXwo6LSizrhmEMdAuQb3wUKHVFdLb7j+ZcYSr7LA== From: George Anthony Vernon To: dmitry.torokhov@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org Cc: George Anthony Vernon , bagasdotme@gmail.com, linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kernel-mentees@lists.linux.dev Subject: [PATCH v2 3/4] input: docs: Fix Amiga joysticks grammar Date: Mon, 26 May 2025 14:59:51 +0100 Message-ID: <20250526135957.180254-4-contact@gvernon.com> In-Reply-To: <20250526135957.180254-1-contact@gvernon.com> References: <20250526135957.180254-1-contact@gvernon.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Migadu-Flow: FLOW_OUT Content-Type: text/plain; charset="utf-8" Make small grammar fixes to Amiga joystick documentation. Signed-off-by: George Anthony Vernon Reviewed-by: Bagas Sanjaya --- Documentation/input/devices/amijoy.rst | 85 +++++++++++++------------- 1 file changed, 42 insertions(+), 43 deletions(-) diff --git a/Documentation/input/devices/amijoy.rst b/Documentation/input/d= evices/amijoy.rst index ea4de1ac0360..cbc5240f8af3 100644 --- a/Documentation/input/devices/amijoy.rst +++ b/Documentation/input/devices/amijoy.rst @@ -1,14 +1,13 @@ -~~~~~~~~~~~~~~~~~~~~~~~~~ -Amiga joystick extensions -~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~ +Amiga joysticks +~~~~~~~~~~~~~~~ =20 =20 -Amiga 4-joystick parport extension -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Amiga 4-joystick parallel port extension +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 Parallel port pins: =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 Pin Meaning Pin Meaning =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 @@ -90,17 +89,17 @@ Pin Meaning =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=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=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D NAME rev ADDR type chip Description -=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=3D=3D=3D=3D -JOY0DAT 00A R Denise Joystick-mouse 0 data (left vert, horiz) -JOY1DAT 00C R Denise Joystick-mouse 1 data (right vert,horiz) -=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=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=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +JOY0DAT 00A R Denise Joystick-mouse 0 data (left vert., horiz.) +JOY1DAT 00C R Denise Joystick-mouse 1 data (right vert., horiz.) +=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=3D=3D=3D=3D=3D=3D=3D =20 These addresses each read a 16 bit register. These in turn are loaded from the MDAT serial stream and are clocked in on the rising edge of SCLK. MLD output is used to parallel load - the external parallel-to-serial converter.This in turn is + the external parallel-to-serial converter. This in turn is loaded with the 4 quadrature inputs from each of two game controller ports (8 total) plus 8 miscellaneous control bits which are new for LISA and can be read in upper 8 bits of @@ -108,7 +107,7 @@ JOY1DAT 00C R Denise Joystick-mouse 1 data (ri= ght vert,horiz) =20 Register bits are as follows: =20 - - Mouse counter usage (pins 1,3 =3DYclock, pins 2,4 =3DXclock) + - Mouse counter usage (pins 1,3 =3DYclock, pins 2,4 =3DXclock) =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 BIT# 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 @@ -179,12 +178,12 @@ JOYTEST 036 W Denise Write to all 4 joyst= ick-mouse counters at once. =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=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=3D=3D=3D=3D=3D=3D=3D=3D=3D NAME rev ADDR type chip Description -=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=3D=3D=3D -POT0DAT h 012 R Paula Pot counter data left pair (vert, horiz) -POT1DAT h 014 R Paula Pot counter data right pair (vert,horiz) -=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=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=3D=3D=3D=3D=3D=3D=3D=3D=3D +POT0DAT h 012 R Paula Pot counter data left pair (vert., horiz.) +POT1DAT h 014 R Paula Pot counter data right pair (vert., horiz.) +=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=3D=3D=3D=3D=3D=3D =20 These addresses each read a pair of 8 bit pot counters. (4 counters total). The bit assignment for both @@ -213,8 +212,8 @@ POT1DAT h 014 R Paula Pot counter data right pai= r (vert,horiz) +-------+------+-----+-----+-------+ =20 With normal (NTSC or PAL) horiz. line rate, the pots will - give a full scale (FF) reading with about 500kohms in one - frame time. With proportionally faster horiz line times, + give a full scale (FF) reading with about 500k ohm in one + frame time. With proportionally faster horiz. line times, the counters will count proportionally faster. This should be noted when doing variable beam displays. =20 @@ -238,26 +237,26 @@ POTINP 016 R Paula Pot pin data read This register controls a 4 bit bi-direction I/O port that shares the same 4 pins as the 4 pot counters above. =20 - +-------+----------+---------------------------------------------+ - | BIT# | FUNCTION | DESCRIPTION | - +=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=3D+ - | 15 | OUTRY | Output enable for Paula pin 33 | - +-------+----------+---------------------------------------------+ - | 14 | DATRY | I/O data Paula pin 33 | - +-------+----------+---------------------------------------------+ - | 13 | OUTRX | Output enable for Paula pin 32 | - +-------+----------+---------------------------------------------+ - | 12 | DATRX | I/O data Paula pin 32 | - +-------+----------+---------------------------------------------+ - | 11 | OUTLY | Out put enable for Paula pin 36 | - +-------+----------+---------------------------------------------+ - | 10 | DATLY | I/O data Paula pin 36 | - +-------+----------+---------------------------------------------+ - | 09 | OUTLX | Output enable for Paula pin 35 | - +-------+----------+---------------------------------------------+ - | 08 | DATLX | I/O data Paula pin 35 | - +-------+----------+---------------------------------------------+ - | 07-01 | X | Not used | - +-------+----------+---------------------------------------------+ - | 00 | START | Start pots (dump capacitors,start counters) | - +-------+----------+---------------------------------------------+ + +-------+----------+---------------------------------------------= -+ + | BIT# | FUNCTION | DESCRIPTION = | + +=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=3D=3D+ + | 15 | OUTRY | Output enable for Paula pin 33 = | + +-------+----------+---------------------------------------------= -+ + | 14 | DATRY | I/O data Paula pin 33 = | + +-------+----------+---------------------------------------------= -+ + | 13 | OUTRX | Output enable for Paula pin 32 = | + +-------+----------+---------------------------------------------= -+ + | 12 | DATRX | I/O data Paula pin 32 = | + +-------+----------+---------------------------------------------= -+ + | 11 | OUTLY | Out put enable for Paula pin 36 = | + +-------+----------+---------------------------------------------= -+ + | 10 | DATLY | I/O data Paula pin 36 = | + +-------+----------+---------------------------------------------= -+ + | 09 | OUTLX | Output enable for Paula pin 35 = | + +-------+----------+---------------------------------------------= -+ + | 08 | DATLX | I/O data Paula pin 35 = | + +-------+----------+---------------------------------------------= -+ + | 07-01 | X | Not used = | + +-------+----------+---------------------------------------------= -+ + | 00 | START | Start pots (dump capacitors, start counters)= | + +-------+----------+---------------------------------------------= -+ --=20 2.49.0 From nobody Sun Feb 8 19:11:20 2026 Received: from out-189.mta0.migadu.com (out-189.mta0.migadu.com [91.218.175.189]) (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 491241F4CA9 for ; Mon, 26 May 2025 14:00:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.189 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268060; cv=none; b=puNzNl/stmJ9vG4XwZRSTedAyFEegNx7XvU6Iknb3c2SJiPPdYzZuKa6mJqTc2w5A7wv005oopKxUghhWjLC8tmMtQrGHppZQEWUthXY55a1Fabd40BbR1/HfQKrVlL4CWagtgBmzXk+Z+wjiySYVCh3/pFfSDCV8YM6OlrZPEg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268060; c=relaxed/simple; bh=nMyPEDnf/zkddzZ2Cw4741aAO+yU0d/61z+A8WlOS94=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=b6px2+a/YTZnGQGATn7f3mDvvED121zeaETn/LNpuBs9GT/EZcBOHtBlDymDkOmsQN87EU53AXar047e40tuEpViKUkq8navklUtyFZsiZDUWOA76LWU9OYzdGkvLWnjqcYba6D601KWCFththSP6Ai4UN4aVm9qEbguX6Vtpvk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com; spf=pass smtp.mailfrom=gvernon.com; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b=FBLIAQVM; arc=none smtp.client-ip=91.218.175.189 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gvernon.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b="FBLIAQVM" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gvernon.com; s=key1; t=1748268056; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=V6dGYyUwgVkfLIw2/DVw8Hb9GNF0VcyeeqTRDuJIL/A=; b=FBLIAQVMmdfIUncAJN6oqa+PKQUXox17Sv8De+wBqYNWky7H0t30it9SRYSgQ1JOmYz7Ey AXDSbnfDLv3hzEGyKbgIBfrrYUu/azuKE+gSYdPamgrSL4O5rX0Mht4E3D1URBTZfesCsG 59DWMnU7iTfXY8dA8jI2SbqwIiNQ/Q2DIL6vuO6q7LjDFzr+FQ2G8c9FKrY+OpQ+76LSiH mKyReVAEgCccBBTUsWezHYP2LXwo4nbhVKbbAgLYifOAGZ387j/WZRqpdQ5GPE+okuuNYt cPLakPex6754Op1M2Zc/TbFyNxLUnnagCiy+xpMVLkKYYSMtg+kqkQZx8eOJNg== From: George Anthony Vernon To: dmitry.torokhov@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org Cc: George Anthony Vernon , bagasdotme@gmail.com, linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kernel-mentees@lists.linux.dev Subject: [PATCH v2 4/4] input: docs: Make headings compliant w/ guidelines Date: Mon, 26 May 2025 14:59:52 +0100 Message-ID: <20250526135957.180254-5-contact@gvernon.com> In-Reply-To: <20250526135957.180254-1-contact@gvernon.com> References: <20250526135957.180254-1-contact@gvernon.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Migadu-Flow: FLOW_OUT Content-Type: text/plain; charset="utf-8" Make heading adornments compliant with the guidelines to improve organisation of the page. Signed-off-by: George Anthony Vernon Reviewed-by: Bagas Sanjaya --- Documentation/input/devices/amijoy.rst | 42 ++++++++++++++++---------- 1 file changed, 26 insertions(+), 16 deletions(-) diff --git a/Documentation/input/devices/amijoy.rst b/Documentation/input/d= evices/amijoy.rst index cbc5240f8af3..a81e9de481c7 100644 --- a/Documentation/input/devices/amijoy.rst +++ b/Documentation/input/devices/amijoy.rst @@ -1,10 +1,12 @@ -~~~~~~~~~~~~~~~ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Amiga joysticks -~~~~~~~~~~~~~~~ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 +Pinouts +=3D=3D=3D=3D=3D=3D=3D =20 Amiga 4-joystick parallel port extension -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +---------------------------------------- =20 Parallel port pins: =20 @@ -19,8 +21,8 @@ Pin Meaning Pin Meaning 19 Gnd1 18 Gnd2 =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 =20 -Amiga digital joystick pinout -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Amiga digital joystick +---------------------- =20 =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Pin Meaning @@ -36,8 +38,8 @@ Pin Meaning 9 Thumb button =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -Amiga mouse pinout -~~~~~~~~~~~~~~~~~~ +Amiga mouse +----------- =20 =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Pin Meaning @@ -53,8 +55,8 @@ Pin Meaning 9 Right button =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -Amiga analog joystick pinout -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Amiga analog joystick +--------------------- =20 =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Pin Meaning @@ -70,8 +72,8 @@ Pin Meaning 9 Analog Y =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -Amiga lightpen pinout -~~~~~~~~~~~~~~~~~~~~~ +Amiga lightpen +-------------- =20 =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Pin Meaning @@ -87,7 +89,11 @@ Pin Meaning 9 Stylus button =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 ---------------------------------------------------------------------------= ----- +Register addresses +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +JOY0DAT/JOY1DAT +--------------- =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=3D=3D=3D=3D=3D=3D=3D NAME rev ADDR type chip Description @@ -159,7 +165,8 @@ JOY1DAT Y7 Y6 Y5 Y4 Y3 Y2 Y1 Y0 X7 X6 X5= X4 X3 X2 X1 X0 | Right | 4 | X1 | +------------+------+---------------------------------+ =20 ---------------------------------------------------------------------------= ----- +JOYTEST +------- =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=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D NAME rev ADDR type chip Description @@ -176,7 +183,8 @@ JOYTEST 036 W Denise Write to all 4 joystic= k-mouse counters at once. JOYxDAT Y7 Y6 Y5 Y4 Y3 Y2 xx xx X7 X6 X5 X4 X3 X2 xx = xx =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 =20 ---------------------------------------------------------------------------= ----- +POT0DAT/POT1DAT +--------------- =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=3D=3D=3D=3D=3D=3D NAME rev ADDR type chip Description @@ -217,7 +225,8 @@ POT1DAT h 014 R Paula Pot counter data right pai= r (vert., horiz.) the counters will count proportionally faster. This should be noted when doing variable beam displays. =20 ---------------------------------------------------------------------------= ----- +POTGO +----- =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=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D NAME rev ADDR type chip Description @@ -226,7 +235,8 @@ POTGO 034 W Paula Pot port (4 bit) bi-directi= on and data, and pot counter start. =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=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 ---------------------------------------------------------------------------= ----- +POTINP +------ =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=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D NAME rev ADDR type chip Description --=20 2.49.0