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-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 103376,2a5467dded7223af
X-Google-Attributes: gid103376,public
X-Google-ArrivalTime: 2002-11-10 10:45:18 PST
Path: 
 archiver1.google.com!news1.google.com!newsfeed.stanford.edu!news-spur1.maxwell.syr.edu!news.maxwell.syr.edu!newsfeed.icl.net!newsfeed.fjserv.net!colt.net!peernews3.colt.net!newsfeed.stueberl.de!eusc.inter.net!news.eusc.inter.net!boavista.snafu.de!news
From: Michael Erdmann <Michael.Erdmann@snafu.de>
Newsgroups: comp.lang.ada
Subject: Re: Building documentation from comments
Date: Sun, 10 Nov 2002 19:39:31 +0100
Organization: gnade.sourceforge.net
Message-ID: <3ol2a-jid.ln1@boavista.snafu.de>
References: <3dc7f605$0$303$bed64819@news.gradwell.net>
 <3dcb4b43$0$301$bed64819@news.gradwell.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7Bit
X-Trace: news.eusc.inter.net 1036953917 2690 213.73.71.145 (10 Nov 2002
 18:45:17 GMT)
X-Complaints-To: abuse@eusc.inter.net
User-Agent: KNode/0.7.1
Xref: archiver1.google.com comp.lang.ada:30688
Date: 2002-11-10T19:39:31+01:00
List-Id: <comp.lang.ada>

I have build some time ago a tool which generates out 
the the comments doocbook documents. This generation is 
based upon some heuritics, e.g.

XXXXXXXXXX
==========

Is proably a dscription and so on. But the problem
is to get the people to follow at least these minimal
resquirements on the structure of the comments.

Michael


Victor Porton wrote:

> In article <x7vr8dx14iu.fsf@smaug.pushface.org>,
> Simon Wright <simon@pushface.org> writes:
>> porton@ex-code.com (Victor Porton) writes:
>> 
>> It always reproduces the big copyright comment that is in the source
>> file!
>> 
>> Not sure about the ethics of removing other folks' copyright notices.
> 
> Just removing such notices for local use (not for distributing) to reduce
> needed scrolling in the Web browser :-)
> 
> Surely distributing files with removed copyright is immoral (if not
> used for just exposition).