| Subject: | Documentation Lacking Output Usage |
| Date: | Fri, 18 Jan 2008 18:51:57 -0500 |
| To: | bug-URL-Grab [...] rt.cpan.org |
| From: | Gary Krueger <gkrueger [...] browsermedia.com> |
Howdy there!
This isn't a problem with the coding. It is just a problem with the
documentation.
The documentation gives the impression that a simple string is returned
from the grab method.
But in reality, the code returns very different results, which are only
slightly more difficult to use.
The grab_single method returns a pointer to a hash. The hash key is the
URL. And the content at that key is the content returned from the URL.
The grab method returns the same thing, but can take a list of URLs for
the input. And that means it will return that list of URLs as keys of
the hash that is referenced.
My description above would be rather terse for documentation purposes,
so it would be good to expand upon what I've said. Or, rephrase it
entirely.
Thank you.
--
Gary Kenneth Krueger -- Software Engineer
browsermedia -- http://www.browsermedia.com
7735 OLD GEORGETOWN RD STE 500 -- (877)468-3769 x.154 (toll-free)
BETHESDA MD 20814 -- (301)656-1144 x.154