Name: rmT116609 Date: 11/03/2003


A DESCRIPTION OF THE REQUEST :
In practically all cases when I write {@link ClassName random-text}
(as opposed to {@link ClassName}), I want the random-text to appear in plain font. So I'm forced to write @linkplain instead, which is unreasonably long. Also, I have to go through all old code (written before @linkplain was introduced) and change it to linkplain.


JUSTIFICATION :
It's very simple to do and quite useful -- it matches the common usage patterns. Whenever plain-text is given for the link text in @link,
the intent is usually that this text not be printed in code font.


EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Add a flag to -javadoc to treat {@link ClassName some-text} as {@linkplain ClassName some-text} whenever some-text is nonempty.
(Incident Review ID: 223220)
======================================================================