Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4948032

{@link ClassName some-random-text} should act like @linkplain

    XMLWordPrintable

    Details

    • Type: Enhancement
    • Status: Resolved
    • Priority: P4
    • Resolution: Cannot Reproduce
    • Affects Version/s: 1.4.2
    • Fix Version/s: None
    • Component/s: tools

      Description



      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)
      ======================================================================

        Attachments

          Activity

            People

            Assignee:
            bpatel Bhavesh Patel (Inactive)
            Reporter:
            rmandalasunw Ranjith Mandala (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: