Johannes Berg <johannes@xxxxxxxxxxxxxxxx> writes: > 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? So I feel like I'm missing something; the problem with Sphinx and namespacing is separate from whether kernel-doc recognizes "-functions"; I don't think that taking out this support will make the other problem any harder to solve. Do you see something I'm not? Thanks, jon
