Re: [PATCH 0/2] kernel-doc: Remove deprecated kernel-doc option 'functions'

[Johannes Berg]

On Mon, 2024-01-22 at 14:28 +0100, Anna-Maria Behnsen wrote:

> the kernel-doc option 'functions' is marked deprecated and is simply an
> alias for 'identifiers'

Is it actually a good idea though that it's deprecated and an alias?

I mean, we have a problem today that sphinx/kernel-doc/whatever cannot
deal with having both

 - struct cfg80211_rx_assoc_resp
 - cfg80211_rx_assoc_resp()

I think at some point I found there's some kind of ticket open against
that, and while I don't hope it will be fixed soon (and we renamed that
struct because of it), maybe doing these changes will make it harder to
eventually deal with such a thing?

johannes