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,e61c8636ef35379d X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2001-01-20 11:58:11 PST Path: supernews.google.com!sn-xit-02!supernews.com!nntp-relay.ihug.net!ihug.co.nz!newsfeed.germany.net!news.netcologne.de!RRZ.Uni-Koeln.DE!a1-hrz.uni-duisburg.de!uni-duisburg.de!l1-hrz.uni-duisburg.de!sb463ba From: sb463ba@l1-hrz.uni-duisburg.de (Georg Bauhaus) Newsgroups: comp.lang.ada Subject: Re: Examples in Docs, was Re: Escape Sequences in Strings Date: 20 Jan 2001 19:50:50 GMT Organization: GMUGHDU Message-ID: <94cq6q$kfp$1@news-hrz.uni-duisburg.de> References: <93objj$guk$1@nnrp1.deja.com> <93q77h$rr6$1@nnrp1.deja.com> <940f9j$nj2$1@nnrp1.deja.com> <94299p$8dd$1@nnrp1.deja.com> <94a2jj$tc2$1@nnrp1.deja.com> <94c73f$hs9$1@nnrp1.deja.com> NNTP-Posting-Host: l1-hrz.uni-duisburg.de X-Newsreader: TIN [version 1.2 PL2] Xref: supernews.google.com comp.lang.ada:4246 Date: 2001-01-20T19:50:50+00:00 List-Id: Stephen Leake (stephen.a.leake.1@gsfc.nasa.gov) wrote: : 1) The document presents an overview of the design of a large system, : so it uses diagrams, and it doesn't belong in any one source file. : 2) The document presents an algorithm that is best described by : mathematical notation; flat ASCII is just not good enough for this. : When I write an algorithm document, I define the mapping from math : symbols to Ada names. I also use LaTeX, so I can edit the document in : the same editor (Emacs) as the Ada source; that makes it much easier : to keep them in synch. There is a still evolving tool for this, and the direction into which it moves is, it seems, under consideration. http://www.eecs.harvard.edu/~nr/noweb/wish.html Georg Bauhaus