| Commit message (Collapse) | Author | Age | Files | Lines |
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
5.00 - 2022-11-25: Changes
Drop support for Perl 5.8. The minimum required version is Perl 5.10.
The default output encoding of Pod::Man on non-EBCDIC systems is now
UTF-8. The utf8 option (-u or --utf8 to pod2man) is now ignored, since
it is the default. See the ENCODING section of its documentation for
testing results and further discussion. (#68741)
Pod::Man now supports an encoding option (-e or --encoding to pod2man),
to change the output encoding to any encoding recognized by Encode, or
the special values groff or roff. Setting it to roff requests the old
behavior of using character substitutions and *roff escapes to generate
ASCII-only output (the default prior to this version).
Pod::Man now supports the groff output encoding, which replaces all
non-ASCII characters with \[uNNNN] escapes. This escape was not
supported by the originally *roff implementation, but it is supported
by groff and mandoc and allows proper representation of Unicode
characters. This output format has no known advantages in portability
over UTF-8 on non-EBCDIC systems. It is the default output format on
EBCDIC systems, and when the Encode module is not available. (#73804)
Pod::Man no longer does guesswork transformations that only affected
troff output. Formatting manual pages with troff is exceptionally
rare, and this magic caused constant maintenance issues. This means
"--" is no longer changed to an em-dash, strings of capital letters
aren't made a bit smaller, no attempt is made to change double quotes
to paired quotes, and no special formatting is done for C++. (#132007)
Guesswork (formatting rules based on heuristics intended for Perl
documentation) can now be disabled or selectively enabled in Pod::Man
with the guesswork option (--guessword to pod2man). (#143668)
Pod::Text now supports an encoding option (-e or --encoding to
pod2text) to force the output encoding, similar to Pod::Man. The utf8
option (-u or --utf8 to pod2text) is still supported and is equivalent
to setting encoding to UTF-8.
Pod::Text now defaults to UTF-8 encoding if it sees a non-ASCII
character on a non-EBCDIC system and the input encoding is not
specified. This should fix rendering of E<> escapes of non-ASCII
characters in POD files that don't specify an input encoding, at the
cost of assuming UTF-8 output. Pod::Text also now commits to an
encoding the first time it outputs a non-ASCII character and sticks
with that encoding for the rest of the file, even if the detected or
declared input encoding changes. (#102631)
Stop using a PerlIO encoding layer for Pod::Text output and instead
use Encode. If a PerlIO encoding layer is already set, trust it and do
no encoding. This fixes encoding problems with output to a string.
Add a coding tag comment to the start of Pod::Man output if the output
encoding is not ASCII. groff's preconv program and FreeBSD's mandoc
will use this line to determine the input encoding.
Pod::Man now supports a language option (--language to pod2man) that
adds groff language configuration commands to the start of the output.
This is required for proper line breaking of Japanese and Chinese text
when the manual page is not installed in a language-specific directory
so that the man program knows to add that configuration automatically.
Unfortunately, the commands added when this option is used are
groff-specific. Thanks to zynldyx for the bug report and suggested
fix.
Pod::Man now converts Unicode zero-width spaces (U+200B) to the *roff
escape \:, which indicates a line break point without a space or
hyphen. (Unfortunately, groff does not honor U+200B itself as a line
break point.) This escape is not part of the language defined in CSTR
this escape won't cause problems. (Debian Bug#941980)
Pod::Man and Pod::Text now correctly honor S<> wrapping L<> with an
anchor and URL, and make the space between the anchor and URL
nonbreaking. (#143768)
Clear the current font before changing fonts in all Pod::Man output,
not just headings. groff 1.22.4 does not clear bold or italic when
seeing \f(CW font change, which meant bold and italic were extending
farther than they should without this change. (#143667)
Honor the quotes, lquote, and rquote configuration parameters to
Pod::Man for C<> text inside the special NAME section. (#143967)
Pod::Man suppresses quote marks around some additional cases of Perl
code in C<> where the intent had been to suppress the quotes but there
were various bugs in the matching regular expressions. This primarily
affects method calls and negative numbers.
Avoid non-standard *roff escape in the troff accent mark definition for
an acute accent. \h"..." was used instead of \h'...' as seen in the
other accent mark definitions. This error appears to have existed
since the first version of Pod::Man. Thanks, Paul Evans. (GitHub #14)
Document that nroff adds two spaces after each sentence when reflowing,
and therefore if you want formatted Pod::Man output to consistently
have one space after each sentence, you will have to avoid ending a
sentence at the end of a line in the middle of a paragraph.
Committer: Adjust Porting/Maintainers.pl and Porting/sync-with-cpan to
reflect upstream acceptance of customizations in core distribution.
|
| |
|
|
|
|
| |
(nor is EBCDIC necessarily z/OS). Fix conditional
|
|
|
|
|
|
|
|
| |
There are a number of files excluded using gitignore rules that are
included in the repository. This can lead to confusion if something
other than git tries to read the ignore files.
Add rules to the gitignore files so that these files won't be ignored.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
[DELTA]
podlators 4.14 (2020-01-04)
Document that parse_lines and parse_string_document expect raw bytes,
not decoded characters.
Fix the test suite use of parse_string_document to pass in raw bytes
rather than decoded characters, which will hopefully fix test failures
with versions of Pod::Simple older than 3.22 and is a more correct
test of encoding handling.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
[DELTA]
podlators 4.13 (2019-12-25)
Drop support for Perl 5.6. The minimum supported version is now Perl
5.8. Perl 5.6 had not been tested even by CPAN Testers in some time
and isn't supported by Travis-CI, so true support is dubious.
Dropping that version allows cleaning up some old compatibility code.
Fix a warning when outputing to something without a PerlIO layer, such
as when output_string is used.
[Pod::Text] Fix behavior of S<> with Unicode input to be consistent
with behavior with a default encoding, namely treat all whitespace
inside S<> as non-space characters and do not collapse it with
adjacent whitespace.
[Pod::Text::Termcap] Remove an ancient workaround that set the
TERMPATH environment variable whenever a Pod::Text::Termcap object was
created in order to add /usr/share/lib/termcap, necessary on some
ancient Solaris systems. Setting environment variables is bad
behavior for a module, and the Solaris systems requiring this
workaround are long obsolete.
[Pod::Text::Termcap] Remove the fallback to VT100 escape sequences if
Term::Cap was not able to find sequences for bold, underline, or
normal text, and instead skip that part of the formatting. This will
produce more correct behavior on dumb terminals at the possible cost
of losing formatting on systems with malfunctioning terminal
databases, which seems like an improvement. Thanks, Zenin. (#131124)
Further improve the man/no-encode.t test to not care whether Encode
was already loaded or not. Thanks, Martin Becker.
Improve logic for showing large test failures to avoid spurious
failures on systems without diff.
|
|
|
|
|
|
|
|
|
|
| |
[DELTA]
podlators 4.12 (2019-05-31)
Skip the man/no-encode.t test if Encode is already loaded while
running the test suite, which seems to happen sometimes with CPAN
Testers tests.
|
|
|
|
| |
(This includes the former blead customization.)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
[DELTA]
podlators 4.10 (2017-12-25)
[Pod::Man] Change man page references and function names to bold
instead of italic, following the current Linux man page standard. The
previous formatting was taken from Solaris, and it seems safe to say
that the Linux man page formatting conventions are now much more
widely followed than Solaris's. Patch from Guillem Jover.
[Pod::Man] Revert the .IX handling code to the earlier version from
Bjarni Ingi Gislason but add the trailing backslashes that should
hopefully avoid blank page issues on HP-UX. This fixes a warning
regression when man is run with warnings enabled. (Debian Bug#847972)
[Pod::Man] Wrap the output file descriptor in a glob before passing it
to PerlIO::get_layers so that the layer check works properly.
Previously, this code would throw a warning if given a scalar not
wrapped in a glob and not detect layers properly. Patch from Zefram.
(#122521)
Produce a proper diagnostic when given empty input on standard input
with no other arguments to pod2man or pod2text. Reported by Guillem
Jover.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
[DELTA]
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)
|
| |
|
| |
|
|
|
|
|
|
| |
It's only perlpodstyle that we can't build the man page for since
it lives in the top-level pod/ directory. Plus there was a new test
that I had missed in the integration.
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
Remove the Changes file that didn't need to be added; also remove the
VERSION file, which I see no need for -- Makefile.PL says that the distro's
version comes from lib/Pod/Man.pm, and in fact all the .pm files have the
same version anyway.
Note: Porting/Maintainers.pl is out of sync in its notes about pod2man and
pod2text (and doesn't note that Makefile.PL is locally modified), but
that's about to change in 4.05 anyway, so no point in fixing right now.
|
| |
|
| |
|
| |
|
|
|
|
| |
This incorporates CPAN RT #87440.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
[DELTA]
2013-02-27 Russ Allbery <rra@stanford.edu>
* VERSION: podlators 2.5.1 released.
* t/color.t: Add Z<> to tag width test to avoid triggering the new
Pod::Parser warning about numeric items in description lists.
* t/overstrike.t: Likewise.
* t/termcap.t: Likewise.
* t/man.t: Remove the test for proper handling of lists that start
with a non-bullet and then have an item that looks like a bullet.
This now triggers a warning in Pod::Simple. Move it to...
* t/man-options.t: ...here, where we can configure the parser to
ignore errors and test that the output is correct.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
[DELTA]
2013-01-02 Russ Allbery <rra@stanford.edu>
* VERSION: podlators 2.5.0 released.
* lib/Pod/Man.pm (guesswork): Extend a small-caps section through
the punctuation that commonly appears in license disclaimers so
that small caps isn't turned on and off at the boundaries of every
word, producing unreadable *roff.
* t/man.t: Test the updated small-caps behavior.
* lib/Pod/Man.pm (new): Support a new errors option with values
die, stderr, pod, and none. Convert the stderr option to the
errors option with value stderr. (#39007)
(end_document): Die if errors was set to die and there were POD
syntax errors.
* lib/Pod/Text.pm (new): Likewise.
(end_document): Likewise.
* scripts/pod2man: Support a new --errors option that sets the
underlying errors formatter option and default to dying on POD
syntax errors.
* scripts/pod2text: Likewise.
* t/man-options.t: Add support for catching exceptions during
formatting. Test valid and invalid errors settings.
* t/text-options.t: Likewise.
* lib/Pod/Man.pm (cmd_l): Add nourls option to suppress the URL
from L<> formatting codes that contain anchor text. (#62210)
* lib/Pod/Text.pm (cmd_l): Likewise.
* scripts/pod2man: New --nourls option to set the corresponding
option in Pod::Man.
* scripts/pod2text: Likewise for Pod::Text.
* t/man-options.t: Test new nourls option.
* t/text-options.t: Likewise.
* lib/Pod/Man.pm (outindex): Also collapse consecutive whitespace
in index term text.
* t/man.t: Test for handling of index terms containing whitespace.
2013-01-02 Kevin Ryde <user42@zip.com.au>
* lib/Pod/Man.pm (outindex): Remove newlines from index term text
since *roff quotes don't span lines. (#82332)
2012-06-01 Russ Allbery <rra@stanford.edu>
* VERSION: podlators 2.4.2 released.
* t/text-encoding.t: Remove the test of a POD document without an
encoding. We previously tested that this interpreted the document
as ISO 8859-1, but Pod::Simple behavior has changed so that the
test started failing, plus Pod::Simple now warns about a missing
=encoding. (#77553)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
[DELTA]
2012-06-01 Russ Allbery <rra@stanford.edu>
* VERSION: podlators 2.4.2 released.
* t/text-encoding.t: Remove the test of a POD document without an
encoding. We previously tested that this interpreted the document
as ISO 8859-1, but Pod::Simple behavior has changed so that the
test started failing, plus Pod::Simple now warns about a missing
=encoding. (#77553)
2012-05-30 Russ Allbery <rra@stanford.edu>
* VERSION: podlators 2.4.1 released.
* lib/Pod/Man.pm (parse_file): Override the Pod::Simple method to
set output_fh to STDOUT if it's not already set. (#77530)
* lib/Pod/Text.pm (parse_file): Likewise.
|
|
|
|
|
|
|
|
| |
Upstream removed the wrappers from the scripts pod2man and pod2text which
will require some re-engineering. I've reinstated the wrappers until after
v5.13.6 ships.
Added perlpodstyle to pod.lst
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
The new perlpodstyle.pod has been located to pod/
Changes were necessary to mkppport because of a new dependency on
Encode in podlators that stopped it being built before Encode was built.
[DELTA]
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.
|
| |
|
|
|
|
|
| |
Using make_ext to generate it uses less code than committing a special
core-only Makefile.PL to the repository, and is no more complex.
|
|
|
|
|
| |
Let ExtUtils::MakeMaker deal with running these extraction scripts, rather than
repeating the logic in (at least) 5 places.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When porting/makerel runs, all files copied into the directory for the
tarball have the executable bit stripped and then only a specific set of
files have the executable bit restored.
There are many files in the repo that have the executable bit set in the
repo that will be stripped. So that the state of files in the repo is
as close as possible to the state of files in the release tarball, the
executable bit has been stripped from such files.
In one recent case, a file added from a dual-life module needed the
executable bit set. Because it had the bit in the repo but was
not listed in makerel to get an executable bit, tests using it
passed in the repo and failed in the tarball.
This commit refactors the list into a new file, Porting/exec-bit.txt
and add tests to detect a mismatch between files listed there
and actual executable bits in the repo.
|
|
|
|
|
| |
Ensures that all $VERSIONs are bumped in files that have changed since
Perl 5.11.4.
|
| |
|
|
|