Sync long descriptions with upstream README: mention more supported file formats, clarify Markdown enhancements as optional, and slightly rephrase comparison with other Markdown parsers.

1 files changed, 48 insertions, 36 deletions

diff --git a/debian/control.in b/debian/control.in
index dcf880ea2..1b6a41626 100644
--- a/debian/control.in
+++ b/debian/control.in
@@ -17,20 +17,24 @@ Suggests: ${cdbs:Suggests}
 Description: general markup converter
  Pandoc is a Haskell library for converting from one markup format to
  another, and a command-line tool that uses this library. It can read
- markdown and (subsets of) reStructuredText, HTML, and LaTeX, and it
- can write plain text, markdown, reStructuredText, HTML, LaTeX, ConTeXt,
- DocBook, RTF, groff man pages, and S5 HTML slide shows.
+ markdown and (subsets of) reStructuredText, HTML, and LaTeX; and it can
+ write plain text, markdown, reStructuredText, HTML, LaTeX, ConTeXt,
+ RTF, DocBook XML, OpenDocument XML, ODT, GNU Texinfo, MediaWiki markup,
+ groff man pages, and S5 HTML slide shows.
  .
- Pandoc extends standard markdown syntax with footnotes, embedded LaTeX,
- tables, definition lists, and other features. A compatibility mode is
- provided for those who need a drop-in replacement for Markdown.pl.
+ Pandoc's enhanced version of markdown includes syntax for footnotes,
+ tables, flexible ordered lists, definition lists, delimited code
+ blocks, superscript, subscript, strikeout, title blocks, automatic
+ tables of contents, embedded LaTeX math, and markdown inside HTML block
+ elements.  (These enhancements can be disabled if a drop-in replacement
+ for `Markdown.pl` is desired.)
  .
- In contrast to existing tools for converting markdown to HTML, which
- use regex substitutions, pandoc has a modular design: it consists of a
- set of readers, which parse text in a given format and produce a native
- representation of the document, and a set of writers, which convert
- this native representation into a target format. Thus, adding an input
- or output format requires only adding a reader or writer.
+ In contrast to most existing tools for converting markdown to HTML,
+ which use regex substitutions, Pandoc has a modular design: it consists
+ of a set of readers, which parse text in a given format and produce a
+ native representation of the document, and a set of writers, which
+ convert this native representation into a target format. Thus, adding
+ an input or output format requires only adding a reader or writer.
  .
  This package contains the pandoc tool itself, and the wrapper script
  markdown2pdf for converting markdown documents to PDFs via LaTeX
@@ -44,20 +48,24 @@ Suggests: ${haskell:Suggests}
 Description: general markup converter
  Pandoc is a Haskell library for converting from one markup format to
  another, and a command-line tool that uses this library. It can read
- markdown and (subsets of) reStructuredText, HTML, and LaTeX, and it
- can write plain text, markdown, reStructuredText, HTML, LaTeX, ConTeXt,
- DocBook, RTF, groff man pages, and S5 HTML slide shows.
+ markdown and (subsets of) reStructuredText, HTML, and LaTeX; and it can
+ write plain text, markdown, reStructuredText, HTML, LaTeX, ConTeXt,
+ RTF, DocBook XML, OpenDocument XML, ODT, GNU Texinfo, MediaWiki markup,
+ groff man pages, and S5 HTML slide shows.
  .
- Pandoc extends standard markdown syntax with footnotes, embedded LaTeX,
- tables, definition lists, and other features. A compatibility mode is
- provided for those who need a drop-in replacement for Markdown.pl.
+ Pandoc's enhanced version of markdown includes syntax for footnotes,
+ tables, flexible ordered lists, definition lists, delimited code
+ blocks, superscript, subscript, strikeout, title blocks, automatic
+ tables of contents, embedded LaTeX math, and markdown inside HTML block
+ elements.  (These enhancements can be disabled if a drop-in replacement
+ for `Markdown.pl` is desired.)
  .
- In contrast to existing tools for converting markdown to HTML, which
- use regex substitutions, pandoc has a modular design: it consists of a
- set of readers, which parse text in a given format and produce a native
- representation of the document, and a set of writers, which convert
- this native representation into a target format. Thus, adding an input
- or output format requires only adding a reader or writer.
+ In contrast to most existing tools for converting markdown to HTML,
+ which use regex substitutions, Pandoc has a modular design: it consists
+ of a set of readers, which parse text in a given format and produce a
+ native representation of the document, and a set of writers, which
+ convert this native representation into a target format. Thus, adding
+ an input or output format requires only adding a reader or writer.
  .
  This package contains the libraries compiled for GHC 6.
 
@@ -68,19 +76,23 @@ Depends: ${misc:Depends}
 Description: general markup converter
  Pandoc is a Haskell library for converting from one markup format to
  another, and a command-line tool that uses this library. It can read
- markdown and (subsets of) reStructuredText, HTML, and LaTeX, and it
- can write plain text, markdown, reStructuredText, HTML, LaTeX, ConTeXt,
- DocBook, RTF, groff man pages, and S5 HTML slide shows.
+ markdown and (subsets of) reStructuredText, HTML, and LaTeX; and it can
+ write plain text, markdown, reStructuredText, HTML, LaTeX, ConTeXt,
+ RTF, DocBook XML, OpenDocument XML, ODT, GNU Texinfo, MediaWiki markup,
+ groff man pages, and S5 HTML slide shows.
  .
- Pandoc extends standard markdown syntax with footnotes, embedded LaTeX,
- tables, definition lists, and other features. A compatibility mode is
- provided for those who need a drop-in replacement for Markdown.pl.
+ Pandoc's enhanced version of markdown includes syntax for footnotes,
+ tables, flexible ordered lists, definition lists, delimited code
+ blocks, superscript, subscript, strikeout, title blocks, automatic
+ tables of contents, embedded LaTeX math, and markdown inside HTML block
+ elements.  (These enhancements can be disabled if a drop-in replacement
+ for `Markdown.pl` is desired.)
  .
- In contrast to existing tools for converting markdown to HTML, which
- use regex substitutions, pandoc has a modular design: it consists of a
- set of readers, which parse text in a given format and produce a native
- representation of the document, and a set of writers, which convert
- this native representation into a target format. Thus, adding an input
- or output format requires only adding a reader or writer.
+ In contrast to most existing tools for converting markdown to HTML,
+ which use regex substitutions, Pandoc has a modular design: it consists
+ of a set of readers, which parse text in a given format and produce a
+ native representation of the document, and a set of writers, which
+ convert this native representation into a target format. Thus, adding
+ an input or output format requires only adding a reader or writer.
  .
  This package contains the library documentation for Pandoc.