Re: RFR: 8285470: Improve handling of @inheritDoc [v3]

2022-04-26 Thread Pavel Rappo
On Mon, 25 Apr 2022 23:12:43 GMT, Jonathan Gibbons wrote: > This one is somewhat questionable. > > Generally, the trees in `javac` and `javadoc` do not store parent pointers > (to save space), leading to a general coding philosophy of "collect any > necessary information as you walk down the

Re: RFR: 8285470: Improve handling of @inheritDoc [v3]

2022-04-25 Thread Jonathan Gibbons
On Fri, 22 Apr 2022 17:32:22 GMT, Pavel Rappo wrote: >> The only taglet that along with its own tag needs to know the immediately >> enclosing tag is `InheritDocTaglet`: >> >> @return {@inheritDoc} >> @throws NullPointerException {@inheritDoc} >> @param p {@inheritDoc} >> >>

Re: RFR: 8285470: Improve handling of @inheritDoc [v3]

2022-04-25 Thread Jonathan Gibbons
On Fri, 22 Apr 2022 17:32:22 GMT, Pavel Rappo wrote: >> The only taglet that along with its own tag needs to know the immediately >> enclosing tag is `InheritDocTaglet`: >> >> @return {@inheritDoc} >> @throws NullPointerException {@inheritDoc} >> @param p {@inheritDoc} >> >>

Re: RFR: 8285470: Improve handling of @inheritDoc [v3]

2022-04-22 Thread Pavel Rappo
> The only taglet that along with its own tag needs to know the immediately > enclosing tag is `InheritDocTaglet`: > > @return {@inheritDoc} > @throws NullPointerException {@inheritDoc} > @param p {@inheritDoc} > > However, the immediately enclosing tag is unconditionally passed to