Alan Coopersmith wrote: > Philip Brown wrote: >> Thus, my position is; ALL interfaces should be documented to some degree, >> and NO interface should be allowed to be called "private" > > Every function call? Every macro? Would you abolish "static" functions > as well, since those are just another form of "private"? > > Sounds like the fastest way to chase away every engineer who would ever > possibly want to work on the code. Not everything that can be used as > an interface should be.
Well, I guess we should then define what we mean when we say "an interface", for this discussion, then :-} I dont consider "all macros and function calls" to be in the scope of this discussion. Rather, "[this 'code module' over here] interacts with [that 'code module' over there]. How they interact, is 'an interface'" I guess there's still some ambiguity about, "how big is a code module?" Well, let's say, "something big enough to get the ARC's attention". There. problem solved? :-D
