Merge branch 'master' into tests

1 files changed, 12 insertions, 4 deletions

diff --git a/README b/README
index 1647ef4a9..07f2266af 100644
--- a/README
+++ b/README
@@ -208,6 +208,10 @@ Options
     `markdown` or `textile`.  It is selected automatically when the input
     format is `textile` or the output format is `latex` or `context`.)
 
+`-5`, `--html5`
+:   Produce HTML5 instead of HTML4.  This option has no effect for writers
+    other than `html`.
+
 `-m` *URL*, `--latexmathml=`*URL*
 :   Use the [LaTeXMathML] script to display embedded TeX math in HTML output.
     To insert a link to a local copy of the `LaTeXMathML.js` script,
@@ -262,8 +266,9 @@ Options
     By default, sections are not numbered.
 
 `--section-divs`
-:   Wrap sections in `<div>` tags, and attach identifiers to the
-    enclosing `<div>` rather than the header itself.
+:   Wrap sections in `<div>` tags (or `<section>` tags in HTML5),
+    and attach identifiers to the enclosing `<div>` (or `<section>`)
+    rather than the header itself.
     See [Section identifiers](#header-identifiers-in-html), below.
 
 `--no-wrap`
@@ -504,6 +509,8 @@ depending on the output format, but include:
     multiple values)
 `date`
 :   date of document, as specified in title block
+`lang`
+:   language code for HTML documents
 
 Variables may be set at the command line using the `-V/--variable`
 option. This allows users to include custom variables in their
@@ -1143,8 +1150,9 @@ Note, however, that this method of providing links to sections works
 only in HTML.
 
 If the `--section-divs` option is specified, then each section will
-be wrapped in a `div`, and the identifier will be attached to the
-enclosing `<div>` tag rather than the header itself. This allows entire
+be wrapped in a `div` (or a `section`, if `--html5` was specified),
+and the identifier will be attached to the enclosing `<div>`
+(or `<section>`) tag rather than the header itself. This allows entire
 sections to be manipulated using javascript or treated differently in
 CSS.