Add files via upload

osx-setup.txt

@@ -0,0 +1,21 @@
+
+Setup on OS-X
+
+
+If you have a previous installation of the game on your computer, 
+then delete it by typing something like:
+
+	rm -fr <game-installation-directory>/<game-dir>
+
+This will save space on your computer's disk drive, and will 
+help to avoid confusion.  Each download is self-contained.
+
+Choose an installation directory and move the tarball there;  
+leaving it in ./Downloads is fine.
+
+For *.7z files, you may use Keka or 7zip to unpack the tarred 
+game directory.
+
+For *.gz files, simply gunzip [] followed by tar -xf [].
+
+

sourceCode.txt

@@ -1,42 +1,17 @@
 Where is the Ada source code?
 
 This repository exists for the convenience of gamers, not co-developers.  
-The tarball contains all the source code, as well as the runtime files 
-for 3 platforms, headers, shaders, textures, music, game files, 
-compilation scripts, nonstandard external libraries, and executables, 
-including a Mac-bundle.  Source code can be found in the main directory 
-and the ./adabindings & ./adautils sub-directories.
+The tarball, *.gz or *.7z, contains all the source code, 
+as well as the runtime files for 3 platforms, headers, shaders, textures, 
+music, game files, compilation scripts, nonstandard external libraries, 
+and executables, including a Mac-bundle.  Source code can be found in
+the main directory and the ./adabindings & ./adautils sub-directories.
 
 =====================================================================
-Note for Windows users:
-
-I decided to deliver tarballs because it is the normal way on
-OSX and Linux, and because I tried 4 ways to extract them on
-Windows, all of which worked smoothly:
-.) PeaZip;
-.) WinZip [demo];
-.) 7-Zip;
-.) tar [on recent versions of Windows]
-
-
-I suggest using 7z [from www.7-zip.org] to unzip, 
-and then untar the files <name.tar.gz>:
-
-1) 7z x name.tar.gz [this unzips a tar file]
-
-2) 7z x name.tar [this untars a tar file into a directory]
-
-After step 2 you should have a new directory:
-
-.\name\
-
-that contains the game, source code, etc.
+Windows users, please read windows-setup.txt,
+Mac users, please read osx-setup.txt
 
 ===================================================
-On osx or linux you do the usual:
-
-1) gunzip name.tar.gz
-2) tar -xf name.tar
-
+On linux you may use the file-manager to unpack.
 
 

windows-setup.txt

@@ -11,25 +11,26 @@ This will save space on your computer's disk drive, and will
 help to avoid confusion.
 
 
-Next, move the newest archive, a zip-file or gz-file [from your Downloads directory] to any directory of your choosing:
-move <file-name>.tar.gz <game-installation-directory>
+Next, move the newest archive, a zip/gz/7z file 
+[from your Downloads directory] to any directory of your choosing:
+move <file-name>.extension <game-installation-directory>
 cd <game-installation-directory>
 
 Next, extract the tarball:
 
-A) If you have it, PeaZip seems to work fine.
+A) If you have it, PeaZip seems to work fine for all archive types.
 
 B) If you do not already have an unzip utility, I recommend 
 downloading 7z [from www.7-zip.org].  It's free, and works nicely:
-1) 7z x <file-name>.tar.gz [this unzips a tar file]
-2) 7z x <file-name>.tar    [this creates a new directory]
+1a) 7z x <file-name>.tar.gz [this unzips gz to a tar file]
+1b) 7z x <file-name>.7z [this unzips 7z to a tar file]
+2) 7z x <file-name>.tar    
+	[this creates a new directory, preserving internal structure]
 3) cd <game-dir>
 
-C) Alternatively, if you have a recent version of Windows 10, simply type:
-1) tar -xf <file-name>.tar.gz
-to extract everything into the current directory.  Then:
-2) cd <game-dir>
 
 Attention:
-there may be error messages [about failure to create links] that can be IGNORED.  These linked files are used only on linux or Mac OSX systems.
+if there are error messages [about failure to create links], 
+they can be IGNORED.  These linked files are used only 
+on linux or Mac OSX systems.