From 4831f5bc8f7752447905fa34c241610b1024872c Mon Sep 17 00:00:00 2001
From: Tristan van Berkom <tristan@codethink.co.uk>
Date: Sat, 26 Sep 2020 17:50:43 +0900
Subject: doc: Documenting ability to specify multiple filenames in a
 dependency.

---
 doc/source/format_declaring.rst | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

(limited to 'doc')

diff --git a/doc/source/format_declaring.rst b/doc/source/format_declaring.rst
index 98b5f926e..380f367e0 100644
--- a/doc/source/format_declaring.rst
+++ b/doc/source/format_declaring.rst
@@ -417,7 +417,23 @@ Attributes:
 
 * ``filename``
 
-  The :ref:`element name <format_element_names>` to depend on.
+  The :ref:`element name <format_element_names>` to depend on, or a list of mutiple element names.
+
+  Specifying multiple element names in a single dependency will result in multiple dependencies
+  being declared with common properties.
+
+  For example, one can declare multiple build dependencies with the same junction:
+
+  .. code:: yaml
+
+     # Declare three build dependencies from subproject.bst
+     depends:
+     - type: build
+       junction: subproject.bst
+       filename:
+       - element-a.bst
+       - element-b.bst
+       - element-c.bst
 
 * ``junction``
 
-- 
cgit v1.2.1