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!newsfeed-east.nntpserver.com!nntpserver.com!newsfeed1.sea.pnap.net!newsfeed2.sea.pnap.net!newsfeed.pnap.net!brmea-news-1.sun.com!news1brm.central.sun.com!new-usenet.uk.sun.com!not-for-mail From: Ole-Hjalmar Kristensen Newsgroups: comp.lang.ada Subject: Re: Literate Programming in Ada, AdaDoc, AdaBrowse Date: 11 Oct 2004 09:33:50 +0200 Organization: Sun Microsystems Message-ID: References: <2sqmccF1oit5sU1@uni-berlin.de> <2sr234F1oog3tU1@uni-berlin.de> NNTP-Posting-Host: khepri06.norway.sun.com Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: new-usenet.uk.sun.com 1097480032 13316 129.159.112.195 (11 Oct 2004 07:33:52 GMT) X-Complaints-To: usenet@new-usenet.uk.sun.com NNTP-Posting-Date: 11 Oct 2004 07:33:52 GMT User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/21.2 Xref: g2news1.google.com comp.lang.ada:5027 Date: 2004-10-11T07:33:52+00:00 List-Id: >>>>> "NR" == Nick Roberts writes: NR> Wes Groleau wrote: >> Were the original "tangle" "web" and "weave" open source? >> I think they were in Pascal. Should be easy to convert to >> Ada and modify some of the details in the process. NR> Well, yes, but that doesn't address the problem I mentioned, that have NR> to run the tangle program evry time between changing the source code NR> (even slightly) and recompiling and running. NR> Since (as I understand it) tangling involves reading and interpreting NR> /all/ the web files of the project, and regenerating /all/ the source NR> code files (obviously, there may be hundreds), it just isn't a NR> practical proposition for software development. NR> -- NR> Nick Roberts Make will automate the tangling, so it can work, but in my experience the main problem is that you compile generated source code, and your development environment is probably set up to let you edit and fix errors in those files, not in the original "web" document. So I think your solution is better. It is essentially the same idea as javadoc and numerous C++ documentation tools. Somewhere I stumbled over a system which could be tailored to different programming languages, but I have forgotten where.... -- C++: The power, elegance and simplicity of a hand grenade.