From 24065337139c3b0e2e7a2ba17cbe3730f54e325c Mon Sep 17 00:00:00 2001 From: nmlgc Date: Sat, 22 May 2021 16:08:41 +0200 Subject: [PATCH] [Contributing] Officially decide on UTF-8 as the default encoding It's been like this since the beginning, I just hadn't written it down. So yeah, sorry to everyone who likes to edit code in period correct 90's DOS terminal editors. Part of P0141, funded by [Anonymous] and rosenrose. --- CONTRIBUTING.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e74d56ab..8c65ac24 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -50,6 +50,16 @@ These cases should gradually be removed as development goes along, though. ## Compatibility +* Despite the games' native encoding being Shift-JIS, most files should be + encoded in UTF-8, as it's simply more comfortable to work with in modern + tools. The only (necessary) exceptions are + + * the big .ASM dump files in the root directory, + * and any files in the per-game `shiftjis/` subdirectory. All hardcoded + Shift-JIS strings should be put there. With files full of Shift-JIS text, + it's also easier to see when an editor didn't recognize the encoding, + which keeps the annoyance from accidentally destroyed files to a minimum. + * Use `__asm` as the keyword for inline assembly. This form works in Borland C++, Open Watcom, and Visual C++, which will ease future third-party ports.