develooper Front page | perl.qa | Postings from June 2007

Re: Testing URIs in POD

Thread Previous | Thread Next
From:
ReneeB
Date:
June 2, 2007 12:40
Subject:
Re: Testing URIs in POD
Message ID:
4661C78C.8050306@renee-baecker.de
Let this the POD from the (nonexistant) module Anything::URI:

=head1 NAME

Anything::URI

=SYNOPSIS

  use Anything::URI;
  my $url = 'http://www.example.tld';
  do_anything_with($url);

...

In that case "http://www.example.tld" shouldn't be extracted and tested
as this is just an example...

Links to other resources should be tested, but not such examples.

Cheers,
Renee


Nadim Khemir wrote:
> Can we get examples? first the POD then what you would like to extract.
>
> Best would be to write your examples as tests.
>
> Nadim.
>
> On Saturday 02 June 2007 12:11, ReneeB wrote:
>   
>> Ian Malpass wrote:
>>     
>>> I've started crafting Test::Pod::URI to extract URIs from POD and
>>> check them to make sure they work. However, my CPAN-fu has been weak
>>> today, so I thought I'd mail here and see if anyone knew of anything
>>> out there that already does such a thing. Anyone?
>>>
>>> Ian
>>>
>>> P.S. If there isn't such a thing, does anyone have any feature requests?
>>>       
>> Do you extract the URIs from verbatim parts, too? There should be any
>> syntax that allows the author to mark an URI as "do not test". That
>> would be useful for modules that have some (example) URIs in the
>> SYNOPSIS...
>>     
>
>
>   


Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About