On 3/21/18 1:59 PM, Jonathan Gibbons wrote:
On 03/21/2018 01:39 PM, mandy chung wrote:
On 3/21/18 10:26 AM, David Lloyd wrote:
I see it with IntelliJ IDEA when I pop up "quick JavaDoc" on, say,
defineClass and then click on "binary name"; it's actually using the
sources, rather than generated JavaDoc.
I don't object to do this renaming as I favor this more explicit id.
However you will hit the same issue if another class names an anchor
conflicts with its private member. Can you configure IntelliJ to
generate public/protected elements to avoid this issue?
Mandy
Mandy,
I think that maybe we should establish a convention such that
user-defined anchors can never conflict with javadoc-generated
anchors. Using an embedded "-" (as in this proposal) in user-defined
anchors is a good start.
A secondary proposal would be to have doclint check for potential
clashes. Even though we may use access filters to restrict the set of
elements included in any documentation, it should never be good to
facilitate clashes that may be caused by non-default options or
non-default tools.
I forgot that you are on this list.
This is a good idea. This is what I was planning to brainstorm with you
what we could do to help catch this and generate clean javadoc including
private elements.
Mandy