From e79574b4613ac20bac7c76126a502e037c16a47a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20=C4=8Ciha=C5=99?= <michal@cihar.com>
Date: Tue, 7 Feb 2017 10:26:22 +0100
Subject: [PATCH] Provide more detailed guideline for customizing configuration
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

See https://github.com/phpmyadmin/docker/issues/82

Signed-off-by: Michal Čihař <michal@cihar.com>
---
 doc/setup.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/doc/setup.rst b/doc/setup.rst
index 25b604b5f8..1f3763fca8 100644
--- a/doc/setup.rst
+++ b/doc/setup.rst
@@ -160,6 +160,11 @@ by linking your database container to ``db`` for phpMyAdmin (by specifying
 to you to setup networking in Docker to allow phpMyAdmin container to access
 the database container over network).
 
+.. _docker-vars:
+
+Docker environment variables
+----------------------------
+
 You can configure several phpMyAdmin features using environment variables:
 
 .. envvar:: PMA_ARBITRARY
@@ -222,12 +227,29 @@ By default, :ref:`cookie` is used, but if :envvar:`PMA_USER` and
     documentation for `MariaDB container <https://hub.docker.com/r/_/mariadb/>`_
     or `MySQL container <https://hub.docker.com/r/_/mysql/>`_.
 
+.. _docker-custom:
+
+Customizing configuration
+-------------------------
+
 Additionally configuration can be tweaked by :file:`/etc/phpmyadmin/config.user.inc.php`. If
 this file exists, it will be loaded after configuration generated from above
 environment variables, so you can override any configuration variable. This
 configuraiton can be added as a volume when invoking docker using 
 `-v /some/local/directory/config.user.inc.php:/etc/phpmyadmin/config.user.inc.php` parameters.
 
+Note that the supplied configuration file is applied after :ref:`docker-vars`,
+but you can override any of the values.
+
+For example to change default behaviour of CSV export you can use following
+configuration file:
+
+.. code-block:: php
+
+    <?php
+    $cfg['Export']['csv_columns'] = true;
+
+
 .. seealso:: 
    
     See :ref:`config` for detailed description of configuration options.
@@ -310,6 +332,8 @@ using volumes directive:
          - /sessions
          - ~/docker/phpmyadmin/config.user.inc.php:/etc/phpmyadmin/config.user.inc.php
 
+.. seealso:: :ref:`docker-custom`
+
 Running behind haproxy in a subdirectory
 ----------------------------------------