Refresh the "game library" documentation.

docs/concepts/game-library.md

@@ -1,29 +1,56 @@
-higan maintains a "game library"
+The game library
-containing all the games you've played.
+is the folder where all the
+[game folders](game-folders.md) go.
+When [icarus](../interface/icarus.md) imports a game,
+it creates or updates
+the corresponding game folder in the game library.
+When you use the console menu items
+in [higan's Library menu](../interface/higan.md#the-library-menu),
+it higan shows you the games for that console
+already in the library.
 
-  - In Windows,
+Inside the game library folder
-    the default location of
+there is a subfolder for each system.
-    the game library is the `Emulation` folder
+Inside each system folder
-    inside your profile folder
+are the game folders
-    (To find your profile folder,
-    press `Win+R` to open the Run dialog,
-    then type `%USERPROFILE%` and press Enter).
-  - In Linux,
-    the default location of
-    the game library is the `Emulation` directory
-    inside your home directory.
-  - On all platforms,
-    the game library location can be configured.
-    See [Moving the Game Library](#moving-the-game-library)
-    below.
-
-Inside the library directory there is a subdirectory for each system,
-and inside each system directory are the game folders
 for each imported game.
 
-For more information about game folders,
+Why a game library?
-see [Why game folders?](#why-game-folders)
+-------------------
-and [What's in a game folder?](#whats-in-a-game-folder)
+
+higan [requires game folders](game-folders.md#why-game-folders),
+but it also invented game folders,
+so existing games need
+to be converted to game folder format
+before higan can play them.
+The converted copy of a game needs to go *somewhere*.
+
+Also,
+for people who have a huge collection of games,
+the game library only lists the games they actually play,
+rather than every possible game,
+making it easier to find the games they like.
+
+
+Where is the game library?
+--------------------------
+
+In Windows,
+the default location of
+the game library is the `Emulation` folder
+inside your profile folder
+(To find your profile folder,
+press `Win+R` to open the Run dialog,
+then type `%USERPROFILE%` and press Enter).
+
+In Linux,
+the default location of
+the game library is the `Emulation` directory
+inside your home directory.
+
+On all platforms,
+the game library location can be configured.
+See [Moving the Game Library](#moving-the-game-library)
 below.
 
 Moving the game library
@@ -39,18 +66,21 @@ and telling higan where to find them.
     as its game library.
  1. Launch icarus,
     then click the "Settings ..." button in the lower-right,
-    to open the Settings dialog.
+    to open
+    [the Settings dialog][icsettings].
  1. Click the "Change ..." button on the right.
-    A [filesystem browser](#the-filesystem-browser) window will appear,
+    A [filesystem browser][fsbrowser] window will appear,
     allowing you to choose
     where imported games will be stored.
  1. Launch higan,
-    then from the Settings menu,
+    then from [the Settings menu][settingsmenu],
-    choose "Configuration ..."
+    choose "Advanced..."
-    to open [the Configuration dialog](#the-configuration-dialog).
+    to open [higan's Advanced settings][advsettings].
- 1. Click the Advanced tab
+ 1. Click the "Change ..." button on the right.
-    then click the "Change ..." button.
+    A [filesystem browser][fsbrowser] will appear,
-    A [filesystem browser](#the-filesystem-browser) will appear,
     allowing you to choose the same directory again.
 
-
+[icsettings]: ../interface/icarus.md#the-icarus-settings-dialog
+[fsbrowser]: ../interface/common.md#the-filesystem-browser
+[settingsmenu]: ../interface/higan.md#the-settings-menu
+[advsettings]: ../interface/higan-config.md#advanced)