From 2f32b5316fe2bde18835041f1d45fc363ddb93e4 Mon Sep 17 00:00:00 2001
From: John MacFarlane <jgm@berkeley.edu>
Date: Fri, 11 Oct 2019 10:06:01 -0700
Subject: [PATCH] More documentation of default files

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

diff --git a/MANUAL.txt b/MANUAL.txt
index 600cc3d23..f98a17fbc 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -1575,6 +1575,22 @@ ignore-args: false
 trace: false
 ```
 
+Fields that are omitted will just have their regular
+default values.  So a defaults file can be as simple as
+one line:
+
+``` yaml
+verbosity: INFO
+```
+
+Default files can be placed in the `defaults` subdirectory of
+the user data directory and used from any directory.  For
+example, one could create a file specifying defaults for writing
+letters, save it as `letter.yaml` in the `defaults` subdirectory
+of the user data directory, and then invoke these defaults
+from any directory using `pandoc --defaults letter`
+or `pandoc -dletter`.
+
 # Templates
 
 When the `-s/--standalone` option is used, pandoc uses a template to