Summary of main changes:
+ Added -o/--output and -d/--debug options to pandoc.
+ Modified pandoc to behave differently depending on the name
of the program. For example, if the program name is 'html2latex',
the default reader will be html and the default writer latex.
+ Removed most of the old wrappers, replacing them with symlinks
to pandoc.
+ Rewrote markdown2pdf and created a new wrapper web2markdown,
with the functionality of the old html2markdown script. These
new scripts exploit pandoc's -d option to avoid having to do
complex command-line parsing.
+ Revised man pages and documentation appropriately.
git-svn-id: https://pandoc.googlecode.com/svn/trunk@279 788f1e2b-df1e-0410-8736-df70ead52e1b
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
+ "SEE ALSO" sections of man files have paragraph fillings errors which
groff(1) complains ("cannot adjust line"). This is because .BR line in
"SEE ALSO" section is too long to break properly. Fix all man pages.
While on it, move all AUTHORS section to the end of the files, this
section should come last.
+ lintian(1) complains about the debian/changelog symlink:
W: pandoc source: changelog-is-symlink
N:
N: The file debian/changelog is a symlink instead of a regular file. This
N: is unnecessary and makes package checking and manipulation more
N: difficult. If the changelog should be available in the source package
N: under multiple names, make debian/changelog the real file and the
N: other names symlinks to it.
N:
N: This problem may have prevented lintian from performing other checks,
N: leading to undetected changelog errors.
Reverse the source and targets in symlink to fix this warning. Now, the
Debian packages can be cleanly built.
git-svn-id: https://pandoc.googlecode.com/svn/trunk@74 788f1e2b-df1e-0410-8736-df70ead52e1b
