diff mbox series

[bug#38980] gnu: sdl-mixer: Describe runtime configuration.

Message ID 20200106110651.3375-1-timotej.lazar@araneo.si
State Accepted
Headers show
Series [bug#38980] gnu: sdl-mixer: Describe runtime configuration. | expand

Checks

Context Check Description
cbaines/applying patch fail Apply failed

Commit Message

Timotej Lazar Jan. 6, 2020, 11:06 a.m. UTC
* gnu/packages/sdl.scm (sdl-mixer)[description]: Add information about runtime
  MIDI playback options.
---
 gnu/packages/sdl.scm | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

Comments

Danny Milosavljevic Jan. 6, 2020, 11:41 a.m. UTC | #1
Thanks!

Pushed to guix master as commit 769b96b62e8c09b078f73adc09fb860505920f8f.
diff mbox series

Patch

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)))