RepoMirrors/mpv
1
0
Fork 0
mirror of https://github.com/mpv-player/mpv synced 2025-01-14 19:11:53 +00:00
Code Issues Releases Wiki Activity

manpage: Document behaviour of *nix configuration directories

Browse Source 
The original documentation here is unclear, so let's describe the
behaviour we actually have. Inspired by wm4's updated docs but
obviously not identical because we're not changing any of the
behaviours.
This commit is contained in:
Philip Langdale 2020-10-14 20:18:43 -07:00 committed by Jan Ekström
parent 949e06c86c
commit 9a1942ac95
1 changed files with 22 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
DOCS/man/mpv.rst
View File

@ -1501,6 +1501,28 @@ For Windows-specifics, see `FILES ON WINDOWS`_ section.
in default configuration will use ``/usr/local/etc/mpv/`` as config
directory, while most Linux distributions will set it to ``/etc/mpv/``).
``~/.config/mpv``
The standard configuration directory. This can be overridden by environment
variables, in ascending order:
:1: If ``$XDG_CONFIG_HOME`` is set, then the derived configuration directory
will be ``$XDG_CONFIG_HOME/mpv``.
:2: If ``$MPV_HOME`` is set, then the derived configuration directory will be
``$MPV_HOME``.
If this directory, nor the original configuration directory (see below) do
not exist, mpv tries to create this directory automatically.
``~/.mpv/``
The original (pre 0.5.0) configuration directory. It will continue to be
read if present.
If both this directory and the standard configuration directory are
present, configuration will be read from both with the standard
configuration directory content taking precedence. However, you should
fully migrate to the standard directory and a warning will be shown in
this situation.
``~/.config/mpv/mpv.conf``
mpv user settings (see `CONFIGURATION FILES`_ section)
@ -1552,12 +1574,6 @@ For Windows-specifics, see `FILES ON WINDOWS`_ section.
Other files in this directory are specific to the corresponding scripts
as well, and the mpv core doesn't touch them.
Note that the environment variables ``$XDG_CONFIG_HOME`` and ``$MPV_HOME`` can
override the standard directory ``~/.config/mpv/``.
Also, the old config location at ``~/.mpv/`` is still read, and if the XDG
variant does not exist, will still be preferred.
FILES ON WINDOWS
================