@@ -1,7 +1,7 @@
11'\" t
2−.\" Automatically generated by Pandoc 2.12.1
2+.\" Automatically generated by Pandoc 2.13
33.\"
4−.TH "Pandoc User\[cq]s Guide" "" "March 20, 2021" "pandoc 2.13" ""
4+.TH "Pandoc User\[cq]s Guide" "" "May 13, 2021" "pandoc 2.14" ""
55.hy
66.SH NAME
77pandoc - general markup converter
@@ -4880,6 +4880,21 @@ header-includes:
48804880 \[ga]\[ga]\[ga]
48814881\f[R]
48824882.fi
4883+.PP
4884+Note: the \f[C]yaml_metadata_block\f[R] extension works with
4885+\f[C]commonmark\f[R] as well as \f[C]markdown\f[R] (and it is enabled by
4886+default in \f[C]gfm\f[R] and \f[C]commonmark_x\f[R]).
4887+However, in these formats the following restrictions apply:
4888+.IP \[bu] 2
4889+The YAML metadata block must occur at the beginning of the document (and
4890+there can be only one).
4891+If multiple files are given as arguments to pandoc, only the first can
4892+be a YAML metadata block.
4893+.IP \[bu] 2
4894+The leaf nodes of the YAML structure are parsed in isolation from each
4895+other and from the rest of the document.
4896+So, for example, you can\[cq]t use a reference link in these contexts if
4897+the link definition is somewhere else in the document.
48834898.SS Backslash escapes
48844899.SS Extension: \f[C]all_symbols_escapable\f[R]
48854900.PP
@@ -6468,9 +6483,29 @@ entries (for author-date and numerical styles only).
64686483.TP
64696484\f[B]\f[CB]lang\f[B]\f[R]
64706485The \f[C]lang\f[R] field will affect how the style is localized, for
6471−example in the translation of labels and the use of quotation marks.
6486+example in the translation of labels, the use of quotation marks, and
6487+the way items are sorted.
64726488(For backwards compatibility, \f[C]locale\f[R] may be used instead of
64736489\f[C]lang\f[R], but this use is deprecated.)
6490+.RS
6491+.PP
6492+A BCP 47 language tag is expected: for example, \f[C]en\f[R],
6493+\f[C]de\f[R], \f[C]en-US\f[R], \f[C]fr-CA\f[R], \f[C]ug-Cyrl\f[R].
6494+The unicode extension syntax (after \f[C]-u-\f[R]) may be used to
6495+specify options for collation (sorting) more precisely.
6496+Here are some examples:
6497+.IP \[bu] 2
6498+\f[C]zh-u-co-pinyin\f[R] \[en] Chinese with the Pinyin collation.
6499+.IP \[bu] 2
6500+\f[C]es-u-co-trad\f[R] \[en] Spanish with the traditional collation
6501+(with \f[C]Ch\f[R] sorting after \f[C]C\f[R]).
6502+.IP \[bu] 2
6503+\f[C]fr-u-kb\f[R] \[en] French with \[lq]backwards\[rq] accent sorting
6504+(with \f[C]cot\['e]\f[R] sorting after \f[C]c\[^o]te\f[R]).
6505+.IP \[bu] 2
6506+\f[C]en-US-u-kf-upper\f[R] \[en] English with uppercase letters sorting
6507+before lower (default is lower before upper).
6508+.RE
64746509.TP
64756510\f[B]\f[CB]notes-after-punctuation\f[B]\f[R]
64766511If true (the default), pandoc will put footnote citations after