=for stopwords API mailmap Readonly committer undef committers
=head1 STATUS
Package Git::Mailmap is currently being developed so changes in the API and functionality are possible, though not likely.
=head1 REQUIREMENTS
The Git::Mailmap package requires the following packages (in addition to normal Perl core packages):
=over 8
=item Carp
=item Carp::Assert
=item Carp::Assert::More
=item Params::Validate
=item Readonly
=item Log::Any
=back
=head1 SUBROUTINES/METHODS
=head2 new
Creator function.
=head2 map
Map the committer name and email to proper name/email. The email can be
proper-email or committer-email (alias). Email is mandatory parameter.
If also name is given, then looks for both. If only email, then
the mapping is done to the first matching email address,
regardless of the name.
=over 8
=item Parameters:
=over 8
=item I<name>, not mandatory.
=item I<email>, mandatory.
=back
=item Return: LIST(proper-name, proper-email). If no name is mapped, then undef. If no email address is mapped, then both are undef.
=back
=head2 add
Add new committer. Add all other information.
Note!
=over 8
=item * There can be only one proper name for each proper email. If more is found, the latter replaces the former.
=item * There can be several different commit names for each commit email.
=back
=over 8
=item Parameters:
=over 8
=item I<proper-email>, mandatory
=item I<proper-name>, not mandatory
=item I<commit-email>, not mandatory
=item I<commit-name>, not mandatory
=back
=item Return: [NONE]
=back
=head2 verify
Search for a given name and/or email.
=over 8
=item Parameters:
=over 8
=item I<proper-email>, not mandatory.
=item I<proper-name>, not mandatory. If matching name is not important,
don't set the *-name parameters!
=item I<commit-email>, not mandatory.
=item I<commit-name>, not mandatory.
=back
=item Return: 1/0, 1 if verified to exist.
=back
=head2 remove
Remove committer information. Remove as much information as you can.
=over 8
=item Parameters:
=over 8
=item I<proper-email>, mandatory. If you specify only this, the whole entry (with proper-name and aliases) will be removed. Other combinations are not supported.
=item I<proper-name>, not mandatory. Not supported.
=item I<commit-email>, not mandatory. If you specify only this, every entry will be checked, and all aliases with this commit email will be removed. If you specify this together with proper-email, only the alias in the entry with that proper-email will be removed.
=item I<commit-name>, not mandatory. Not supported.
=item I<all>, not mandatory. Cannot be used together with other parameters. Removes all committers.
=back
=item Return: [NONE]
=back
=head2 from_string
Read the committers from a string. If any committers already exist,
these will B<not> be removed; so it is possible to merge mailmap files.
If called as a class method (creator method
instead of method new()), will also create the object and return it.
=over 8
=item Parameters:
=over 8
=item I<mailmap>, mandatory. This is the mailmap file as a string.
=back
=item Return: the object.
=back
=head2 to_string
Return a mailmap file as string.
=over 8
=item Parameters:
=over 8
=item [NONE]
=back
=item Return: string.
=back
=head1 AUTHOR
'Mikko Koivunalho <mikko.koivunalho@iki.fi>'
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2015 by Mikko Koivunalho.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
Keyboard Shortcuts
Global
s
Focus search bar
?
Bring up this help dialog
GitHub
gp
Go to pull requests
gi
go to github issues (only if github is preferred repository)