History

DOCS/man: note that default autoprobe order is unrealiable

The default values for --ao, --vo, --gpu-api, --gpu-context change from time to time, but some libmpv clients rely on the existing autoprobe order and breaks as a result when the value changes. This specifies that the default autoprobe order should not be relied upon.

nanahi committed 2 years ago

Commit d890f361 parent 46dbaff3 files · +14 −1Browse files

Unified · Split

3 files
  1. DOCS/man/ao.rst +4 −0
  2. DOCS/man/options.rst +6 −1
  3. DOCS/man/vo.rst +4 −0
DOCS/man/ao.rst+4−0
@@ -15,6 +15,10 @@ in the list. · 14 unmodified lines
1515 See ``--ao=help`` for a list of compiled-in audio output drivers sorted by
1616 autoprobe order.
1717
18+ Note that the default audio output driver is subject to change, and must
19+ not be relied upon. If a certain AO needs to be used, it must be
20+ explicitly specified.
21+
1822 Available audio output drivers are:
1923
2024 ``alsa``
DOCS/man/options.rst+6−1
@@ -6447,6 +6447,9 @@ them. · 6446 unmodified lines
64476447 order. You can also pass ``help`` to get a complete list of compiled in backends
64486448 (sorted by the default autoprobe order).
64496449
6450+ Note that the default GPU context is subject to change, and must not be relied upon.
6451+ If a certain GPU context needs to be used, it must be explicitly specified.
6452+
64506453 auto
64516454 auto-select (default). Note that this context must be used alone and
64526455 does not participate in the priority list.
@@ -6489,7 +6492,9 @@ them. · 36 unmodified lines
64896492 Controls which type of graphics APIs will be accepted:
64906493
64916494 auto
6492− Use any available API (default)
6495+ Use any available API (default). Note that the default GPU API used for this
6496+ value is subject to change, and must not be relied upon. If a certain GPU API
6497+ needs to be used, it must be explicitly specified.
64936498 opengl
64946499 Allow only OpenGL (requires OpenGL 2.1+ or GLES 2.0+)
64956500 vulkan
DOCS/man/vo.rst+4−0
@@ -19,6 +19,10 @@ in the list. · 18 unmodified lines
1919 does not work, it will fallback to other drivers (in the same order as
2020 listed by ``--vo=help``).
2121
22+ Note that the default video output driver is subject to change, and must
23+ not be relied upon. If a certain VO needs to be used (e.g. for ``libmpv``
24+ rendering API), it must be explicitly specified.
25+
2226 Available video output drivers are:
2327
2428 ``gpu``

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t