From 46baf6659dad59d1d633894b4db886a2e1311d43 Mon Sep 17 00:00:00 2001 From: Albert Krewinkel Date: Fri, 14 May 2021 22:43:38 +0200 Subject: MANUAL: add info about YAML escape sequences, link to spec. Closes: #7152 --- MANUAL.txt | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) (limited to 'MANUAL.txt') diff --git a/MANUAL.txt b/MANUAL.txt index cdfb0e332..7ab07264d 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -4177,10 +4177,12 @@ option is used. All of the metadata will appear in a single block at the beginning of the document. Note that [YAML] escaping rules must be followed. Thus, for example, -if a title contains a colon, it must be quoted. The pipe character -(`|`) can be used to begin an indented block that will be interpreted -literally, without need for escaping. This form is necessary -when the field contains blank lines or block-level formatting: +if a title contains a colon, it must be quoted, and if it contains a +backslash escape, then it must be ensured that it is not treated as a +[YAML escape sequence]. The pipe character (`|`) can be used to begin +an indented block that will be interpreted literally, without need for +escaping. This form is necessary when the field contains blank lines +or block-level formatting: --- title: 'This is the title: it contains a colon' @@ -4255,6 +4257,7 @@ following restrictions apply: example, you can't use a reference link in these contexts if the link definition is somewhere else in the document. +[YAML escape sequence]: https://yaml.org/spec/1.2/spec.html#id2776092 ## Backslash escapes -- cgit v1.2.3