Unix/Linux Go Back    


CentOS 7.0 - man page for cpan::changes::release (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


CPAN::Changes::Release(3)      User Contributed Perl Documentation	CPAN::Changes::Release(3)

NAME
       CPAN::Changes::Release - Information about a particular release

SYNOPSIS
	   my $rel = CPAN::Changes::Release->new(
	       version => '0.01',
	       date    => '2009-07-06',
	   );

	   $rel->add_changes(
	       { group => 'THINGS THAT MAY BREAK YOUR CODE' },
	       'Return a Foo object instead of a Bar object in foobar()'
	   );

DESCRIPTION
       A changelog is made up of one or more releases. This object provides access to all of the
       key data that embodies a release including the version number, date of release, and all of
       the changelog information lines. Any number of changelog lines can be grouped together
       under a heading.

METHODS
   new( %args )
       Creates a new release object, using %args as the default data.

   version( [ $version ] )
       Gets/sets the version number for this release.

   date( [ $date ] )
       Gets/sets the date for this release.

   changes( [ $group ] )
       Gets the list of changes for this release as a hashref of group/changes pairs. If a group
       name is specified, an array ref of changes for that group is returned. Should that group
       not exist, undef is returned.

   add_changes( [ \%options ], @changes )
       Appends a list of changes to the release. Specifying a "group" option appends them to that
       particular group. NB: the default group is represented by and empty string.

	   # Append to default group
	   $release->add_changes( 'Added foo() function' );

	   # Append to a particular group
	   $release->add_changes( { group => 'Fixes' }, 'Fixed foo() function' );

   set_changes( [ \%options ], @changes )
       Replaces the existing list of changes with the supplied values. Specifying a "group"
       option will only replace change items in that group.

   clear_changes( )
       Clears all changes from the release.

   groups( sort => \&sorting_function )
       Returns a list of current groups in this release.

       If sort is provided, groups are sorted according to the given function. If not, they are
       sorted alphabetically.

   add_group( @groups )
       Creates an empty group under the names provided.

   delete_group( @groups )
       Deletes the groups of changes specified.

   delete_empty_groups( )
       Deletes all groups that don't contain any changes.

   serialize( group_sort => \&sorting_function )
       Returns the release data as a string, suitable for inclusion in a Changes file.

       If group_sort is provided, change groups are sorted according to the given function. If
       not, groups are sorted alphabetically.

SEE ALSO
       o   CPAN::Changes::Spec

       o   CPAN::Changes

       o   Test::CPAN::Changes

AUTHOR
       Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE
       Copyright 2011-2013 by Brian Cassidy

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.

perl v5.16.3				    2013-05-02			CPAN::Changes::Release(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 04:38 AM.