Skip to content

Commit

Permalink
DOCS/man/mpv: clarify config-dir path behavior
Browse files Browse the repository at this point in the history
  • Loading branch information
Arcitec committed Oct 29, 2024
1 parent 0c5420b commit 4a33621
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions DOCS/man/mpv.rst
Original file line number Diff line number Diff line change
Expand Up @@ -514,14 +514,17 @@ Currently, the prefix ``~~home/`` expands to the mpv configuration directory
``~/`` expands to the user's home directory. (The trailing ``/`` is always
required.) The following paths are currently recognized:

**Important:** Beware that if ``--no-config`` is used, then all of the "config
directory"-based paths will resolve to an empty path prefix, meaning that both
``~~/foobar`` and ``~~home/foobar`` will resolve to ``foobar``, which might not
be what you expected.

================ ===============================================================
Name Meaning
================ ===============================================================
``~~/`` If the subpath exists in any of the mpv's config directories
``~~/`` If the subpath exists in any of mpv's config directories, then
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``)
``~~home/`` mpv config dir (for example ``~/.config/mpv/``)
``~~global/`` the global config path, if available (not on win32)
Expand Down

0 comments on commit 4a33621

Please sign in to comment.