NAME

Meta::Info::Author - object oriented author personal information.

COPYRIGHT

Copyright (C) 2001, 2002 Mark Veltzer; All rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.

DETAILS

        MANIFEST: Author.pm
        PROJECT: meta
        VERSION: 0.22

SYNOPSIS

        package foo;
        use Meta::Info::Author qw();
        my($object)=Meta::Info::Author->new();
        my($result)=$object->method();

DESCRIPTION

This class provides author information according to the DocBook DTD.

FUNCTIONS

        BEGIN()
        init($)
        new_file($$)
        new_modu($$)
        get_default_passphrase($)
        get_default_email($)
        get_default_affiliation($)
        get_sourceforge_user($)
        get_sourceforge_password($)
        get_sourceforge_mail($)
        get_sourceforge_ssh($)
        get_cpan_user($)
        get_cpan_mail($)
        get_cpan_password($)
        get_cpan_url($)
        get_homepage($)
        get_perl_makefile($)
        get_perl_source($)
        get_perl_copyright($)
        get_vcard($)
        get_html_copyright($)
        get_html_info($)
        get_full_name($)
        get_docbook_author($)
        get_docbook_address($)
        TEST($);

FUNCTION DOCUMENTATION

BEGIN()

This method builds the attribute access method for this class. The attributes are: 0. "honorific" - honorific of the person. 1. "firstname" - first name of the person. 2. "surname" - sur name of the person. 3. "initials" - the persons initials. 4. "webpages" - set of web pages for the author (object list). 5. "emails" - set of email for the author (object list). 6. "accounts" - set of accounts for the author (object list). 7. "affiliations" - set of affiliations for the author (object list). 8. "security_keys" - set of security keys for the author (object list). 9. "ims" - set of instant messaging addresses for the author (object list).

For their meaning please consult the author DTD.

new_file($$)

This method will create a new instance from an XML/author file.

new_modu($$)

This method will create a new instance from an XML/author module (Meta::Development::Module object).

get_default_passphrase($)

This method will retrieve the default passphrase of the author.

get_default_email($)

This method will retrieve the default email of the author.

get_default_affiliation($)

This method will retrieve the default affiliation of the author.

get_handle($)

This method will retrieve the unix user name of the author.

get_sourceforge_user($)

This method returns the source forge user name of the author.

get_sourceforge_password($)

This method returns the source forge password of the author.

get_sourceforge_mail($)

This method returns the source forge email of the author.

get_sourceforge_ssh($)

This method returns the ssh url where ssh interaction is possible with source forge.

get_cpan_user($)

This method returns the CPAN id of the author.

get_cpan_mail($)

This method returns the CPAN email of the author.

get_cpan_password($)

This method returns the CPAN password of the author.

get_cpan_url($)

This method returns the CPAN url of the author.

get_homepage($)

This method returns the defualt homepage of the author.

get_perl_makefile($)

This method will return the name of the author suitable for inclusion in a perl makefile (Makefile.PL).

get_perl_source($)

This method will return the name of the author suitable for inclusion in a perl source file under a POD AUTHOR section.

get_perl_copyright($)

This method will return the perl copyright notice for this author. in a perl source file under a POD COPYRIGHT section. The copyright years are taken from Aegis.

get_vcard($)

This method will provide you with a string which contains VCARD information that could be sent (for instance) as an email attachment so the recipient will automatically have your details in his contacts software.

Here is a sample VCARD: ----------------------- BEGIN:VCARD X-EVOLUTION-FILE-AS:Falk, Rachel FN:Rachel Falk N:Falk;Rachel TEL;WORK;VOICE:02-5892301 TEL;CELL:050-256655 EMAIL;INTERNET:rachel.falk@intel.com ORG:Intel NOTE;QUOTED-PRINTABLE:Cvish Begin=0ATake light to right=0AUp the ramp=0AFirst light Left=0AReach= industrial zone=0AFirst right=0AFirst Left=0APass 500 meters=0AIntel buil= ding on right CATEGORIES:Business UID:file:///local/home/mark/evolution/local/Contacts/addressbook.db/pas-id-3B73B04400000015 END:VCARD -----------------------

get_html_copyright($)

Get a copyright suitable for inserting into an HTML page.

get_html_info($)

Get info suitable for inclusing in an HTML page.

get_full_name($)

This method will return the full name of the Author.

get_docbook_author($)

Return XML snipplet fit to be fitted in a Docbook document as author information.

get_docbook_address($)

Return XML snipplet fit to be fitted in a Docbook document as address information.

TEST($)

Test suite for this module.

The test currently creates an author object and prints it out. It also runs various shortcut accessor method and prints the results of those too.

SUPER CLASSES

None.

BUGS

None.

AUTHOR

        Name: Mark Veltzer
        Email: mailto:veltzer@cpan.org
        WWW: http://www.veltzer.org
        CPAN id: VELTZER

HISTORY

        0.00 MV perl packaging
        0.01 MV perl packaging again
        0.02 MV PDMT
        0.03 MV md5 project
        0.04 MV database
        0.05 MV perl module versions in files
        0.06 MV movies and small fixes
        0.07 MV more Class method generation
        0.08 MV thumbnail user interface
        0.09 MV more thumbnail issues
        0.10 MV md5 project
        0.11 MV website construction
        0.12 MV improve the movie db xml
        0.13 MV web site development
        0.14 MV web site automation
        0.15 MV SEE ALSO section fix
        0.16 MV bring movie data
        0.17 MV move tests into modules
        0.18 MV web site development
        0.19 MV weblog issues
        0.20 MV finish papers
        0.21 MV teachers project
        0.22 MV md5 issues

SEE ALSO

Data::Dumper(3), IO::String(3), Meta::Baseline::Aegis(3), Meta::Class::MethodMaker(3), Meta::Ds::Ohash(3), Meta::Info::Affiliation(3), Meta::Xml::Parsers::Author(3), XML::Writer(3), strict(3)

TODO

-make the signature routine produce a better signature.

-make the VCARD method do its thing.

-add more info.

-fix the constructor methods here (first argument in constructor should always be class type or blessing to right class wont be possible).

-add the following methods: get_default_security_key() get_advogato_user(), get_advogato_email().

cpanm Meta::Init

perl -MCPAN -e shell
install Meta::Init