Andy Lester wrote:
On Tue, Jul 26, 2005 at 04:37:19PM -0400, Ivan Tubert-Brohman ([EMAIL
PROTECTED]) wrote:
* all entries should be written in lowercase, unless uppercase is
necessary due to case sensitivity. For example, for generic keyworks
like "operator", use X<operator>, not X<Operator>.
What about X<Larry>?
How about we phrase it "Do not use capitals unless it would be incorrect
to not have them."
On one hand I agree that it is nice to use correct spellings and all
that. But on the other hand, I don't want to expect users to have to
spell proper names with correct capitalization when searching. For
example, it is very likely that someone looking for Larry will type
perldoc -k larry
rather than
perldoc -k Larry
How many people use proper caps when filling a searchbox in google or
any other search engine? Yes, perl hackers are used to case sensitivity
and all that, but the general laziness when typing queries might
override that. People might expect having to type -X rather than -x,
knowing that those are case-sensitive operators, but maybe that won't be
the case with "Larry".
However, another potential use of this index could be to create an
actual printed index using latex, or an index file in POD, which then
can be converted to HTML and other formats. In such an index, it would
look much better with proper capitalization. So I guess you are right,
and the real answer is for perldoc to handle that. It could try a
case-sensitive search first, and if it returns no results, try a
case-insensitive search.
Strange, I ended up debating myself!
Ivan
