Hi Lee,
Cop-out!
Do what I do and make something up (joke)! :'D
If I thought anyone would actually read the comments then maybe yes. But I assume that apart from this thread no-one will read it.
Well, it fixes the warning ;)
Yeah, I could not dig up anything useful to say here. Was tempted to just drop all the kernel-doc syntax but that was a larger change.
Did you trace it from it's origin down to it's final use?
Yeah, but not something that seemed useful. I could have added "translating from pixels->bytes" as they are described somewhere else. But I could not convince myself this was right so I just silenced the warning.
The only reason I kept the kernel-doc in the first place is that I am told some editors use it.
The only effect the kernel-doc in fbdev has right now is burning effort that could have been spent (better?) somewhere else, and I would personally prefer to drop the kernel-doc annotations.
But I already discussed this in another thread (not fbdev related) and I was told it was useful for some, so it is kept.
Sam