Upstream changes:
podlators 4.09 (unreleased)
[Pod::Text] Use Pod::Simple's logic to determine the native code
points for NO BREAK SPACE and SOFT HYPHEN instead of hard-coding the
ASCII values. Hopefully fixes the case of mysterious disappearing
open brackets on EBCDIC systems. (#118240)
podlators 4.08 (2016-09-24)
[Pod::Man] Partially revert change in 4.00 to require the name option
(--name to pod2man) when generating man pages from standard input.
Historically, pod2man silently tolerated this, and there turned out to
be a lot of software that depended on this, making the change too
disruptive. Instead, silently set the man page title to STDIN in this
case, but warn about it in the documentation. (#117990)
[Pod::Man] Fix rendering bug for "TRUE (1)", which was recognized as
needing small caps and then erroneously as a man page reference,
resulting in escaped nroff. (Found by Dan Jacobson with the
XML::LibXML::Element man page.) (Debian Bug#836831)
[Pod::Man] Fix rendering bug causing "\s0(1)" to be mistakenly marked
as a man page reference, later confusing backslash escaping.
[Pod::Man] Add new lquote and rquote options (and corresponding
--lquote and --rquote flags to pod2man) to set the left and right
quotes for C<> text independently. (#103298)
Remove test for nested L<> markup, since an upcoming version of
Pod::Simple will drop support for this. (#114075)
Upstream changes:
podlators 4.07 (2016-03-20)
[Pod::Man] Avoid undefined variable warnings when determining the
title for a Perl module at the top level of a distribution. Thanks,
Dave Mitchell. (#112625)
[Pod::Man] Fix font resets with nroff when fixed-width fonts are used
in the label for an =item. Previously, italic was being ended with
\f(CW even in nroff mode, which, with groff, only changes the font to
fixed-width and doesn't reset to a non-italic font. Thanks, Paul
Townsend. (#98199)
[Pod::Man] Suppress warnings about a missing Encode module if
PERL_CORE is set in the environment. Due to build ordering during
Perl core builds, Encode is expected to not yet be available during
the build step that sets PERL_CORE. Thanks, Dave Mitchell.
Upstream changes:
podlators 4.06 (2016-01-31)
Handle scripts ending in .com on VMS systems and don't generate the
man page for perlpodstyle when built as part of Perl core. These are
hopefully the last two changes required to fully merge with Perl core
without core having to maintain a separate build system. Thanks,
Craig A. Berry.
During build, generate the pod2text and pod2man man pages from the
*.PL files rather than the generated scripts. This may be required
due to the different script extensions on VMS hosts.
Rename perlpodstyle back to perlpodstyle.pod, since we no longer need
the workaround for Module::Build's POD handling.
Upstream changes:
podlators 4.05 (2016-01-16)
Switch back to generating pod2man and pod2text from *.PL files. While
ExtUtils::MakeMaker can fix the #! line, it can't handle all non-UNIX
operating systems, and the *.PL script generation code can. This will
hopefully remove the need for Perl core to maintain a separate copy of
the *.PL wrapper scripts as well. Thanks, Craig A. Berry.
[Pod::Man] Fall back (with a warning) to non-utf8 behavior if the utf8
option is specified but the Encode module is not available. This is
useful in some cross-compilation situations. Thanks, Niko Tyni.
Don't try to remove the temporary directory used by tests in the tests
themselves, since this races with other tests run in parallel.
Instead, just remove it on make clean.
Provide a mailto address in bug tracking metadata, use the shorter
form of the RT bug tracker URL, and fix the license value to match the
new metadata specification.
podlators 4.04 (2016-01-02)
Fix portability of the t/docs/synopsis.t test to Windows. It was
assuming UNIX path delimiters when filtering out files it didn't
intend to test.
Don't include .travis.yml in the distribution so that it isn't picked
up by Perl core. Thanks, Karen Etheridge. (#110385)
Add homepage information to the CPAN metadata and change the canonical
repository location to GitHub.
podlators 4.03 (2015-12-06)
Fix tests when POD_MAN_DATE or SOURCE_DATE_EPOCH are already set in
the environment. Thanks, Niko Tyni. (Debian Bug#807086)
Continue general improvements and refactoring of the test suite to
make it more maintainable and clean out duplicate or unnecessary code.
podlators 4.02 (2015-12-02)
For versions of Perl prior to 5.11, install the modules into the Perl
core module directories, since in those versions site modules did not
take precedence over Perl core modules. Thanks, Peter Rabbitson.
(#110024)
podlators 4.01 (2015-12-01)
[Pod::Text::Termcap] Do not override the TERMPATH environment variable
if it's already set. This should fix the test suite with Term::Cap
1.16 (which has a bug in termcap handling if TERMPATH doesn't point to
a valid file). Also document the manipulation of TERMPATH.
Revert the switch to Module::Build as the build system. This creates
a circular dependency with Module::Build, since it wants a newer
version of Pod::Man than in Perl versions prior to 5.10.1. Instead,
add the new metadata to Makefile.PL and stick with a single build
system that will also work inside Perl core.
podlators 4.00 (2015-11-28)
Increase the version number of the package to be larger than any of
the previous version numbers of any of the modules, and change all
modules to use the same version as the overall podlators package.
Switch to a simple decimal version number to avoid complexity with
v-strings and portability to old versions of Perl.
podlators now requires Perl 5.006 or later. All modules enable
warnings. Please report any unexpected or confusing warnings as bugs
in the bug tracker.
[pod2man] In previous versions, the -r or --release option could be
specified without an argument and was interpreted as setting that
value to the empty string. That never made a great deal of sense, and
the original change to Perl was apparently because no one realized one
could pass the empty string as the argument value. The argument is
now mandatory, but may be the empty string, which will cause some
*roff implementations to use the system default.
Allow any even number of characters to be specified as the quote marks
for Pod::Text and Pod::Man (and the corresponding --quotes options of
pod2text and pod2man), rather than being artificially limited to one-
or two-character quotes. The first half of the string will be used as
the left quote and the second half as the right quote. This allows
Unicode characters or groff escapes like \(lq and \(rq to be used.
(Partly addresses #103298)
[Pod::Man] Attempt to detect if the input came from a pipe and
therefore has a completely unhelpful (and nonreproducible) source file
name, and diagnose this as an error. Document that the name option
(--name to pod2man) is required when processing POD source from
standard input. (Debian Bug#777405)
[Pod::Man] Honor the environment variable SOURCE_DATE_EPOCH and use it
as the timestamp from which to derive the left-hand footer if the date
option is not set, overriding the timestamp of the input file. This
is primarily useful to ensure reproducible builds of the same output
file given the same souce and Pod::Man version, even when file
timestamps may not be consistent. Thanks, Niko Tyni. (Debian
Bug#801621)
[Pod::Man] Honor the environment variable POD_MAN_DATE and use its
contents, if set, as the value of the left-hand footer if the date
option is not set, overriding the timestamp of the input file. This
was an earlier version of SOURCE_DATE_EPOCH, but has been supported in
Debian for a while and doesn't serve exactly the same purpose, so both
continue to be supported. Thanks, Niko Tyni.
[Pod::Man] The default left-hand footer date is now based on UTC
rather than the local time zone to make the output more reproducible.
Thanks, Chris Lamb. (Debian Bug#780259)
[Pod::Man] Simplify the preamble code for handling the F register and
index entries, and add backslashes after the braces in the preamble
code for handling the F register to avoid introducing a spurious page
break before at the first page with AT&T *roff. Thanks, Carsten
Kunze and Daphne Pfister. (#92979)
[Pod::Man] Support setting the left-hand footer to the empty string.
Fix documentation of the utf8 option to Pod::Man and Pod::Text, and
the corresponding -u option to pod2man and pod2text, to reflect that
Pod::Simple now autodetects Latin-1 and UTF-8 but warns.
More clearly document the options that set values in the .TH header in
the pod2man and Pod::Man documentation. Thanks, Guillem Jover.
(#103297)
[Pod::Text] Fix encoding handling in documents that start without an
encoding declaration and then declare an encoding partway through.
Previously, this would result in attempts to print wide characters if
there were non-ASCII characters in the document. Thanks, Magnolia K.
(#101722)
[Pod::Text] Change the documentation to not say Pod::Text only
generates ASCII text. (#89355)
Switch the preferred module build system to Module::Build, but still
provide a Makefile.PL file for backward compatibility and for the use
of Perl core. (#108714)
Installation of this package no longer tries to overwrite the Pod::Man
and Pod::Text modules that come with Perl core, and instead relies on
the normal precedence rules in Perl's module search path that prefer
locally-installed modules over core modules.
Rename NEWS to Changes to match the normal Perl convention.
Work around a bug in Term::Cap 1.16 that caused the test suite to fail
by forcing a setting of TERMPATH to a termcap file provided by the
test suite while running tests. (#98272)
Problems found locating distfiles:
Package cabocha: missing distfile cabocha-0.68.tar.bz2
Package convertlit: missing distfile clit18src.zip
Package php-enchant: missing distfile php-enchant/enchant-1.1.0.tgz
Otherwise, existing SHA1 digests verified and found to be the same on
the machine holding the existing distfiles (morden). All existing
SHA1 digests retained for now as an audit trail.
Changes from previous:
----------------------
2010-10-10 Russ Allbery <rra@stanford.edu>
* VERSION: podlators 2.4.0 released.
* scripts/pod2man: Remove the code to generate the #! line and
supporting code and instead rely on ExtUtils::MakeMaker to handle
that during package build.
* scripts/pod2text: Likewise.
* scripts/pod2man.PL: Renamed to pod2man.
* scripts/pod2text.PL: Renamed to pod2text.
* Makefile.PL: Remove PL_FILES section.
* pod/perlpodstyle.pod: New style guide for POD documentation,
split mostly from the NOTES section of the pod2man man page.
* scripts/pod2man.PL: Remove NOTES section, now maintained as the
separate perlpodstyle document.
* Makefile.PL: Add perlpodstyle.1 to the generated man pages.
* lib/Pod/Man.pm (cmd_para): Do not strip escaped trailing
whitespace, such as that created by S<> at the end of a line,
since the backslash is then taken by *roff as escaping the
newline. Thanks, Kevin Ryde.
* t/man.t: Test S<> at the end of lines.
* lib/Pod/Man.pm (output): If the utf8 option is given, encode
output in UTF-8 if there is no encoding layer. Now requires the
Encode module.
(start_document): Rather than forcibly change the PerlIO encoding
layer, probe the PerlIO layers with protection for Perl versions
without PerlIO and set a flag indicating whether to encode on the
fly on output.
* lib/Pod/Text.pm: Likewise.
* Makefile.PL: Mark Encode as required.
* t/man-perlio.t: Test Pod::Man output to a file handle with a
PerlIO encoding layer already applied.
* t/text-perlio.t: Likewise for Pod::Text.
pkgsrc changes:
- Adjusting dependencies according to META.yml
- Adding license definition (perl license)
Upstream changes:
2009-12-28 Russ Allbery <rra@stanford.edu>
* VERSION: podlators 2.3.0 released.
* Do not turn off IN_NAME for any formatting code.
Suppress formatting if in the NAME section to not confuse lexgrog.
* Test formatting codes in the NAME section.
* Allow anchor text for URLs as well. Fix the check of the anchor
text to not think no text was provided when the text was "0".
* Test anchor text of "0" and anchor text with URLs.
* Require Pod::Simple 3.06 or later for proper handling of L<>
tags with anchor text.
* Remove logic to skip an S<> test for Pod::Simple versions earlier
than 3.06.
* Support anchor text for L<> links of type URL by rendering the
anchor text and then the URL in angle brackets.
* Test rendering of L<> URL links with anchor text.
* When formatting item tags, use the width of the tag without
formatting codes. This does not change the output of Pod::Text
but provides a hook for correct formatting in subclasses.
* New function strip_format.
* Test proper formatting of item tags which have formatting codes
applied.
* New test of Pod::Text::Overstrike.
* Use Test::More for testing. Remove duplicate addition of
../blib/lib to the library search path.
* Update to the current version of this test from C TAP Harness
1.1, converting it to use Test::More.
2009-06-15 Russ Allbery <rra@stanford.edu>
* Unlink temporary files in a loop to be sure that all versions
are deleted on VMS.
Thanks, John E. Malmberg.
2009-03-29 Russ Allbery <rra@stanford.edu>
* Escape backslashes in the quoted text of .IX macros generated
from X<> formatting code.
* Add test case for X<\n>.
2009-03-05 Russ Allbery <rra@stanford.edu>
* Clarify that no markup should be used in the NAME section of a
manual page.
2009-02-28 Russ Allbery <rra@stanford.edu>
* Avoid POSIX::strftime because POSIX requires Fcntl, which is
an XS module, and hence can't build in miniperl. This allows
ExtUtils::MakeMaker to build as a normal module in Perl core.
Thanks, Michael G Schwern.
* Test that Pod::Man's devise_date method matches the output of
strftime.
* Don't exit IN_NAME mode because of a C<> block.
Thanks, Niko Tyni.
* Return an ASCII quoted string if in the NAME section to avoid
confusing lexgrog.
Thanks, Niko Tyni.
* Test C<> in the NAME section.
2009-01-17 Russ Allbery <rra@stanford.edu>
* VERSION: podlators 2.2.2 released.
* New file testing Pod::Man options for changing the .TH line of the
generated man page.
* Correctly handle indentation of verbatim paragraphs that contain
lines with only whitespace. Thanks, Renee Baecker.
* Test for this fix.
