Update docs

Author: amorison

docs/sources/cli.rst

@@ -53,15 +53,5 @@ is displayed.
 
 .. option:: --create
 
-   Create a new config file from scratch. This is useful if your configuration
-   file is broken or you want to reset the modifications you made to your
-   configuration.
-
-.. option:: --update
-
-   Add missing entries to your config file (or create a new one if necessary).
-
-.. option:: --edit
-
-   Open your config file in ``vim``.
+   Create a new config file from scratch.
 

docs/sources/install.rst

@@ -32,18 +32,22 @@ for more information about installing Python packages.
 Some setup
 ----------
 
-Run the following once to create your config file (in ``~/.config/stagpy/``)::
+Run the following to create a local config file (``.stagpy.toml``)::
 
     % stagpy config --create
 
 You can enable command-line auto-completion if you use either bash or zsh.
 
-Add this to your ``~/.bashrc`` file::
+For bash::
 
-    source ~/.config/stagpy/bash/stagpy.sh
+    # adapt path as appropriate for your system
+    % mkdir -p ~/.local/share/bash-completion/completions
+    % cd !$
+    % stagpy completions --bash
 
-Or this to your ``~/.zshrc`` file::
+For zsh, with ``fpath+=~/.zfunc`` in your ``.zshrc``::
 
-    source ~/.config/stagpy/zsh/_stagpy.sh
+    % cd ~/.zfunc
+    % stagpy completions --zsh
 
 Enjoy!

docs/sources/stagyydata.rst

@@ -81,7 +81,7 @@ Parameters set in the ``par`` file are accessible through the
 a dictionary of dictionaries.  For example, to access the Rayleigh number from
 the ``refstate`` section of the par file, one can use
 ``sdat.par['refstate']['ra0']``. Parameters that are not set in the par file
-are given a default value according to the par file ``~/.config/stagpy/par``.
+are given a default value.
 
 Radial profiles
 ---------------

docs/sources/tuto.rst

@@ -112,13 +112,13 @@ use the :class:`~stagpy.stagyydata.StagyyData` class.
 Plotting style
 --------------
 
-StagPy defines two custom plotting styles for matplotlib, ``stagpy-paper`` (the
-default) and ``stagpy-slides``.  You can edit them to your convenience, they
-are in the ``~/.config/stagpy`` directory.  You can specify which style to use
-with ``plot.mplstyle``, available in the command line interface with the
-``--mplstyle`` option.  You can specify a space-separated list to combine
-several styles.  For example, if you want a dark-background figure with a
-font size adapted for slides, you can use the following command::
-
-   % stagpy field --mplstyle='dark_background stagpy-slides'
+For convenience, StagPy defines two custom plotting styles for matplotlib,
+``stagpy-paper`` (the default when using the CLI) and ``stagpy-slides``. You
+can specify which style to use with ``plot.mplstyle``, available in the command
+line interface with the ``--mplstyle`` option.  You can specify a
+comma-separated list to combine several styles.  For example, if you want a
+dark-background figure with a font size adapted for slides, you can use the
+following command::
+
+   % stagpy field --mplstyle='dark_background,stagpy-slides'