You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@netbeans.apache.org by Thomas Kellerer <sh...@gmx.net> on 2018/03/06 07:42:44 UTC
Disabling fully qualified class names in JavDoc completion
When using code-completion in JavaDocs (e.g. for a @see attribute), NetBeans always inserts fully qualifed class names for parameters, e.g.
@see #someMethod(java.lang.String, java.lang.String)
Is it possible (in 8.2 or 9.0) to disable this, so that the above is written as:
@see #someMethod(String, String)
This is not so much a problem with JDK classes, but with our own classes which tend to have longer package names.
Thomas
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by cowwoc <co...@bbs.darktech.org>.
I'm also interested in this feature.
Gili
On 2018-03-06 2:42 AM, Thomas Kellerer wrote:
> When using code-completion in JavaDocs (e.g. for a @see attribute), NetBeans always inserts fully qualifed class names for parameters, e.g.
>
> @see #someMethod(java.lang.String, java.lang.String)
>
> Is it possible (in 8.2 or 9.0) to disable this, so that the above is written as:
>
> @see #someMethod(String, String)
>
> This is not so much a problem with JDK classes, but with our own classes which tend to have longer package names.
>
> Thomas
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by cowwoc <co...@bbs.darktech.org>.
Hi,
I filed https://issues.apache.org/jira/browse/NETBEANS-447
Gili
On 2018-03-06 12:34 PM, Paul Szudzik wrote:
> Hopefully this would be an option flag.. Otherwise I wouldn't know if
> I was overriding something by accident via a library load.. so, I
> would vote for option check, where if it was CHECKED, would drop the
> fully qualified class names for base and non-overridden functions..
> If I do override a function, then the fully qualified path should show..
>
> Just concerned about this request
>
>
> -----Original Message----- From: Thomas Kellerer
> Sent: Monday, March 05, 2018 11:42 PM
> To: NetBeans Users
> Subject: Disabling fully qualified class names in JavDoc completion
>
> When using code-completion in JavaDocs (e.g. for a @see attribute),
> NetBeans always inserts fully qualifed class names for parameters, e.g.
>
> @see #someMethod(java.lang.String, java.lang.String)
>
> Is it possible (in 8.2 or 9.0) to disable this, so that the above is
> written as:
>
> @see #someMethod(String, String)
>
> This is not so much a problem with JDK classes, but with our own
> classes which tend to have longer package names.
>
> Thomas
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by Niklas Matthies <ne...@nmhq.net>.
Done. I also created https://issues.apache.org/jira/browse/NETBEANS-452.
Niklas
On Wed 2018-03-07 at 12:30h, cowwoc wrote on users:
> PSA: Please move discussion over to
> https://issues.apache.org/jira/browse/NETBEANS-447 :)
>
> Thank you,
> Gili
>
> On 2018-03-07 9:48 AM, Niklas Matthies wrote:
> > I'm not sure why there should be an option here, instead of always
> > inserting the non-qualified name for imported names. There is no
> > option for inserting fully qualified names in regular Java code
> > either. IMHO the javadoc code completion should just work the same way
> > as the code completion in regular Java code.
> >
> > A related issue is that javadoc code completion currently doesn't
> > support camel case initials-based code completion, e.g., typing "BAOS"
> > to complete to "ByteArrayOutputStream" doesn't work in javadoc
> > context, unlike in regular Java code.
> >
> > Niklas
> >
> >
> > On Wed 2018-03-07 at 09:51h, Thomas Kellerer wrote on users:
> > > I expected that to be an option either in the "Code Completion"
> > > section or maybe the "Formatter" section for JavaDocs.
> > >
> > > Btw: The fully qualified path is not necessary in the JavaDocs if
> > > that class is already imported. The class names in the JavaDocs
> > > share the same "visibility" rules as regular classes.
> > >
> > > Thomas
> > >
> > > Paul Szudzik schrieb am 06.03.2018 um 18:34:
> > > > Hopefully this would be an option flag.. Otherwise I wouldn't know
> > > > if I was overriding something by accident via a library load.. so,
> > > > I would vote for option check, where if it was CHECKED, would drop
> > > > the fully qualified class names for base and non-overridden
> > > > functions.. If I do override a function, then the fully qualified
> > > > path should show..
> > > >
> > > > Just concerned about this request
> > > >
> > > >
> > > > -----Original Message----- From: Thomas Kellerer
> > > > Sent: Monday, March 05, 2018 11:42 PM
> > > > To: NetBeans Users
> > > > Subject: Disabling fully qualified class names in JavDoc completion
> > > >
> > > > When using code-completion in JavaDocs (e.g. for a @see
> > > > attribute), NetBeans always inserts fully qualifed class names for
> > > > parameters, e.g.
> > > >
> > > > @see #someMethod(java.lang.String, java.lang.String)
> > > >
> > > > Is it possible (in 8.2 or 9.0) to disable this, so that the above is written as:
> > > >
> > > > @see #someMethod(String, String)
> > > >
> > > > This is not so much a problem with JDK classes, but with our own classes which tend to have longer package names.
> > > >
> > > > Thomas
> > > >
> > > >
> > > >
> > > > ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> > > > For additional commands, e-mail: users-help@netbeans.apache.org
> > > >
> > > > For further information about the NetBeans mailing lists, visit:
> > > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> > > >
> > > > ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> > > > For additional commands, e-mail: users-help@netbeans.apache.org
> > > >
> > > > For further information about the NetBeans mailing lists, visit:
> > > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> > > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> > > For additional commands, e-mail: users-help@netbeans.apache.org
> > >
> > > For further information about the NetBeans mailing lists, visit:
> > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> > >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: users-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by cowwoc <co...@bbs.darktech.org>.
PSA: Please move discussion over to
https://issues.apache.org/jira/browse/NETBEANS-447 :)
Thank you,
Gili
On 2018-03-07 9:48 AM, Niklas Matthies wrote:
> I'm not sure why there should be an option here, instead of always
> inserting the non-qualified name for imported names. There is no
> option for inserting fully qualified names in regular Java code
> either. IMHO the javadoc code completion should just work the same way
> as the code completion in regular Java code.
>
> A related issue is that javadoc code completion currently doesn't
> support camel case initials-based code completion, e.g., typing "BAOS"
> to complete to "ByteArrayOutputStream" doesn't work in javadoc
> context, unlike in regular Java code.
>
> Niklas
>
>
> On Wed 2018-03-07 at 09:51h, Thomas Kellerer wrote on users:
>> I expected that to be an option either in the "Code Completion"
>> section or maybe the "Formatter" section for JavaDocs.
>>
>> Btw: The fully qualified path is not necessary in the JavaDocs if
>> that class is already imported. The class names in the JavaDocs
>> share the same "visibility" rules as regular classes.
>>
>> Thomas
>>
>> Paul Szudzik schrieb am 06.03.2018 um 18:34:
>>> Hopefully this would be an option flag.. Otherwise I wouldn't know
>>> if I was overriding something by accident via a library load.. so,
>>> I would vote for option check, where if it was CHECKED, would drop
>>> the fully qualified class names for base and non-overridden
>>> functions.. If I do override a function, then the fully qualified
>>> path should show..
>>>
>>> Just concerned about this request
>>>
>>>
>>> -----Original Message----- From: Thomas Kellerer
>>> Sent: Monday, March 05, 2018 11:42 PM
>>> To: NetBeans Users
>>> Subject: Disabling fully qualified class names in JavDoc completion
>>>
>>> When using code-completion in JavaDocs (e.g. for a @see
>>> attribute), NetBeans always inserts fully qualifed class names for
>>> parameters, e.g.
>>>
>>> @see #someMethod(java.lang.String, java.lang.String)
>>>
>>> Is it possible (in 8.2 or 9.0) to disable this, so that the above is written as:
>>>
>>> @see #someMethod(String, String)
>>>
>>> This is not so much a problem with JDK classes, but with our own classes which tend to have longer package names.
>>>
>>> Thomas
>>>
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
>>> For additional commands, e-mail: users-help@netbeans.apache.org
>>>
>>> For further information about the NetBeans mailing lists, visit:
>>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
>>> For additional commands, e-mail: users-help@netbeans.apache.org
>>>
>>> For further information about the NetBeans mailing lists, visit:
>>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: users-help@netbeans.apache.org
>>
>> For further information about the NetBeans mailing lists, visit:
>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by Niklas Matthies <ne...@nmhq.net>.
I'm not sure why there should be an option here, instead of always
inserting the non-qualified name for imported names. There is no
option for inserting fully qualified names in regular Java code
either. IMHO the javadoc code completion should just work the same way
as the code completion in regular Java code.
A related issue is that javadoc code completion currently doesn't
support camel case initials-based code completion, e.g., typing "BAOS"
to complete to "ByteArrayOutputStream" doesn't work in javadoc
context, unlike in regular Java code.
Niklas
On Wed 2018-03-07 at 09:51h, Thomas Kellerer wrote on users:
> I expected that to be an option either in the "Code Completion"
> section or maybe the "Formatter" section for JavaDocs.
>
> Btw: The fully qualified path is not necessary in the JavaDocs if
> that class is already imported. The class names in the JavaDocs
> share the same "visibility" rules as regular classes.
>
> Thomas
>
> Paul Szudzik schrieb am 06.03.2018 um 18:34:
> > Hopefully this would be an option flag.. Otherwise I wouldn't know
> > if I was overriding something by accident via a library load.. so,
> > I would vote for option check, where if it was CHECKED, would drop
> > the fully qualified class names for base and non-overridden
> > functions.. If I do override a function, then the fully qualified
> > path should show..
> >
> > Just concerned about this request
> >
> >
> > -----Original Message----- From: Thomas Kellerer
> > Sent: Monday, March 05, 2018 11:42 PM
> > To: NetBeans Users
> > Subject: Disabling fully qualified class names in JavDoc completion
> >
> > When using code-completion in JavaDocs (e.g. for a @see
> > attribute), NetBeans always inserts fully qualifed class names for
> > parameters, e.g.
> >
> > @see #someMethod(java.lang.String, java.lang.String)
> >
> > Is it possible (in 8.2 or 9.0) to disable this, so that the above is written as:
> >
> > @see #someMethod(String, String)
> >
> > This is not so much a problem with JDK classes, but with our own classes which tend to have longer package names.
> >
> > Thomas
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: users-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: users-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by cowwoc <co...@bbs.darktech.org>.
Please add your comments to
https://issues.apache.org/jira/browse/NETBEANS-447
Thank you,
Gili
On 2018-03-07 3:51 AM, Thomas Kellerer wrote:
> I expected that to be an option either in the "Code Completion" section or maybe the "Formatter" section for JavaDocs.
>
> Btw: The fully qualified path is not necessary in the JavaDocs if that class is already imported. The class names in the JavaDocs share the same "visibility" rules as regular classes.
>
> Thomas
>
> Paul Szudzik schrieb am 06.03.2018 um 18:34:
>> Hopefully this would be an option flag.. Otherwise I wouldn't know if I was overriding something by accident via a library load.. so, I would vote for option check, where if it was CHECKED, would drop the fully qualified class names for base and non-overridden functions.. If I do override a function, then the fully qualified path should show..
>>
>> Just concerned about this request
>>
>>
>> -----Original Message----- From: Thomas Kellerer
>> Sent: Monday, March 05, 2018 11:42 PM
>> To: NetBeans Users
>> Subject: Disabling fully qualified class names in JavDoc completion
>>
>> When using code-completion in JavaDocs (e.g. for a @see attribute), NetBeans always inserts fully qualifed class names for parameters, e.g.
>>
>> @see #someMethod(java.lang.String, java.lang.String)
>>
>> Is it possible (in 8.2 or 9.0) to disable this, so that the above is written as:
>>
>> @see #someMethod(String, String)
>>
>> This is not so much a problem with JDK classes, but with our own classes which tend to have longer package names.
>>
>> Thomas
>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: users-help@netbeans.apache.org
>>
>> For further information about the NetBeans mailing lists, visit:
>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: users-help@netbeans.apache.org
>>
>> For further information about the NetBeans mailing lists, visit:
>> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by Thomas Kellerer <sh...@gmx.net>.
I expected that to be an option either in the "Code Completion" section or maybe the "Formatter" section for JavaDocs.
Btw: The fully qualified path is not necessary in the JavaDocs if that class is already imported. The class names in the JavaDocs share the same "visibility" rules as regular classes.
Thomas
Paul Szudzik schrieb am 06.03.2018 um 18:34:
> Hopefully this would be an option flag.. Otherwise I wouldn't know if I was overriding something by accident via a library load.. so, I would vote for option check, where if it was CHECKED, would drop the fully qualified class names for base and non-overridden functions.. If I do override a function, then the fully qualified path should show..
>
> Just concerned about this request
>
>
> -----Original Message----- From: Thomas Kellerer
> Sent: Monday, March 05, 2018 11:42 PM
> To: NetBeans Users
> Subject: Disabling fully qualified class names in JavDoc completion
>
> When using code-completion in JavaDocs (e.g. for a @see attribute), NetBeans always inserts fully qualifed class names for parameters, e.g.
>
> @see #someMethod(java.lang.String, java.lang.String)
>
> Is it possible (in 8.2 or 9.0) to disable this, so that the above is written as:
>
> @see #someMethod(String, String)
>
> This is not so much a problem with JDK classes, but with our own classes which tend to have longer package names.
>
> Thomas
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by Paul Szudzik <ps...@throwarock.com>.
Hopefully this would be an option flag.. Otherwise I wouldn't know if I was
overriding something by accident via a library load.. so, I would vote for
option check, where if it was CHECKED, would drop the fully qualified class
names for base and non-overridden functions.. If I do override a function,
then the fully qualified path should show..
Just concerned about this request
-----Original Message-----
From: Thomas Kellerer
Sent: Monday, March 05, 2018 11:42 PM
To: NetBeans Users
Subject: Disabling fully qualified class names in JavDoc completion
When using code-completion in JavaDocs (e.g. for a @see attribute), NetBeans
always inserts fully qualifed class names for parameters, e.g.
@see #someMethod(java.lang.String, java.lang.String)
Is it possible (in 8.2 or 9.0) to disable this, so that the above is written
as:
@see #someMethod(String, String)
This is not so much a problem with JDK classes, but with our own classes
which tend to have longer package names.
Thomas
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Disabling fully qualified class names in JavDoc completion
Posted by Claus Lüthje <cl...@thetop.ch>.
That’s something I’d like to have, too.
Regards,
Claus
> Am 06.03.2018 um 08:42 schrieb Thomas Kellerer <sh...@gmx.net>:
>
> When using code-completion in JavaDocs (e.g. for a @see attribute), NetBeans always inserts fully qualifed class names for parameters, e.g.
>
> @see #someMethod(java.lang.String, java.lang.String)
>
> Is it possible (in 8.2 or 9.0) to disable this, so that the above is written as:
>
> @see #someMethod(String, String)
>
> This is not so much a problem with JDK classes, but with our own classes which tend to have longer package names.
>
> Thomas
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: users-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@netbeans.apache.org
For additional commands, e-mail: users-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists