c-gimplify.c:gimplify_decl_stmt

[Zack Weinberg]

kenner@vlsi1.ultra.nyu.edu (Richard Kenner) writes:

>     I disagree. There's nothing at all wrong with describing the function
>     itself and what it does and how it works. 
>
> Of course not!  But it's critical to separate the *specification* and
> *implementation* of a function and when you put them both in the same
> comment, you aren't doing that.

As long as it's obvious to the reader which is which, I fail to see a
problem.

zw