RepoMirrors/mpv
1
0
Fork 0
mirror of https://github.com/mpv-player/mpv synced 2025-03-20 10:17:31 +00:00
Code Issues Releases Wiki Activity

DOCS: clarify what the ~~/ path means

Browse Source 
As it turns out the manual was very wrong about this.
This commit is contained in:
sfan5 2021-10-30 23:58:58 +02:00
parent 87c9eefb29
commit 3ea1f8e80a
1 changed files with 11 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
DOCS/man/mpv.rst
View File

@ -433,23 +433,28 @@ need to escape special characters. To work this around, the path can be
additionally wrapped in the fixed-length syntax, e.g. ``%n%string_of_length_n`` additionally wrapped in the fixed-length syntax, e.g. ``%n%string_of_length_n``
(see above). (see above).
Some mpv options interpret paths starting with ``~``. Currently, the prefix Some mpv options interpret paths starting with ``~``.
``~~/`` expands to the mpv configuration directory (usually ``~/.config/mpv/``). Currently, the prefix ``~~home/`` expands to the mpv configuration directory
(usually ``~/.config/mpv/``).
``~/`` expands to the user's home directory. (The trailing ``/`` is always ``~/`` expands to the user's home directory. (The trailing ``/`` is always
required.) The following paths are currently recognized: required.) The following paths are currently recognized:
================ =============================================================== ================ ===============================================================
Name Meaning Name Meaning
================ =============================================================== ================ ===============================================================
``~~/`` mpv config dir (for example ``~/.config/mpv/``) ``~~/`` If the subpath exists in any of the mpv's config directories
the path of the existing file/dir is returned. Otherwise this
is equivalent to ``~~home/``.
Note that if --no-config is used ``~~/foobar`` will resolve to
``foobar`` which can be unexpected.
``~/`` user home directory root (similar to shell, ``$HOME``) ``~/`` user home directory root (similar to shell, ``$HOME``)
``~~home/`` same as ``~~/`` ``~~home/`` mpv config dir (for example ``~/.config/mpv/``)
``~~global/`` the global config path, if available (not on win32) ``~~global/`` the global config path, if available (not on win32)
``~~osxbundle/`` the macOS bundle resource path (macOS only) ``~~osxbundle/`` the macOS bundle resource path (macOS only)
``~~desktop/`` the path to the desktop (win32, macOS) ``~~desktop/`` the path to the desktop (win32, macOS)
``~~exe_dir`` win32 only: the path to the directory containing the exe (for ``~~exe_dir/`` win32 only: the path to the directory containing the exe (for
config file purposes; ``$MPV_HOME`` overrides it) config file purposes; ``$MPV_HOME`` overrides it)
``~~old_home`` do not use ``~~old_home/`` do not use
================ =============================================================== ================ ===============================================================