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

Not all inherited methods from multiple extended interfaces are documented

XMLWordPrintable

    • b28
    • generic
    • other

      I have an interface IInterfaceSpecification that extends many others.
      In some cases, the same method signature is present in several of the
      extended interfaces.

      When I look at the Javadoc for the extending interface, I see references to
      each of the extended interfaces (in the lists of methods inherited from).
      However, methods that are in each of the extended interfaces sometimes show up
      in the Javadoc for the extending interface and sometimes they don't.

      In some cases the methods show up about half the time. That is, the method
      signatures show up in the list of inherited methods for about half the
      interfaces they're actually in. For the rest of the interfaces, they don't show
      up in the inherited methods. However, if I follow the link to the inerface's
      Javadoc page, the method signature is there.

      I can't find any pattern (method name alphabetical order, etc) to explain this.

      Is there any way to force Javadoc to show references to all instances of an
      inherited method signature?

      I'm using the standard doclet, 1.4.2.

      I'll enclose two jpg samples of what I'm seeing.

      All the methods are public.

      Here are my command line args. I've had this problem right from the start,
      before I added the two custom tags.

      {params} -tag database.Attribute:a:"Database Attribute"
      -tag database.Table:a:"Database Table" -use -classpath {filesystems} {files}

      More specifically, the IInterfaceSpecification methods marked with ">" are
      inherited from IAccountProductSpecifcation, but the rest are not.

      IInterfaceSpecification extends IAccountProductSpecification

      IAccountProductSpecification

          public void setCreateUserid(String userid);
          public String getCreateUserid();
          public void setCreateDate(java.sql.Date createDate);
          public java.sql.Date getCreateDate();
       > public String getDealerNum();
       > public void setDealerNum(String dealerNum);
       > public void setState(String state);
       > public String getState();
       > public void setZip(String zip);
       > public String getZip();
          public void setTa(String ta);
          public String getTa();
         

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

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: