ref: ff51b009ca2db0789b09e6984c9e93d6757c329c
parent: a4f919079255f4f7edb0d3199fbe93bbf79987c6
author: Simon Howard <fraggle+github@gmail.com>
date: Tue Oct 4 15:28:43 EDT 2016
README.Music: Fix subsectioning OPL "Operating System support" section was mistakenly listed as a level-1 heading, and heading levels in general were pretty screwed up. Change them to saner nested levels.
--- a/README.Music.md
+++ b/README.Music.md
@@ -2,7 +2,7 @@
the era, it is MIDI-based. Chocolate Doom includes a number of
different options for music playback, detailed below.
-## Native MIDI playback
+# Native MIDI playback
Most modern operating systems have some kind of built-in support for
MIDI playback; some have very good quality MIDI playback (Mac OS X for
@@ -9,7 +9,7 @@
example). To use this, choose “Native MIDI” in the sound configuration
dialog in the setup tool.
-## Timidity
+# Timidity
Timidity is a software-based MIDI synthesizer, and a version of it is
included in the SDL_mixer library used by Chocolate Doom. To use
@@ -24,7 +24,7 @@
configuration file” widget below to enter the path to the Timidity
configuration file (normally named timidity.cfg).
-## Gravis Ultrasound (GUS)
+# Gravis Ultrasound (GUS)
The Gravis Ultrasound (GUS) was a PC sound card popular in the ’90s,
notable for having wavetable synthesis that provided MIDI playback
@@ -48,7 +48,7 @@
512KB or 768KB card instead, change the gus_ram_kb option in
chocolate-doom.cfg.
-## OPL (Soundblaster / Adlib)
+# OPL (Soundblaster / Adlib)
Most people playing Doom in the ’90s had Soundblaster-compatible sound
cards, which used the Yamaha OPL series of chips for FM-based MIDI
@@ -62,7 +62,7 @@
cards do have real hardware OPL. If you have such a card, here’s how
to configure Chocolate Doom to use it.
-# Sound cards with OPL chips
+## Sound cards with OPL chips
If you have an ISA sound card, it almost certainly includes an OPL
chip. Modern computers don’t have slots for ISA cards though, so you
@@ -97,7 +97,7 @@
If your machine is not a PC, you don’t have an OPL chip, and you will
have to use the software OPL.
-# Operating System support
+## Operating System support
If you’re certain that you have a sound card with hardware OPL, you
may need to take extra steps to configure your operating system to
@@ -105,7 +105,7 @@
the chip directly, which is usually not possible in modern operating
systems unless you are running as the superuser (root/Administrator).
-## Windows 9x
+### Windows 9x
If you’re running Windows 95, 98 or Me, there is no need to configure
anything. Windows allows direct access to the OPL chip. You can
@@ -114,7 +114,7 @@
OPL_Init: Using driver 'Win32'.
-## Windows NT (including 2000, XP and later)
+### Windows NT (including 2000, XP and later)
If you’re running an NT-based system, it is not possible to directly
access the OPL chip, even when running as Administrator. Fortunately,
@@ -136,7 +136,7 @@
[this](http://www.vogons.org/viewtopic.php?f=46&t=36445) thread on
vogons.org for some more information.
-## Linux
+### Linux
If you are using a system based on the Linux kernel, you can access
the OPL chip directly, but you must be running as root. You can
@@ -152,7 +152,7 @@
options snd-ymfpci fm_port=0x388
options snd-cmipci fm_port=0x388
-## OpenBSD/NetBSD
+### OpenBSD/NetBSD
You must be running as root to access the hardware OPL directly. You
can confirm that hardware OPL is working by checking for this message