Revised format of changelog to match release announcement.

2 files changed, 299 insertions, 437 deletions

diff --git a/changelog b/changelog
index 8a05b35ed..b998f7641 100644
--- a/changelog
+++ b/changelog
@@ -2,193 +2,158 @@ pandoc (1.6)
 
   [ John MacFarlane ]
 
-  * Added a slidy writer.  Resolves Issue #122.
-
-  * Made a proper ODT writer.
-    + Transformed the old Text.Pandoc.ODT module into a proper
-      writer module, Text.Pandoc.Writers.ODT.
-    + Instead of saveOpenDocumentAsODT, we now have writeODT, which
-      takes a Pandoc document and produces a bytestring.
-      saveOpenDocumentAsODT has been removed.
-    + To extract the images and insert them into the ODT, we now use
-      processPandocM on the Pandoc document rather than a custom XML parser.
-    + Handle the case where the image is remote (or not found) by
-      converting the Image element into an Emph with the label.
-    + Plumbing in pandoc.hs changed slightly to accomodate this, and to
-      allow other writers that live in the IO monad.
-
-  * Added an EPUB writer.
-    + New writer module Text.Pandoc.Writers.EPUB
-    + Stylesheet in epub.css
-    + --epub-stylesheet command-line option.
-    + New utility module Text.Pandoc.UUID to generate
-      random UUIDs for EPUBs.
-    + Added writerEPUBMetadata field and --epub-metadata option.
-
-  * Moved Pandoc prettyprinting code from Shared to new Native writer.
-    + Text.Pandoc.Writers.Native
-    + The function prettyPandoc is now gone.  Use writeNative instead.
-
-  * Added --section-divs option. Header identifiers now get attached to
-    the headers, unless --section-divs is specified, in which case they
-    are added to enclosing divs. By default, the divs are not added.
-    Resolves Issue #230, #239.
-
-  * Added --webtex option for HTML math.
-    + Added --webtex command-line option, with optional parameter.
-      (Defaults to using google charts API.)
-    + Added WebTeX HTMLMathMethod.
-    + Removed MimeTeX HTMLMathMethod.  (WebTeX is generic and subsumes it.)
-    + Modified --mimetex option to use WebTeX.
-    + Thanks to lpeterse for the idea and some of the code.
-
-  * Made spacing at end of output more consistent. Previously some
-    of the writers added spurious whitespace. This has been removed,
-    resolving Issue #232.
-
-    NOTE: If your application combines pandoc's output with other
-    text, for example in a template, you may need to add spacing.
-    For example, a pandoc-generated markdown file will not have
-    a blank line after the final block element.  If you are inserting
-    it into another markdown file, you will need to make sure there
-    is a blank line between it and the next block element.
-
-  * Added Text.Pandoc.UTF8 for portable UTF8 string IO.
-    + Pandoc no longer respects locale, even when compiled by GHC 6.12.
-    + Use new UTF8 module in Shared, ODT, and the executables.
-    + Modified readFile and getContents to strip BOM if present.
-
-  * Removed Text.Pandoc.Writers.S5 and writeS5 function.
-    Moved s5Includes to new module, Text.Pandoc.S5.
-    (Now s5 is handled in more or less the same way as slidy;
-    to write S5, you use writeHtml with writerSlideVariant set
-    to S5Slides or SlidySlides.)
-
-  * Added new --offline option for slidy and S5.
-    + The default for both is now to include links, rather than a full
-      copy of scripts and stylesheets. If you are relying on pandoc
-      to produce a self-contained slide show, you should specify
-      '--offline'.
-    + Added slidy/slidy.min.{css,js}.
-
-  * Cause horizontal rules to start a new slide in s5 and slidy.
-
-  * Added grid tables for markdown.
-    + Moved generic grid table functions from RST reader -> Parsing.
-      Here they can be used by the Markdown reader as well.
-    + Resolves Issue #43.
-
-  * Allow language-neutral table captions.
-    + Captions may now begin simply with ':', instead of 'Table:'
-    + Captions may now appear either above or below the table.
-    + Resolves Issue #227.
-
-  * Added sequentially numbered example lists in markdown, using
-    (@) list markers.  These are documented in README under
-    "Numbered examples."
-
-  * Changes to WriterOptions:
-    + Added writerUserDataDir.
-    + Added writerSourceDirectory.
-    + Removed writerIncludeBefore & writerIncludeAfter (no
-      longer used with the new templating system).
-
-  * Added HTMLSlideVariant (Text.Pandoc.Parsing).
-
-  * Made KeyTable a map instead of an association list.
-    + This affects the RST and Markdown readers.
-    + The type for stateKeys in ParserState has also changed.
-    + Pandoc, Meta, Inline, and Block have been given Ord instances.
-    + Reference keys now have a type of their own (Key), with its
-      own Ord instance for case-insensitive comparison.
-
-  * Moved headerShift from pandoc.hs to Text.Pandoc.Shared.
-
-  * Moved parsing functions from Text.Pandoc.Shared to new module,
-    Text.Pandoc.Parsing.
-
-  * Added amssymb to default latex template.
-    Resolves github Issue 1.
-
-  * Use default highlighting CSS rather than embedding CSS in templates.
-
-  * Updated pandoc to use highlighting-kate 0.2.7.
-    NOTE: Update any custom CSS or templates accordingly.
-
-  * Improved handling of code in man writer.
-    + Inline code is now in monoscpace, not bold.
-    + Code blocks now use .nf (no fill) and .IP (indented paragraph).
-    + Resolves Issue #247.
-
-  * HTML reader: parse <tt> as Code.  Partially resolves Issue #247.
-
-  * HTML writer:
-    + Made inclusion of date meta tag conditional.
-    + Put insert-before text before the title h1 in HTML.
-      This is the documented behavior; the insert-before text
-      comes after the <body> tag.  Resolves Issue #241.
-
-  * Add bird tracks to lhs in HTML when compiled wo -fhighlighting.
-    Resolves Issue #242. Previously the bird tracks would be stripped
-    off when pandoc was not compiled with highlighting support, even if
-    -t html+lhs was specified. Thanks to Nicholas Wu for pointing out
-    the problem.
-
-  * Don't allow colon in autogenerated XML/HTML identifiers.
-    They have a special meaning in XML (e.g. in EPUB).
-
-  * LaTeX reader:
-    + Made latex \section, \chapter parsers more forgiving of whitespace.
-    + Added stateHasChapters to ParserState.
-    + Parse \chapter{} in latex. If a \chapter command is encountered,
-      this is set to True and subsequent \section commands (etc.) will
-      be bumped up one level.
-    + Changed rawLaTeXInline to accept '\section', '\begin', etc.
-    + Use new rawLaTeXInline' in LaTeX reader, and export rawLaTeXInline
-      for use in markdown reader.
-    + Fixes bug wherein '\section{foo}' was not recognized as raw TeX
-      in markdown document.
-
-  * LaTeX writer: Give images a maximum width using the prelude only.
-
-  * Plain, markdown, RST writers: Use unicode for smart punctuation.
-
-  * Man writer: convert math to unicode when possible, as in other
-    writers.
-
-  * Allow markdown2pdf to recognize citeproc options.
-
-  * Use explicit imports from Data.Generics. Otherwise we have a
-    conflict with the 'empty' symbol, introduced in syb >= 0.2. Thanks
-    to ddssff for pointing out the problem. Resolves Issue #237.
-
-  * Convert command-line arguments to UTF8.  Resolves Issue #234.
-
-  * Use texmath's parser in TexMath module.
-    + This replaces a lot of custom parser code, and expands
-      the tex -> unicode conversion.
-    + The behavior has also changed: if the whole formula can't
-      be converted, the whole formula is left in raw TeX.
-    + Previously, pandoc converted parts of the formula to unicode
-      and left other parts in raw TeX.
-    + Added (but not yet exported) readTeXMath', which returns a Maybe.
-    + Updated tests
-
-  * In parsing smart quotes, leave unicode curly quotes alone.
-    Resolves Issue #143.
-
-  * Removed obsolete markdown2pdf script.
-
-  * Removed parsec < 3 restriction.
-
-  * Require texmath >= 0.3, highlighting-kate >= 0.2.7.1.
-
-  * Added 'threaded' cabal flag.
-    + GHC lacks a threaded runtime on some architectures.
-      Provide a 'threaded' flag that can be disabled for compiling
-      on these architectures.
-    + Removed '-threaded' from pandoc's ghc-options.  '-threaded'
-      is only needed for markdown2pdf, due to its use of readProcess.
+  * New EPUB and HTML Slidy writers. (Issue #122)
+
+      - EPUB is a standard ebook format, used in Apple's iBooks for
+        the iPad and iPhone, Barnes and Noble's nook reader, the Sony
+        reader, and many other devices.
+      - Slidy, like S5, is a system for producing HTML+javascript slide
+        shows.
+
+  * All input is assumed to be UTF-8, no matter what the locale and ghc
+    version, and all output is UTF-8. This reverts to pre-1.5 behavior.
+    Also, a BOM, if present, is stripped from the input.
+
+  * Markdown now supports grid tables, whose cells can contain
+    arbitrary block elements. (Issue #43)
+
+  * Sequentially numbered example lists in markdown with `@` marker.
+
+  * Markdown table captions can begin with a bare colon and no longer need
+    to include the English word "table." Also, a caption can now occur
+    either before or after the table. (Issue #227)
+
+  * New command-line options:
+
+      - `--epub-stylesheet` allows you to specify a CSS file that will
+        be used to style your ebook.
+      - `--epub-metadata` allows you to specify metadata for the ebook.
+      - `--offline` causes the generated HTML slideshow to include all
+        needed scripts and stylesheets.
+      - `--webtex` causes TeX math to be converted to images using the
+        Google Charts API (unless a different URL is specified).
+      - `--section-divs` causes div tags to be added around each section
+        in an HTML document. (Issue #230, 239)
+
+  * Default behavior of S5 writer in standalone mode has changed:
+    previously, it would include all needed scripts and stylesheets
+    in the generated HTML; now, only links are included unless
+    the `--offline` option is used.
+
+  * Default behavior of HTML writer has changed. Between 1.2 and 1.5,
+    pandoc would enclose sections in div tags with identifiers on the
+    div tags, so that the sections can be manipulated in javascript.
+    This caused undesirable interactions with raw HTML div tags. So,
+    starting with 1.6, the default is to put the identifiers directly
+    on the header tags, and not to include the divs.  The `--section-divs`
+    option selects the 1.2-1.5 behavior.
+
+  * API changes:
+
+      - `HTMLMathMethod`: Added `WebTeX`, removed `MimeTeX`.
+      - `WriterOptions`: Added `writerUserDataDir`, `writerSourceDirectory`,
+        `writerEPUBMetadata` fields. Removed `writerIncludeBefore`,
+        `writerIncludeAfter`.
+      - Added `headerShift` to `Text.Pandoc.Shared`.
+      - Moved parsing code and `ParserState` from `Text.Pandoc.Shared`
+        to a new module, `Text.Pandoc.Parsing`.
+      - Added `stateHasChapters` to `ParserState`.
+      - Added `HTMLSlideVariant`.
+      - Made `KeyTable` a map instead of an association list.
+      - Added accessors for `Meta` fields (`docTitle`, `docAuthors`,
+        `docDate`).
+      - `Pandoc`, `Meta`, `Inline`, and `Block` have been given `Ord`
+        instances.
+      - Reference keys now have a type of their own (`Key`), with its
+        own `Ord` instance for case-insensitive comparison.
+      - Added `Text.Pandoc.Writers.EPUB`.
+      - Added `Text.Pandoc.UUID`.
+      - Removed `Text.Pandoc.ODT`, added `Text.Pandoc.Writers.ODT`.
+        Removed `saveOpenDocumentAsODT`, added `writeODT`.
+      - Added `Text.Pandoc.Writers.Native` and `writeNative`.
+        Removed `prettyPandoc`.
+      - Added `Text.Pandoc.UTF8` for portable UTF8 string IO.
+      - Removed `Text.Pandoc.Writers.S5` and the `writeS5` function.
+        Moved `s5Includes` to a new module, `Text.Pandoc.S5`.
+        To write S5, you now use `writeHtml` with `writerSlideVariant`
+        set to `S5Slides` or `SlidySlides`.
+
+  * Template changes.  If you use custom templates, please update them,
+    particularly if you use syntax highlighting with pandoc. The old HTML
+    templates hardcoded highlighting CSS that will no longer work with
+    the most recent version of highlighting-kate.
+
+      - HTML template: avoid empty meta tag if no date.
+      - HTML template: Use default highlighting CSS from highlighting-kate
+        instead of hard-coding the CSS into the template.
+      - HTML template: insert-before text goes before the title, and
+        immediately after the <body> tag, as documented. (Issue #241)
+      - Added slidy and s5 templates.
+      - Added amssymb to preamble of latex template. (github Issue 1)
+
+  * Removed excess newlines at the end of output. Note: because output
+    will not contain an extra newline, you may need to make adjustments
+    if you are inserting pandoc's output into a template.
+
+  * In S5 and slidy, horizontal rules now cause a new slide, so you
+    are no longer limited to one slide per section.
+
+  * Improved handling of code in man writer. Inline code is now monospace,
+    not bold, and code blocks now use .nf (no fill) and .IP (indented para).
+
+  * HTML reader parses `<tt>` as Code. (Issue #247)
+
+  * html+lhs output now contains bird tracks, even when compiled without
+    highlighting support. (Issue #242)
+
+  * Colons are now no longer allowed in autogenerated XML/HTML identifiers,
+    since they have a special meaning in XML.
+
+  * Code improvements in ODT writer.  Remote images are now replaced with
+    their alt text rather than a broken link.
+
+  * LaTeX reader improvements:
+
+      - Made latex `\section`, `\chapter` parsers more forgiving of
+        whitespace.
+      - Parse `\chapter{}` in latex.
+      - Changed `rawLaTeXInline` to accept `\section`, `\begin`, etc.
+      - Use new `rawLaTeXInline'` in LaTeX reader, and export `rawLaTeXInline`
+        for use in markdown reader.
+      - Fixes bug wherein `\section{foo}` was not recognized as raw TeX
+        in markdown document.
+
+  * LaTeX writer:  images are automatically shrunk if they would extend
+    beyond the page margin.
+
+  * Plain, markdown, RST writers now use unicode for smart punctuation.
+
+  * Man writer converts math to unicode when possible, as in other writers.
+
+  * `markdown2pdf` can now recognize citeproc options.
+
+  * Command-line arguments are converted to UTF-8. (Issue #234)
+
+  * `Text.Pandoc.TeXMath` has been rewritten to use texmath's parser.
+    This allows it to handle a wider range of formulas. Also, if a formula
+    cannot be converted, it is left in raw TeX; formulas are no longer
+    partially converted.
+
+  * Unicode curly quotes are left alone when parsing smart quotes. (Issue
+    #143)
+
+  * Cabal file changes:
+
+      - Removed parsec < 3 restriction.
+      - Added 'threaded' flag for architectures where GHC lacks a threaded
+        runtime.
+      - Use 'threaded' only for markdown2pdf; it is not needed for pandoc.
+      - Require highlighting-kate 0.2.7.
+
+  * Use explicit imports from `Data.Generics`. Otherwise we have a
+    conflict with the 'empty' symbol, introduced in syb >= 0.2. (Issue #237)
+
+  * New data files:  slidy/slidy.min.js, slidy/slidy.min.css, epub.css.
 
 pandoc (1.5.1.1)
 
@@ -208,9 +173,9 @@ pandoc (1.5.1)
       parsed text and the escaped URI (in the latter case, with
       the mailto: prefix).
     + HTML reader: unsanitaryURI has been modified to allow unicode
-		  high characters in a URI.
+      high characters in a URI.
     + Readers:  All link and image URIs are now escaped using
-		  escapeURI.
+      escapeURI.
     + Markdown and RST writers:  unescapeURI is used so that URIs
       in these formats are human-readable.
 
diff --git a/relann1.6 b/relann1.6
index 2574098e3..38911ab15 100644
--- a/relann1.6
+++ b/relann1.6
@@ -7,266 +7,163 @@ also use 'cabal install' to get the latest version from HackageDB:
     cabal update
     cabal install pandoc
 
-Here is a summary of the major changes in this version.
-
-New writers
------------
-
-Two new output formats are supported: [EPUB] and [Slidy].
-
-EPUB is a standard ebook format, used in Apple's iBooks for the iPad
-and iPhone, Barnes and Noble's nook reader, the Sony reader, and many
-other devices, and by online ebook readers like [bookworm]. (Amazon's
-Kindle uses a different format, MobiPocket, but EPUB books can easily be
-converted to Kindle format.) Now you can write your book in markdown and
-produce an ebook with a single command!  I've put up a short
-[tutorial here].
-
-Slidy, like S5, is a system for producing HTML+javascript slide shows.
-
-[EPUB]: http://en.wikipedia.org/wiki/EPUB
-[Slidy]: http://www.w3.org/Talks/Tools/Slidy
-[bookworm]: http://bookworm.oreilly.com/
-[tutorial here]: http://johnmacfarlane.net/pandoc/epub.html
-
-New Command-line Options
-------------------------
-
-For EPUB output:
-
-  * `--epub-stylesheet` allows you to specify a CSS file that will
-    be used to style your ebook.
-
-  * `--epub-metadata` allows you to specify a file containing metadata
-    besides the title and authors, which are automatically included.
-
-For Slidy and S5 output:
-
-  * `--offline` causes the javascript and stylesheets needed for
-    S5 or Slidy slide shows to be included directly in the generated
-    HTML.  (By default, only links are included.)
-
-Note that this option goes with a change in the default behavior of the
-S5 writer, which used to include the javascript and stylesheets whenever
-`--standalone` was specified. If you are relying on pandoc to produce a
-self-contained slide show, you should specify `--offline`.
-
-For HTML output:
-
-  * `--webtex` causes TeX math to be converted to images using the Google
-    Charts API (unless a different URL is specified). (Thanks to
-    lpeterse.)
-
-  * Added `--section-divs` option. Causes div tags to be added around
-    each section in an HTML document.
-
-This last change requires a bit of explanation. Before version 1.2,
-pandoc would put section identifiers directly on headers:
-
-    <h1 id="my-section">My Section</h1>
-    ...blah blah...
-
-Someone wanted to be able to manipulate whole sections in javascript,
-so, starting with 1.2, I changed pandoc to put sections inside divs,
-with the identifiers on the divs:
-
-    <div id="my-section">
-      <h1>My Section</h1>
-      ...blah blah...
-    </div>
-
-Recently several people have pointed out to me that the divs can
-produce bad interaction effects when combined with raw HTML.
-http://code.google.com/p/pandoc/issues/detail?id=230
-
-So in 1.6, I have reverted to the old behavior (no divs, identifiers
-directly on section headers) as a default, adding a `--section-divs`
-option that will select the 1.2-1.5 behavior, with divs around sections
-and identifiers on the divs.
-
-Markdown extensions
--------------------
-
-You can now use "grid tables" in markdown. (Most of the code
-is from Eric Kowey's grid tables patch to the RST reader, from
-the last release.)
-
-Table captions need no longer begin with the English word
-`Table:`, a bare colon is sufficient. Also, captions may appear
-above a table instead of below it.
-
-A new type of list marker, `@`, has been added.  A list with items
-numbered `@` is sequentially numbered, like a list with items numbered
-`#`. The difference is that with `@`, the number sequence continues
-across a list boundary. `@` list items may also be labeled and referred
-to elsewhere in the document. An example will illustrate their use:
-
-    Here is my first list:
-
-    (@) first example, numbered 1
-    (@) second example, numeber 2
-
-    Some commentary here.
-
-    (@) third example, numbered 3
-    (@special) fourth example, numbered 4
-    (@) fifth example, numbered 5
-
-    Some commentary about (@special) (will appear as 4).
-
-This feature allows easy construction of a running list of
-sequentially numbered examples. For documentation, see README under
-"Numbered examples."
-
-API Changes
------------
-
-There are quite a few API changes in this release.  If you use pandoc
-as a library, please review these carefully.
-
-  * Text.Pandoc.Shared:
-    + HTMLMathMethod:  Added WebTeX, removed MimeTeX. (WebTeX is
-      generic enough to subsume MimeTeX.)
-    + WriterOptions: Added writerUserDataDir, writerSourceDirectory,
-      writerEPUBMetadata fields. Removed unused fields
-      writerIncludeBefore, writerIncludeAfter.
-    + Moved all the parsing-related functions and definitions
-      to a new module, Text.Pandoc.Parsing.
-    + Moved headerShift from pandoc.hs.
-
-  * New module, Text.Pandoc.Parsing, for shared parsing functions
-    and ParserState.
-    + Added HTMLSlideVariant.
-    + Made KeyTable a map instead of an association list.
-      This affects the RST and Markdown readers.
-    + The type for stateKeys in ParserState has changed.
-
-  * Text.Pandoc.Definition:
-    + Pandoc, Meta, Inline, and Block have been given Ord instances.
-    + Reference keys now have a type of their own (Key), with its
-      own Ord instance for case-insensitive comparison.
-
-  * New module, Text.Pandoc.Writers.EPUB.
-
-  * New utility module, Text.Pandoc.UUID, for generating random UUIDs for
-    EPUBs.
-
-  * Removed Text.Pandoc.ODT, added Text.Pandoc.Writers.ODT.
-    Instead of saveOpenDocumentAsODT, we now have writeODT, which takes
-    a Pandoc document and produces a bytestring. saveOpenDocumentAsODT
-    has been removed.
-
-  * Added Text.Pandoc.Writers.Native. This contains the prettyprinting
-    code from Text.Pandoc.Shared.  prettyPandoc has been removed;
-    use the new writeNative instead.
-
-  * Added Text.Pandoc.UTF8 for portable UTF8 string IO.
-
-  * Removed Text.Pandoc.Writers.S5 and writeS5 function.
-    Moved s5Includes to new module, Text.Pandoc.S5.
-    (Now S5 is handled in more or less the same way as slidy;
-    to write s5, you use writeHtml with writerSlideVariant set
-    to S5Slides or SlidySlides.)
-
-Template Changes
-----------------
-
-There have been some changes to the default templates; please update
-your templates.
-
-  * HTML template: avoid empty meta tag if no date.
-
-  * Added S5 and Slidy templates.
-
-  * Added amssymb to the preamble in the default latex template.
-
-  * Use default highlighting CSS rather than embedding CSS in templates.
-    Note: if you use an older template, you'll have the wrong CSS for
-    recent versions of highlighting-kate.
-
-Other Changes
--------------
-
-  * All input is assumed to be UTF-8, and all output is UTF-8. Pandoc no
-    longer respects locale, even when compiled by GHC 6.12.
-
-  * Made spacing at end of output more consistent. Previously some
-    of the writers added spurious whitespace. This has been removed.
-    Note: If your application combines pandoc's output with other
-    text, for example in a template, you may need to add spacing.
-    For example, a pandoc-generated markdown file will not have
-    a blank line after the final block element.  If you are inserting
-    it into another markdown file, you will need to make sure there
-    is a blank line between it and the next block element.
-
-  * In S5 (and Slidy), horizontal rules now cause a "slide break,"
-    so you are no longer limited to one slide per level-one
-    section.
-
-  * Improved handling of code in man writer.
-    + Inline code is now in monoscpace, not bold.
-    + Code blocks now use .nf (no fill) and .IP (indented paragraph).
-
-  * HTML reader: parse <tt> as Code.
-
-  * HTML writer: Put insert-before text before the title h1 in HTML.
-    This is the documented behavior; the insert-before text
-    comes after the <body> tag.
-
-  * Add bird tracks to lhs in HTML when compiled wo -fhighlighting.
-    Previously the bird tracks would be stripped off when pandoc was
-    not compiled with highlighting support, even if -t html+lhs was
-    specified. Thanks to Nicholas Wu for pointing out the problem.
-
-  * Don't allow colon in autogenerated XML/HTML identifiers.
-    They have a special meaning in XML (e.g. in EPUB).
-
-  * LaTeX reader:
-    + Made latex \section, \chapter parsers more forgiving of whitespace.
-    + Added stateHasChapters to ParserState.
-    + Parse \chapter{} in latex. If a \chapter command is encountered,
-      this is set to True and subsequent \section commands (etc.) will
-      be bumped up one level.
-    + Changed rawLaTeXInline to accept '\section', '\begin', etc.
-    + Use new rawLaTeXInline' in LaTeX reader, and export rawLaTeXInline
+Thanks to everyone who contributed, either by filing bug reports or by
+contributing patches. Here is a summary of the major changes in this
+version:
+
++ New EPUB and HTML Slidy writers. (Issue #122)
+
+    - [EPUB] is a standard ebook format, used in Apple's iBooks for
+      the iPad and iPhone, Barnes and Noble's nook reader, the Sony
+      reader, and many other devices, and by online ebook readers like
+      [bookworm]. (Amazon's Kindle uses a different format, MobiPocket,
+      but EPUB books can easily be converted to Kindle format.) Now you
+      can write your book in markdown and produce an ebook with a single
+      command! I've put up a short [tutorial here].
+    - [Slidy], like S5, is a system for producing HTML+javascript slide shows.
+
++ All input is assumed to be UTF-8, no matter what the locale and ghc
+  version, and all output is UTF-8. This reverts to pre-1.5 behavior.
+  Also, a BOM, if present, is stripped from the input.
+
++ Markdown now supports grid tables, whose cells can contain
+  arbitrary block elements. (Issue #43)
+
++ Sequentially numbered example lists in markdown with `@` marker.
+
++ Markdown table captions can begin with a bare colon and no longer need
+  to include the English word "table." Also, a caption can now occur
+  either before or after the table. (Issue #227)
+
++ New command-line options:
+
+    - `--epub-stylesheet` allows you to specify a CSS file that will
+      be used to style your ebook.
+    - `--epub-metadata` allows you to specify metadata for the ebook.
+    - `--offline` causes the generated HTML slideshow to include all
+      needed scripts and stylesheets.
+    - `--webtex` causes TeX math to be converted to images using the
+      Google Charts API (unless a different URL is specified).
+    - `--section-divs` causes div tags to be added around each section
+      in an HTML document. (Issue #230, 239)
+
++ Default behavior of S5 writer in standalone mode has changed:
+  previously, it would include all needed scripts and stylesheets
+  in the generated HTML; now, only links are included unless
+  the `--offline` option is used.
+
++ Default behavior of HTML writer has changed. Between 1.2 and 1.5,
+  pandoc would enclose sections in div tags with identifiers on the
+  div tags, so that the sections can be manipulated in javascript.
+  This caused undesirable interactions with raw HTML div tags. So,
+  starting with 1.6, the default is to put the identifiers directly
+  on the header tags, and not to include the divs.  The `--section-divs`
+  option selects the 1.2-1.5 behavior.
+
++ API changes:
+
+    - `HTMLMathMethod`: Added `WebTeX`, removed `MimeTeX`.
+    - `WriterOptions`: Added `writerUserDataDir`, `writerSourceDirectory`,
+      `writerEPUBMetadata` fields. Removed `writerIncludeBefore`,
+      `writerIncludeAfter`.
+    - Added `headerShift` to `Text.Pandoc.Shared`.
+    - Moved parsing code and `ParserState` from `Text.Pandoc.Shared`
+      to a new module, `Text.Pandoc.Parsing`.
+    - Added `stateHasChapters` to `ParserState`.
+    - Added `HTMLSlideVariant`.
+    - Made `KeyTable` a map instead of an association list.
+    - Added accessors for `Meta` fields (`docTitle`, `docAuthors`, `docDate`).
+    - `Pandoc`, `Meta`, `Inline`, and `Block` have been given `Ord` instances.
+    - Reference keys now have a type of their own (`Key`), with its
+      own `Ord` instance for case-insensitive comparison.
+    - Added `Text.Pandoc.Writers.EPUB`.
+    - Added `Text.Pandoc.UUID`.
+    - Removed `Text.Pandoc.ODT`, added `Text.Pandoc.Writers.ODT`.
+      Removed `saveOpenDocumentAsODT`, added `writeODT`.
+    - Added `Text.Pandoc.Writers.Native` and `writeNative`.
+      Removed `prettyPandoc`.
+    - Added `Text.Pandoc.UTF8` for portable UTF8 string IO.
+    - Removed `Text.Pandoc.Writers.S5` and the `writeS5` function.
+      Moved `s5Includes` to a new module, `Text.Pandoc.S5`.
+      To write S5, you now use `writeHtml` with `writerSlideVariant`
+      set to `S5Slides` or `SlidySlides`.
+
++ Template changes.  If you use custom templates, please update them,
+  particularly if you use syntax highlighting with pandoc. The old HTML
+  templates hardcoded highlighting CSS that will no longer work with
+  the most recent version of highlighting-kate.
+
+    - HTML template: avoid empty meta tag if no date.
+    - HTML template: Use default highlighting CSS from highlighting-kate
+      instead of hard-coding the CSS into the template.
+    - HTML template: insert-before text goes before the title, and
+      immediately after the <body> tag, as documented. (Issue #241)
+    - Added slidy and s5 templates.
+    - Added amssymb to preamble of latex template. (github Issue 1)
+
++ Removed excess newlines at the end of output. Note: because output
+  will not contain an extra newline, you may need to make adjustments
+  if you are inserting pandoc's output into a template.
+
++ In S5 and slidy, horizontal rules now cause a new slide, so you
+  are no longer limited to one slide per section.
+
++ Improved handling of code in man writer. Inline code is now monospace,
+  not bold, and code blocks now use .nf (no fill) and .IP (indented para).
+
++ HTML reader parses `<tt>` as Code. (Issue #247)
+
++ html+lhs output now contains bird tracks, even when compiled without
+  highlighting support. (Issue #242)
+
++ Colons are now no longer allowed in autogenerated XML/HTML identifiers,
+  since they have a special meaning in XML.
+
++ Code improvements in ODT writer.  Remote images are now replaced with
+  their alt text rather than a broken link.
+
++ LaTeX reader improvements:
+    - Made latex `\section`, `\chapter` parsers more forgiving of whitespace.
+    - Parse `\chapter{}` in latex.
+    - Changed `rawLaTeXInline` to accept `\section`, `\begin`, etc.
+    - Use new `rawLaTeXInline'` in LaTeX reader, and export `rawLaTeXInline`
       for use in markdown reader.
-    + Fixes bug wherein '\section{foo}' was not recognized as raw TeX
+    - Fixes bug wherein `\section{foo}` was not recognized as raw TeX
       in markdown document.
 
-  * LaTeX writer: Give images a maximum width using the prelude only.
++ LaTeX writer:  images are automatically shrunk if they would extend
+  beyond the page margin.
 
-  * Plain, markdown, RST writers: Use unicode for smart punctuation.
++ Plain, markdown, RST writers now use unicode for smart punctuation.
 
-  * Man writer: convert math to unicode when possible, as in other
-    writers.
++ Man writer converts math to unicode when possible, as in other writers.
 
-  * Allow markdown2pdf to recognize citeproc options.
++ `markdown2pdf` can now recognize citeproc options.
 
-  * Convert command-line arguments to UTF8.
++ Command-line arguments are converted to UTF-8. (Issue #234)
 
-  * Use texmath's parser in TexMath module. This replaces a lot of
-    custom parser code, and expands the tex -> unicode conversion. The
-    behavior has also changed: if the whole formula can't be converted,
-    the whole formula is left in raw TeX. Previously, pandoc converted
-    parts of the formula to unicode and left other parts in raw TeX.
++ `Text.Pandoc.TeXMath` has been rewritten to use texmath's parser.
+  This allows it to handle a wider range of formulas. Also, if a formula
+  cannot be converted, it is left in raw TeX; formulas are no longer
+  partially converted.
 
-  * In parsing smart quotes, leave unicode curly quotes alone.
++ Unicode curly quotes are left alone when parsing smart quotes. (Issue #143)
 
-  * Removed obsolete markdown2pdf script.
++ Cabal file changes:
 
-  * Removed parsec < 3 restriction.
+    - Removed parsec < 3 restriction.
+    - Added 'threaded' flag for architectures where GHC lacks a threaded
+      runtime.
+    - Use 'threaded' only for markdown2pdf; it is not needed for pandoc.
+    - Require highlighting-kate 0.2.7.
 
-  * ODT: Handle the case where the image is remote (or not found) by
-    converting the Image element into an Emph with the label.
++ Use explicit imports from `Data.Generics`. Otherwise we have a
+  conflict with the 'empty' symbol, introduced in syb >= 0.2. (Issue #237)
 
-  * Added 'threaded' cabal flag.
-    + GHC lacks a threaded runtime on some architectures.
-      Provide a 'threaded' flag that can be disabled for compiling
-      on these architectures.
-    + Removed '-threaded' from pandoc's ghc-options.  '-threaded'
-      is only needed for markdown2pdf, due to its use of readProcess.
++ New data files:  slidy/slidy.min.js, slidy/slidy.min.css, epub.css.
 
-  * Modified readFile and getContents to strip BOM if present.
-
-  * Updated pandoc to use highlighting-kate 0.2.7.
+[EPUB]: http://en.wikipedia.org/wiki/EPUB
+[Slidy]: http://www.w3.org/Talks/Tools/Slidy
+[bookworm]: http://bookworm.oreilly.com/
+[tutorial here]: http://johnmacfarlane.net/pandoc/epub.html