document xdg compatible xonshrc path

This commit is contained in:
con-f-use 2020-06-11 01:59:14 +02:00 committed by GitHub
parent d6ffd678bf
commit bf4eb0e5d4
Failed to generate hash of commit

View file

@ -4,7 +4,7 @@ Xonsh allows you to have run control files to customize your shell behavior. Th
The system-wide ``xonshrc`` file controls options that are applied to all users of Xonsh on a given system. You can create this file in ``/etc/xonshrc`` for Linux and OSX and in ``%ALLUSERSPROFILE%\xonsh\xonshrc`` on Windows.
Xonsh also allows you to have a run control file in your home directory called ``~/.xonshrc``. The options set in the local ``xonshrc`` only apply to the current user and will override any conflicting settings set in the system-wide control file.
Xonsh also allows you to have a run control file in your home directory. It can either be directly in ``~/.xonshrc`` or for XDG compliance in ``~/.config/rc.xsh``. The options set in the local ``xonshrc`` only apply to the current user and will override any conflicting settings set in the system-wide control file.
These files are written in the xonsh language, of course. They are executed exactly once
at startup. The following is a real-world example of such a file.
@ -47,3 +47,4 @@ The colors of the ``ls`` command may be hard to read in a dark terminal. If so,
.. code-block:: xonshcon
>>> $LS_COLORS='rs=0:di=01;36:ln=01;36:mh=00:pi=40;33:so=01;35:do=01;35:bd=40;33;01:cd=40;33;01:or=40;31;01:su=37;41:sg=30;43:ca=30;41:tw=30;42:ow=34;42:st=37;44:ex=01;32:'