MANUAL: better docs on how to create a custom reference.docx.

1 files changed, 24 insertions, 8 deletions

diff --git a/MANUAL.txt b/MANUAL.txt
index 19ed5781b..fc6b65da8 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -795,6 +795,13 @@ Options affecting specific writers
     `--data-dir`). If this is not found either, sensible defaults will be
     used.
 
+    To produce a custom `reference.odt`, first get a copy of
+    the default `reference.odt`: `pandoc
+    --print-default-data-file reference.odt >
+    custom-reference.odt`.  Then open `custom-reference.docx` in
+    LibreOffice, modify the styles as you wish, and save the
+    file.
+
 `--reference-docx=`*FILE*
 
 :   Use the specified file as a style reference in producing a docx file.
@@ -805,14 +812,23 @@ Options affecting specific writers
     reference docx is specified on the command line, pandoc will look
     for a file `reference.docx` in the user data directory (see
     `--data-dir`). If this is not found either, sensible defaults will be
-    used. The following styles are used by pandoc: [paragraph]
-    Normal, Body Text, First Paragraph, Compact, Title, Subtitle, Author, Date,
-    Abstract, Bibliography, Heading 1, Heading 2, Heading 3, Heading 4,
-    Heading 5, Heading 6, Block Text, Footnote Text, Definition Term,
-    Definition, Caption, Table Caption, Image Caption, Figure,
-    Figure With Caption, TOC Heading;
-    [character] Default Paragraph Font, Body Text Char, Verbatim Char,
-    Footnote Reference, Hyperlink; [table] Normal Table.
+    used.
+
+    To produce a custom `reference.docx`, first get a copy of
+    the default `reference.docx`: `pandoc
+    --print-default-data-file reference.docx >
+    custom-reference.docx`.  Then open `custom-reference.docx`
+    in Word, modify the styles as you wish, and save the file.
+    For best results, do not make changes to this file other
+    than modifying the styles used by pandoc: [paragraph] Normal,
+    Body Text, First Paragraph, Compact, Title, Subtitle,
+    Author, Date, Abstract, Bibliography, Heading 1, Heading 2,
+    Heading 3, Heading 4, Heading 5, Heading 6, Block Text,
+    Footnote Text, Definition Term, Definition, Caption, Table
+    Caption, Image Caption, Figure, Figure With Caption, TOC
+    Heading; [character] Default Paragraph Font, Body Text Char,
+    Verbatim Char, Footnote Reference, Hyperlink; [table] Normal
+    Table.
 
 `--epub-stylesheet=`*FILE*