summary refs log tree commit diff
diff options
context:
space:
mode:
authorTimotej Lazar <timotej.lazar@araneo.si>2020-01-06 12:06:51 +0100
committerDanny Milosavljevic <dannym@scratchpost.org>2020-01-06 12:40:29 +0100
commit769b96b62e8c09b078f73adc09fb860505920f8f (patch)
treedaa5eaa102dd2076756efaa25c083b94bef517b8
parentc27710859c3cb59c439571ddc56cf71c36a1c33c (diff)
downloadguix-769b96b62e8c09b078f73adc09fb860505920f8f.tar.gz
gnu: sdl-mixer: Describe runtime configuration.
* gnu/packages/sdl.scm (sdl-mixer)[description]: Add information about runtime
MIDI playback options.

Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
-rw-r--r--gnu/packages/sdl.scm10
1 files changed, 8 insertions, 2 deletions
diff --git a/gnu/packages/sdl.scm b/gnu/packages/sdl.scm
index 80725561fb..727a276dc5 100644
--- a/gnu/packages/sdl.scm
+++ b/gnu/packages/sdl.scm
@@ -281,8 +281,14 @@ WEBP, XCF, XPM, and XV.")
     (synopsis "SDL multi-channel audio mixer library")
     (description "SDL_mixer is a multi-channel audio mixer library for SDL.
 It supports any number of simultaneously playing channels of 16 bit stereo
-audio, plus a single channel of music.  Supported format include FLAC, MOD,
-MIDI, Ogg Vorbis, and MP3.")
+audio, plus a single channel of music.  Supported formats include FLAC, MOD,
+MIDI, Ogg Vorbis, and MP3.
+
+This package supports two MIDI backends, selectable at runtime.  To use the
+newer @code{fluidsynth} library, install a soundfont such as @code{fluid-3}
+and specify it using the @code{SDL_SOUNDFONTS} environment variable.  For the
+legacy @code{timidity} backend, install a patch set such as @code{freepats}
+and set the path to the configuration file with @code{TIMIDITY_CFG}.")
     (home-page "https://www.libsdl.org/projects/SDL_mixer/")
     (license zlib)))