# HG changeset patch # User Goffi # Date 1586888807 -7200 # Node ID f21412896620a6407e468914cc7f890192ccd387 # Parent e4d3ba75b1b2fa11ca9045ed30004214b5fe6dae doc (config): fixed documentation about configuration file possible paths + minor corrections. diff -r e4d3ba75b1b2 -r f21412896620 doc/configuration.rst --- a/doc/configuration.rst Tue Apr 14 20:25:05 2020 +0200 +++ b/doc/configuration.rst Tue Apr 14 20:26:47 2020 +0200 @@ -8,12 +8,12 @@ by a ``.`` if you want to hide it on suitable platforms). It is a common file used both by backend and all frontends (and even related project like SàT Pubsub). -This file can located in the following paths (in order of parsing): +This file can be located in the following paths (in order of parsing): - ``/etc`` - ``~`` (``$HOME`` or your home directory) - - the directory where you are launching the backend or frontend from - XDG directory for configuration (most of time it is - ``~/.config/sat/sat.conf``) + ``~/.config/sat/``) + - the parent directory of SàT installation path If several configurations files are found, they are merged. In case of conflict, the option parsed last is the one used (in other words: if you have an option set in @@ -23,8 +23,8 @@ Format ====== -``sat.conf`` is a using the `INI`_ file format as understood by Python's -`SafeConfigParser`_ (meaning that you can use interpolation). +``sat.conf`` is using the `INI`_ file format as understood by Python's `SafeConfigParser`_ +(meaning that you can use interpolation). The ``DEFAULT`` section is used for global options, this is where you specify where are your media. diff -r e4d3ba75b1b2 -r f21412896620 doc/overview.rst --- a/doc/overview.rst Tue Apr 14 20:25:05 2020 +0200 +++ b/doc/overview.rst Tue Apr 14 20:26:47 2020 +0200 @@ -44,10 +44,10 @@ time ``~/.local/share/sat``. In this directory, you'll find the main database in the ``sat.db`` file, which is a `SQLite`_ database. -The backend is run and stopped with the ``sat`` binary. Running it without argument launch -the backend in the background, with ``sat fg`` you run it in the foreground (you'll see -log directly and can stop the backend with ``Ctrl + c``). The ``sat status`` commands help -you discover if the backend is running or stopped. +The backend is run and stopped with the ``sat`` executable. Running it without argument +launch the backend in the background, with ``sat fg`` you run it in the foreground (you'll +see log directly and can stop the backend with ``Ctrl + c``). The ``sat status`` commands +help you discover if the backend is running or stopped. .. _XDG directory: https://www.freedesktop.org/wiki/Software/xdg-user-dirs/ .. _SQLite: https://sqlite.org