improve documentation

ChangeLog

@@ -23,9 +23,12 @@ v7.0.0:
   where to store your modified 3DS ROM files
 
 ::documentation
+- update REAMDE
 - update README.RC
 - update README.STATUS_CODES
 - update README.GAMEIDS
+  - now includes game search paths
+  - now includes expected filenames
 
 ::misc. changes
 - show full path for Hans Files for all games, instead of relative

README

@@ -1,47 +1,58 @@
-Based on DMMs and Wiimms excellent work, I've created a flexible
+Based on DMMs and Wiimms excellent work, I've created a flexible patchscript
-patchscript for GNU/Linux. Additionally to riivolution patches, this
+for GNU/Linux. Additionally to applying riivolution patches to Wii games, it
-one will also allow patching ROMs using ips/ppf patches. And more...
+also allows patching 3DS games and Wii U games.
 
-patchimage allows choosing a custom GAMEID, aswell as downloading
+features include:
-riivolution-files, patches and soundtrack (if available).
+ - downloading riivolution files or patches
+ - downloading soundtracks (if available)
+ - downloading custom banners for Wii games (if available)
+ - downloading covers for Wii games (if available)
+ - automatic storing of patched games into desired destination (see README.RC)
+ - automatic patching of Wii games, 3DS games, Wii U games
 
-NOTE: don't fiddle around with sub-folders in riivolution-files, the
+NOTE: don't fiddle around with sub-folders in riivolution-files, the script uses
-script uses files as "unzip" creates them. No need to modify whatever.
+files as "unzip" creates them. No need to modify anything.
 
-... Well, you need the original game to do this legally, if you don't
+You need the original games to do this legally, if you don't own the original,
-own the original, you can't blame me. patchimage is 100% legal, as it
+you can't blame me. patchimage is 100% legal, as it does not contain any
-does not contain any propritary contents, nor is able to grab them.
+propritary contents, nor is able to grab them.
 
-Starting with versions 4.90 and up, patchimage support Mario Kart Wiimm
+patchimage supports the following base games:
-and Wimmfi (custom server for Mario Kart Wii and other games after the
+	* New Super Mario Bros. Wii
-official server's shutdown).
+	* Kirby's Adventure Wii
+	* Mario Kart Wii
+	* Tokyo Mirage Sessions #FE
+	* Pokemon X
+	* Pokemon Y
+	* Pokemon Omega Ruby
+	* Pokemon Alpha Sapphire
+	* Bravely Second
 
 More information:
-	* supported games: 		see file README.GAMEIDS
+	* supported game modifcations, search paths and expecte file names
-	* supported commandline flags:	see file README.CMD_OPTS
+		see README.GAMEIDS
-	* configuration file example:	see file README.RC
+	* supported commandline flags
-	* status code while processing:	see file README.STATUS_CODES
+		see README.CMD_OPTS
-	* exit codes (for debugging):	see file README.EXIT_CODES
+	* configuration file example
+		see README.RC
+	* status code while processing
+		see README.STATUS_CODES
+	* exit codes (for debugging)
+		see README.EXIT_CODES
 
-Default searchpaths:
+Example usages:
 
-    ISO: BASE.iso / BASE.wbfs / GAMEID.iso / GAMEID.wbfs
+	Newer Super Mario Bros Wii
-    Riivolution: Original name of the zip / unpacked folder
+	$ patchimage --game=NewerSMBW --iso=/home/test/SMNP01.iso --download
-    ROM: some mask matching the file (eg: "*[Ll]ink*[Pp]ast*smc" for Zelda: Parallel Worlds)
 
-Example usage:
+	Zelda: Parallel Worlds
+	$ patchimage --game=ParallelWorlds --rom=/home/test/ALTTP.smc --download
 
-NewerSMBW:
+	Toyko Mirage Sessions #FE Restoration
-$ patchimage --game=NewerSMBW --iso=/home/test/SMNP01.iso --download
+	$ patchimage --game=TMSFE --xdelta=/home/test/xdelta/ --cpk=/home/test/ASEP01/content/Pack/
-
-Zelda: Parallel Worlds
-$ patchimage --game=ParallelWorlds --rom=/home/test/ALTTP.smc --download
 
 License: GNU GPLv3
 Extra Licenses:
-
+> applyppf3	as-is
-> wit GNU GPL v2
+> xml patches	as-is
-> szs GNU GPL v2
+> other tools	GNU GPL v2 / GNU GPL v3
-> uips GNU GPL v2
-> applyppf3 as-is
-> xml-patchfiles as-is

README.GAMEIDS

@@ -2,8 +2,19 @@ GAMEIDS
 
 ### New Super Mario Bros. Wii ###
 
+>> searched paths:
+
+a) ${PWD}
+b) ${PATCHIMAGE_WBFS_DIR}
+
+>> expected filenames
+
+a) BASE.iso
+b) BASE.wbfs
+c) SMN?01.iso
+d) SMN?01.wbfs
+
 SLF?01		NSMBW3: The Final Levels
-SMN?01		Original New Super Mario Bros. Wii
 SMN?03		Newer Super Mario Bros. Wii
 SMN?04		Canon Super Mario Bros. Wii
 SMN?05		Another Super Mario Bros. Wii
@@ -32,7 +43,18 @@ MRR?01		New Super Mario Bros. Wii Retro Remix
 
 ### Mario Kart Wii ###
 
-RMC?01		Original Mario Kart Wii
+>> searched paths:
+
+a) ${PWD}
+b) ${PATCHIMAGE_WBFS_DIR}
+
+>> expected filenames
+
+a) BASE.iso
+b) BASE.wbfs
+c) RMC?01.iso
+d) RMC?01.wbfs
+
 RMC?06		Wiimms MKW Fun 2010-12
 RMC?07		Wiimms MKW Retro 2011-02
 RMC?08		Wiimms MKW Fun 2011-03
@@ -63,11 +85,32 @@ RMC?32		Wiimms MKW-Fun 2016-07
 
 ### Kirby's Adventure Wii ###
 
+>> searched paths:
+
+a) ${PWD}
+b) ${PATCHIMAGE_WBFS_DIR}
+
+>> expected filenames
+
+a) BASE.iso
+b) BASE.wbfs
+c) SUK?01.iso
+d) SUK?01.wbfs
+
 SUK?01		Kirby's Adventure Wii
 		* exchange first player's character
 
 ### Pokemon ###
 
+>> searched paths:
+
+a) ${PWD}
+b) ${PATCHIMAGE_3DS_DIR}
+
+>> expected filenames
+
+a) GAMEID.cxi
+
 0004000000055D00	Pokemon X
 			* Pokemon Neo X
 			* Pokemon Eternal X
@@ -83,9 +126,26 @@ SUK?01		Kirby's Adventure Wii
 
 ### Bravely ###
 
+>> searched paths:
+
+a) ${PWD}
+b) ${PATCHIMAGE_3DS_DIR}
+
+>> expected filenames
+
+a) GAMEID.cxi
+
 000400000017BB00	Bravely Second
 			* De-Censoring the game
 
 ### Toyko Mirage Sessions #FE ###
 
+>> searched paths:
+
+none (specified by user)
+
+>> expected filenames
+
+none (specified by user)
+
 ASE?01		De-Censoring the game