On Thu, 28 Jun 2018 16:32:35 -0400 Steven Rostedt <rostedt@xxxxxxxxxxx> wrote: > I understand the rational for having it above the prototype, because > you would think that's where people may look if they don't have the > source (just the headers). But realistically, people who use etags and > such, when they want to see a function, the vim and emacs commands will > bring the user to the C code and not the prototype. This is why Linux > enforces the comments above the C code. One more reason for having the comments above the code and not the prototype (which I'm struggling with right now), is that when reviewing a function, I have no idea what it's suppose to be doing. I need to search the header to find the comments associated with it. Makes reviewing much more time consuming. -- Steve
|