On Fri, 28 Oct 2022 23:35:59 GMT, Pavel Rappo <pra...@openjdk.org> wrote:

>>> While I think it's quite clear...
>> 
>> I guess the narrative form is _exception class_ even if the BNF form is 
>> `ExceptionType` !
>
> Maybe we could simply call it _exception_? Exception _class_ excludes type 
> variables. Exception _name_ is too stringly-typed. Exception _type_ and 
> _element_ clash with liked-named entities in javax.lang.model.
> 
> Coming up with good terms is hard. FWIW, in ThrowsTaglet I consistently call 
> `@throws` and `@exception` exception tags.

On terminology ...

You **declare** _exception classes_ (meaning any `class` that directly or 
indirectly extends `Throwable`.
You **throw** exception types, which includes the names of _exception classes_ 
and also _type variables_ that reference exception classes.

This is effectively the classic distinction in the Language Model API between 
_elements_ and _types_.

So, each can be correct, depending on the context.

-------------

PR: https://git.openjdk.org/jdk/pull/10746

Reply via email to