docs updates

Author: neogeographica

README.md

@@ -70,7 +70,7 @@ I like to put any Quake map release into its own gamedir, even vanilla bsp-only
 
 > To evangelize briefly: Keeping each release in its own gamedir lets me see at a glance what I've currently installed, makes it obvious which savegames and bits of configuration are relevant to which releases, makes "uninstallation" braindead-simple, and also makes it possible to do some automated installation and launching with a pretty lightweight script.
 
-One consequence is that non-standalone Arcane Dimensions and Copper releases installed this way cannot be launched *unless* you are using a Quake engine like [FTE](http://fte.triptohell.info/), [Quakespasm-Spiked](http://triptohell.info/moodles/qss/), [vkQuake](https://github.com/Novum/vkQuake), [Ironwail](https://github.com/andrei-drexler/ironwail), or [DarkPlaces](https://icculus.org/twilight/darkplaces/) that supports specifying multiple "game" directories to use when loading a mod or maps. See the "Arcane Dimensions and Copper" section of [scripts/README.md](scripts/README.md) for more details.
+One consequence is that non-standalone releases that depend on Arcane Dimensions, Copper, or Alkaline cannot be installed and launched in this way *unless* you are using a Quake engine like [FTE](http://fte.triptohell.info/), [Quakespasm-Spiked](http://triptohell.info/moodles/qss/), [vkQuake](https://github.com/Novum/vkQuake), [Ironwail](https://github.com/andrei-drexler/ironwail), or [DarkPlaces](https://icculus.org/twilight/darkplaces/) that supports specifying multiple "game" directories to use when loading a mod or maps. See the "Arcane Dimensions, Copper, and Alkaline" section of [scripts/README.md](scripts/README.md) for more details.
 
 ## Some assembly required
 

browser_integration/README.md

@@ -4,7 +4,7 @@ These are the files necessary to set up Chrome to auto-install-and-run a Quake m
 
 Because of the limitations on Chrome extensions, we can't quite implement a feature that would do "download this file and then open it with the desired app". What we *can* do is make Chrome put a special file extension ".qz" on the downloaded file, and we can associate ".qz" with our Quake app. Then once the file is downloaded you can click to open it from the Chrome downloads shelf, or even set Chrome to auto-open all ".qz" files when downloaded. This will give you the browser-integration behavior described in the [top-level readme](../README.md).
 
-Keep in mind that for non-standalone Arcane Dimensions and Copper releases, this feature requires a Quake engine like [FTE](http://fte.triptohell.info/), [Quakespasm-Spiked](http://triptohell.info/moodles/qss/), [vkQuake](https://github.com/Novum/vkQuake), [Ironwail](https://github.com/andrei-drexler/ironwail) or [DarkPlaces](https://icculus.org/twilight/darkplaces/) that supports specifying multiple "game" directories to use when loading a mod or maps. (See the "Arcane Dimensions and Copper" section of the [scripts readme](../scripts/README.md) for more details.) If you don't have that capability, and you try to do "Open with Quake" on a browser link to such an AD/Copper release, then after the download you'll get a desktop notification about the error and the gamedir will not be launched.
+Keep in mind that for non-standalone releases that depend on Arcane Dimensions, Copper, or Alkaline, this feature requires a Quake engine like [FTE](http://fte.triptohell.info/), [Quakespasm-Spiked](http://triptohell.info/moodles/qss/), [vkQuake](https://github.com/Novum/vkQuake), [Ironwail](https://github.com/andrei-drexler/ironwail) or [DarkPlaces](https://icculus.org/twilight/darkplaces/) that supports specifying multiple "game" directories to use when loading a mod or maps. (See the "Arcane Dimensions, Copper, and Alkaline" section of the [scripts readme](../scripts/README.md) for more details.) If you don't have that capability, and you try to do "Open with Quake" on a browser link to such an AD/Copper/Alkaline release, then after the download you'll get a desktop notification about the error and the gamedir will not be launched.
 
 # Setup
 

scripts/README.md

@@ -108,21 +108,25 @@ If the script can't figure out which map to load, just use the console as usual
 
 ## Quoth and missionpacks
 
-If the gamedir contains a document that mentions a dependency on quoth, hipnotic, or rogue, then "quakelaunch" will honor that dependency when launching it... unless the gamedir appears to be "standalone" i.e. comes with its own progs.dat.
+If a gamedir does not come with its own progs.dat (game logic), then it might depend on assets that need to be loaded from some other gamedir (a "base" gamedir). "quakelaunch" will do its best to figure out whether such a dependency exists.
+
+For example, if the files in the archive were originally organized so that Quake-specific folders like "maps" were inside a folder named "quoth", "hipnotic", or "rogue", then quakelaunch will assume that this release has a dependency on Quoth, missionpack 1, or missionpack 2 respectively.
+
+If the folder organization didn't reveal any dependency -- or if this is a first-time launch of a gamedir that was not unpacked and installed by "quakelaunch" itself -- then "quakelaunch" will also check to see if the gamedir contains a document that mentions quoth, hipnotic, or rogue.
 
 An attempt to launch a gamedir with such a dependency will stop with an error if the necessary base gamedir is not present.
 
-## Arcane Dimensions and Copper
+## Arcane Dimensions, Copper, and Alkaline
 
-"quakelaunch" will similarly look in docs for mentions of Copper (unless the gamedir is standalone). If it finds such a mention, that will be interpreted as a dependency on that mod.
+"quakelaunch" will similarly look for dependencies on Arcane Dimensions, Copper, and Alkaline. As with the Quoth/missionpacks stuff described above, if the "maps" etc. folders were originally contained in a folder named "ad", "copper", or "alkaline" then that will signal a dependency.
 
-For Arcane Dimensions, instead of examining the docs it will look to see if there is a bsp filename that starts with the "ad_" prefix... that turns out to be a 100% reliable indicator (so far) of a dependency on AD.
+If necessary "quakelaunch" will also look in docs for mentions of Copper or Alkaline. For Arcane Dimensions, instead of examining the docs it will look to see if there is a bsp filename that starts with the "ad_" prefix... that turns out to be an almost completely reliable indicator (so far) of a dependency on AD.
 
-Unlike the situation with Quoth and missionpack dependencies however, not all Quake engines can handle launching non-standalone AD/Copper-dependent content that is installed in its own separate gamedir. If you have a Quake engine that can do it, you can set the relevant options in your "quakelaunch.conf" file. I do know that recent releases of [FTE](http://fte.triptohell.info/), [Quakespasm-Spiked](http://triptohell.info/moodles/qss/), [vkQuake](https://github.com/Novum/vkQuake), [Ironwail](https://github.com/andrei-drexler/ironwail), and [DarkPlaces](https://icculus.org/twilight/darkplaces/) can do it, and I've included examples in the conf file that work with those engines.
+Unlike the situation with Quoth and missionpack dependencies however, not all Quake engines can handle launching non-standalone AD/Copper/Alkaline-dependent content that is installed in its own separate gamedir. If you have a Quake engine that can do it, you can set the relevant options in your "quakelaunch.conf" file. I do know that recent releases of [FTE](http://fte.triptohell.info/), [Quakespasm-Spiked](http://triptohell.info/moodles/qss/), [vkQuake](https://github.com/Novum/vkQuake), [Ironwail](https://github.com/andrei-drexler/ironwail), and [DarkPlaces](https://icculus.org/twilight/darkplaces/) can do it, and I've included examples in the conf file that work with those engines.
 
 (BTW if you are making your own build of Quakespasm, [multigame-support.md](multigame-support.md) describes how you can add this capability to Quakespasm.)
 
-If you try to launch a non-standalone gamedir that depends on AD or Copper, and you are **not** set up in quakelaunch.conf to handle AD/Copper as a base gamedir, you'll get an error message and the gamedir will not be launched. You can override this behavior if you want, by editing the per-gamedir config (see below).
+If you try to launch a non-standalone gamedir that depends on AD/Copper/Alkaline, and you are **not** set up in quakelaunch.conf to handle AD/Copper/Alkaline as a base gamedir, you'll get an error message and the gamedir will not be launched. You can override this behavior if you want, by editing the per-gamedir config (see below).
 
 ## Per-gamedir configs
 

scripts/multigame-support.md

@@ -4,7 +4,7 @@ This may be interesting to you if you are compiling your own build of Quakespasm
 
 ## What's the problem?
 
-As mentioned in the [readme](README.md), it's handy to have "multiple gamedir" support in Quake. That allows you to easily work with foundational mods like Arcane Dimensions and Copper which have additional map releases based on them. You can keep those "other releases" in their own separate gamedirs and just instruct Quake to use the foundational mod as a base gamedir to build on top of.
+As mentioned in the [readme](README.md), it's handy to have "multiple gamedir" support in Quake. That allows you to easily work with foundational mods like Arcane Dimensions, Copper, and Alkaline which can have additional map releases based on them. You can keep those "other releases" in their own separate gamedirs and just instruct Quake to use the foundational mod as a base gamedir to build on top of.
 
 Any modern Quake engine that is meant for singleplayer will support this nice behavior for Quoth. You can just give it the "-quoth" argument to indicate that a gamedir depends on Quoth. For example if you have a gamedir named "ne_tower" that depends on your "quoth" gamedir as a foundation, you can launch Quake with the arguments "-quoth -game ne_tower".
 
@@ -16,7 +16,7 @@ Happily a couple of other engines have also taken this feature onboard in recent
 
 If you're using a Quake engine that supports this feature, you can specify the "ad_basegame_args" and "copper_basegame_args" values in quakelaunch.conf to handle automatic installation of releases that depend on Arcane Dimensions or Copper.
 
-If you're using a Quake engine that does **not** support this feature, you have to manually do file-merges of AD or Copper releases into the main AD or Copper directory.
+If you're using a Quake engine that does **not** support this feature, you have to manually do file-merges of AD/Copper/Alkaline-based releases into the main AD/Copper/Alkaline directory.
 
 ## What's the solution?