diff --git a/docs/html/user_guide.rst b/docs/html/user_guide.rst
index b9ea48580b3..281a8c27082 100644
--- a/docs/html/user_guide.rst
+++ b/docs/html/user_guide.rst
@@ -440,7 +440,9 @@ and ``--no-cache-dir``, falsy values have to be used:
no-compile = no
no-warn-script-location = false
-Appending options like ``--find-links`` can be written on multiple lines:
+It is possible to **append** values to a section within an config file such as the pip.ini file.
+This is applicable to appending options like ``--find-links`` or ``--trusted-host``,
+which can be written on multiple lines:
.. code-block:: ini
@@ -453,6 +455,13 @@ Appending options like ``--find-links`` can be written on multiple lines:
http://mirror1.example.com
http://mirror2.example.com
+ [install]
+ trusted-host =
+ http://mirror1.example.com
+ http://mirror2.example.com
+
+This enables users to add additional values in the order of entry for such command line args.
+
Environment Variables
---------------------
diff --git a/news/7803.doc b/news/7803.doc
new file mode 100644
index 00000000000..bf86b8976ab
--- /dev/null
+++ b/news/7803.doc
@@ -0,0 +1 @@
+Added example of defining multiple values for options which support them