Your IP : 216.73.216.86
CHANGES 0000644 00000010223 15170754416 0005547 0 ustar 00 1.69 (marekr)
- CPAN#111313: Makefile creation issue with Pod-Usage-1.68
thanks to H M Brand for the suggestion on how to create a more portable
tar.gz distribution file
- CPAN#109830: Tests fail
bundle some old Pod::Parser modules in the test so that there is no more
dependency. This has to refactored one day to entirely get rid of that
1.68 (marekr)
- CPAN#102529: License declaration mismatch
unified the license for Pod-Usage to "as Perl itself", and corrected authors
- CPAN#109830: Tests fail
added prerequisite for Pod::Text 4.00 to avoid running tests with outdated
Pod::Text
- CPAN#110443: [PATCH] fix -perldoc option in pod2usage() method
added missing '-'
- CPAN#110446: [feature request] -perldocopt for supplying perldoc options
added this option; split of string on whitespace is not optimal, but
should do the job
1.67 (marekr)
- added options -perlcmd and -perldoc to allow for non-standard installations
of perl and the perldoc script. Thanks to Markus Jansen for the patch
1.66 (marekr)
- CPAN#102116: pod2usage() -sections omits section with subsection specified
added more precise documentation about the -section syntax and semantics
- CPAN#102117: pod2usage() changes formatting
added documentation to describe what formatting changes pod2usage applies
- CPAN#102101: New tests fail when in core
changed the way the tests find their dependencies. Thanks to BINGOS for
the patch, applied in slightly modified way
1.65 (marekr)
- CPAN#81059: [RT #115534]: Pod::Usage Failes to Select -sections with Negation
fixed a specific corner case for section selection
- CPAN#101538: Pod::Usage doesn't handle E<copy> correctly
introduced a utf8 option; this may actually not solve the problem, but
it is the best we can do for the moment
- CPAN#101581: pod2usage() -sections omits marked-up text from =head lines
make sure that marked-up text is not skipped
1.64 (marekr)
- CPAN#93170: Abstract in pod doesn't follow convention
fixed the NAME section
- CPAN#86932: documentation does not work with use strict
rewritten parts of the DESCRIPTION section
- CPAN#86776: "pod2usage -verbose 2 FILE" is broken when perldoc is missing
verified that pod2usage acts decently if perldoc is missing
note: a Perl installation without perldoc is like a haunted house
without ghosts
1.63 (marekr)
- CPAN#85477: Module version not updated in last release
...fixed
- CPAN#85478: typo fixes
...corrected
1.62 (marekr)
Patches provided by rjbs - many thanks!
- These commits update Pod::Usage to only use Pod::Simple, so that any
reliance on Pod::Parser is removed, making it easier to remove Pod::Parser
from core.
- [PATCH 1/4] update Makefile: strict, INSTALLDIR, 5.6
- [PATCH 2/4] we will start to require perl 5.6 from here on out
- [PATCH 3/4] always use Pod::Text as default base class
- [PATCH 4/4] eliminate the branch in which Pod::Parser would be used
This commit is intended entirely to free Pod::Usage from any reliance on
Pod::Parser.
* Usage.pm now defaults to using Pod::Text, rather than checking $] to pick.
* $Pod::Select::MAX_HEADING_LEVEL is replaced with a local var
* &Pod::Select::_compile_section_spec is copied into this module
This isn't the most elegant fix, but it's a bit of a ball of mud. The code
is written to let you alter @ISA at runtime to something that is derived
either from Pod::Parser or Pod::Simple. This should probably be more
explicitly limited to Pod::Simple in future releases.
1.61 (marekr)
- fix empty META.yml (CPAN RT#83118: META.yml is empty)
- update outdated test expected data (CPAN RT#83111: fails test)
1.60 (marekr)
- moved POD behind __END__ for slighlty quicker loading
- CPAN RT#81387: 2 suggestions for module Pod::Usage
added example of how to use FindBin to locate the script;
added $Pod::Usage::Formatter to allow a different base class
- CPAN RT#75598: [PATCH] Don't use perldoc if it is missing
implemented as suggested in the RT ticket
- factored Pod::Usage out of the Pod-Parser distribution into a separate one,
in order to prepare the rewrite based upon Pod::Simple
- thanks to rjbs for driving this
For prior changes, see the Pod::Parser change log.
README 0000644 00000004647 15170754416 0005451 0 ustar 00 Pod::Usage
----------
The Perl5 module "Pod::Usage" which provides the function "pod2usage()"
to print usage messages for a Perl script based on its embedded pod
documentation. Pod::Usage is a subclass of Pod::PlainText. Please see
the POD documentation for this module (embedded in the file "Usage.pm")
for more details. The pod2usage() function is probably the most
generally useful function in this entire distribution since it is
useful to just about any Perl5 script that is invoked from the
command-line.
See the POD documentation for more details.
This separate distribution was created to allow refactoring of Pod::Usage
to use Pod::Simple instead of Pod::Parser, such that Pod::Parser can be
discontinued from the Perl Core in the near future.
AUTHORS/CONTRIBUTORS
====================
Marek Rouchal <marekr@cpan.org>
Brad Appleton <bradapp@enteract.com> http://www.enteract.com/~bradapp/
rjbs for driving the transition to Pod::Simple
LICENSE
=======
Pod-Usage is free software; you can redistribute it and/or modify it
under the same terms as the Perl 5 interpreter. Please refer to
http://dev.perl.org/licenses/ for more details.
DISCLAIMER
===========
This software is distributed in the hope that it will be useful, but
is provided "AS IS" WITHOUT WARRANTY OF ANY KIND, either expressed or
implied, INCLUDING, without limitation, the implied warranties of
MERCHANTABILITY and FITNESS FOR A PARTICULAR PURPOSE.
The ENTIRE RISK as to the quality and performance of the software
IS WITH YOU (the holder of the software). Should the software prove
defective, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
CORRECTION.
IN NO EVENT WILL ANY COPYRIGHT HOLDER OR ANY OTHER PARTY WHO MAY CREATE,
MODIFY, OR DISTRIBUTE THE SOFTWARE BE LIABLE OR RESPONSIBLE TO YOU OR TO
ANY OTHER ENTITY FOR ANY KIND OF DAMAGES (no matter how awful - not even
if they arise from known or unknown flaws in the software).
REQUIREMENTS
============
* Perl version 5.005 or later
* Pod::Simple from CPAN (already bundled in recent Perl 5 releases)
BUILDING & INSTALLING
=====================
Please see the perl "ExtUtils::MakeMaker" manpage for how to build and
install using the Makefile.PL template. In a nutshell, simply typing:
perl Makefile.PL
should build a Makefile with the usual targets like "all", "clean",
"test", and "install".
BUGS
====
Please use the CPAN bug tracking to report bugs:
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Pod-Usage