Path: utzoo!utgpu!watmath!watcgl!kim From: kim@watsup.waterloo.edu (Kim Nguyen) Newsgroups: gnu.emacs Subject: Re: 2nd Generation GNU Emacs & texinfo ? Message-ID: Date: 29 May 89 23:42:37 GMT References: Sender: daemon@watcgl.waterloo.edu Distribution: gnu Organization: PAMI Group, U. of Waterloo, Ontario Lines: 25 In-reply-to: eho@bogey.Princeton.EDU's message of 28 May 89 01:31:28 GMT In article eho@bogey.Princeton.EDU (Eric Y.W. Ho) writes: Also, is anyone extending texinfo where it can integrate code as well -- [...] now you're documenting your ideas & writing code at the same time and when you've finished, you just run the whole thing through some converter/filter and it'll churn out pure code (be they in Lisp, C or whatever) on the one hand and typesetted documentation for you designs on the other hand. Eric Ho Princeton Cognitive Science Lab., Princeton University email = eho@phoenix.princeton.edu voice = 609-987-2819 Generating "documentation" from the comments in your code is a somewhat brain-damaged way of describing your programs usefully. Good documentation consists of high-level descriptions, followed by increasingly detailed nitty-gritty discussions. A company for which I worked used to document its code "automatically", but the manuals were essentially useless. -- Kim Nguyen kim@watsup.waterloo.edu Systems Design Engineering -- University of Waterloo, Ontario, Canada