@@ -2,16 +2,41 @@ pandoc (0.4) UNRELEASED; urgency=low
22
33 [ John MacFarlane ]
44
5− * Added support for Markdown tables. Two kinds of tables are supported
6− (a simple table with one-line rows, and a more complex variety with
7− multiline rows). Currently only the Markdown reader and the LaTeX,
8− Docbook, and HTML writers support tables. The syntax is documented in
9− README.
10−
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.
9+
10+ * Added support for tables (with a new Table block element). Two kinds
11+ of tables are supported: a simple table with one-line rows, and a
12+ more complex variety with multiline rows. All output formats are
13+ supported, but only markdown tables are parsed at the moment. The
14+ syntax is documented in README.
15+
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
19+ in README.
20+
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.
25+
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.
30+
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
34+ in a table row.
35+
1136 * Refactored to avoid reliance on Haskell's Text.Regex library, which
1237 (a) is slow, and (b) does not properly handle unicode. This fixed
1338 some strange bugs, e.g. in parsing S-cedilla, and improved performance.
14−
39+
1540 + Replaced 'gsub' with a general list function 'substitute'
1641 that does not rely on Text.Regex.
1742 + Rewrote extractTagType in HTML reader so that it doesn't use
@@ -22,17 +47,47 @@ pandoc (0.4) UNRELEASED; urgency=low
2247 + Modified Docbook writer so that it doesn't rely on Text.Regex for
2348 detecting 'mailto' links.
2449 + 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
2651 avoid reliance on Text.Regex (see below on Entity handling changes).
27−
28− * Changed handling of SGML entities. Entities are now parsed (and unicode
52+
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.
56+
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.
81+
82+ * Changed handling of XML entities. Entities are now parsed (and unicode
2983 characters returned) in the Markdown and HTML readers, rather than being
3084 handled in the writers. In HTML and Docbook writers, UTF-8 is now used
3185 instead of entities for characters above 128. This makes the HTML and
32− Docbook output much more readable and more easily editable.
33−
86+ DocBook output much more readable and more easily editable.
87+
3488 + 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.
3691 + Added parsers characterEntity, namedEntity, decimalEntity, hexEntity
3792 to Entities.hs; these parse a string and return a unicode character.
3893 + Added new 'entity' parser to Markdown reader, and added '&' as a
@@ -44,26 +99,71 @@ pandoc (0.4) UNRELEASED; urgency=low
4499 unprocessed entities are included in the native representation of
45100 the document. (In the HTML reader, most of this work is done by a
46101 change in extractAttributeName.)
47− + Added escapeSGMLChar to Entities.hs. Modified escapeSGMLString to
48− use escapeSGMLChar.
49− + In SGML and Markdown output, escape unicode nonbreaking space as ' ',
102+ + In XML and Markdown output, escape unicode nonbreaking space as ' ',
50103 since a unicode non-breaking space is impossible to distinguish visually
51− from a regular space. (Resolves issue #3.)
52− + Replaced all calls to stringToSGML and encodeEntities with calls to
53− escapeSGMLString.
54− + Rewrote escapeSGMLString for better performance.
104+ from a regular space. (Resolves Issue #3.)
55105 + Added charToEntity and charToNumericalEntity to Entities.hs.
56106 Removed encodeEntitiesNumerical.
57107 + Use Data.Map for entityTable and (new) reverseEntityTable, for a
58108 slight performance boost over the old association list.
59109 + Removed unneeded decodeEntities from 'str' parser in HTML and
60110 Markdown readers.
61−
111+
112+ * Text.Pandoc.UTF8: Renamed encodeUTF8 to toUTF8, decodeUTF8 to
113+ fromUTF8, for clarity.
114+
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
118+ xhtml for html.
119+
120+ * Removed Blank block element as unnecessary.
121+
122+ * HTML writer:
123+
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
137+ Issue #9.
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
145+ and looks better.
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.
155+
62156 * Fixed several bugs in HTML reader (extractTagType, attribute parsing).
63−
157+
64158 * Markdown reader:
65−
66− + Fixed several bugs in smart quote recognition.
159+
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
166+ care in upgrading.
67167 + Changed autoLink parsing to conform better to Markdown.pl's
68168 behavior. <google.com> is not treated as a link, but
69169 <http://google.com>, <ftp://google.com>, and <mailto:google@google.com> are.
@@ -72,53 +172,132 @@ pandoc (0.4) UNRELEASED; urgency=low
72172 + Use lookAhead parser for the 'first pass' (looking for reference keys),
73173 instead of parsing normally, then using setInput to reset input. This
74174 yields a slight performance boost.
75−
76− * Markdown writer: Use autolinks when possible. Instead of
77− [site.com](site.com), use <site.com>.
78−
79− * RST Reader:
80−
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.
189+
190+ * Markdown writer:
191+
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.
195+ + Use autolinks when possible. Instead of [site.com](site.com),
196+ use <site.com>.
197+
198+ * RST reader:
199+
81200 + Allow the URI in a RST hyperlink target to start on the line
82201 after the reference key.
83− + Added 'try' in front of 'string', where needed, or used a different parser,
84− in RST reader. This fixes a bug where ````` would not be correctly parsed as
202+ + Added 'try' in front of 'string', where needed, or used a different
203+ parser. This fixes a bug where ````` would not be correctly parsed as
85204 a verbatim `.
86205 + Fixed slow performance in parsing inline literals in RST reader. The
87206 problem was that ``#`` was seen by 'inline' as a potential link or image.
88207 Fix: inserted 'notFollowedBy (char '`')' in link parsers.
89− (Resolves issue #8.)
208+ Resolves Issue #8.
90209 + Use lookAhead instead of getInput/setInput in RST reader. Removed
91210 unneeded getState call, since lookAhead automatically saves and
92211 restores the parser state.
93−
94− * LaTeX Reader: replaced 'choice [(try (string ...), ...]' idiom with
212+ + Allow hyperlink target URIs to be split over multiple lines, and
213+ to start on the line after the reference. Resolves Issue #7.
214+
215+ * LaTeX reader: replaced 'choice [(try (string ...), ...]' idiom with
95216 'oneOfStrings' in LaTeX reader, for clarity.
96−
97− * Modified LaTeX writer to insert '\,' between consecutive quotes.
98−
217+
218+ * LaTeX writer:
219+
220+ + Modified LaTeX writer to insert '\,' between consecutive quotes.
221+ + Removed unused function tableRowColumnWidths.
222+ + Simplified code for escaping special characters.
223+ + Leave extra blank line after \maketitle.
224+
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.
228+
99229 * Text.ParserCombinators.Pandoc:
100−
230+
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.
101236 + Removed followedBy' parser, replacing it with the lookAhead parser from
102237 Text/ParserCombinators/Parsec.
103238 + Added some needed 'try's before multicharacter parsers, especially in
104239 'option' contexts.
105240 + Removed the 'try' from the 'end' parser in 'enclosed', so that
106241 'enclosed' behaves like 'option', 'manyTill', etc.
107−
108− * Added defaultWriterOptions to Text/Pandoc/Shared.
242+ + Added lineClump parser, which parses a raw line block up to and
243+ including any following blank lines.
244+
245+ * Text.Pandoc.Shared:
246+
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
260+ of contents.
261+
262+ * Refactored runtests.pl; added separate tests for tables.
263+
264+ * Shell scripts:
265+
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.
109271
110− * Improved website target:
111−
112− + Use a subsidiary Makefile that can be run from the website
113− directory.
114− + Improved "Examples" page: added a templating system, syntax
115− highlighting of xml, tex, and html files, and a demo of
116− docbook postprocessed by xmlto.
117− + Download links now go to Google's download details page (with
118− SHA1 checksum) rather than directly to the files.
119−
272+ * Changes to build process:
273+
274+ + Dropped support for compilation with GHC 6.4. GHC 6.6 or higher
275+ is now required.
276+ + Removed cabalize and Pandoc.cabal.in. The repository now contains
277+ pandoc.cabal itself.
278+ + Pandoc.cabal has been changed to pandoc.cabal, because HackageDB
279+ likes the cabal file to have the same name as the tarball.
280+ + Expanded and revised the package description in pandoc.cabal.
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
287+ man page writer.
288+
120289 * Added FreeBSD port.
121−
290+
291+ [ Recai Oktaş ]
292+
293+ * debian/control:
294+
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.
299+
300+
122301 -- Recai Oktaş <roktas@debian.org> Tue, 16 Jan 2007 00:37:21 +0200
123302
124303pandoc (0.3) unstable; urgency=low
@@ -209,7 +388,7 @@ pandoc (0.3) unstable; urgency=low
209388 + Modified HTML reader to skip a newline following a <br> tag.
210389 Otherwise the newline will be treated as a space at the beginning
211390 of the next line.
212−
391+
213392 * Made handling of code blocks more consistent. Previously, some
214393 readers allowed trailing newlines, while others stripped them.
215394 Now, all readers strip trailing newlines in code blocks. Writers
@@ -246,7 +425,7 @@ pandoc (0.3) unstable; urgency=low
246425 + Include title block in header even when title is null.
247426 + Made javascript obfuscation of emails even more obfuscatory,
248427 by combining it with entity obfuscation.
249−
428+
250429 * Changed default ASCIIMathML text color to black.
251430
252431 * Test suite: