Name: bsC130419 Date: 07/13/2001


1.4beta documentation

Sorry for the pickiness of this wording bug report, but this is a
too-frequent error, and shows that the author wasn't paying attention
to English.

(Actually, I might even be able to make the argument that the
bad usage makes the sentence harder to follow and therefore makes
the documentation less clear and possibly harder to understand.)


The class description for java.util.regex.Matcher says:

  "... replacing matched subsequences by new strings..."

That "by" should be "with".


You can say "A is replaced _by_ B" because that "by" is part of
the passive-voice form of "B replaces A."

You CANNOT say "It replaces A by B." That has to be "It replaces A
_with_ B."


DSB/DFI
(Review ID: 128082)
======================================================================