Subject: | Email linking with L<> |
Date: | Wed, 9 Jun 2010 17:33:15 +0200 |
To: | <bug-Pod-HtmlEasy [...] rt.cpan.org> |
From: | "Wieselquist William" <William.Wieselquist [...] psi.ch> |
Greetings,
I have one bug to report and also a related feature request for the
Pod::HtmlEasy package.
Bug
---
The regular expression which matches email addresses
($Pod::HtmlEasy::Parser::MAIL_RE) does not allow for a '.' in the first
part of the email address before the @. Thus my email address
william.wieselquist@psi.ch gets transformed to the html:
william.<a href='mailto:wieselquist@psi.ch'>wieselquist@psi.ch</a>
I would recommend the [\w-]+ in # some word chars be changed to [\w\.-]
as shown below.
Readonly::Scalar my $MAIL_RE => qr{
( # grab all of this
[\w-\.]+ # some word chars with '-' included foo
\0? # possible NUL escape
\@ # literal '@' @
[\w\\-]+ # another word bar
(?: # non-grabbing pattern
\. # literal '.' .
[\w\-\.]+# that word stuff stuff
\. # another literal '.' .
[\w\-]+ # another word and
| # or
\. # literal '.' .
[\w\-]+ # word nonsense
| # or empty?
) # end of non-grab
) # end of grab
}smx; # [6062]
Feature
-------
The Pod::Html package allows one to specify the location of other html
documents on the system (via htmlroot and htmldir options). This
feature would be very useful in Pod::HtmlEasy so that L<My::Module>
links can get the proper prefix, with the prefix specified at
documentation generation time instead of hard-coded into the POD.
Thanks for your time and keep up the good work.
Best Regards,
William Wieselquist
William Wieselquist, Ph.D.
Laboratory for Reactor Physics and System Behaviour (LRS)
PAUL SCHERRER INSTITUT
William Wieselquist OVGA/311
5232 Villigen PSI
Schweiz
Tel +41 056 310 2710
Fax +41 056 310 4141
william.wieselquist@psi.ch