ANDREWF / Pod-POM-0.29 / Changes

#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for Pod::POM module.
#
# AUTHOR
#   Andy Wardley   <abw@kfs.org>
#   Andrew Ford    <A.Ford@ford-mason.co.uk>
#
#------------------------------------------------------------------------
# $Id: Changes 91 2013-12-31 07:36:02Z ford $
#========================================================================

#------------------------------------------------------------------------
# Version 0.29  2013-12-31
#------------------------------------------------------------------------

* fixed bug 87124 (upgrade Module::Install)

* fixed bug 90010 (typos)

#------------------------------------------------------------------------
# Version 0.28  2013-05-30
#------------------------------------------------------------------------

* fixed bug 81707 (test failures due to hash randomisation in perl 5.17.6)

* change 'use vars' to 'our' declarations


#------------------------------------------------------------------------
# Version 0.27  2010-04-02
#------------------------------------------------------------------------

* changed 'unless (defined (%{"$class\::ACCEPT"}))' to just
  'unless (%{"$class\::ACCEPT"})' in Pod::POM::Node to fix defect #56205
  (use of the now deprecated "defined(%hash)" construct)

#------------------------------------------------------------------------
# Version 0.26  2009-08-20
#------------------------------------------------------------------------

* updated Makefile.PL to require at least 2001.0929 of Text::Wrap, as 
  versions prior to this always unexpand tabs.

* applied Andreas Koenig's encoding patch

* changed 'use base' to 'use parent'

* split Pod::POM::Nodes into separate modules, retaining the original file
  to just use all the individual node modules.

* added AF to author and copyright info for modules (in addition to ABW)

#------------------------------------------------------------------------
# Version 0.25  2009-03-27
#------------------------------------------------------------------------

* updated Makefile.PL to use Module::Include properly - i.e. flag modules
  as test_requires as appropriate

* output test failure reason with diag()

* added t/YAML/Tiny.pm (self-contained YAML library) to remove test-only
  module dependency

* test library uses Test::Differences if available but package does not 
  list it as a dependency

#------------------------------------------------------------------------
# Version 0.24  2009-03-21
#------------------------------------------------------------------------

* fixed broken YAML files in testcases that were causing tests to fail on
  some platforms

* added text and HTML verbatim paragraph view tests

* fixed typo in synopsis in Pod::POM


#------------------------------------------------------------------------
# Version 0.23  2009-03-20
#------------------------------------------------------------------------

* Applied JJ's patch for coalescing verbatim paragraphs separated by blank lines
  and refined verbatim paragraph test cases and expected output

* Tweaked pom dump format to quote individual text lines

* Tweaked PodPOMTestLib to remove dependency on Class::Accessor

* Added test cases for =headN hierarchy and =begin blocks

* Added format name to =end in Pod::POM::View::Pod

* Switch Makefile.PL to Module::Include

#------------------------------------------------------------------------
# Version 0.22  2009-03-19
#------------------------------------------------------------------------

* Added missing dependencies to Makefile.PL

* Added pomdump program to list of executables

#------------------------------------------------------------------------
# Version 0.21  2009-03-18
#------------------------------------------------------------------------

* Added missing dependencies to Makefile.PL

#------------------------------------------------------------------------
# Version 0.20  2009-03-17
#------------------------------------------------------------------------

* Added basic pod documentation to the view modules

* expanded the test cases (especially expanded sequences and blockquote
  paragraphs)

* add support for blockquote paragraphs to Text and HTML views


#------------------------------------------------------------------------
# Version 0.19  2009-03-17
#------------------------------------------------------------------------

* Added dump method to Pod::POM::Node

* Reorganized tests with new testcases directory


#------------------------------------------------------------------------
# Version 0.18  2009-03-11
#------------------------------------------------------------------------

