Docs: update (#2341)

Author: emmercm

docs/dats/dir2dat.md

@@ -10,6 +10,12 @@ The `dir2dat` command creates a [Logiqx XML](http://www.logiqx.com/DatFAQs/) DAT
 
 Example usage:
 
+=== ":fontawesome-brands-windows: Windows"
+
+=== ":fontawesome-brands-apple: macOS"
+
+=== ":simple-linux: Linux"
+
 ```shell
 igir dir2dat --input <path|glob> [--input <path|glob>..]
 ```

docs/dats/introduction.md

@@ -17,12 +17,12 @@ See the [DAT scanning page](scanning.md) for details about how to supply DATs to
 A number of different release groups maintain sets of DATs, the most popular are:
 
 - [No-Intro](https://datomatic.no-intro.org/index.php?page=download&s=64&op=daily) (cartridge-based consoles)
-- [Redump](http://redump.org/downloads/) (optical media-based consoles)
+- [Redump](https://redump.info/downloads) (optical media-based consoles)
+- [The Old School Emulation Center (TOSEC)](https://www.tosecdev.org/downloads/category/22-datfiles)
 - [MAME](https://www.mamedev.org/release.html) (official "full driver" MAME ListXML)
 
 And some less popular release groups are:
 
-- [The Old School Emulation Center (TOSEC)](https://www.tosecdev.org/downloads/category/22-datfiles)
 - [GoodTools](https://github.com/Eggmansworld/Datfiles/releases/tag/goodtools) (home computers, gen 1-5 consoles)
 - [libretro (RetroArch)](https://www.libretro.com/):
   - [Custom DATs](https://github.com/libretro/libretro-database/tree/master/dat) (specific games, some optical media-based consoles)

docs/dats/processing.md

@@ -29,6 +29,40 @@ Headerless|Encrypted
 
     `--dat-name-regex-exclude <pattern|filename>` is particularly helpful for excluding some No-Intro DATs versions such as "encrypted" and "headerless".
 
+!!! example
+
+    Processing a directory of No-Intro DATs while excluding the "headerless" and "encrypted" variants:
+
+    === ":fontawesome-brands-windows: Windows"
+
+        ```batch
+        igir copy ^
+          --dat "No-Intro*.zip" ^
+          --dat-name-regex-exclude "/headerless|encrypted/i" ^
+          --input ROMs ^
+          --output ROMs-Sorted
+        ```
+
+    === ":fontawesome-brands-apple: macOS"
+
+        ```shell
+        igir copy \
+          --dat "No-Intro*.zip" \
+          --dat-name-regex-exclude "/headerless|encrypted/i" \
+          --input ROMs \
+          --output ROMs-Sorted
+        ```
+
+    === ":simple-linux: Linux"
+
+        ```shell
+        igir copy \
+          --dat "No-Intro*.zip" \
+          --dat-name-regex-exclude "/headerless|encrypted/i" \
+          --input ROMs \
+          --output ROMs-Sorted
+        ```
+
 ### DAT description regex filtering
 
 ```text
@@ -47,9 +81,42 @@ The `--dat-combine` option lets you combine every game from every parsed DAT int
 
 This may be desirable when creating a [dir2dat](dir2dat.md), a [fixdat](fixdats.md), or other complicated situations.
 
-!!! note
-
-    You may want to use [`--allow-incomplete-sets`](../roms/sets.md#allowing-inexact-sets) when combining DATs.
+!!! example
+
+    TOSEC separates DATs by region, so combining all regions for one console into one DAT may be desirable:
+
+    === ":fontawesome-brands-windows: Windows"
+
+        ```batch
+        igir copy ^
+          --dat "TOSEC*.zip" ^
+          --dat-name-regex "/Dreamcast/i" ^
+          --dat-combine ^
+          --input ROMs ^
+          --output ROMs-Dreamcast
+        ```
+
+    === ":fontawesome-brands-apple: macOS"
+
+        ```shell
+        igir copy \
+          --dat "TOSEC*.zip" \
+          --dat-name-regex "/Dreamcast/i" \
+          --dat-combine \
+          --input ROMs \
+          --output ROMs-Dreamcast
+        ```
+
+    === ":simple-linux: Linux"
+
+        ```shell
+        igir copy \
+          --dat "TOSEC*.zip" \
+          --dat-name-regex "/Dreamcast/i" \
+          --dat-combine \
+          --input ROMs \
+          --output ROMs-Dreamcast
+        ```
 
 !!! note
 

docs/dats/scanning.md

@@ -55,34 +55,69 @@ There have been many DAT-like formats developed over the years. Igir supports th
 
 ## DAT URLs
 
-The `--dat <path|glob|url>` option is unique in that it can download files from URLs, which can be helpful with files that keep a consistent URL but update on a regular basis. For example:
+The `--dat <path|glob|url>` option is unique in that it can download files from URLs, which can be helpful with files that keep a consistent URL but update on a regular basis.
 
-=== ":fontawesome-brands-windows: Windows"
+!!! example
 
-    ```batch
-    igir copy ^
-      --dat "https://raw.githubusercontent.com/libretro/libretro-database/master/dat/DOOM.dat" ^
-      --input ROMs ^
-      --output ROMs-Sorted
-    ```
+    Copying only the BIOS ROMs from your collection, naming them what [RetroArch](../usage/desktop/retroarch.md) expects:
 
-=== ":fontawesome-brands-apple: macOS"
+    === ":fontawesome-brands-windows: Windows"
 
-    ```shell
-    igir copy \
-      --dat "https://raw.githubusercontent.com/libretro/libretro-database/master/dat/DOOM.dat" \
-      --input ROMs \
-      --output ROMs-Sorted
-    ```
+        ```batch
+        igir copy ^
+          --dat "https://raw.githubusercontent.com/libretro/libretro-database/master/dat/System.dat" ^
+          --input ROMs ^
+          --output RetroArch-BIOS
+        ```
 
-=== ":simple-linux: Linux"
+    === ":fontawesome-brands-apple: macOS"
 
-    ```shell
-    igir copy \
-      --dat "https://raw.githubusercontent.com/libretro/libretro-database/master/dat/DOOM.dat" \
-      --input ROMs \
-      --output ROMs-Sorted
-    ```
+        ```shell
+        igir copy \
+          --dat "https://raw.githubusercontent.com/libretro/libretro-database/master/dat/System.dat" \
+          --input ROMs \
+          --output RetroArch-BIOS
+        ```
+
+    === ":simple-linux: Linux"
+
+        ```shell
+        igir copy \
+          --dat "https://raw.githubusercontent.com/libretro/libretro-database/master/dat/System.dat" \
+          --input ROMs \
+          --output RetroArch-BIOS
+        ```
+
+!!! example
+
+    Copying Nintendo Entertainment System ROMs, naming them in a way that is easy to browse from an [EverDrive](../usage/hardware/everdrive.md):
+
+    === ":fontawesome-brands-windows: Windows"
+
+        ```batch
+        igir copy ^
+          --dat "https://raw.githubusercontent.com/frederic-mahe/Hardware-Target-Game-Database/refs/heads/master/EverDrive%20Pack%20SMDBs/NES2.0%20SMDB.txt" ^
+          --input ROMs ^
+          --output EverDrive-NES
+        ```
+
+    === ":fontawesome-brands-apple: macOS"
+
+        ```shell
+        igir copy \
+          --dat "https://raw.githubusercontent.com/frederic-mahe/Hardware-Target-Game-Database/refs/heads/master/EverDrive%20Pack%20SMDBs/NES2.0%20SMDB.txt" \
+          --input ROMs \
+          --output EverDrive-NES
+        ```
+
+    === ":simple-linux: Linux"
+
+        ```shell
+        igir copy \
+          --dat "https://raw.githubusercontent.com/frederic-mahe/Hardware-Target-Game-Database/refs/heads/master/EverDrive%20Pack%20SMDBs/NES2.0%20SMDB.txt" \
+          --input ROMs \
+          --output EverDrive-NES
+        ```
 
 !!! note
 
@@ -97,3 +132,40 @@ You can ignore certain DAT files from being scanned with the option:
 ```
 
 This can help you exclude DATs that you don't want to process to cut down on processing time or to make your resulting collection smaller.
+
+!!! example
+
+    Processing a directory of DATs while excluding any "Beta" and "Demo" DATs:
+
+    === ":fontawesome-brands-windows: Windows"
+
+        ```batch
+        igir copy ^
+          --dat DATs ^
+          --dat-exclude "DATs\*Beta*" ^
+          --dat-exclude "DATs\*Demo*" ^
+          --input ROMs ^
+          --output ROMs-Sorted
+        ```
+
+    === ":fontawesome-brands-apple: macOS"
+
+        ```shell
+        igir copy \
+          --dat DATs \
+          --dat-exclude "DATs/*Beta*" \
+          --dat-exclude "DATs/*Demo*" \
+          --input ROMs \
+          --output ROMs-Sorted
+        ```
+
+    === ":simple-linux: Linux"
+
+        ```shell
+        igir copy \
+          --dat DATs \
+          --dat-exclude "DATs/*Beta*" \
+          --dat-exclude "DATs/*Demo*" \
+          --input ROMs \
+          --output ROMs-Sorted
+        ```

docs/installation.md

@@ -20,12 +20,24 @@ Igir does not currently provide an auto-update functionality, but many of the fo
 
 The best way to ensure that you are always running the most up-to-date version of Igir is to run it via [`npx`](https://docs.npmjs.com/cli/v9/commands/npx) (which comes installed with [Node.js](https://nodejs.org/en/download/)):
 
+=== ":fontawesome-brands-windows: Windows"
+
+=== ":fontawesome-brands-apple: macOS"
+
+=== ":simple-linux: Linux"
+
 ```shell
 npx igir@latest [commands..] [options]
 ```
 
 for example:
 
+=== ":fontawesome-brands-windows: Windows"
+
+=== ":fontawesome-brands-apple: macOS"
+
+=== ":simple-linux: Linux"
+
 ```shell
 npx igir@latest copy extract --dat *.dat --input ROMs --output ROMs-Sorted --dir-dat-name
 ```
@@ -38,20 +50,22 @@ npx igir@latest copy extract --dat *.dat --input ROMs --output ROMs-Sorted --dir
 
     === ":fontawesome-brands-apple: macOS"
 
-        ```bash
-        alias igir="npx igir@latest"
-        ```
-
     === ":simple-linux: Linux"
 
-        ```bash
-        alias igir="npx igir@latest"
-        ```
+    ```bash
+    alias igir="npx igir@latest"
+    ```
 
 !!! tip
 
     Igir also supports [Bun](https://bun.com/), which typically executes JavaScript faster and with less memory usage. You can run the latest version of Igir like this:
 
+    === ":fontawesome-brands-windows: Windows"
+
+    === ":fontawesome-brands-apple: macOS"
+
+    === ":simple-linux: Linux"
+
     ```shell
     bunx igir@latest [commands..] [options]
     ```
@@ -62,6 +76,12 @@ npx igir@latest copy extract --dat *.dat --input ROMs --output ROMs-Sorted --dir
 
     If you want to help beta test Igir, you can run the most bleeding-edge version (sometimes called a "nightly") with the command:
 
+    === ":fontawesome-brands-windows: Windows"
+
+    === ":fontawesome-brands-apple: macOS"
+
+    === ":simple-linux: Linux"
+
     ```shell
     npx --yes "https://pkg.pr.new/igir@main" [commands..] [options]
     ```
@@ -73,13 +93,21 @@ npx igir@latest copy extract --dat *.dat --input ROMs --output ROMs-Sorted --dir
 
 [Homebrew](https://brew.sh/) is a third-party package manager for macOS. You can install Igir with this command:
 
+=== ":fontawesome-brands-apple: macOS"
+
+=== ":simple-linux: Linux"
+
 ```shell
 brew trust emmercm/igir
 brew install emmercm/igir/igir
 ```
 
 and then run Igir as if it were any other executable:
 
+=== ":fontawesome-brands-apple: macOS"
+
+=== ":simple-linux: Linux"
+
 ```shell
 igir copy extract \
   --dat *.dat \
@@ -90,6 +118,10 @@ igir copy extract \
 
 Igir can then be updated with _either_ of these commands
 
+=== ":fontawesome-brands-apple: macOS"
+
+=== ":simple-linux: Linux"
+
 ```shell
 # Update every Homebrew package
 brew update
@@ -105,13 +137,17 @@ brew upgrade igir
 
 [Scoop](https://scoop.sh/) is a third-party command-line installer for Windows. You can install Igir with this command:
 
+=== ":fontawesome-brands-windows: Windows"
+
 ```shell
 scoop bucket add igir https://github.com/emmercm/igir
 scoop install igir
 ```
 
 and then run Igir as if it were any other executable:
 
+=== ":fontawesome-brands-windows: Windows"
+
 ```batch
 igir copy extract ^
   --dat *.dat ^
@@ -122,6 +158,8 @@ igir copy extract ^
 
 Igir can then be updated with _either_ of these commands:
 
+=== ":fontawesome-brands-windows: Windows"
+
 ```shell
 # Update every Scoop app
 scoop update *