From c52d28c33c4a4c16ffdf64ead586c3ba5c7ad444 Mon Sep 17 00:00:00 2001
From: Vhati <tvtronix@yahoo.com>
Date: Mon, 11 Dec 2017 20:52:50 -0500
Subject: [PATCH] Revised readmes

---
 README.md                         |  2 +-
 skel_common/readme_modders.txt    | 12 +++++++++---
 skel_unix/readme_for_unixlike.txt | 27 +++++++++++++++++----------
 skel_win/readme_for_windows.txt   | 27 +++++++++++++++++----------
 4 files changed, 44 insertions(+), 24 deletions(-)

diff --git a/README.md b/README.md
index 752920f..3906100 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ Requirements
 ------------
 * Java (1.6 or higher).
     * http://www.java.com/en/download/
-* FTL (1.01-1.5.13, Windows/OSX/Linux, Steam/GOG/Standalone).
+* FTL (1.01-1.6.2, Windows/OSX/Linux, Steam/GOG/Standalone).
     * http://www.ftlgame.com/
 * WinXP SP1 can't run Java 1.7.
     * (1.7 was built with VisualStudio 2010, causing a DecodePointer error.)
diff --git a/skel_common/readme_modders.txt b/skel_common/readme_modders.txt
index d8ca824..4b51488 100644
--- a/skel_common/readme_modders.txt
+++ b/skel_common/readme_modders.txt
@@ -55,9 +55,7 @@ General
   accepts the unix style (LF): fine for xml, crashing for layout.txt.
   Slipstream will convert both to CR-LF as it patches.
 
-  File and directory names must be plain ASCII (no accents). That
-  restriction isn't confirmed for the game, but the mod manager enforces
-  it just to be safe.
+  File and directory names must be plain ASCII (no accents).
 
   Images should be 32bit PNGs (24bit color + 8bit alpha transparency).
   Things that *should* be opaque rectangles like backgrounds may vary,
@@ -108,6 +106,14 @@ Encoding!?
   by including tests to determine when they're dealing with UTF-16 or
   something else.
 
+  Note to translators: Slipstream lets modders encode how they like and
+  converts to whatever FTL wants, but characters are limited by how FTL
+  ultimately reads the text. FTL 1.01-1.5.13 assumes text to be windows-1252
+  (you can only use characters that would be valid in that encoding). Since
+  FTL 1.6.1, it assumes UTF-8 (no worries). After the game has read the text,
+  another issue is whether the fonts contain the glyphs to display the
+  characters. You may need to replace the fonts.
+
 
 Advanced XML
 
diff --git a/skel_unix/readme_for_unixlike.txt b/skel_unix/readme_for_unixlike.txt
index 3916e28..8a1f7a8 100644
--- a/skel_unix/readme_for_unixlike.txt
+++ b/skel_unix/readme_for_unixlike.txt
@@ -84,13 +84,20 @@ Troubleshooting
     See the suggestion below for replacing corrupt resources.
 
 * If FTL's resources are corrupt...
-    Delete the files in SMM/backup/
-    Steam users:
-      Delete FTL's resource directory:
-        Linux: "[~/.local/share or $XDG_DATA_HOME]/Steam/SteamApps/common/FTL Faster Than Light/data/resources"
-        Mac: "~/Library/Application Support/Steam/SteamApps/common/FTL Faster Than Light/FTL.app"
-      Start Steam and "verify game cache".
-        https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335
-      Run FTL, which will cause steam to copy fresh resources from its cache.
-    Standalone users:
-      Reinstall FTL.
+    Option 1:
+      In SMM, Help-DeleteBackups
+      Steam users:
+        In SMM, Help-Steam:VerifyGameCache.
+      Standalone users:
+        Reinstall FTL.
+
+    Option 2:
+      Delete the files in SMM/backup/
+      Steam users:
+        Delete FTL's resource directory:
+          Linux: "[~/.local/share or $XDG_DATA_HOME]/Steam/SteamApps/common/FTL Faster Than Light/data/resources"
+          Mac: "~/Library/Application Support/Steam/SteamApps/common/FTL Faster Than Light/FTL.app"
+        Start Steam and "verify game cache".
+          https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335
+      Standalone users:
+        Reinstall FTL.
diff --git a/skel_win/readme_for_windows.txt b/skel_win/readme_for_windows.txt
index b2297dc..f2a6c01 100644
--- a/skel_win/readme_for_windows.txt
+++ b/skel_win/readme_for_windows.txt
@@ -16,7 +16,7 @@ Requirements
   Java (1.6 or higher).
     http://www.java.com/en/download/
 
-  FTL (1.01-1.5.13, Windows/OSX/Linux, Steam/GOG/Standalone).
+  FTL (1.01-1.6.2, Windows/OSX/Linux, Steam/GOG/Standalone).
     http://www.ftlgame.com/
 
   * WinXP SP1 can't run Java 1.7.
@@ -121,12 +121,19 @@ Troubleshooting
     See the suggestion below for replacing corrupt resources.
 
 * If FTL's resources are corrupt...
-    Delete the files in SMM\backup\
-    Steam users:
-      Delete FTL's resource directory:
-        "C:\Program Files [or (x86)]\Steam\steamapps\common\FTL Faster Than Light\resources"
-      Start Steam and "verify game cache".
-        https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335
-      Run FTL, which will cause steam to copy fresh resources from its cache.
-    Standalone users:
-      Reinstall FTL.
+    Option 1:
+      In SMM, Help-DeleteBackups
+      Steam users:
+        In SMM, Help-Steam:VerifyGameCache.
+      Standalone users:
+        Reinstall FTL.
+
+    Option 2:
+      Delete the files in SMM\backup\
+      Steam users:
+        Delete FTL's resource directory:
+          "C:\Program Files [or (x86)]\Steam\steamapps\common\FTL Faster Than Light\resources"
+        Start Steam and "verify game cache".
+          https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335
+      Standalone users:
+        Reinstall FTL.