Re: Ability to list a method in the Constructors summary

2018-10-09 Thread Jonathan Gibbons
Nir, Thanks for setting this up; but being realistic, I don't see this going anywhere. The main problem is that it is not well-enough defined. Ask any one person and they may be able to give a well-defined answer, but they may not all be the same answer. For example, builders tend to be separ

Re: Ability to list a method in the Constructors summary

2018-10-09 Thread Nir Lisker
Hi again, The activity on the post has more or less stopped. You can read what people wrote (the points of a comment indicates the amount of people who agree with it give or take). I found it an interesting read. To summarize, the majority prefer a JavaDoc comment tag and that the factory and bui

Re: Ability to list a method in the Constructors summary

2018-10-04 Thread Nir Lisker
Iv'e created a Reddit post [1] if you would like to add anything. I can monitor it and when activity ceases I can bring it to your attention to draw conclusions. [1] https://www.reddit.com/r/java/comments/9la6vj/opinions_request_would_you_like_to_see_factory/ On Wed, Oct 3, 2018 at 9:45 PM Jonath

Re: Ability to list a method in the Constructors summary

2018-10-03 Thread Jonathan Gibbons
Nir, The level of interest could be interesting. I do note that there is more of a trend in Java API design these days to use factory methods, e.g. the ".of(...)" pattern so that would lend weight to such a feature. That being said, it would then come down to the level of design and impleme

Re: Ability to list a method in the Constructors summary

2018-10-03 Thread Nir Lisker
Hi Jon, Thanks for the info. If I bring it up on the Java subreddit and see what people say, would it count as a measure for interest? How is "sufficient interest" evaluated, more or less? - Nir On Wed, Oct 3, 2018 at 2:27 AM Jonathan Gibbons wrote: > > > On 10/02/2018 06:54 AM, Nir Lisker wr

Re: Ability to list a method in the Constructors summary

2018-10-02 Thread Jonathan Gibbons
On 10/02/2018 06:54 AM, Nir Lisker wrote: Hi, Many static methods are used to obtain an instance of a class, functioning as a de-facto constructor and sometimes replacing it altogether. These are factory or builder methods and the like. The problem is that while they function as constructo