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
36a3bb7274