comp.lang.ada
 help / color / mirror / Atom feed
From: dennison@romulus23.DAB.GE.COM (Ted Dennison)
Subject: Re: New Ada Emacs mode !
Date: 6 Sep 1994 13:39:22 GMT
Date: 1994-09-06T13:39:22+00:00	[thread overview]
Message-ID: <34hrea$iil@theopolis.orl.mmc.com> (raw)
In-Reply-To: BEVAN.94Sep4132752@lemur.cs.man.ac.uk

In article <BEVAN.94Sep4132752@lemur.cs.man.ac.uk>, bevan@cs.man.ac.uk (Stephen J Bevan) writes:
|> [ I tried email but it bounced - bevan ]

I'm sorry about this one. For some reason my email address is
being incorrectly posted. I should complain to my postmaster about
this, but I'm too lazy.

I should also routinely post my real address, but again, laziness
tends to get the better of me.

|> 
|> In article <341rj4$bd0@theopolis.orl.mmc.com> dennison@romulus23.DAB.GE.COM (Ted Dennison) writes:
|>    o  -  Are you working on a more elaborate header?  I usualy need way more 
|> 	 documentation that just Author, Title, and Creation Date.
|> 
|> Just curious: why store this information in the file rather than being
|> mainly implicit in a revision control system?

Heh Heh Heh! Good question. I'll make sure to forward it to my CM and QA 
people, not that it will do any good.  

Let's just say that on (most) every project I work on, there are code 
header standards. I have never seen them require that little information.
Typical requirements are for a more detailed description, description of
all parameters, list of all possible exceptions that might be raised, and
explanation of any side efects a routine might have. File headers typicaly
require a running list of changes to the file be kept, with authors, dates,
and reason for change (even though this info is avaiable through sccs or 
any other decent revision control system).

T.E.D.
dennison@romulus.orl.mmc.com



           reply	other threads:[~1994-09-06 13:39 UTC|newest]

Thread overview: expand[flat|nested]  mbox.gz  Atom feed
 [parent not found: <BEVAN.94Sep4132752@lemur.cs.man.ac.uk>]
replies disabled

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox