From 93698b509bc84754ce612b1def46dd0766739609 Mon Sep 17 00:00:00 2001
From: David Lord <davidism@gmail.com>
Date: Fri, 20 Apr 2018 13:22:06 -0700
Subject: [PATCH] document cli option env vars closes #2713

---
 docs/cli.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/cli.rst b/docs/cli.rst
index 456fdc03..b857fe9b 100644
--- a/docs/cli.rst
+++ b/docs/cli.rst
@@ -183,6 +183,24 @@ production, you should call :func:`~cli.load_dotenv` manually.
 .. _python-dotenv: https://github.com/theskumar/python-dotenv#readme
 
 
+Setting Command Options
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Click is configured to load default values for command options from
+environment variables. The variables use the pattern
+``FLASK_COMMAND_OPTION``. For example, to set the port for the run
+command, instead of ``flask run --port 8000``:
+
+.. code-block:: none
+
+    export FLASK_RUN_PORT=8000
+    flask run
+     * Running on http://127.0.0.1:8000/
+
+These can be added to the ``.flaskenv`` file just like ``FLASK_APP`` to
+control default command options.
+
+
 Environment Variables From virtualenv
 -------------------------------------