Patches #1164217 "Updated GS Support + Percussion Remapping Patch" and

#1181750 "Updated Native MIDI documentation". Thanks _tom a lot.

svn-id: r17571

3 files changed, 38 insertions, 3 deletions

diff --git a/doc/05_01.tex b/doc/05_01.tex
index 2afc462e53..ebd671b7a6 100644
--- a/doc/05_01.tex
+++ b/doc/05_01.tex
@@ -36,9 +36,10 @@ Usage: scummvm [OPTIONS]... [GAME]\\
                           &atari, fmtowns, mac, pc, windows)\\
   --savepath=PATH         &Path to where savegames are stored\\
   --multi-midi            &Enable combination of Adlib and native MIDI\\
-  --soundfont             &Select the SoundFont for MIDI playback. (Only\\
-                          &supported by some MIDI drivers.)\\
+  --soundfont             &Select the SoundFont for MIDI playback (Only\\
+                          &supported by some MIDI drivers)\\
   --native-mt32           &True Roland MT-32 (disable GM emulation)\\
+  --enable-gs	     	   &Enable Roland GS mode for MIDI playback\\
   --output-rate=RATE      &Select output sample rate in Hz (e.g. 22050)\\
   --aspect-ratio          &Enable aspect ratio correction\\
   --render-mode=MODE      &Enable additional render modes (cga, ega, hercGreen, hercAmber, amiga)\\
diff --git a/doc/07_03.tex b/doc/07_03.tex
index 347a2bd427..bd754bf9ee 100644
--- a/doc/07_03.tex
+++ b/doc/07_03.tex
@@ -9,3 +9,33 @@
 Use the appropriate -e<mode> command line option from the list above to
 select your preferred MIDI device. For example, if you wish to use the
 Windows MIDI driver, use the -ewindows option.
+
+\subsubsection{Using MIDI options to customize Native MIDI output}
+ScummVM supports a variety of MIDI modes, depending on the capabilities
+of your MIDI device.
+
+If --native-mt32 is specified, ScummVM will treat your device as a real
+MT-32. Because the instrument mappings and system exclusive commands of
+the MT-32 vary from those of General MIDI devices, you should only
+enable this option if you are using an actual Roland MT-32, LAPC-I, CM-64,
+CM-32L, CM-500, or GS device with an MT-32 map.
+
+If --enable-gs is specified, ScummVM will initialize your GS-compatible
+device with settings that mimic the MT-32's reverb, (lack of) chorus,
+pitch bend sensitivity, etc. If it is specified in conjunction with
+--native-mt32, ScummVM will select the MT-32-compatible map and drumset on
+your GS device. This setting works better than default GM or GS emulation
+with games that do not have custom instrument mappings (Loom and Monkey1).
+You should only specify both settings if you are using a GS device that
+has an MT-32 map, such as an SC-55, SC-88, SC-88 Pro, SC-8820, SC-8850, etc.
+Please note that --enable-gs is automatically disabled in both DOTT and
+Samnmax, since they use General MIDI natively.
+
+If neither of the above settings is enabled, ScummVM will initialize your
+device in General MIDI mode and use GM emulation in games with MT-32
+soundtracks.
+
+Some games contain sound effects that are exclusive to the Adlib soundtrack.
+For these games, you may wish to specify --multi-midi in order to combine
+MIDI music with Adlib sound effects.
+
diff --git a/doc/08.tex b/doc/08.tex
index 56e829415d..84cdf3285f 100644
--- a/doc/08.tex
+++ b/doc/08.tex
@@ -102,11 +102,15 @@ The following keywords are recognized:
                         &         supported by some MIDI drivers.)\\
         native\_mt32    &bool     If true, disable GM emulation and assume that\\
                         &         there is a true Roland MT-32 available.\\
+	   enable\_gs      &bool     If true, enable Roland GS-specific features to\\
+                        &         enhance GM emulation. If native\_mt32 is also\\
+                        &         true, the GS device will select an MT-32 map\\
+                        &         to play the correct instruments.\\
         sfx\_volume     &number   The sfx volume setting (0-255)\\
         tempo           &number   The music tempo (50-200) (default: 100)\\
         speech\_volume  &number   The speech volume setting (0-255)\\
 \\
-        copy\_protection&bool     Enable copy protection in SCUMM games ,when\\
+        copy\_protection&bool     Enable copy protection in SCUMM games, when\\
                         &         ScummVM disables it by default.\\
         demo\_mode      &bool     Start demo in Maniac Mansion\\
         alt\_intro      &bool     Use alternative intro for CD versions of \\