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=-0.7 required=5.0 tests=BAYES_00,HEADER_SPAM, INVALID_MSGID autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 1032a1,4f5d9fdcc65429b5 X-Google-Attributes: gid1032a1,public X-Google-Thread: 103376,4f5d9fdcc65429b5 X-Google-Attributes: gid103376,public From: ict@eh.org (Iain Truskett) Subject: Re: Ada and Literate Programming Date: 2000/05/09 Message-ID: <8f9o4a$9aq$1@news.fas.harvard.edu>#1/1 X-Deja-AN: 621244484 References: <8f6iue$pu5$1@news.fas.harvard.edu> <391728d1@pfaff.ethz.ch> Organization: None. Newsgroups: comp.lang.ada,comp.programming.literate Originator: nr@labrador.eecs.harvard.edu (Norman Ramsey) Date: 2000-05-09T00:00:00+00:00 List-Id: On 8 May 2000 22:51:29 +0100, Robert Dewar wrote: [...] > Seeing as the substance of literate programming is very little more > than writing code that is properly documented, I would hope that > everyone is doing literate programming in Ada. The very fact that this > needed to be identified as a special technique and given a special > name is a bit appalling. The idea of programs that are illiterate and > cannot be read is frightening to me. Mind you, LP *does* have the important feature of not requiring your code to be linear. i.e. the code can be organised to suit the documentation rather than the documentation being organised to fit the code. Very important, particularly in the case of error handling since otherwise your error handling can distract the reader from the substance of what your code is meant to be doing. cheers, -- iain.