.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "WWW::Finger 3pm" .TH WWW::Finger 3pm "2021-09-11" "perl v5.32.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" WWW::Finger \- get useful data from e\-mail addresses .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 6 \& use WWW::Finger; \& my $finger = WWW::Finger\->new("joe@example.com"); \& if (defined $finger) \& { \& print $finger\->name . "\en"; \& } .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" This module is \fInot\fR an implementation of the finger protocol (\s-1RFC 1288\s0). Use Net::Finger for that. Instead it is a set of implementations of \&\fIother\fR methods for getting information from an e\-mail address, or e\-mail like identifier. This package includes four such implementations, and it's pretty easy to create your own additional implementations: .IP "\(bu" 8 WebFinger .IP "\(bu" 8 Fingerpoint .IP "\(bu" 8 MetaCPAN \s-1API\s0 for cpan.org addresses .IP "\(bu" 8 Unnamed finger protocol described on bitworking.org .SS "Constructor" .IX Subsection "Constructor" .IP "\(bu" 8 \&\f(CW\*(C`new\*(C'\fR .Sp .Vb 1 \& $finger = WWW::Finger\->new($identifier); .Ve .Sp Creates a WWW::Finger object for a particular identifier. Will return undef if no implemetation is able to handle the identifier .SS "Object Methods" .IX Subsection "Object Methods" Any of these methods can return undef if the appropriate information is not available. The \f(CW\*(C`name\*(C'\fR, \f(CW\*(C`mbox\*(C'\fR, \f(CW\*(C`homepage\*(C'\fR, \f(CW\*(C`weblog\*(C'\fR, \&\f(CW\*(C`image\*(C'\fR and \f(CW\*(C`key\*(C'\fR methods work in both scalar and list context. Depending on which implementation was used by \f(CW\*(C`WWW::Finger\->new\*(C'\fR, the object may also have additional methods. Consult the documentation of the various implementations for details. .ie n .IP """name""" 4 .el .IP "\f(CWname\fR" 4 .IX Item "name" The person's name (or handle/nickname). .ie n .IP """mbox""" 4 .el .IP "\f(CWmbox\fR" 4 .IX Item "mbox" The person's e\-mail address (including \*(L"mailto:\*(R"). .ie n .IP """homepage""" 4 .el .IP "\f(CWhomepage\fR" 4 .IX Item "homepage" The person's personal homepage. .ie n .IP """weblog""" 4 .el .IP "\f(CWweblog\fR" 4 .IX Item "weblog" The person's blog. (There may be some overlap with \f(CW\*(C`homepage\*(C'\fR.) .ie n .IP """image""" 4 .el .IP "\f(CWimage\fR" 4 .IX Item "image" An avatar, photo or other image depicting the person. .ie n .IP """key""" 4 .el .IP "\f(CWkey\fR" 4 .IX Item "key" The \s-1URL\s0 of the person's \s-1GPG/PGP\s0 public key. .ie n .IP """webid""" 4 .el .IP "\f(CWwebid\fR" 4 .IX Item "webid" A \s-1URI\s0 uniquely identifying the person. See . .ie n .IP """endpoint""" 4 .el .IP "\f(CWendpoint\fR" 4 .IX Item "endpoint" A \s-1SPARQL\s0 Protocol endpoint which may provide additional data about the person. (See RDF::Query::Client.) .ie n .IP """graph""" 4 .el .IP "\f(CWgraph\fR" 4 .IX Item "graph" An RDF::Trine::Model object holding data about the person. (See RDF::Trine.) .SH "SEE ALSO" .IX Header "SEE ALSO" Net::Finger. .PP . .PP . .PP . .PP fingerw. .SH "AUTHOR" .IX Header "AUTHOR" Toby Inkster, .SH "COPYRIGHT AND LICENCE" .IX Header "COPYRIGHT AND LICENCE" Copyright (C) 2009\-2012 by Toby Inkster .PP This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. .SH "DISCLAIMER OF WARRANTIES" .IX Header "DISCLAIMER OF WARRANTIES" \&\s-1THIS PACKAGE IS PROVIDED \*(L"AS IS\*(R" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.\s0