* Add patches from RT

  * BOOK's ticket #24266: Proposed correction for bugs #1949 and #5759
    (As described in tickets #1949 and #5759, the content =begin/=end blocks
     should be treated as data text (no sequence parsing, etc).)

  * JJ's ticket #16764: Problem handling paragraph separators - incompatibility with perlpodspec
    (Pod::POM 0.17 does not accept blank lines containing whitespace as
    paragraph separators, it only accepts blank lines containing no
    characters at all. According to perlpodspec, blank lines containing
    whitespace should be taken as paragraph separators.

* Modified pom2 to search for viewer modules other than Pod, Text and
  HTML in @INC, and to pass any options to the constructor method.

#------------------------------------------------------------------------
# Version 0.17  
#------------------------------------------------------------------------

* Pod::POM::View::Pod::view_item could have $title non reference, so
  handle that gracefully.

* add 'fallback => 1' to use of overload in Pod::POM::Node.

#------------------------------------------------------------------------
# Version 0.16  
#------------------------------------------------------------------------

* Pod::POM::View::Text and Pod::POM::View::HTML now implement F<>
  rendering similar to I<>. Tests adjusted. [Stas Bekman]

* Added 'bool' overload to Pod::POM::Node to prevent unwanted 
  stringification of nodes simply to test their truth.  Also removed
  C<length $text> test from Pod::POM::Nodes::Text::present() which
  was having the same early stringification side-effect.


#------------------------------------------------------------------------
# Version 0.15  8th March 2002
#------------------------------------------------------------------------

* Applied a patch from Stas Bekman to re-implement view_seq_link() in 
  Pod/POM/View/HTML.pm
  
  - don't add "the foo manpage" automatically. 
  - implement a big part of the L<> according to the spec, parts
    borrowed from Pod::HTML
  - the implementation includes an optional callback which can be
    sub-classed to provide transformations of the 'page' part of the L<>
    tag. For example if the page is located elsewhere.

* Applied another patch from Stas to fix view_seq_text()

  - ! and ; are also punctuation chars
  - fix comment typos
  - fix incorrectly parsed url followed by punctuation at the end of string:


#------------------------------------------------------------------------
# Version 0.14  25th February 2002
#------------------------------------------------------------------------

* Added the visit(), leave() and visiting() methods to Pod::POM::View 
  to allow visitors to track elements of the path that they've taken.
  This allows one method to know if it has been called within the context
  of another.  

#------------------------------------------------------------------------
# Version 0.13  6th February 2002
#------------------------------------------------------------------------

* Applied a patch from Leon Brocard to change 'length' to 'defined' to
  make Pod::POM work OK with bleadperl.

* Changed Pod::POM::View::HTML view_seq_text() method to automatically
  escape < > and &.  Thanks to lazy POD author Mark Fowler for raising 
  the issue. :-)


#------------------------------------------------------------------------
# Version 0.12  3rd January 2002
#------------------------------------------------------------------------

* Applied a patch from Stas Bekman which:

  - fixes the over/item functionality (quite a few very missing), see 
    the tests

  - fixes a bug revealed with "" overload

  - changes HTML version to be <code>foo</code>, not '<code>foo</code>'

  - adds the URL hyperlinking code, borrowed from bleadperl's Pod::Html.

* Fixed a typo in the SYNOPSIS and removed some dead spaces.  Thanks to 
  Ron Savage for reporting the problems.  

* Added Ron's fancy-pom2.pl script as bin/custom-pom2

* Renamed pomcheck to podlint because it is a much catchier name :-)

* Added some docs to bin/pom2 and bin/podlint

* Several other minor documentation fixes and improvements.
 

#------------------------------------------------------------------------
# Version 0.11  2nd December 2001
#------------------------------------------------------------------------

* Fixed HTML view_verbatim() to escape < > and & to HTML entities.

* Bumped version number up to 0.11 to ensure it supercedes the ill fated
  0.1 release which has been confusing CPAN ever since (0.1 < 0.03)


#------------------------------------------------------------------------
# Version 0.03  26th November 2001
#------------------------------------------------------------------------

* Fixed HTML view_head1() to remove illegal <ul> ... </ul> tags.  Also
  modified view_over() to detect the type of the first item 
  (e.g. '=item *', '=item 1.' or '=item foo') and adjust accordingly to
  create a '<ul>...</ul>' or '<ol>...</ol>' list.  Item titles of the 
  form '*' or '1.' then get stripped off as appropiate.   Thanks to 
  Stas Bekman for raising these issues.

* Added support for new =head3 and =head4 POD tags, also due to prodding 
  from Stas.  :-)

* Added support for experimental 'meta' tag.  Disabled by default.


#------------------------------------------------------------------------
# Version 0.02  09-Apr-2001
#------------------------------------------------------------------------

* Fixed several bugs in Pod/POM/Nodes.pm where I had relied on the 5.6.0
  "Do The Right Thing" behaviour of C<$EXPECT = qw( ... )> to correctly
  quote a single string.  Now changed to C<$EXPECT = '...'>.  Thanks
  to Randal Schwartz for identifying the problem.

* Added C<use Pod::POM::View> to Pod::POM::View::* modules because 
  C<use base qw( Pod::POM::View )> doesn't do it automatically for
  you in some earlier versions of Perl, even if it says it does.

* Updated documentation to refer to released Template Toolkit v2.02
  and added a little more on using the Pod plugin and VIEW directive
  to munge Pod.

* Changed the Pod::POM::View::Text module to be smarter about indenting,
  keeping track of a current indent level via an internal INDENT member
  (when used as an object) or the package variable $INDENT (when used
  as a class) instead of the previous approach of blindly stuffing 
  everything through Text::Wrap as an afterthought.  Converting Pod to
  text is now significantly faster and should generate correctly indented
  output.
  

#------------------------------------------------------------------------
# Version 0.01  09-Jan-2001
#------------------------------------------------------------------------

* first public release.



Hosting generously
sponsored by Bytemark