Revised changelog to reflect changes since r105.

Included below is a summary of changes committed in the merge of
the wrappers branch (r177):

Refactored wrappers, with the following aims:

+ New command line convention, as follows:
 1st form: input files specified
    <wrapper> [wrapper_arg...] input_files... [pandoc_option...]
 2nd form: using STDIN, no input file is specified
        <wrapper> [wrapper_arg...] -- [pandoc_option...]
 3rd form: input files specified, optional --
    <wrapper> [wrapper_arg...] input_files... -- [pandoc_option...]

  - All wrappers except 'html2markdown' and 'latex2markdown' should
    accept multiple filenames.
  - Use getopts shell builtin for portable option parsing.

+ Remove code duplication and provide consistency across
  command line interface.

+ Allow white space in filenames, especially suitable for Mac OSX users

+ Improve html2markdown's web grabber code, making it more robust,
  configurable and verbose.

  - new function 'grab_url_with' as the wrapper to web grabbers.
  - 'grab_url_with' can report errors if the grabber fails.
  - new command line option 'n' to avoid automatic web grabbing.
  - new command line option 'g' which explicitly selects a grabber and 
    optionally specifies new options for the selected grabber.  Possible 
    use cases:
        # Just use curl.
        html2markdown -g 'curl'

        # Use wget by setting timeout to 10 seconds and limit retries to 2.
        html2markdown -g 'wget --timeout=10 --tries=2'

+ Add code to html2markdown that tries to determine the character 
  encoding of an HTML file, by parsing the "Content-type" meta tag.

  - if the encoding can't be determined, then if the content is local,
    the local encoding is used; if it comes from a URL, UTF-8 is used 
    by default.
  - if input is from stdin, don't try to determine character
    encoding.
  - add a new option '-e' to specify encoding.

+ Better warning messages:

  - print warning if iconv not available
  - in markdown2latex, print only relevant parts of log when pdflatex
    returns an error condition
  - in markdown2latex, when 'ucs.sty' is not found, print message
    telling where to find the 'unicode' package.

+ Remove PANDOC_OPTS environment variable functionality.  It is
  no longer necessary, now that pandoc options may be specified on
  the command line.

+ Add tests for wrappers' processing of command line arguments:

  - new file 'testwrapper.in' to test the parsing code under 'bash',
    'dash', 'ksh' and 'zsh' in POSIX mode.
  - new makefile target 'test-wrappers' to run 'testwrapper'

+ Document changes in revisions to wrapper syntax in README and man pages.



git-svn-id: https://pandoc.googlecode.com/svn/trunk@178 788f1e2b-df1e-0410-8736-df70ead52e1b

1 files changed, 60 insertions, 4 deletions

diff --git a/debian/changelog b/debian/changelog
index dc013e9b8..c15ee60cf 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -15,10 +15,30 @@ pandoc (0.3) unstable; urgency=low
       Cabal versions.
 
   * Refactored template processing (fillTemplates.pl).
-	
-  * Modified wrapper scripts to make them more robust.
 
-  * Added '--output' option to markdown2pdf.
+  * Modified wrapper scripts to make them more robust and portable.
+    To avoid code duplication and ensure consistency, wrappers are 
+    generated via a templating system from templates in src/wrappers.
+    + New command line convention allows options to be passed to
+      pandoc, as follows:
+        1st form: input files specified
+          <wrapper> [wrapper_arg...] input_files... [pandoc_option...]
+        2nd form: using STDIN, no input file is specified
+          <wrapper> [wrapper_arg...] -- [pandoc_option...]
+        3rd form: input files specified, optional '--'
+          <wrapper> [wrapper_arg...] input_files... -- [pandoc_option...]
+    + All wrappers except 'html2markdown' and 'latex2markdown' now
+      accept multiple filenames.
+    + getopts shell builtin is used for portable option parsing.
+    + Spaces and tabs allowed in filenames.
+    + Improved html2markdown's web grabber code, making it more robust,
+      configurable and verbose.  Added '-e', '-n', '-g' options.
+      Possible use case:
+        # Use wget by setting timeout to 10 seconds and limit retries
+        to 2.  html2markdown -g 'wget --timeout=10 --tries=2'
+    + Added tests for wrappers' processing of command line arguments.
+
+  * Added '-o' option to markdown2pdf.
 
   [ John MacFarlane ]
 
@@ -33,6 +53,30 @@ pandoc (0.3) unstable; urgency=low
     + Process quotes before dashes.  This way (foo -- 'bar') will turn into
       (foo---`bar') instead of (foo---'bar').
 
+  * Minor improvements to LaTeX reader:
+    + Fixed parsing of metadata.  Now the title, author, and date
+      are parsed correctly.  Everything else in the preamble is skipped.
+    + Modified escapedChar to allow a \ at the end of a line to count
+      as escaped whitespace.
+    + '\thanks' now treated like a footnote.    
+    + Simplified parsing of LaTeX command arguments and options.
+      commandArgs now returns a list of arguments OR options (in
+      whatever order they appear).  The brackets are included, and
+      a new stripFirstAndLast function is provided to strip them off
+      when needed.  This fixes a problem in dealing with \newcommand
+      and \newenvironment.
+
+  * Fixed bug in notFollowedBy' combinator (adding 'try' before 'parser').
+    Adjusted code that uses this combinator accordingly.
+
+  * Made handling of code blocks more consistent.  Previously, some
+    readers allowed trailing newlines, while others stripped them.
+    Now, all readers strip trailing newlines in code blocks. Writers
+    insert a newline at the end of code blocks as needed.
+
+  * Changed HTML writer to include title block in header even
+    when title is null.
+
   * Revised pandoc wrapper scripts to pipe output (as well as input)
     through iconv.
 
@@ -42,10 +86,22 @@ pandoc (0.3) unstable; urgency=low
     + New osx directory contains files needed for construction
       of the package.
 
+  * Added code to html2markdown that tries to determine the character 
+    encoding of an HTML file, by parsing the "Content-type" meta tag.
+    + If the encoding can't be determined, then if the content is local,
+      the local encoding is used; if it comes from a URL, UTF-8 is used 
+      by default.
+    + Encoding can be specified explicitly using '-e' option.
+
+  * Improved warning messages:
+    + Print warning if iconv not available
+    + More user-friendly error messages in markdown2pdf, when
+      pdflatex fails.
+
   * Rewrote documentation and man pages.  Split README into INSTALL
     and README.
 
- -- Recai Oktaş <roktas@debian.org>  Tue, 24 Oct 2006 07:48:30 +0300
+ -- Recai Oktaş <roktas@debian.org>  Tue, 12 Dec 2006 07:48:30 +0300
 
 pandoc (0.2) unstable; urgency=low