From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham
	autolearn_force=no version=3.4.4
X-Google-Thread: 103376,fc52c633190162e0
X-Google-Attributes: gid103376,public
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news1.google.com!news3.google.com!border1.nntp.dca.giganews.com!nntp.giganews.com!local01.nntp.dca.giganews.com!nntp.comcast.com!news.comcast.com.POSTED!not-for-mail
NNTP-Posting-Date: Fri, 23 Mar 2007 21:12:27 -0500
From: tmoran@acm.org
Newsgroups: comp.lang.ada
Subject: Re: commenting, was Re: Use of declare blocks
References: <vrZMh.6295$tv6.5915@newssvr19.news.prodigy.net>
X-Newsreader: Tom's custom newsreader
Message-ID: <GYydnepKEqaRFJnbnZ2dnUVZ_uqvnZ2d@comcast.com>
Date: Fri, 23 Mar 2007 21:12:28 -0500
NNTP-Posting-Host: 67.164.83.70
X-Trace: 
 sv3-K5N44fofrEQxryilB/czQFcM8DKWVmXB5kWwLNMR0XUtHwwdQYeO4lxmv5opDKs7TprUbFG7iP+9R6M!K2algwxhkwdSYv+h5Gl1Xsw5uBgKrjLFj17cZ5S0gh5i6S9AHmPGXQVcR35muuDRb5oa6uCGEgce!jhTht4pCebkPVpHdX8NDbOQpUbNz
X-Complaints-To: abuse@comcast.net
X-DMCA-Complaints-To: dmca@comcast.net
X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers
X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint
 properly
X-Postfilter: 1.3.34
Xref: g2news1.google.com comp.lang.ada:14628
Date: 2007-03-23T21:12:28-05:00
List-Id: <comp.lang.ada>

> Wherever I wanted to be able to expand the source code
> with additional documentation, I included a
>
>        --{file-name}
  My problem is that I don't go back to yesterday's code that wasn't
throw-away after all and comment it, or go back to last month's library
routine that was easily readable by anyone working in last month's
context, and expand on its comments.  I would have to be forced,
or at least "re-educated".