1CPAN::Changes::Release(U3s)er Contributed Perl DocumentatCiPoAnN::Changes::Release(3)
2
3
4

NAME

6       CPAN::Changes::Release - Information about a particular release
7

SYNOPSIS

9           my $rel = CPAN::Changes::Release->new(
10               version => '0.01',
11               date    => '2009-07-06',
12           );
13
14           $rel->add_changes(
15               { group => 'THINGS THAT MAY BREAK YOUR CODE' },
16               'Return a Foo object instead of a Bar object in foobar()'
17           );
18

DESCRIPTION

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

METHODS

27   new( %args )
28       Creates a new release object, using %args as the default data.
29
30   version( [ $version ] )
31       Gets/sets the version number for this release.
32
33   date( [ $date ] )
34       Gets/sets the date for this release.
35
36   changes( [ $group ] )
37       Gets the list of changes for this release as a hashref of group/changes
38       pairs. If a group name is specified, an array ref of changes for that
39       group is returned. Should that group not exist, undef is returned.
40
41   add_changes( [ \%options ], @changes )
42       Appends a list of changes to the release. Specifying a "group" option
43       appends them to that particular group. NB: the default group is
44       represented by and empty string.
45
46           # Append to default group
47           $release->add_changes( 'Added foo() function' );
48
49           # Append to a particular group
50           $release->add_changes( { group => 'Fixes' }, 'Fixed foo() function' );
51
52   set_changes( [ \%options ], @changes )
53       Replaces the existing list of changes with the supplied values.
54       Specifying a "group" option will only replace change items in that
55       group.
56
57   clear_changes( )
58       Clears all changes from the release.
59
60   groups( sort => \&sorting_function )
61       Returns a list of current groups in this release.
62
63       If sort is provided, groups are sorted according to the given function.
64       If not, they are sorted alphabetically.
65
66   add_group( @groups )
67       Creates an empty group under the names provided.
68
69   delete_group( @groups )
70       Deletes the groups of changes specified.
71
72   delete_empty_groups( )
73       Deletes all groups that don't contain any changes.
74
75   serialize( group_sort => \&sorting_function )
76       Returns the release data as a string, suitable for inclusion in a
77       Changes file.
78
79       If group_sort is provided, change groups are sorted according to the
80       given function. If not, groups are sorted alphabetically.
81

SEE ALSO

83       ·   CPAN::Changes::Spec
84
85       ·   CPAN::Changes
86
87       ·   Test::CPAN::Changes
88

AUTHOR

90       Brian Cassidy <bricas@cpan.org>
91

93       Copyright 2011-2013 by Brian Cassidy
94
95       This library is free software; you can redistribute it and/or modify it
96       under the same terms as Perl itself.
97
98
99
100perl v5.16.3                      2013-05-02         CPAN::Changes::Release(3)
Impressum