On Sun, Aug 12, 2001 at 07:51:05PM -0700, Joe Kelsey wrote:
> OK, so we have beaten the psm and keyboard code to death. The entire
> point that I have been trying to make in this discussion is that it is
> imperative to document design decisions somewhere that is likely to
> survive changes in maintainer.
...
> What I am pleading for is nothing more than any commercial software
> house requires of its programmers.
And *PAYS* its programmers to do. This is the point you are missing.
If you were to commercially sponsor some design docs, I'm sure we can get
them written.
> Certainly, we could adopt some sort of standard practice to
> embed design comments in the code. I personally prefer to over-comment
> as it is hard to determine exactly what someone needs 5 years from now
> to fix a problem.
Send patches. You wanted some of the PSM comments added to the code --
send a patch that adds the ones you think would have helped you.
--
-- David ([EMAIL PROTECTED])
To Unsubscribe: send mail to [EMAIL PROTECTED]
with "unsubscribe freebsd-current" in the body of the message
