From d61528737eaee72823258bf3460e2ac88e94a6a6 Mon Sep 17 00:00:00 2001
From: Michael Williamson <mike@zwobble.org>
Date: Tue, 29 Nov 2016 22:11:32 +0000
Subject: Document :separator

---
 NEWS      |  2 ++
 README.md | 21 +++++++++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/NEWS b/NEWS
index 449369f..f8edbad 100644
--- a/NEWS
+++ b/NEWS
@@ -8,6 +8,8 @@
 
 * Allow escape sequences in style IDs, style names and CSS class names.
 
+* Allow a separator to be specified when HTML elements are collapsed.
+
 * Add include_embedded_style_map argument to allow embedded style maps to be
   disabled.
 
diff --git a/README.md b/README.md
index acece48..9a7ec13 100644
--- a/README.md
+++ b/README.md
@@ -526,6 +526,27 @@ Modifiers must be used in the correct order:
 h1.section-title:fresh
 ```
 
+#### Separators
+
+To specify a separator to place between the contents of paragraphs that are collapsed together,
+use `:separator('SEPARATOR STRING')`.
+
+For instance, suppose a document contains a block of code where each line of code is a paragraph with the style `Code Block`.
+We can write a style mapping to map such paragraphs to `<pre>` elements:
+
+```
+p[style-name='Code Block'] => pre
+```
+
+Since `pre` isn't marked as `:fresh`,
+consecutive `pre` elements will be collapsed together.
+However, this results in the code all being on one line.
+We can use `:separator` to insert a newline between each line of code:
+
+```
+p[style-name='Code Block'] => pre:separator('\n')
+```
+
 #### Nested elements
 
 Use `>` to specify nested elements.
-- 
cgit v1.2.3