> I think what's missing is a higher-level view of how the source fits
> together, and that's probably why Werner's enthusiastic about a
> comment-block per class.
Exactly.
> Perhaps those on the list that can grok C could have a go at doing
> Werner's class comments, [...] But would it require
Hi,
Ulrich wrote:
> As I understand it, the man-pages are directed at the user of a
> program who wants to know WHAT a program is supposed to do and how she
> can control it via options.
>
> Comments in the source are directed at the programmer, who wants to
> understand HOW the functionality of
