Skip to content

Commit 6e6db1c

Browse files
committed
Remove mention of pyglet PulseAudio bug
1 parent af45705 commit 6e6db1c

File tree

1 file changed

+5
-12
lines changed

1 file changed

+5
-12
lines changed

doc/programming_guide/sound.rst

+5-12
Original file line numberDiff line numberDiff line change
@@ -653,24 +653,17 @@ Backends Determine Playback Features
653653
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
654654

655655
.. _pyglet_openal: https://pyglet.readthedocs.io/en/latest/programming_guide/media.html#openal
656-
.. _pyglet_pulseaudiobug: https://pyglet.readthedocs.io/en/latest/programming_guide/media.html#the-bug
657656

658657
As with formats, you can maximize compatibility by only using the lowest
659658
common denominators among features. The most restrictive backends are:
660659

661660
* Mac's only backend, an OpenAL version limited to 16-bit audio
662-
* PulseAudio on Linux, which has multiple limitations:
661+
* PulseAudio on Linux, which lacks support for common features such as
662+
:ref:`positional audio <sound-other-libraries-pyglet-positional>`.
663663

664-
* It lacks support for :ref:`positional audio <sound-other-libraries-pyglet-positional>`
665-
* It can `crash under certain circumstances <pyglet_pulseaudiobug_>`_
666-
when other backends will not:
667-
668-
* Pausing / resuming in debuggers
669-
* Rarely and unpredictably when multiple sounds are playing
670-
671-
On Linux, the best way to deal with the PulseAudio bug is to `install
672-
OpenAL <pyglet_openal_>`_. It will often already be installed as a
673-
dependency of other packages.
664+
On Linux, the best way to deal with the PulseAudio backend's limitations
665+
is to `install OpenAL <pyglet_openal_>`_. It will often already be installed
666+
as a dependency of other packages.
674667

675668
Other differences between backends are less drastic. Usually, they will
676669
be things like the specific positional features supported and the maximum

0 commit comments

Comments
 (0)