10 Nov
2014
10 Nov
'14
8:09 p.m.
At Mon, 10 Nov 2014 17:55:08 +0000, Mark Brown wrote:
On Mon, Nov 10, 2014 at 05:30:45PM +0100, Takashi Iwai wrote:
- @list: linked list of assigned pins to the same jack
I thought there was a way to mark implementation details that the user isn't supposed to look at as such in kerneldoc?
You can put /* private: */ and /* public: */ comments. See Documentation/kernel-doc-nano-HOWTO.txt.
But in this case, the list item appears as the first, so it'd become a bit ugly. Also, struct snd_soc_jack_zone has already the description of list item, so having only one shown and one hidden would be inconsistent. For these reasons, I chose to add a comment on it, too.
Takashi