From 127e1110488993b0cfdeb3fa98ff4e3915b94ad0 Mon Sep 17 00:00:00 2001
From: xxLnolan <136196109+xxLnolan@users.noreply.github.com>
Date: Thu, 15 Oct 2026 19:08:47 +0200
Subject: [PATCH] test(keycode): cover non-US backslash mapping

---
 core/libs/tests/GuestConvertKeycode.cpp | 4 ++++
 docs/dev/debt/libSceConvertKeycode.md   | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/core/libs/tests/GuestConvertKeycode.cpp b/core/libs/tests/GuestConvertKeycode.cpp
index ec8968222b..7e4b8c1cc4 100644
--- a/core/libs/tests/GuestConvertKeycode.cpp
+++ b/core/libs/tests/GuestConvertKeycode.cpp
@@ -36,6 +36,10 @@ int main() {
         Require(character[0] == u'1');
         Require(sceConvertKeycodeGetCharacter(0x3A, state, 0, character) == 0);
         Require(character[0] == 0);
+        Require(sceConvertKeycodeGetCharacter(0x64, state, 0, character) == 0);
+        Require(character[0] == u'\\');
+        Require(sceConvertKeycodeGetCharacter(0x32, state, 0, character) == 0);
+        Require(character[0] == 0);
     }
     return 0;
 }
diff --git a/docs/dev/debt/libSceConvertKeycode.md b/docs/dev/debt/libSceConvertKeycode.md
index 25d15eaa60..458e175688 100644
--- a/docs/dev/debt/libSceConvertKeycode.md
+++ b/docs/dev/debt/libSceConvertKeycode.md
@@ -2,7 +2,7 @@
 
 ### Unknown function info
 
-- [sceConvertKeycodeGetCharacter](../../../core/libs/prx/libSceConvertKeycode/Export.cpp) (libSceConvertKeycode) - the signature `(uint16_t keycode, uint32_t, uint32_t keyboardType, char16_t* character)` is inferred from PPSA12361, which passes a 16-bit keycode, 0, the type from `sceConvertKeycodeGetImeKeyboardType` and a pointer it reads one UTF-16 unit from when the result is 0. The meaning of the second argument is unknown. PRAGMATA (PPSA02530, #5726) and Onimusha: Way of the Sword (PPSA27836) pass `0x4000000` as a constant: Onimusha calls it for every keycode from 0 to 0x8F to build a table of key names, upper-cases `a` to `z` itself and skips keycodes that fail or return 0, so that bit is ignored and the unshifted character is returned as for 0. Any other bit throws, and so does a keyboard type other than 0.
+- [sceConvertKeycodeGetCharacter](../../../core/libs/prx/libSceConvertKeycode/Export.cpp) (libSceConvertKeycode) - the signature `(uint16_t keycode, uint32_t, uint32_t keyboardType, char16_t* character)` is inferred from PPSA12361, which passes a 16-bit keycode, 0, the type from `sceConvertKeycodeGetImeKeyboardType` and a pointer it reads one UTF-16 unit from when the result is 0. The meaning of the second argument is unknown. PRAGMATA (PPSA02530, #5726) and Onimusha: Way of the Sword (PPSA27836) pass `0x4000000` as a constant: Onimusha calls it for every keycode from 0 to 0x8F to build a table of key names, upper-cases `a` to `z` itself and skips keycodes that fail or return 0, so that bit is ignored and the unshifted character is returned as for 0. Any other bit throws, and so does a keyboard type other than 0. The returned character for HID usage `0x64` has not been measured on a console; `\` is an unverified US-layout guess based on the Windows VK mapping, which does not establish the console result.
 
 ### Functional