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

Doclet API: tags() method requires more documentation

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 1.4.0
    • 1.4.0
    • tools
    • beta
    • generic
    • generic
    • Verified

      |> > tags(String name) needs to specify the form of the
      |> > name, using an example.
      |> >
      |> > I can never remember whether it is
      |> > tags("@serial")
      |> > or
      |> > tags("serial")
      |> >
      |> > that gets me the tags of a specific kind.
      |> >
      |> > (I recall that Javadoc throws the "@" at me
      |> > in some places, and requires it in some places,
      |> > but I can never remember when it does or doesn't.)
      |> >
      |> To follow up on that:
      |>
      |> The Tag class gives an example showing name() and
      |> text(). But the tags(String) method in a class
      |> returns tags that match kind(). The tag class does
      |> not give an example, or better yet a list, of the
      |> possible values of kind().
      |>

            jhosunw Jamie Ho (Inactive)
            jhosunw Jamie Ho (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: