Update changelog.

1 files changed, 258 insertions, 0 deletions

diff --git a/changelog b/changelog
index 1403b881e..09731d1ea 100644
--- a/changelog
+++ b/changelog
@@ -1,3 +1,261 @@
+pandoc (1.19)
+
+  * Changed resolution of filter paths.
+
+    + We now first treat the argument of `--filter` as a full (absolute
+      or relative) path, looking for a program there.  If it's found,
+      we run it.
+    + If not, and if it is a simple program name or a relative path,
+      we try resolving it relative to `$DATADIR/filters`.
+    + If this fails, then we treat it as a program name and look in
+      the user's PATH.
+    + Removed a hardcoded '/' that may have caused problems with Windows
+      paths.
+
+    Previously if you did `--filter foo` and you had `foo` in your
+    path and also an executable `foo` in your working directory,
+    the one in the path would be used. Now the one in the working
+    directory is used.
+
+    In addition, when you do `--filter foo/bar.hs`, pandoc will now
+    find a filter `$DATADIR/filters/foo/bar.hs` -- assuming there
+    isn't a `foo/bar.hs` relative to the working directory.
+
+  * Allow `file://` URIs as arguments (#3196).  Also improved default reader
+    format detection.  Previously with a URI ending in .md or .markdown,
+    pandoc would assume HTML input.  Now it treats these as markdown.
+
+  * Allow to overwrite top-level division type heuristics (#3258,
+    Albert Krewinkel).  Pandoc uses heuristics to determine the most
+    reasonable top-level division type when emitting LaTeX or Docbook markup.
+    It is now possible to overwrite this implicitly set top-level division
+    via the `top-level-division` command line parameter.
+
+  * Text.Pandoc.Options [API change] (#3197): The type of the
+    `writerTopLevelDivision` field in of the `WriterOptions` data type is
+    altered from `Division` to `Maybe Division`. The field's default value
+    is changed from `Section` to `Nothing`.
+
+  * Improved error if they give wrong arg to `--top-level-division`.
+
+  * DocBook reader: Fixed xref lookup (#3243).
+    It previously only worked when the qnames lacked the docbook
+    namespace URI.
+
+  * HTML reader:
+
+    + Improved table parsing (#3027).  We now check explicitly for non-1
+      rowspan or colspan attributes, and fail when we encounter them.
+      Previously we checked that each row had the same number of cells,
+      but that could be true even with rowspans/colspans.
+      And there are cases where it isn't true in tables that
+      we can handle fine -- e.g. when a tr element is empty.
+      So now we just pad rows with empty cells when needed.
+    + Treat `<math>` as MathML by default unless something else
+      is explicitly specified in xmlns.  Provided it parses as MathML,
+      of course.  Also fixed default which should be to inline math if no
+      display attribute is used.
+    + Only treat "a" element as link if it has href (#3226).  Otherwise
+      treat as span.
+
+  * Docx reader (Jesse Rosenthal):
+
+    + Add a placeholder value for CHART.  We wrap `[CHART]` in a
+      `<span class="chart">`. Note that it maps to inlines because, in docx,
+      anything in a drawing tag can be part of a larger paragraph.
+    + Be more specific in parsing images We not only want `w:drawing`,
+      because that could also include charts. Now we specify
+      `w:drawing/pic:pic`. This shouldn't change behavior at all, but it's
+      a first step toward allowing other sorts of drawing data as well.
+    + Abstract out function to avoid code repetition.
+    + Update tests for img title and alt (#3204).
+    + Handle Alt text and titles in images.  We use the "description" field
+      as alt text and the "title" field as title. These can be accessed
+      through the "Format Picture" dialog in Word.
+    + Docx reader utils: handle empty namespace in `elemName`.
+      Previously, if given an empty namespace `(elemName ns "" "foo")`
+      `elemName` would output a QName with a `Just ""` namespace. This is
+      never what we want. Now we output a `Nothing`. If someone *does* want a
+      `Just ""` in the namespace, they can enter the QName value explicitly.
+
+  * ODT reader/writer:
+
+    + Inline code when text has a special style (Hubert Plociniczak).  When
+      a piece of text has a text `Source_Text` then we assume that this is a
+      piece of the document that represents a code that needs to be inlined.
+      Adapted the writer to also reflect that change. Previously it was just
+      writing a 'preformatted' text using a non-distinguishable font style.
+      Code blocks are still not recognized by the ODT reader.  That's a
+      separate issue.
+    + Infer table's caption from the paragraph (#3224, Hubert Plociniczak).
+      ODT's reader always put empty captions for the parsed tables. This commit
+
+      1. checks paragraphs that follow the table definition
+      2. treats specially a paragraph with a style named 'Table'
+      3. does some postprocessing of the paragraphs that combines
+         tables followed immediately by captions
+
+      The ODT writer used the `TableCaption` style for the caption
+      paragraph. This commit follows the OpenOffice approach which
+      allows for appending captions to table but uses a built-in style
+      named `Table` instead of `TableCaption`. Users of a custom
+      `reference.odt` should change the style's name from `TableCaption`
+      to `Table`.
+
+  * ODT reader: Infer tables' header props from rows (#3199, Hubert
+    Plociniczak).  ODT reader simply provided an empty header list
+    which meant that the contents of the whole table, even if not empty,
+    was simply ignored.  While we still do not infer headers we at least
+    have to provide default properties of columns.
+
+  * Markdown reader:
+
+    + Allow reference link labels starting with `@...` if `citations`
+      extension disabled (#3209).  Example:  in
+
+        [link text][@a]
+
+        [@a]: url
+
+    `link text` isn't hyperlinked because `[@a]` is parsed as a citation.
+    Previously this happened whether or not the `citations` extension was
+    enabled. Now it happens only if the `citations` extension is enabled.
+    + Allow alignments to be specified in Markdown grid tables.  For example,
+
+         +---------------+---------------+--------------------+
+         | Right         | Left          | Centered           |
+         +==============:+:==============+:==================:+
+         | Bananas       | $1.34         | built-in wrapper   |
+         +---------------+---------------+--------------------+
+
+    + Allow Small Caps elements to be created using bracketed spans
+      (as they already can be using HTML-syntax spans) (#3191, Kolen Cheung).
+
+  * LaTeX reader:
+
+    + Don't treat `\vspace` and `\hspace` as block commands (#3256).
+      Fixed an error which came up, for example, with `\vspace`
+      inside a caption.  (Captions expect inlines.)
+    + Improved table handling.  We can now parse all of the tables emitted
+      by pandoc in our tests.  The only thing we don't get yet are
+      alignments and column widths in more complex tables.  See #2669.
+    + Limited support for minipage.
+    + Allow for `[]`s inside LaTeX optional args.  Fixes cases like:
+
+        \begin{center}
+        \begin{tikzpicture}[baseline={([yshift=+-.5ex]current bounding box.center)}, level distance=24pt]
+        \Tree [.{S} [.NP John\index{i} ] [.VP [.V likes ] [.NP himself\index{i,*j} ]]]
+        \end{tikzpicture}
+        \end{center}
+    + Handle BVerbatim from fancyvrb (#3203).
+    + Handle hungarumlaut (#3201).
+    + Allow beamer-style `<...>` options in raw LaTeX (also in Markdown)
+      (#3184).  This allows use of things like `\only<2,3>{my content}` in
+      Markdown that is going to be converted to beamer.
+
+  * Use pre-wrap for code in dzslides template (Nicolas Porcel).
+    Otherwise overly long code will appear on every slide.
+
+  * Org reader (Albert Krewinkel):
+
+    + Respect column width settings (#3246).  Table column properties can
+      optionally specify a column's width with which it is displayed in
+      the buffer. Some exporters, notably the ODT exporter in org-mode v9.0,
+      use these values to calculate relative column widths. The org reader now
+      implements the same behavior.  Note that the org-mode LaTeX and HTML
+      exporters in Emacs don't support this feature yet, which should be kept
+      in mind by users who use the column widths parameters.
+    + Allow HTML attribs on non-figure images (#3222).  Images which are the
+      only element in a paragraph can still be given HTML attributes, even if
+      the image does not have a caption and is hence not a figure.
+      The following will add set the `width` attribute of the image to `50%`:
+
+        #+ATTR_HTML: :width 50%
+        [[file:image.jpg]]
+
+    + Support `ATTR_HTML` for special blocks (#3182).
+      Special blocks (i.e. blocks with unrecognized names) can be prefixed
+      with an `ATTR_HTML` block attribute.  The attributes defined in that
+      meta-directive are added to the `Div` which is used to represent the
+      special block.
+    + Support the `todo` export option.  The `todo` export option allows to
+      toggle the inclusion of TODO keywords in the output.  Setting this to
+      `nil` causes TODO keywords to be dropped from headlines.  The default
+      is to include the keywords.
+    + Add support for todo-markers.  Headlines can have optional todo-markers
+      which can be controlled via the `#+TODO`, `#+SEQ_TODO`, or `#+TYP_TODO`
+      meta directive.  Multiple such directives can be given, each adding a
+      new set of recognized todo-markers.  If no custom todo-markers are
+      defined, the default `TODO` and `DONE` markers are used.  Todo-markers
+      are conceptually separate from headline text and are hence excluded
+      when autogenerating headline IDs.  The markers are rendered as spans
+      and labelled with two classes: One class is the markers name, the other
+      signals the todo-state of the marker (either `todo` or `done`).
+
+  * LaTeX writer:
+
+    + Use `\autocites*` when "suppress-author" citation used.
+    + Ensure that simple tables have simple cells (#2666).  If cells contain
+      more than a single Plain or Para, then we need to set nonzero widths
+      and put contents into minipages.
+    + Remove invalid inlines in sections (#3218, Hubert Plociniczak).
+
+  * Markdown writer:
+
+    + Fix calculation of column widths for aligned multiline tables
+      (#1911, Björn Peemöller).  This also fixes excessive CPU and memory
+      usage for tables when `--columns` is set in such a way that cells
+      must be very tiny.  Now cells are guaranteed to be big enough so that
+      single words don't need to line break, even if this pushes the
+      line length above the column width.
+    + Use bracketed form for native spans when `bracketed_spans`
+      enabled (#3229).
+    + Fixed inconsistent spacing issue (#3232).  Previously a tight bullet
+      sublist got rendered with a blank line after, while a tight ordered
+      sublist did not.  Now we don't get the blank line in either case.
+    + Fix escaping of spaces in super/subscript (#3225).  Previously two
+      backslashes were inserted, which gave a literal backslash.
+    + Adjust widths in Markdown grid tables so that they match on round-trip.
+
+  * Docx writer:
+
+    + Give full detail when there are errors converting tex math.
+    + Handle title text in images (Jesse Rosenthal).  We already handled alt
+      text.  This just puts the image "title" into the docx "title" attr.
+    + Fixed XML markup for empty cells (#3238).  Previously the Compact
+      style wasn't being applied properly to empty cells.
+
+  * Text.Pandoc.Pretty:
+
+    + Fixed some bugs that caused blank lines in tables (#3251).
+      The bugs caused spurious blank lines in grid tables when we
+      had things like ``blankline $$ blankline``.
+    + Add exported function `minOffet` [API change] (Björn Peemöller).
+    + Added error message for illegal call to `block` (Björn Peemöller).
+
+  * Text.Pandoc.Shared: Put `warn` in MonadIO.
+
+  * Export Text.Pandoc.getDefaultExtensions [API change] (#3178).
+
+  * In --version, trap error in `getAppUserDataDirectory` (#3241).
+    This fixes a crash with `pandoc --version` on unusual systems with
+    no real user (e.g. SQL Server 2016).
+
+  * Added weigh-pandoc for memory usage diagnostics (#3169).
+
+  * Use correct mime types for woff and woff2 (#3228).
+
+  * Remove make_travis_yml.hs (#3235, Kolen Cheung).
+
+  * changelog:  Moved an item that was misplaced in the 1.17.2 section to
+    the 1.18 section where it belongs.
+
+  * CONTRIBUTING.md: minor change in wording and punctuation (#3252,
+    Kolen Cheung).
+
+  * Further revisions to manual for `--version` changes (#3244).
+
+
 pandoc (1.18)
 
   * Added `--list-input-formats`, `--list-output-formats`,