Re: Lines of documentation per LOC

[ncohen@watson.ibm.com (Norman H. Cohen)]

In article <1994Oct26.094543.24213@sei.cmu.edu>, lpb@sei.cmu.edu (Loic
Briand) writes: 

|>                        The problem is that when you have a client who ask for
|> 10 lines of doc par LOC and you have budgeted 0.1 (based on the expected
|> complexity of your code), you have to prove your point.

What idiocy!  This is a fine incentive to start writing Ada code like

for I in L'Range(1)loop for J in R'Range(2)loop Res(I,J):=0.0; for K in
L'Range(2)loop Res(I,J):=Res(I,J)+L(I,K)*R(K,J);end loop;end loop;end loop;

instead of

   for I in Left'Range(1) loop
      for J in Right'Range(2) loop
         Result(I, J) := 0.0;
         for K in Left'Range(2) loop
            Result(I, J) :=  Result(I, J) + Left(I, K) * Right(K, J);
         end loop;
      end loop;
   end loop;

-- (unless,
-- of
-- course,
-- you
-- write
-- your
-- comments
-- like
-- this).

--
Norman H. Cohen    ncohen@watson.ibm.com