README: Documented 'unnumbered' class and '-' shortcut.

1 files changed, 14 insertions, 1 deletions

diff --git a/README b/README
index b9d0e321b..39c69d08f 100644
--- a/README
+++ b/README
@@ -395,7 +395,9 @@ Options affecting specific writers
 
 `-N`, `--number-sections`
 :   Number section headings in LaTeX, ConTeXt, HTML, or EPUB output.
-    By default, sections are not numbered.
+    By default, sections are not numbered.  Sections with class
+    `unnumbered` will never be numbered, even if `--number-sections`
+    is specified.
 
 `--number-offset`=*NUMBER[,NUMBER,...]*,
 :   Offset for section headings in HTML output (ignored in other
@@ -926,6 +928,17 @@ the following headers will all be assigned the identifier `foo`:
 
 (This syntax is compatible with [PHP Markdown Extra].)
 
+Headers with the class `unnumbered` will not be numbered, even if
+`--number-sections` is specified.  A single hyphen (`-`) in an attribute
+context is equivalent to `.unnumbered`, and preferable in non-English
+documents.  So,
+
+    # My header {-}
+
+is just the same as
+
+    # My header {.unnumbered}
+
 **Extension: `auto_identifiers`**
 
 A header without an explicitly specified identifier will be