summaryrefslogtreecommitdiff
path: root/MANUAL.txt
diff options
context:
space:
mode:
authorJesse Rosenthal <jrosenthal@jhu.edu>2018-02-21 16:12:13 -0500
committerJesse Rosenthal <jrosenthal@jhu.edu>2018-02-22 14:41:02 -0500
commit9d076eb8ef83b70ed75b555c3a3595a401ffb643 (patch)
treedabf55799bcd3d39891f2110019d0c990782120b /MANUAL.txt
parent69a72099305ff4efe10f8bc5dbab103f1302b2ad (diff)
MANUAL.txt: Document incremental and nonincremental divs.
Blockquoted lists are still described, but fenced divs are presented in preference.
Diffstat (limited to 'MANUAL.txt')
-rw-r--r--MANUAL.txt32
1 files changed, 28 insertions, 4 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index 9df9948f2..144ec8494 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -4248,14 +4248,38 @@ Incremental lists
By default, these writers produce lists that display "all at once."
If you want your lists to display incrementally (one item at a time),
use the `-i` option. If you want a particular list to depart from the
-default (that is, to display incrementally without the `-i` option and
-all at once with the `-i` option), put it in a block quote:
+default, put it in a `div` block with class `incremental` or
+`nonincremental`. So, for example, using the `fenced div` syntax, the
+following would be incremental regardless of the document default:
+
+ ::: incremental
+
+ - Eat spaghetti
+ - Drink wine
+
+ :::
+
+or
+
+ ::: nonincremental
+
+ - Eat spaghetti
+ - Drink wine
+
+ :::
+
+While using `incremental` and `nonincremental` divs are the
+recommended method of setting incremental lists on a per-case basis,
+an older method is also supported: putting lists inside a blockquote
+will depart from the document default (that is, it will display
+incrementally without the `-i` option and all at once with the `-i`
+option):
> - Eat spaghetti
> - Drink wine
-In this way incremental and nonincremental lists can be mixed in
-a single document.
+Both methods allow incremental and nonincremental lists to be mixed
+in a single document.
Inserting pauses
----------------