From 24faccdf5daea774d950e6685c38f18c8528b69a Mon Sep 17 00:00:00 2001
From: Tristan Stenner <derstenner@gmail.com>
Date: Mon, 19 Mar 2018 17:20:16 +0100
Subject: Add examples for raw docx blocks (#4472)

The documentation states that the target format name should match the output format, which isn't the case for `docx`/`openxml`.

This PR adds a remark and a frequently requested example (inserting a pagebreak in docx output) to the documentation.
---
 MANUAL.txt | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/MANUAL.txt b/MANUAL.txt
index ff00288af..e08e9e876 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -3415,9 +3415,20 @@ And the following produces a raw `html` inline element:
 
     This is `<a>html</a>`{=html}
 
+This can be useful to insert raw xml into `docx` documents, e.g.
+a pagebreak:
+
+    ```{=openxml}
+    <w:p>
+      <w:r>
+        <w:br w:type="page"/>
+      </w:r>
+    </w:p>
+    ```
+
 The format name should match the target format name (see
 `-t/--to`, above, for a list, or use `pandoc
---list-output-formats`).
+--list-output-formats`). Use `=openxml` for `docx` output.
 
 This extension presupposes that the relevant kind of
 inline code or fenced code block is enabled.  Thus, for
-- 
cgit v1.2.3