Steve Litt <sl...@troubleshooters.com> writes: > Rainer Weikusat <rainerweiku...@virginmedia.com> wrote: > >> Can the effect of the following C function >> >> static void print_start(char const *name, char const *what) >> {
[...] >> } >> >> be considered obvious or should it rather get an explanation? > > Hi Rainer, > > Others have pointed out potential coding problems, but I'm just going > to answer your question about need for comments. In my opinion, the > preceding function is short enough to document itself *if and only if* > the function gets a much more descriptive name. Descriptive of what it > does and how it's used. The naming is indeed poor. Thank you for pointing this out. _______________________________________________ Dng mailing list Dng@lists.dyne.org https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/dng