@@ -653,24 +653,17 @@ Backends Determine Playback Features
653
653
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
654
654
655
655
.. _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
657
656
658
657
As with formats, you can maximize compatibility by only using the lowest
659
658
common denominators among features. The most restrictive backends are:
660
659
661
660
* 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 >`.
663
663
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.
674
667
675
668
Other differences between backends are less drastic. Usually, they will
676
669
be things like the specific positional features supported and the maximum
0 commit comments