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
15 See ``--ao=help`` for a list of compiled-in audio output drivers sorted by15 See ``--ao=help`` for a list of compiled-in audio output drivers sorted by
16 autoprobe order.16 autoprobe order.
17 17
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
18Available audio output drivers are:22Available audio output drivers are:
19 23
20``alsa``24``alsa``
DOCS/man/options.rst+6−1
@@ -6447,6 +6447,9 @@ them. · 6446 unmodified lines
6447 order. You can also pass ``help`` to get a complete list of compiled in backends6447 order. You can also pass ``help`` to get a complete list of compiled in backends
6448 (sorted by the default autoprobe order).6448 (sorted by the default autoprobe order).
6449 6449
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
6450 auto6453 auto
6451 auto-select (default). Note that this context must be used alone and6454 auto-select (default). Note that this context must be used alone and
6452 does not participate in the priority list.6455 does not participate in the priority list.
@@ -6489,7 +6492,9 @@ them. · 36 unmodified lines
6489 Controls which type of graphics APIs will be accepted:6492 Controls which type of graphics APIs will be accepted:
6490 6493
6491 auto6494 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.
6493 opengl6498 opengl
6494 Allow only OpenGL (requires OpenGL 2.1+ or GLES 2.0+)6499 Allow only OpenGL (requires OpenGL 2.1+ or GLES 2.0+)
6495 vulkan6500 vulkan
DOCS/man/vo.rst+4−0
@@ -19,6 +19,10 @@ in the list. · 18 unmodified lines
19 does not work, it will fallback to other drivers (in the same order as19 does not work, it will fallback to other drivers (in the same order as
20 listed by ``--vo=help``).20 listed by ``--vo=help``).
21 21
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
22Available video output drivers are:26Available video output drivers are:
23 27
24``gpu``28``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