/ 
Meta-0.06
River stage zero No dependents
/ Meta::Info::Author

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.18

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_deve($$)
get_perl_makefile($)
get_perl_source($)
get_perl_copyright($)
get_email_signature($)
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" 1. "firstname" 2. "surname" 3. "cpanid" 4. "cpanpasswd" 5. "cpanemail" 6. "sourceforgeid" 7. "sourceforgepasswd" 8. "sourceforgeemail" 9. "advogatoid" 10. "advogatopasswd" 11." advogatoemail" 12. "initials" 13. "handle" 14. "homepage" 15. "affiliation". For their meaning please consult the Docbook DTD.

new_file($$)

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

new_deve($$)

This method will create a new instance from an XML/author file which will be located in the development path.

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_email_signature($)

This method will provide you with a text fitting for an email signature.

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.

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

SEE ALSO

IO::String(3), Meta::Baseline::Aegis(3), Meta::Class::MethodMaker(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 and track the Docbook DTD more strictly.

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