| Subject: | Missing documentation for Markdown.pl, MultiMarkdown.pl |
Hi,
The scripts you are shipping as part of your distribution do not have
any documentation - one of them even had the --help switch, but did
nothing ;-)
I wrote the manpage for both (actually, the same manpage with minor
modifications) to include it in the Debian package. Of course, if you
add the manpages to the official release, we all end up winning :)
Please note that, in order to comply with Debian's policy, we are
renaming the scripts to plainly markdown and multimarkdown - And the
documentation I wrote reflects those names.
Oh, and as for installing the manpages: As you are using a probably
modified Module::Install, I prefered not to mess with your Makefile.PL -
I am doing this in my debian/rules (i.e. the makefile for the Debian
package building):
install -d $(CURDIR)/debian/$(PACKAGE)/usr/share/man/man1/
pod2man $(CURDIR)/debian/$(PACKAGE)/usr/bin/markdown
$(CURDIR)/debian/$(PACKAGE)/usr/share/man/man1/markdown.1
pod2man $(CURDIR)/debian/$(PACKAGE)/usr/bin/multimarkdown
$(CURDIR)/debian/$(PACKAGE)/usr/share/man/man1/multimarkdown.1
Of course, it would be way cleaner if the POD were also
manified/installed together with the rest of the files.
| Subject: | add_missing_pod |
Message body not shown because it is not plain text.