| Subject: | Incorrect use of "it's" in POD description |
[this is a slightly-edited forward of Debian Bug#268524, a mass bug filing. Package descriptions for CPAN modules are typically autoextracted from the POD documentation]
Hello,
DNS::ZoneParse uses the contraction "it's" in the
DESCRIPTION section of its manual page in what appears to be an
incorrect way. Recall that "it's" is a contraction for "it is" or
"it has", and any other use (for instance, as a possessive) is not
grammatically correct English. Hypothetical examples:
- XMMS is cool. It's one of the best ... [correct, "It is"]
- XMMS is cool. It's been rated highly ... [correct, "It has"]
- XMMS is cool. It's features include ... [wrong]
- XMMS is cool. Its features include ... [correct, possessive]
Using "it's" and "its" correctly is in your best interest, since
incorrect usage may cause someone browsing the package descriptions to
have a bad first impression of that package.