Revision history for Getopt-Euclid

0.4.8  2024-10-22
  - another set of test failures on perls without '.' in @INC
  - Promoting previous trial release to stable

0.4.7  2024-08-28 (TRIAL RELEASE)
  - Don't fail tests on perl >= 5.41.3 (removal of apostrophe as
    package separator (GH PR #2, thanks to jkeenan)

0.4.6  2023-06-28
  - David Precious (BIGPRESH) taking on maintainership
  - Avoid test failures on perls without '.' in @INC (reported by TODDR in
    RT#127234)
  - Minor wording change (reported by Debian team in RT #95412)


0.4.5  2014-03-21
  - Fixed bug when parsing arguments with missing variable (reported by Torbjørn
    Lindahl)

0.4.4  2013-08-21
  - Fixed bug with Bleadperl v5.19.2-257-gc30fc27 (bug #87804, reported by
    Andreas Koenig, patch by Dave Mitchell)
  - New process_pod() method to specify arbitrary list of POD files to parse
    (bug #87592, requested by zdm)
  - More optional default checks

0.4.3  2013-07-22
  - Added a check for .default and .opt_default references in argument description
  - Speed optimizations

0.4.2  2013-07-17
  - Ignore POD from .pod files generated by earlier versions of Getopt::Euclid

0.4.1  2013-07-17
  - Support for default values defined based on variables

0.4.0  2013-02-08
  - Fixed issue with option values that are substrings of others (bug #76728, 
    reported by Igor Kleshchevich, patch by James F Hester)
  - Update of META.yml (bug #83221)

0.3.9  2012-12-12
  - Fixed issues in mutually exclusive arguments that have default values (RT
    bug #81630 again)

0.3.8  2012-12-03
  - Messages respect order of user options (fixes RT bug #81630)
  - Show --man and --usage in help message
  - Prevent a trailing whitespace in --help usage string

0.3.7  2012-08-08
  - Fixed too enthusiastic variable interpolation in Euclid specs (RT bug #78854)
  - Fixed bug tracker URL (credits to Kent Fredric)

0.3.6  2012-07-31
  - Fixed occasional non-minimized entry when using :minimal_keys specifier

0.3.5  2012-02-20
  - Removed extraneous \E (patch by Todd Rinaldo)
  - Better handling of quoted arguments (RT bug #49525, reported by Ken Galinsky)

0.3.4  2012-02-12
  - New standard argument --podfile to write the manual in a .pod file
  - Fixed issue where the NAME and VERSION sections appeared as a verbatim
    section (which podchecker complains about)
  - Always convert POD to text when calling help() and man()
  - help() is now paged if IO::Pager::Page is installed
  - Dependency changes:
      Pod::Simple::Text replaces Pod::Text
      Pod::Simple::Text is required instead of recommended,
      IO::Pager::Page is recommended

0.3.3  2012-01-06
  - Attempt to extract POD even from files that look binary (might be packaged
    with pp, perlapp or similar program)

0.3.2  2011-10-28
  - Another attempt to make the CPAN indexer happy

0.3.1  2011-10-27
  - Changed $VERSION to make the CPAN indexer happy
  - Export repeatable options with multiple placeholders as an empty arrayref,
    not as an empty hashref (RT bug #71165, reported by Bill Levering)

0.3.0  2011-09-13
  - Reverted feature to match POD head section =head2, =head3 and =head4 because
    of backward compatibility issue (RT bug #70942)

0.2.9  2011-09-03
  - This command does not generate warnings anymore:
    perl -e 'use Getopt::Euclid; print $Getopt::Euclid::VERSION;'
  - Required and optional arguments can now be put in a POD head section =head2,
    =head3 and =head4 for more flexibility

0.2.8  2011-09-02
  - Support for optional defaults (RT bug #61438, patch from Paolo Medeo)
  - Extended the grammar of recognized POD headers for required and optional arguments:
    [STANDARD|STD|PROGRAM|SCRIPT|CLI|COMMAND[-| ]LINE] [REQUIRED|MANDATORY] [PARAM|PARAMETER|ARG|ARGUMENT][S]
    [STANDARD|STD|PROGRAM|SCRIPT|CLI|COMMAND[-| ]LINE]      OPTION[AL|S]    [PARAM|PARAMETER|ARG|ARGUMENT][S]
  - Usage error message now mentions the --man option in addition to --help

0.2.7  2011-07-12
  - Updated dependencies in Build.PL module

0.2.6  2011-07-11
  - Bugfix: corrected a .pod file finding issue

0.2.5  2011-07-10
  - Bugfix for #69324: more efficient and accurate POD extraction using Perl::Tidy
  - Bugfix for #29301: automatically looking for POD located into .pod files
  - Bugfix for #69105: file META.yml states which license the module uses
  - Bugfix for #34200: variables in constraint specifications are read as
    originating from the 'main' package namespace
  - Little internal modification to prevent identical placeholders that are
    present multiple times in the specification to be processed multiple times.
  - Error messages for arguments that do not validate against the constraints
    now display the value of variables instead of their name.

0.2.4  2011-06-23
  - Default values can now be specified in the POD and displayed in the program
    documentation
  - Support for more integer arguments, e.g. scientific notation like 1E8
  - Support for arguments that cannot coexist using the 'exclude' keyword
  - New specifier to defer processing of @ARGV arguments: :defer
  - New method to pass an arbitrary array of arguments to parsing: process_args
  - New methods to access the program usage, version, manual and help messages
  - When a version number is missing from the POD or $main::VERSION, the file
    time and date are used as version number
  - The help message now includes --version and is more consistent with the
    usage message
  - Bugfix: the options in the help message are no longer randomly sorted
  - Bugfix: the man page is now properly formed when .pm files that have no POD
    are use'd
  - Bugfix: when the --man flag was passed and the script name was, e.g. 'myprog'
    instead of 'myprog - short description', an undef warning was issued
  - Bugfix: when the --help flag was passed and either no required arguments or
    no optional arguments were specified in the POD, an undef warning was issued
  - Bugfix: the POD parsing mechanism now removes rogue PODs hidden inside
    variables and other Perl-quoted strings
  - Bugfix for #34195: addresses compatibility with Perl compiling (syntax check)
  - Bugfix for #34207: .type.error is now taken into account properly
  - Bugfix for #38461: file path that uses the volume and dir
  - Bugfix for #34199: new subroutine _check_name() verifies that argument name
    specifications are well-balanced with <> brackets

0.2.3  Tue Sep 14 2010
  - #61321 - made tests that require writeable files set own properties to 644

0.2.2  Thu Sep  9 19:30:55 2010
  - #28474 - fixed the way name was being parsed
  - #35895 - line delimiters converted to newlines
  - #49524 - fixed way POD parsed so that headers after a =cut get parsed
             properly
  - #55259 - created $SCRIPT_VERSION variable containing parsed version
  - #61039 - don't insert default value for options with optional placeholders
             where the flag is given but a value for the placeholder is not

0.2.1  Sun May 31 12:57:07 2009
  - Removed BEGIN blocks and simply brought the defined variables to the top
    of the module (thanks Todd)
  - Update POD to make sure people don't "use Getopt::Euclid ();"
  - Removed debugger break point (thanks Diab)
  - Removed no bugs claim in POD

0.2.0  Sat Aug  4 17:22:31 2007
  - Added fallback to $main::VERSION if version not specified in Pod
    (thanks Todd and Thomas)
  - Added non-zero exit value on bad arg list (thanks Toby)
  - Changed module behaviour: now removes identified arguments from @ARGV.
    on successful match (thanks Aran and Tim)
  - Allowed alternations everywhere (i.e. outside optionals too)
  - Allowed E<lt> and E<gt> in option specifiers (thanks Wes)

0.1.0  Thu Nov  2 19:47:05 2006
  - Fixed failure to recognize +integer and 0+integer type specification
    (thanks Ron)
  - Added quotemeta'ing of regexically special characters 
    (thanks Ron)
  - Repatched :vars<opt_> mode to really export all args
    (thanks again Tim!)

0.0.9  Thu Oct 26 21:18:46 2006
  - Patched :vars<opt_> mode to export all args (thanks Tim!)

0.0.8  Sun Oct  8 12:45:17 2006
  - Remove spurious smart comments
  - Added missing documentation for placeholder misspecification diagnostic
  - Made contents of validator subs fallback to main::
  - Allowed false: flags to be regexes
  - Fixed readable/writable test for '-' (thanks Thomas)
  - Added regexes as valid placeholder type constraints

0.0.7  Tue Oct  3 03:54:01 2006
  - Added :vars<opt_> mode (thanks Tim!)
  - Fixed option names containing dashes. (thanks Tim!)
  - Fixed minimal matching mode to more accurately detect clashes (thanks
    Thomas)
  - Added user-specified type.error messages (thanks Thomas)
  - Tightened up checking of placeholder type constraints (thanks Tim)

0.0.6  Sun Sep 17 02:48:04 2006
  - Removed spurious "compilation failed message" for interface errors
    (thanks David!)
  - Added 'repeatable' option (thanks Thomas)

0.0.5  Fri Feb 17 15:52:20 2006
  - Changed POD::Text to Pod::Text (curse you, case-independent MacOS X!! ;-)
  - Fixed erroneous bug report when only syntax checking with perl -c
  - Fixed bug in license defaults (thanks clpoda!)
  - Added :minimal_keys mode (thanks Thomas)

0.0.4  Thu Aug  4 18:03:28 2005
  - Fixed embarrassing encoding bug (thanks dakkar!)

0.0.3  Sun Jul 24 20:16:17 2005
  - Removed need for Smart::Comments

0.0.2  Sat Jul 23 04:37:18 2005
  No changes logged

0.0.1  Sun Jan 30 20:42:36 2005
  Initial release.