@@ -2,16 +2,41 @@ pandoc (0.4) UNRELEASED; urgency=low
3 [ John MacFarlane ]
3 [ John MacFarlane ]
5+ * Added two new output formats: groff man pages and ConTeXt. By
6+ default, output files with extensions ".ctx" and ".context" are
7+ assumed to be ConTeXt, and output files with single-digit extensions
8+ are assumed to be man pages.
5− * Added support for Markdown tables. Two kinds of tables are supported
10+ * Added support for tables (with a new Table block element). Two kinds
6− (a simple table with one-line rows, and a more complex variety with
11+ of tables are supported: a simple table with one-line rows, and a
7− multiline rows). Currently only the Markdown reader and the LaTeX,
12+ more complex variety with multiline rows. All output formats are
8− Docbook, and HTML writers support tables. The syntax is documented in
13+ supported, but only markdown tables are parsed at the moment. The
9− README.
14+ syntax is documented in README.
16+ * Added support for definition lists (with a new DefinitionList block
17+ element). All output formats are supported, but only markdown
18+ definition lists are parsed at the moment. The syntax is documented
21+ * Added a --toc|--table-of-contents option. This causes an automatically
22+ generated table of contents (or an instruction that creates one) to
23+ be inserted at the beginning of the document. Not supported in S5,
24+ DocBook, or man page writers.
26+ * Added Text.Pandoc module that exports basic readers, writers,
27+ definitions, and utility functions. This should export everything
28+ needed for most uses of Pandoc libraries. The haddock documentation
29+ includes a short example program.
31+ * Added Text.Pandoc.Blocks module to help in printing markdown
32+ and RST tables. This module provides functions for working with
33+ fixed-width blocks of text--e.g., placing them side by side, as
11 * Refactored to avoid reliance on Haskell's Text.Regex library, which
36 * Refactored to avoid reliance on Haskell's Text.Regex library, which
12 (a) is slow, and (b) does not properly handle unicode. This fixed
37 (a) is slow, and (b) does not properly handle unicode. This fixed
13 some strange bugs, e.g. in parsing S-cedilla, and improved performance.
38 some strange bugs, e.g. in parsing S-cedilla, and improved performance.
15 + Replaced 'gsub' with a general list function 'substitute'
40 + Replaced 'gsub' with a general list function 'substitute'
16 that does not rely on Text.Regex.
41 that does not rely on Text.Regex.
17 + Rewrote extractTagType in HTML reader so that it doesn't use
42 + Rewrote extractTagType in HTML reader so that it doesn't use
@@ -22,17 +47,47 @@ pandoc (0.4) UNRELEASED; urgency=low
22 + Modified Docbook writer so that it doesn't rely on Text.Regex for
47 + Modified Docbook writer so that it doesn't rely on Text.Regex for
23 detecting 'mailto' links.
48 detecting 'mailto' links.
24 + Removed escapePreservingRegex and reamped entity-handling
49 + Removed escapePreservingRegex and reamped entity-handling
25− functions in Text/Pandoc/Shared.hs and Text/Pandoc/Entities.hs to
50+ functions in Text.Pandoc.Shared and Text.Pandoc.Entities to
26 avoid reliance on Text.Regex (see below on Entity handling changes).
51 avoid reliance on Text.Regex (see below on Entity handling changes).
53+ * Removed Key and Note blocks from the Pandoc data structure. All
54+ links are now stored as explicit links, and note contents are
55+ stored with the (inline) notes.
57+ + All link Targets are now explicit (URL, title) pairs; there
58+ is no longer a 'Ref' target.
59+ + Markdown and RST parsers now need to extract data from key and
60+ note blocks and insert them into the relevant inline elements.
61+ Other parsers have been simplified, since there is no longer any need
62+ to construct separate key and note blocks.
63+ + Markdown, RST, and HTML writers need to construct lists of
64+ notes; Markdown and RST writers need to construct lists of link
65+ references (when the --reference-links option is specified); and
66+ the RST writer needs to construct a list of image substitution
67+ references. All writers have been rewritten to use the State monad
68+ when state is required.
69+ + Several functions (generateReference, keyTable,
70+ replaceReferenceLinks, replaceRefLinksBlockList, and some auxiliaries
71+ used by them) have been removed from Text.Pandoc.Shared, since
72+ they are no longer needed. New functions and data structures
73+ (Reference, isNoteBlock, isKeyBlock, isLineClump) have been
74+ added. The functions inTags, selfClosingTag, inTagsSimple, and
75+ inTagsIndented have been moved to the DocBook writer, since that
76+ is now the only module that uses them. NoteTable is now exported
77+ in Text.Pandoc.Shared.
78+ + Added stateKeys and stateNotes to ParserState; removed stateKeyBlocks,
79+ stateKeysUsed, stateNoteBlocks, stateNoteIdentifiers, stateInlineLinks.
80+ + Added writerNotes and writerReferenceLinks to WriterOptions.
28− * Changed handling of SGML entities. Entities are now parsed (and unicode
82+ * Changed handling of XML entities. Entities are now parsed (and unicode
29 characters returned) in the Markdown and HTML readers, rather than being
83 characters returned) in the Markdown and HTML readers, rather than being
30 handled in the writers. In HTML and Docbook writers, UTF-8 is now used
84 handled in the writers. In HTML and Docbook writers, UTF-8 is now used
31 instead of entities for characters above 128. This makes the HTML and
85 instead of entities for characters above 128. This makes the HTML and
32− Docbook output much more readable and more easily editable.
86+ DocBook output much more readable and more easily editable.
34 + Removed sgmlHexEntity, sgmlDecimalEntity, sgmlNamedEntity, and
88 + Removed sgmlHexEntity, sgmlDecimalEntity, sgmlNamedEntity, and
35− sgmlCharacterEntity regexes from Shared.hs.
89+ sgmlCharacterEntity regexes from Text.Pandoc.Shared.
90+ + Renamed escapeSGMLChar to escapeCharForXML. Added escapeStringForXML.
36 + Added parsers characterEntity, namedEntity, decimalEntity, hexEntity
91 + Added parsers characterEntity, namedEntity, decimalEntity, hexEntity
37 to Entities.hs; these parse a string and return a unicode character.
92 to Entities.hs; these parse a string and return a unicode character.
38 + Added new 'entity' parser to Markdown reader, and added '&' as a
93 + Added new 'entity' parser to Markdown reader, and added '&' as a
@@ -44,26 +99,71 @@ pandoc (0.4) UNRELEASED; urgency=low
44 unprocessed entities are included in the native representation of
99 unprocessed entities are included in the native representation of
45 the document. (In the HTML reader, most of this work is done by a
100 the document. (In the HTML reader, most of this work is done by a
46 change in extractAttributeName.)
101 change in extractAttributeName.)
47− + Added escapeSGMLChar to Entities.hs. Modified escapeSGMLString to
49− + In SGML and Markdown output, escape unicode nonbreaking space as ' ',
102+ + In XML and Markdown output, escape unicode nonbreaking space as ' ',
50 since a unicode non-breaking space is impossible to distinguish visually
103 since a unicode non-breaking space is impossible to distinguish visually
51− from a regular space. (Resolves issue #3.)
104+ from a regular space. (Resolves Issue #3.)
52− + Replaced all calls to stringToSGML and encodeEntities with calls to
54− + Rewrote escapeSGMLString for better performance.
55 + Added charToEntity and charToNumericalEntity to Entities.hs.
105 + Added charToEntity and charToNumericalEntity to Entities.hs.
56 Removed encodeEntitiesNumerical.
106 Removed encodeEntitiesNumerical.
57 + Use Data.Map for entityTable and (new) reverseEntityTable, for a
107 + Use Data.Map for entityTable and (new) reverseEntityTable, for a
58 slight performance boost over the old association list.
108 slight performance boost over the old association list.
59 + Removed unneeded decodeEntities from 'str' parser in HTML and
109 + Removed unneeded decodeEntities from 'str' parser in HTML and
60 Markdown readers.
110 Markdown readers.
112+ * Text.Pandoc.UTF8: Renamed encodeUTF8 to toUTF8, decodeUTF8 to
113+ fromUTF8, for clarity.
115+ * Replaced old haskell98 module names replaced by hierarchical module
116+ names, e.g. List by Data.List. Removed haskell98 from dependencies
117+ in pandoc.cabal, and added mtl (needed for state monad). Substituted
120+ * Removed Blank block element as unnecessary.
124+ + Modified HTML writer to use the Text.XHtml library. This results
125+ in cleaner, faster code, and it makes it easier to use Pandoc in
126+ other projects, like wikis, which use Text.XHtml. Two functions are
127+ now provided, writeHtml and writeHtmlString: the former outputs an
128+ Html structure, the latter a rendered string. The S5 writer is also
129+ changed, in parallel ways (writeS5, writeS5String).
130+ + The Html header is now written programmatically, so it has been
131+ removed from the 'headers' directory. The S5 header is still
132+ needed, but the doctype and some of the meta declarations have
133+ been removed, since they are written programatically. This change
134+ introduces a new dependency on the xhtml package.
135+ + Fixed two bugs in email obfuscation involving improper escaping
136+ of '&' in the <noscript> section and in --strict mode. Resolves
138+ + Fixed another bug in email obfuscation: If the text to be obfuscated
139+ contains an entity, this needs to be decoded before obfuscation.
140+ Thanks to thsutton for the patch. Resolves Issue #15.
141+ + Changed the way the backlink is displayed in HTML footnotes.
142+ Instead of appearing on a line by itself, it now generally
143+ appears on the last line of the note. (Exception: when the
144+ note does not end with a Plain or Para block.) This saves space
146+ + Added automatic unique identifiers to headers:
147+ - The identifier is derived from the header via a scheme
148+ documented in README.
149+ - WriterState now includes a list of header identifiers and a table
150+ of contents in addition to notes.
151+ - The function uniqueIdentifiers creates a list of unique identifiers
152+ from a list of inline lists (e.g. headers).
153+ - This list is part of WriterState and gets consumed by blockToHtml
154+ each time a header is encountered.
62 * Fixed several bugs in HTML reader (extractTagType, attribute parsing).
156 * Fixed several bugs in HTML reader (extractTagType, attribute parsing).
64 * Markdown reader:
158 * Markdown reader:
66− + Fixed several bugs in smart quote recognition.
160+ + Ordered list items may no longer begin with uppercase letters, or
161+ letters greater than 'n'. (This prevents first initials and page
162+ reference, e.g. 'p. 400', from being parsed as beginning lists.)
163+ Also, numbers beginning list items may no longer end with ')',
164+ which is now allowed only after letters. Note: These changes
165+ may cause documents to be parsed differently. Users should take
67 + Changed autoLink parsing to conform better to Markdown.pl's
167 + Changed autoLink parsing to conform better to Markdown.pl's
68 behavior. <google.com> is not treated as a link, but
168 behavior. <google.com> is not treated as a link, but
69 <http://google.com>, <ftp://google.com>, and <mailto:google@google.com> are.
169 <http://google.com>, <ftp://google.com>, and <mailto:google@google.com> are.
@@ -72,53 +172,132 @@ pandoc (0.4) UNRELEASED; urgency=low
72 + Use lookAhead parser for the 'first pass' (looking for reference keys),
172 + Use lookAhead parser for the 'first pass' (looking for reference keys),
73 instead of parsing normally, then using setInput to reset input. This
173 instead of parsing normally, then using setInput to reset input. This
74 yields a slight performance boost.
174 yields a slight performance boost.
75−
175+ + Fixed several bugs in smart quote recognition.
176+ + Fixed bug in indentSpaces (which didn't properly handle
177+ cases with mixed spaces and tabs).
178+ + Consolidated 'text', 'special', and 'inline' into 'inline'.
179+ + Fixed bug which allowed URL and title to be separated by multiple blank
180+ lines in links and reference keys. They can be on separate lines but
181+ can't have blank lines between them.
182+ + Correctly handle bracketed text inside inline footnotes and links,using
183+ new function inlinesInBalanced. Resolves Issue #14.
184+ + Fixed bug in footnotes: links in footnotes were not being
185+ processed. Solution: three-stage parse. First, get all the
186+ reference keys and add information to state. Next, get all the
187+ notes and add information to state. (Reference keys may be needed
188+ at this stage.) Finally, parse everything else.
192+ + Links in markdown output are now printed as inline links by default,
193+ rather than reference links. A --reference-links option has been added
194+ that forces links to be printed as reference links. Resolves Issue #4.
76− * Markdown writer: Use autolinks when possible. Instead of
195+ + Use autolinks when possible. Instead of [site.com](site.com),
77− [site.com](site.com), use <site.com>.
196+ use <site.com>.
79− * RST Reader:
198+ * RST reader:
81 + Allow the URI in a RST hyperlink target to start on the line
200 + Allow the URI in a RST hyperlink target to start on the line
82 after the reference key.
201 after the reference key.
83− + Added 'try' in front of 'string', where needed, or used a different parser,
202+ + Added 'try' in front of 'string', where needed, or used a different
84− in RST reader. This fixes a bug where ````` would not be correctly parsed as
203+ parser. This fixes a bug where ````` would not be correctly parsed as
85 a verbatim `.
204 a verbatim `.
86 + Fixed slow performance in parsing inline literals in RST reader. The
205 + Fixed slow performance in parsing inline literals in RST reader. The
87 problem was that ``#`` was seen by 'inline' as a potential link or image.
206 problem was that ``#`` was seen by 'inline' as a potential link or image.
88 Fix: inserted 'notFollowedBy (char '`')' in link parsers.
207 Fix: inserted 'notFollowedBy (char '`')' in link parsers.
89− (Resolves issue #8.)
208+ Resolves Issue #8.
90 + Use lookAhead instead of getInput/setInput in RST reader. Removed
209 + Use lookAhead instead of getInput/setInput in RST reader. Removed
91 unneeded getState call, since lookAhead automatically saves and
210 unneeded getState call, since lookAhead automatically saves and
92 restores the parser state.
211 restores the parser state.
93−
212+ + Allow hyperlink target URIs to be split over multiple lines, and
213+ to start on the line after the reference. Resolves Issue #7.
94− * LaTeX Reader: replaced 'choice [(try (string ...), ...]' idiom with
215+ * LaTeX reader: replaced 'choice [(try (string ...), ...]' idiom with
95 'oneOfStrings' in LaTeX reader, for clarity.
216 'oneOfStrings' in LaTeX reader, for clarity.
97− * Modified LaTeX writer to insert '\,' between consecutive quotes.
220+ + Modified LaTeX writer to insert '\,' between consecutive quotes.
98−
221+ + Removed unused function tableRowColumnWidths.
222+ + Simplified code for escaping special characters.
223+ + Leave extra blank line after \maketitle.
225+ * Instead of adding "\n\n" to the end of an input string in Main.hs,
226+ this is now done in the readers. This makes the libraries behave
227+ the way you'd expect from the pandoc program. Resolves Issue #10.
99 * Text.ParserCombinators.Pandoc:
229 * Text.ParserCombinators.Pandoc:
231+ + Renamed to Text.Pandoc.ParserCombinators, in order to have all the
232+ pandoc libraries in the same place.
233+ + Fixed a bug in the anyLine parser. Previously it would parse an empty
234+ string "", but it should fail on an empty string, or we get an error
235+ when it is used inside "many" combinators.
101 + Removed followedBy' parser, replacing it with the lookAhead parser from
236 + Removed followedBy' parser, replacing it with the lookAhead parser from
102 Text/ParserCombinators/Parsec.
237 Text/ParserCombinators/Parsec.
103 + Added some needed 'try's before multicharacter parsers, especially in
238 + Added some needed 'try's before multicharacter parsers, especially in
104 'option' contexts.
239 'option' contexts.
105 + Removed the 'try' from the 'end' parser in 'enclosed', so that
240 + Removed the 'try' from the 'end' parser in 'enclosed', so that
106 'enclosed' behaves like 'option', 'manyTill', etc.
241 'enclosed' behaves like 'option', 'manyTill', etc.
107−
242+ + Added lineClump parser, which parses a raw line block up to and
243+ including any following blank lines.
245+ * Text.Pandoc.Shared:
108− * Added defaultWriterOptions to Text/Pandoc/Shared.
247+ + Added defaultWriterOptions.
248+ + Added writerTableOfContents to WriterOptions.
249+ + Added writerIgnoreNotes option to WriterOptions. This is needed
250+ for processing header blocks for a table of contents, since notes on
251+ headers should not appear in the TOC.
252+ + Added prettyprinting for native Table format.
253+ + Removed some unneeded imports.
254+ + Moved escape and nullBlock parsers from
255+ Text.ParserCombinators.Pandoc, since the latter is for
256+ general-purpose parsers that don't depend on Text.Pandoc.Definition.
257+ + Moved isHeaderBlock from Text.Pandoc.Writers.HTML.
258+ + Moved Element, headerAtLeast, and hierarchicalize from Docbook
259+ writer, because HTML writer now uses these in constructing a table
262+ * Refactored runtests.pl; added separate tests for tables.
266+ + Added -asxhtml flag to tidy in html2markdown. This will
267+ perhaps help the parser, which expects closing tags.
268+ + Modified markdown2pdf to run pdflatex a second time if --toc or
269+ --table-of-contents was specified; otherwise the table of
270+ contents won't appear.
110− * Improved website target:
272+ * Changes to build process:
112− + Use a subsidiary Makefile that can be run from the website
274+ + Dropped support for compilation with GHC 6.4. GHC 6.6 or higher
113− directory.
275+ is now required.
114− + Improved "Examples" page: added a templating system, syntax
276+ + Removed cabalize and Pandoc.cabal.in. The repository now contains
115− highlighting of xml, tex, and html files, and a demo of
277+ pandoc.cabal itself.
116− docbook postprocessed by xmlto.
278+ + Pandoc.cabal has been changed to pandoc.cabal, because HackageDB
117− + Download links now go to Google's download details page (with
279+ likes the cabal file to have the same name as the tarball.
118− SHA1 checksum) rather than directly to the files.
280+ + Expanded and revised the package description in pandoc.cabal.
119−
281+ Revised the package synopsis.
282+ + The tarball built by 'make tarball' now contains files built from
283+ templates (including man pages and shell scripts), so pandoc can
284+ be built directly using Cabal tools, without preprocessing.
285+ + Executable binaries are now stripped before installing.
286+ + Man pages are now generated from markdown sources, using pandoc's
120 * Added FreeBSD port.
289 * Added FreeBSD port.
295+ + Changed pandoc's Build-Depends to include libghc6-mtl-dev and
296+ libghc6-xhtml-dev. Removed libghc6-html-dev.
297+ + Suggest texlive-latex-recommended | tetex-extra instead of
298+ tetex-bin. This brings in fancyvrb and unicode support.
122 -- Recai Oktaş <roktas@debian.org> Tue, 16 Jan 2007 00:37:21 +0200
301 -- Recai Oktaş <roktas@debian.org> Tue, 16 Jan 2007 00:37:21 +0200
124pandoc (0.3) unstable; urgency=low
303pandoc (0.3) unstable; urgency=low
@@ -209,7 +388,7 @@ pandoc (0.3) unstable; urgency=low
209 + Modified HTML reader to skip a newline following a <br> tag.
388 + Modified HTML reader to skip a newline following a <br> tag.
210 Otherwise the newline will be treated as a space at the beginning
389 Otherwise the newline will be treated as a space at the beginning
211 of the next line.
390 of the next line.
213 * Made handling of code blocks more consistent. Previously, some
392 * Made handling of code blocks more consistent. Previously, some
214 readers allowed trailing newlines, while others stripped them.
393 readers allowed trailing newlines, while others stripped them.
215 Now, all readers strip trailing newlines in code blocks. Writers
394 Now, all readers strip trailing newlines in code blocks. Writers
@@ -246,7 +425,7 @@ pandoc (0.3) unstable; urgency=low
246 + Include title block in header even when title is null.
425 + Include title block in header even when title is null.
247 + Made javascript obfuscation of emails even more obfuscatory,
426 + Made javascript obfuscation of emails even more obfuscatory,
248 by combining it with entity obfuscation.
427 by combining it with entity obfuscation.
250 * Changed default ASCIIMathML text color to black.
429 * Changed default ASCIIMathML text color to black.
252 * Test suite:
431 * Test suite: