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-13 08:29:21 PST Path: archiver1.google.com!news1.google.com!sn-xit-02!supernews.com!newsfeed.direct.ca!look.ca!fu-berlin.de!uni-berlin.de!ppp-2-240.cvx1.telinco.NET!not-for-mail From: "Nick Roberts" Newsgroups: comp.lang.ada Subject: Re: Literate Programming [was: A case where ...] Date: Sun, 13 Jan 2002 14:46:31 -0000 Message-ID: References: <3C34BF2C.6030500@mail.com> <5ee5b646.0201040829.18db8001@posting.google.com> <3C35E733.6030603@mail.com> <3C35FE2A.9020802@mail.com> <3C3C1438.FBF10FC3@baesystems.com> <3C3EB43E.B82E92CA@baesystems.com> NNTP-Posting-Host: ppp-2-240.cvx1.telinco.net (212.1.137.240) X-Trace: fu-berlin.de 1010938793 30164172 212.1.137.240 (16 [25716]) X-Priority: 3 X-MSMail-Priority: Normal X-Newsreader: Microsoft Outlook Express 5.50.4133.2400 X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400 Xref: archiver1.google.com comp.lang.ada:18862 Date: 2002-01-13T14:46:31+00:00 List-Id: "Georg Bauhaus" wrote in message news:a1pop2$lgk$1@a1-hrz.uni-duisburg.de... > Several things might be interesting to consult here: > ANNA, > Lout (with Ada support, can turn on Lout mode in Ada comments) Will do. > How would you deal with the multi-syntax problem that Ada/Non-Ada > switching will entail? If the switching token must be on a line on its own, and is different to anything else (likely) to be written in any other syntax, it shouldn't be too much of a problem? > : 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). Indeed, but then that would certainly require a tangle pre-processor; there would be some advantages (for Ada code, at least) in avoiding the need for a tangler. An alternative (perhaps a better one) would be make/build tools that would work with (or have built-in) a tangler. > How would that be advocacy given empirical results of advocating > literate programming? :-) Well *I'm* going to keep plugging away! -- Best wishes, Nick Roberts