Re: 'constant functions' and access constant params (was Re: Array of Variant Records Question...)

[Robert Dewar <robert_dewar@my-deja.com>]

In article <7socka$6u4@dfw-ixnews19.ix.netcom.com>,
  Richard D Riehle <laoXhai@ix.netcom.com> wrote:
> Robert, one reason why I sometimes still look at the internal
> implemention of a subprogram is my distrust of comments over
> the life of a contract.  The comment may introduce me to what
> the subprogram does, but rarely tells me what it does not do.

Then the comments are defective, a vital part of documentation
says what the code does not do and WHY it does not do it. Bugs
in documentation are serious bugs, and competent programmers
treat them as such.

> When a contract is new, the comments are usually pretty
> reliable. As the program ages and is subjected to an increased
> level of  modification, "all bets are off."

Then it is being modified by incompetent people. yes, I
understand that this often happens, but be careful not to
create the impression that this is an inevitable or tolerable
state of affairs. Most programmers have horrible documentation
skills, and as far as I am concerned, that is a fatal flaw.
I would immediately get rid of a programmer who was not
competent at documenting their code, regardless of how
much of a wiz they were in getting things to "work".


  So it is, Robert, that I am
> so often, as you say, "completely lost."
>
> Fortunately, well-designed Ada software will export services
that
> do only one thing and are, as you so often emphasize, more
readable
> than writeable.  When looking at a C++ program, I am often
"completely
> lost" because there is so little hope of unraveling the
meaning of
> little modifications made to a program over its lifetime.  I
certainly
> cannot rely on the comments when using heavily maintained C++
code.
>
> Richard Riehle
> http://www.adaworks.com
>
>         * My copy of Hamlet is not immediately handy, but
>           I think I am pretty close to the original text.
>
>                                 Richard
>


Sent via Deja.com http://www.deja.com/
Before you buy.