Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 295603 - dev-perl/Apache-Test - bad description
Summary: dev-perl/Apache-Test - bad description
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High QA (vote)
Assignee: Gentoo Perl team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-12-04 00:44 UTC by chris
Modified: 2009-12-10 11:13 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
description_homepage.patch (description_homepage.patch,535 bytes, patch)
2009-12-04 21:33 UTC, David Abbott (RETIRED)
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description chris 2009-12-04 00:44:44 UTC
Current description:
Test.pm wrapper with helpers for testing Apache

Suggested alternative description:
Helps authors of Apache::* modules write test suites


The current description is misleading.  I thought that installing this module would help me, as a general server administrator, to test Apache itself.  However it is actually intended for Perl developers who want to query an actual running Apache server with mod_perl and their modules loaded into it (which the 'dev-perl/' location of the ebuild correctly suggests).

In addition, the "Homepage" field lists:
http://cpan.org/modules/by-module/Apache/
...which is where the actual module is downloaded, but it is just a directory listing, not a homepage.
A better homepage might be:
http://perl.apache.org/docs/1.0/api/Apache/test.html
Comment 1 David Abbott (RETIRED) gentoo-dev 2009-12-04 21:33:20 UTC
Created attachment 212073 [details, diff]
description_homepage.patch
Comment 2 Torsten Veller (RETIRED) gentoo-dev 2009-12-06 12:07:23 UTC
(In reply to comment #0)
> In addition, the "Homepage" field lists:
> http://cpan.org/modules/by-module/Apache/
> ...which is where the actual module is downloaded, but it is just a directory
> listing, not a homepage.
> A better homepage might be:
> http://perl.apache.org/docs/1.0/api/Apache/test.html

This link doesn't describe the module.

In the README of the module there is a link to http://httpd.apache.org/test/ which contains a link to "Apache-Test - the testing engine behind the Perl Framework and other HTTP-based projects like mod_perl". Which is only a placeholder.

I think our default link to http://search.cpan.org/dist/Apache-Test/ is sufficient.
Comment 3 chris 2009-12-07 02:36:55 UTC
Wow...

$ eix apache test
* dev-perl/Apache-Test
     Available versions:  1.29 ~1.30
     Homepage:            http://cpan.org/modules/by-module/Apache/
     Description:         Test.pm wrapper with helpers for testing Apache

"default homepage" doesn't match what you say.  The homepage I suggested was just the first thing I found that explained what the module was and how to use it.  If you want the related page from the domain you suggest, I'd recommend:

http://search.cpan.org/dist/Apache-Test/lib/Apache/Test.pm
Comment 4 chris 2009-12-07 02:39:26 UTC
Actually, I take that back... I like your suggestion for homepage better.  (but it isn't the homepage listed in my ebuild)
Comment 5 Torsten Veller (RETIRED) gentoo-dev 2009-12-10 11:13:44 UTC
(In reply to comment #4)

> "default homepage"

"Default homepage" as "HOMEPAGE set by perl-module.eclass".

HOMEPAGE is fixed in dev-perl/Apache-Test-1.30.
I changed the longdescription in metadata.xml.


Thanks