From 007aa0a6fc6c3c2baf389285e78572d342d5ab4e Mon Sep 17 00:00:00 2001
From: Mike Swanson <mikeonthecomputer@gmail.com>
Date: Fri, 17 Jul 2026 17:13:26 -0700
Subject: [PATCH 1/3] Document support for AaruFormat images

---
 hardware/diskimages.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/hardware/diskimages.rst b/hardware/diskimages.rst
index bbead3f..b0f9d41 100644
--- a/hardware/diskimages.rst
+++ b/hardware/diskimages.rst
@@ -208,16 +208,16 @@ Supported formats:
     - File extension
     - Notes
 
+  * - ISO
+    - .iso
+    -
+
   * - Cue sheet
     - .cue + .bin
 
       (+ optional audio)
     - :ref:`Audio tracks are supported. <hardware/diskimages:CD audio>`
 
-  * - ISO
-    - .iso
-    -
-
   * - Alcohol 120%
     - .mds + .mdf
     - Support for Daemon Tools MDS v2 images will not be available on Windows hosts if the included ``mdsx.dll`` file is missing from the 86Box directory.
@@ -226,10 +226,14 @@ Supported formats:
     - .mdx
     - Support will not be available on Windows hosts if the included ``mdsx.dll`` file is missing from the 86Box directory.
 
+  * - `AaruFormat <https://aaru.app/>`_
+    - .aaruf, .aif, .aaruformat
+    - Support for AaruFormat images requires ``libaaruformat.dll`` (Windows), ``libaaruformat.dylib`` (macOS), or ``libaaruformat.so`` (Linux and other Unices)
+
 CD audio
 ^^^^^^^^
 
-Compact Disc Digital Audio (CDDA) playback through the emulated CD-ROM drives is supported on **Cue sheet** and **Daemon Tools** images. Audio output is enabled on the first CD-ROM drive and muted on subsequent drives by default; individual drives can be muted or unmuted through the :ref:`status bar <usage/statusbar:|cdrom| |dvdrom| CD-ROM drives>` or :ref:`Media menu <usage/menubar:Media>`.
+Compact Disc Digital Audio (CDDA) playback through the emulated CD-ROM drives is supported on **AaruFormat**, **Cue sheet**, and **Daemon Tools** images. Audio output is enabled on the first CD-ROM drive and muted on subsequent drives by default; individual drives can be muted or unmuted through the :ref:`status bar <usage/statusbar:|cdrom| |dvdrom| CD-ROM drives>` or :ref:`Media menu <usage/menubar:Media>`.
 
 For **Cue sheet** images, audio tracks in raw (.bin), encapsulated (.wav) and compressed (.mp3 .ogg .flac) formats are supported.
 

From dafac501e180af9c769f4fa53eed7d9632da3b18 Mon Sep 17 00:00:00 2001
From: Mike Swanson <mikeonthecomputer@gmail.com>
Date: Sat, 18 Jul 2026 13:52:14 -0700
Subject: [PATCH 2/3] Document support for CD/DVD CHD images

---
 hardware/diskimages.rst | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/hardware/diskimages.rst b/hardware/diskimages.rst
index b0f9d41..0c0084b 100644
--- a/hardware/diskimages.rst
+++ b/hardware/diskimages.rst
@@ -4,7 +4,7 @@ Disk images
 86Box supports a large variety of disk image formats for the emulated storage drives.
 
 .. raw:: html
-  
+
   <style>
     /* There's no getting around Sphinx automatically sizing columns without some CSS.
        It's that kind of recurring issue a lot of people had but nobody ever addressed. */
@@ -226,6 +226,10 @@ Supported formats:
     - .mdx
     - Support will not be available on Windows hosts if the included ``mdsx.dll`` file is missing from the 86Box directory.
 
+  * - `CHD <https://docs.mamedev.org/tools/chdman.html>`_
+    - .chd
+    -
+
   * - `AaruFormat <https://aaru.app/>`_
     - .aaruf, .aif, .aaruformat
     - Support for AaruFormat images requires ``libaaruformat.dll`` (Windows), ``libaaruformat.dylib`` (macOS), or ``libaaruformat.so`` (Linux and other Unices)
