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,81054609038e88e3 X-Google-Attributes: gid103376,public X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news1.google.com!news1.google.com!news.glorb.com!solnet.ch!solnet.ch!news-zh.switch.ch!irazu.switch.ch!switch.ch!newsmi-eu.news.garr.it!NewsITBone-GARR!newsserver.cilea.it!news.crs4.it!not-for-mail From: Jacob Sparre Andersen Newsgroups: comp.lang.ada Subject: Re: Literate Programming in Ada, AdaDoc, AdaBrowse Date: 18 Oct 2004 15:47:26 +0200 Organization: CRS4, Center for Adv. Studies, Research and Development in Sardinia Message-ID: References: <2sqmccF1oit5sU1@uni-berlin.de> <2sr4jaF1od20uU1@uni-berlin.de> NNTP-Posting-Host: jacob.crs4.it Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: pietro.crs4.it 1098102267 30077 156.148.71.80 (18 Oct 2004 12:24:27 GMT) X-Complaints-To: news@nntpserver.crs4.it. NNTP-Posting-Date: 18 Oct 2004 12:24:27 GMT User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.2 Xref: g2news1.google.com comp.lang.ada:5399 Date: 2004-10-18T12:24:27+00:00 List-Id: Marius Amado Alves wrote: > When you open a file for reference you want to look at the > *significant* code, and usually at the start of it. A long comment > at the top totally gets in the way. Compare: > > http://www.liacc.up.pt/~maa/files/g-io_aux.ads > http://www.liacc.up.pt/~maa/files/g-io_aux-edited.ads Unfair example. Wasting space on copyright notices in every damned text file is a horrible idea. If you remove the copyright notice from the beginning of the original version of the file, the first 10 lines (well, actually the first five), show you useful information about the overall idea with the file. Jacob -- "[...] *transfer* a bit of salary from the person who writes a bug to the person that finds a bug..." -- Keith Ray