From 5159d6653b0e04f03066a50794bc24195bdf81aa Mon Sep 17 00:00:00 2001
From: William Lupton <wlupton@broadband-forum.org>
Date: Thu, 19 Aug 2021 14:18:54 +0100
Subject: [PATCH] Clarify that each YAML block is a separate YAML document

---
 MANUAL.txt | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/MANUAL.txt b/MANUAL.txt
index 877021cd8..c94b69289 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -4179,6 +4179,10 @@ A document may contain multiple metadata blocks.  If two
 metadata blocks attempt to set the same field, the value from
 the second block will be taken.
 
+Each metadata block is handled internally as an independent YAML document.
+This means, for example, that any YAML anchors defined in a block cannot be
+referenced in another block.
+
 When pandoc is used with `-t markdown` to create a Markdown document,
 a YAML metadata block will be produced only if the `-s/--standalone`
 option is used.  All of the metadata will appear in a single block