cpan::changes::release(3) [centos man page]

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)

Check Out this Related Man Page

GETGROUPLIST(3) 					   BSD Library Functions Manual 					   GETGROUPLIST(3)

NAME

     getgrouplist, getgroupmembership, -- calculate group access list

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <unistd.h>

     int
     getgrouplist(const char *name, gid_t basegid, gid_t *groups, int *ngroups);

     int
     getgroupmembership(const char *name, gid_t basegid, gid_t *groups, int maxgrp, int *ngroups);

DESCRIPTION

     The getgrouplist() and getgroupmembership() functions read through the group database and calculate the group access list for the user speci-
     fied in name.  The basegid is automatically included in the groups list.  Typically this value is given as the group number from the password
     database.

     The resulting group list is returned in the integer array pointed to by groups.

     For getgrouplist(), the caller specifies the size of the groups array in the integer pointed to by ngroups.

     For getgroupmembership(), the caller specifies the size of the groups array in maxgrp.

     The actual number of groups found is returned in ngroups.

     Duplicate group ids will be suppressed from the result.

RETURN VALUES

     The getgrouplist() and getgroupmembership() functions return 0 if successful, and return -1 if the size of the group list is too small to
     hold all the user's groups.  In the latter case, the groups array will be filled with as many groups as will fit and ngroups will contain the
     total number of groups found.

FILES

     /etc/group  group membership list

SEE ALSO

     setgroups(2), initgroups(3), group(5)

HISTORY

     The getgrouplist() function first appeared in 4.4BSD.  The getgroupmembership() function first appeared in NetBSD 3.0 to address an API defi-
     ciency in getgrouplist().

BUGS

     The getgrouplist() function uses the routines based on getgrent(3).  If the invoking program uses any of these routines, the group structure
     will be overwritten in the call to getgrouplist().

BSD
								  January 6, 2005							       BSD

Linux and UNIX Man Pages

cpan::changes::release(3) [centos man page]

Check Out this Related Man Page