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!newscon02.news.prodigy.net!prodigy.net!newsdst01.news.prodigy.net!prodigy.com!postmaster.news.prodigy.com!newssvr19.news.prodigy.net.POSTED!4988f22a!not-for-mail From: Newsgroups: comp.lang.ada References: <1174645259.9435.22.camel@localhost.localdomain> Subject: Re: commenting, was Re: Use of declare blocks X-Priority: 3 X-MSMail-Priority: Normal X-Newsreader: Microsoft Outlook Express 6.00.2900.2180 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.2180 X-RFC2646: Format=Flowed; Original Message-ID: NNTP-Posting-Host: 70.134.112.39 X-Complaints-To: abuse@prodigy.net X-Trace: newssvr19.news.prodigy.net 1174692699 ST000 70.134.112.39 (Fri, 23 Mar 2007 19:31:39 EDT) NNTP-Posting-Date: Fri, 23 Mar 2007 19:31:39 EDT Organization: AT&T http://yahoo.sbc.com X-UserInfo1: [[PAPDONTBWQR]TX\ZIBNFXBWR\HPCTL@XT^OBPLAH[\BPIB_NVUAH_[BL[\IRKIANGGJBFNJF_DOLSCENSY^U@FRFUEXR@KFXYDBPWBCDQJA@X_DCBHXR[C@\EOKCJLED_SZ@RMWYXYWE_P@\\GOIW^@SYFFSWHFIXMADO@^[ADPRPETLBJ]RDGENSKQQZN Date: Fri, 23 Mar 2007 16:32:11 -0800 Xref: g2news1.google.com comp.lang.ada:14625 Date: 2007-03-23T16:32:11-08:00 List-Id: I once wrote a program that enabled files of comments to be inserted in the program wherever I wanted them. I wrote it for a client, but I am not sure I still have the source code. However, it would be easy to write. Wherever I wanted to be able to expand the source code with additional documentation, I included a --{file-name} Then, we could print the source file with all the comments embedded or not, depending on the option in the print routine. Actually, this program included several other printing options, as well. Maybe I need to find it and make it available in the source code repository. Richard Riehle ==================================================== wrote in message news:pqednfl5KJ4GhpnbnZ2dnUVZ_v2knZ2d@comcast.com... >> even when their meaning seemed obvious to me. In particular, when their >> meaning seemed obvious. As you say, it won't stay obvious, and >> the programmer's knowledge at the time of writing is lost with >> the missing comment and has to be regained. > I'd like comments that are fuller as the code gets older. > I've long wanted a system that each day would find those files that > are, say, two days old and it would ask me to either delete or give a > (very) short description (but longer than an 8.3 file name!). Files that > haven't been accessed in two weeks would either be deleted or it would > require me to give a somewhat longer description. Similarly after two > months, with a description that would make sense two years from now. > This would have to be system-enforced, since I can't bring myself to > do it manually (and sometimes it isn't clear how long certain files > will continue to exist anyway). > It would be nice to do something similar with source code and comments.