@@ -237,6 +241,11 @@ Compact Disc Digital Audio (CDDA) playback through the emulated CD-ROM drives is
 
 For **Cue sheet** images, audio tracks in raw (.bin), encapsulated (.wav) and compressed (.mp3 .ogg .flac) formats are supported.
 
+CHD support
+^^^^^^^^^^^
+
+CHD files are most often seen in software sets intended for the `MAME <https://www.mamedev.org/>`_ emulator, but other sources exist, including self-made images created with the ``chdman`` utility.  86Box only supports CHDs that represent CD and DVD media, other CHD types (such as hard disk and LaserDisc) are not supported.
+
 Cassette tape images
 --------------------
 

From c6ff371e3fe278edb36faca78e13733ca19bead4 Mon Sep 17 00:00:00 2001
From: Mike Swanson <mikeonthecomputer@gmail.com>
Date: Sat, 18 Jul 2026 16:46:54 -0700
Subject: [PATCH 3/3] Document multiple session support for CDs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

At present, only ISO and CHD formats lack support for multiple
sessions.  For cue files, multiple sessions are supported through an
unofficial extension to the format.

With the recent expansion of image formats supported, rewrite the CD
audio section also to specifically call out ISO as the sole format
that doesn’t support them, instead of naming every other type (which
can easily expand in the future).
---
 hardware/diskimages.rst | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/hardware/diskimages.rst b/hardware/diskimages.rst
index 0c0084b..6a58bb1 100644
--- a/hardware/diskimages.rst
+++ b/hardware/diskimages.rst
@@ -210,13 +210,13 @@ Supported formats:
 
   * - ISO
     - .iso
-    -
+    - Represents only a single data track, no audio tracks supported.
 
   * - Cue sheet
     - .cue + .bin
 
       (+ optional audio)
-    - :ref:`Audio tracks are supported. <hardware/diskimages:CD audio>`
+    -
 
   * - Alcohol 120%
     - .mds + .mdf
@@ -237,10 +237,25 @@ Supported formats:
 CD audio
 ^^^^^^^^
 
-Compact Disc Digital Audio (CDDA) playback through the emulated CD-ROM drives is supported on **AaruFormat**, **Cue sheet**, and **Daemon Tools** images. Audio output is enabled on the first CD-ROM drive and muted on subsequent drives by default; individual drives can be muted or unmuted through the :ref:`status bar <usage/statusbar:|cdrom| |dvdrom| CD-ROM drives>` or :ref:`Media menu <usage/menubar:Media>`.
+Compact Disc Digital Audio (CDDA) playback through the emulated CD-ROM drives is supported with most image formats, with the notable exception of ISO file images. Audio output is enabled on the first CD-ROM drive and muted on subsequent drives by default; individual drives can be muted or unmuted through the :ref:`status bar <usage/statusbar:|cdrom| |dvdrom| CD-ROM drives>` or :ref:`Media menu <usage/menubar:Media>`.
 
 For **Cue sheet** images, audio tracks in raw (.bin), encapsulated (.wav) and compressed (.mp3 .ogg .flac) formats are supported.
 
+Multiple session support
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+CDs containing multiple sessions (sometimes branded “Enhanced CD”) is supported on the **Cue sheet**, **Alcohol 120%**, **Daemon Tools**, and **AaruFormat** image types.  Other image types do not support representing multiple sessions.
+
+For **Cue sheet** images, multiple sessions are implement through an unofficial ``REM SESSION XX`` extension, not supported by the original CDRWIN software nor many other Cue sheet-supporting programs.  An example of a multi-session Cue sheet is as follows::
+
+  FILE "data.bin" BINARY
+  REM SESSION 01
+    TRACK 01 AUDIO
+      INDEX 01 00:00:00
+  REM SESSION 02
+    TRACK 02 MODE2/2352
+      INDEX 01 05:00:00
+
 CHD support
 ^^^^^^^^^^^