On 2020-07-02 at 19:06:04 +0200, Paul E. McKenney <paulmck@xxxxxxxxxx> wrote: > On Thu, Jul 02, 2020 at 06:25:57PM +0200, Tobias Klauser wrote: > > Fix the kerneldoc comments for rcu_read_unlock_bh(), > > rcu_read_unlock_sched() and rcu_head_after_call_rcu() so they e.g. get > > properly linked in the API documentation. > > > > Signed-off-by: Tobias Klauser <tklauser@xxxxxxxxxx> > > The addition of the second "*" is clearly needed, good eyes and thank you! > But where do these entries link to? As in does adding the "()" link > somewhere else, and if so, where? If it instead links to the entry > created by the corresponding docbook comment, is that really helpful? > > What am I missing here? Adding the "()" doesn't change anything with regards to whether a link gets created and where it points to, as far as I can tell. I mainly changed these to be consistent with the kerneldoc comments for other functions in the same file, which all use the "()" notation. Sorry, I should have mentioned that in the commit message. I can drop this part from the patch or send a patch with a revised commit message if you prefer. Thanks Tobias