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,25aa3c7e1b59f7b5
X-Google-Attributes: gid103376,public
X-Google-ArrivalTime: 2002-01-12 08:37:55 PST
Path: 
 archiver1.google.com!news1.google.com!newsfeed.stanford.edu!news-spur1.maxwell.syr.edu!news.maxwell.syr.edu!newsfeeds.belnet.be!news.belnet.be!psinet-eu-nl!unlisys!news.snafu.de!cs.tu-berlin.de!uni-duisburg.de!not-for-mail
From: Georg Bauhaus <sb463ba@l1-hrz.uni-duisburg.de>
Newsgroups: comp.lang.ada
Subject: Re: Literate Programming [was: A case where ...]
Date: Sat, 12 Jan 2002 16:37:54 +0000 (UTC)
Organization: GMUGHDU
Message-ID: <a1pop2$lgk$1@a1-hrz.uni-duisburg.de>
References: <3C34BF2C.6030500@mail.com>
	   <5ee5b646.0201040829.18db8001@posting.google.com>
 <3C35E733.6030603@mail.com> <u3bu42jp7h5k0d@corp.supernews.com>
 <3C35FE2A.9020802@mail.com> <a15j7p$ogtku$1@ID-25716.news.dfncis.de>
 <x7vn0ztysj6.fsf@smaug.pushface.org> <a1g3kt$q2ehl$1@ID-25716.news.dfncis.de>
 <3C3C1438.FBF10FC3@baesystems.com> <wccg05e3q2k.fsf@shell01.TheWorld.com>
 <3C3EB43E.B82E92CA@baesystems.com> <wccn0zl813m.fsf@shell01.TheWorld.com>
 <a1o2gr$sfe3f$1@ID-25716.news.dfncis.de>
NNTP-Posting-Host: l1-hrz.uni-duisburg.de
X-Trace: a1-hrz.uni-duisburg.de 1010853474 22036 134.91.4.34 (12 Jan 2002
 16:37:54 GMT)
X-Complaints-To: usenet@news.uni-duisburg.de
NNTP-Posting-Date: Sat, 12 Jan 2002 16:37:54 +0000 (UTC)
User-Agent: tin/1.5.8-20010221 ("Blue Water") (UNIX) (HP-UX/B.11.00
 (9000/800))
Xref: archiver1.google.com comp.lang.ada:18825
Date: 2002-01-12T16:37:54+00:00
List-Id: <comp.lang.ada>


Several things might be interesting to consult here:
ANNA,
Lout (with Ada support, can turn on Lout mode in Ada comments)

How would you deal with the multi-syntax problem that Ada/Non-Ada
switching will entail?

: For the unfamiliar, the essence of 'literate programming' (invented by the
: heroic Prof. Don Knuth) is to combine software documentation, in its own
: suitable markup language (e.g. TeX or DocBook), with the source code itself,
: in the same source file.

Plus the capability to add readability by reordering chunks
of source language code to help the reader, not the compiler
(ex.: body of nested subprograms defined outside the declarative
region of the enclosing subprogram in AdaWEB source, yet not making
it separate, big switches squeezed to one half page or so, that from
a readers point of view may seem similar to a limited PERFORM in COBOL).

A variant of this is found in Booch's Software Components with Ada.

: It would be a splendid opportunity to add a great buzzword to Ada: we could
: say it was a "literate programming language". Gotta help with advocacy!

How would that be advocacy given empirical results of advocating
literate programming? :-)


Georg