Archive-Date: Sun, 01 Jan 1995 06:16:07 CDT Sender: owner-litprog@SHSU.edu Subject: Advice Needed Message-ID: <1995Jan1.111004.7095@wisipc.weizmann.ac.il> From: oren@hadar.weizmann.ac.il (Ben-Kiki Oren) Reply-To: LitProg@SHSU.edu, oren@HADAR.WEIZMANN.AC.IL Date: Sun, 1 Jan 1995 11:10:04 GMT To: LitProg@SHSU.EDU I am looking for advice on how to begin integrating literate programming tools into my development environment. My situation is as follows: I work in a small start-up, where in the last year or so I was the sole code-writer. I wrote approximately 20K LOC (in C++), 15K of which are in a major library (~150 .cpp files). The code is reasonably commented, but lacks documentation of the overall structure and the relationships between the different library parts. We are now expanding and hiring a few (~4) more programmers. I therefore need to complete the documentation. Further, in my new role as 'lord of code writers', I need to set up coding guidelines (and my code had better satisfy them :-) Now, my code is rather orderly, and follows a consistent style (which I can formalize without much trouble). However, as I mentioned above, its documentation is somewhat lacking. I have been following this newsgroup about a year ago, but I never used a literate programming tool. I thought this would be a good opportunity to start using one; if it works out, I could have have all my programmers use it, and make it an integrated part of the development process. The problem is, of course, which tool to use. We will be developing our libraries on UNIX. The GUI will be based on MS/Windows, but I feel that complex documentation of the GUI part is unnecessary, since the help system will fill the same need. So, I can settle for a UNIX-based tool. I would naturally like the tool I use to be as simple and lightweight as possible. I would also like to have hyper-text abilities, good indices, etc. Formatting should be kept simple, so I am weary of tools which require using plain TeX. LaTeX is probably acceptable; Texinfo would be perfect, if it weren't for the strange fact the FAQ did not list any tool using it. Some may be configured for it, I suppose, but I lack the time for prolonged customizations. The trouble is, quite a few tools mentioned in the FAQ may be appropriate, in particular: - CLiP (may be configurable to using Texinfo, but did it say a 64 files limit?) - CWEB (integrated C/C++ support) - FunnelWeb (to quote the FAQ: 'production-quality' + 'simple', plus tutorials) - FWEB (how come its documented in Texinfo, but produces TeX/LaTeX?) - noweb (very simple, HTML support, could be just the thing) - nuweb (simple) - ProTeX? (well, someone published a book on it, so it can't be that bad :-) Obviously I can't just download each, play with it for a week, and make up my mind. I will probably download two, or at most three, and make up my mind after reading the docs. So, could anyone give me some good arguments for/against any of the above, point out the major differences, or otherwise help me out? I'll post a summary of the replies; if its relevant, I'll format it as an addition to the FAQ. Thanks, Oren Ben-Kiki -- Life is tough and the hard ships are many. ================================================================================ Archive-Date: Sun, 01 Jan 1995 15:31:34 CDT Sender: owner-litprog@SHSU.edu From: dancarden@aol.com (Dancarden) Subject: malloc error Date: 1 Jan 1995 16:18:32 -0500 Message-ID: <3e7678$bi8@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, dancarden@aol.com (Dancarden) To: LitProg@SHSU.EDU what is a malloc error? ================================================================================ Archive-Date: Sun, 01 Jan 1995 17:40:02 CDT Sender: owner-litprog@SHSU.edu From: brothers@mdd.comm.mot.com (Joseph Brothers) Reply-To: LitProg@SHSU.edu, brothers@MDD.COMM.MOT.COM Subject: Re: Advice Needed Date: 1 Jan 1995 15:20:12 -0800 Message-ID: <3e7dbc$6ep@bb13c.mdd.comm.mot.com> To: LitProg@SHSU.EDU Please try noweb. It's not only very simple in operation and easy to learn to use, it is very powerful and has many useful output options including a very nice HTML converter. Its language independence and LaTeX integration make it broadly useful. Noweb quickly becomes familiar and gets out of your way, letting you improve the clarity of your understanding and exposition of your code. -- Joseph L. Brothers brothers@mdd.comm.mot.com uunet!mdisea!brothers "I am speaking solely for my self, not my employer." ================================================================================ Archive-Date: Sun, 01 Jan 1995 20:17:43 CDT Sender: owner-litprog@SHSU.edu From: bcwbrian@aol.com (BCWBrian) Subject: Newbie Date: 1 Jan 1995 21:10:57 -0500 Message-ID: <3e7nbh$dti@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, bcwbrian@aol.com (BCWBrian) To: LitProg@SHSU.EDU Is there anyone out there to help someone new to programming? If you're willing to, e-mail back to BCWBrian@aol.com. Thank-you in advance. -Brian Wengerter BCWBrian@aol.com ================================================================================ Archive-Date: Mon, 02 Jan 1995 02:47:22 CDT Sender: owner-litprog@SHSU.edu From: etmall@ci.ua.pt (Manuel Lemos) Reply-To: LitProg@SHSU.edu, etmall@CI.UA.PT Subject: Re: CWEB 3.3 patch level 11a available Message-ID: Date: Mon, 2 Jan 1995 01:58:43 GMT To: LitProg@SHSU.EDU Andreas Scherer (scherer@genesis.informatik.rwth-aachen.de) wrote: : I herewith announce the availability of the December installation of : CWEB 3.3 [p11a]. There are two groups of hosts that hold it. CD versions : will be made from their archives. : Firstly, for all the Amiga fans out there, look for : AMINET:/dev/c/cweb33p11a.lha : where `AMINET' stands for any Aminet server near you. What exactly is CWEB and what is it used for? ================================================================================ Archive-Date: Mon, 02 Jan 1995 05:18:37 CDT Sender: owner-litprog@SHSU.edu From: utcke@nerys.ti1.tu-harburg.de (Sven Utcke) Reply-To: LitProg@SHSU.edu, utcke@NERYS.TI1.TU-HARBURG.DE Subject: information on web-mode.el and FWEB Date: 2 Jan 1995 11:08:48 GMT Message-ID: <3e8ms0$q1r@rztsun.tu-harburg.de> To: LitProg@SHSU.EDU Hi everyone, after next to a year of programming-abstinence, I'm now starting to do some again. My programming environment, at the moment, is: Editor: GNU Emacs 19.27.1 (rs6000-ibm-aix) Mode : Beta of Version 2.7 of web-mode.el Web : FWEB 1.30a And I now wonder if this is still an up-to-date environment (and, no, I cant help working on an rs6000 :-). I'm especially interested in the following: a) is FWEB 1.4 still a highly experimental system for the experienced and brave only? You would think that by now it would be highly stable... b) Is my version of web-mode.el the current version? Or is there anything better out there? I really like the help given with scrap-names (selecting, renaming and so forth). That's really most valuable. However, the TeX-mode-part does hardly deserve the name (well, I suppose it's meant for generic documentation, but still...), and the same goes for the code-part (for obvious reasons, given that it is meant to work with multiple languages). I dearly miss support for hilit, and the rebinding of C-x C-c drives me nuts. So I suppose I'm really looking for something entirely different, giving me the same help with scrap-names web-mode does (no, I won't do without) but at the same time allowing for different additional modes in both the documentation (LaTeX-mode at least) and the code section (c-mode). Does anything like this exist? Thanks for your help and a happy new year Sven -- e-mail: utcke@tu-harburg.d400.de finger: utcke@kirk.ti1.tu-harburg.de WWW : http://bashir.ti1.tu-harburg.de/~utcke/utcke.html ================================================================================ Archive-Date: Mon, 02 Jan 1995 05:27:57 CDT Sender: owner-litprog@SHSU.edu From: utcke@nerys.ti1.tu-harburg.de (Sven Utcke) Reply-To: LitProg@SHSU.edu, utcke@NERYS.TI1.TU-HARBURG.DE Subject: FWEB and Khoros Date: 2 Jan 1995 11:17:35 GMT Message-ID: <3e8ncf$q1r@rztsun.tu-harburg.de> To: LitProg@SHSU.EDU Hi everyone, I wonder if anybody could give me some advise on the following: About one and a half year ago I started programming in FWEB and have since done nearly all my programming in it. I love it and don't know how I could ever do without. However, I now have to program for Khoros. Programming is still done in C, but the source file contains not only the C-code for both a main file and a library file, but also for the documentation and some more, and part of the c-code is actually created automagically from the other parts of the file (like printing part of the man page if wrong usage is detected). I'm afraid the two paradigm won't go together easily... Has anybody out there ever used both (not necessarily F)WEB and Khoros? Any advice you can give? Thanks and a happy new year Sven -- e-mail: utcke@tu-harburg.d400.de finger: utcke@kirk.ti1.tu-harburg.de WWW : http://bashir.ti1.tu-harburg.de/~utcke/utcke.html ================================================================================ Archive-Date: Mon, 02 Jan 1995 15:54:00 CDT Sender: owner-litprog@SHSU.edu From: oli@makeitso.swb.de (Oliver Goetz) Reply-To: LitProg@SHSU.edu, oli@MAKEITSO.SWB.DE Subject: FunnelWeb Mailing List Message-ID: Date: Sat, 31 Dec 94 15:58:50 +0100 To: LitProg@SHSU.EDU In the comp.programming.literate FAQ list, a mailing list for FunnelWeb is mentioned, but no address is given, where to subscribe to it. Does anybody know how to get on this list? Many thanks in advance, and please e-mail any replies directly to me, there have been a few problems with news recently at my site, so I'm not sure I would see a followup. -- Oliver Goetz | "...all mattresses grown in the swamps of s_goetz@ira.uka.de | Sqornshellous Zeta are very thoroughly killed oli@makeitso.swb.de | and dried before being put to service. Lochwiesenstr.1 | Very few have ever come to life again." D67122 Altrip, Germany | -- The Hitch Hiker's Guide To The Galaxy ================================================================================ Archive-Date: Mon, 02 Jan 1995 18:09:30 CDT Sender: owner-litprog@SHSU.edu From: tobeyp@aol.com (TobeyP) Subject: Computer Programmer needed to interview about career. Date: 2 Jan 1995 18:57:24 -0500 Message-ID: <3ea3t4$lr3@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, tobeyp@aol.com (TobeyP) To: LitProg@SHSU.EDU I'm looking for a computer programmer to e-interview about his/her career. I'm doing this interview for part of a research paper about my current career choice, computer programming. If anyone fits the criteria of being employed as a computer programmer and would be willing to respond to a questionair about their career via e-mail I would greatly appreciate a message sent to tobeyp@aol.com expressing their willingness to participate. Thanks much. Tobey ================================================================================ Archive-Date: Tue, 03 Jan 1995 03:33:30 CDT Sender: owner-litprog@SHSU.edu From: purelogic@aol.com (Pure Logic) Subject: Visual Basic Newsletter Starting Date: 3 Jan 1995 03:46:49 -0500 Message-ID: <3eb2tp$qdm@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, purelogic@aol.com (Pure Logic) To: LitProg@SHSU.EDU I am looking to increse my knowledge of Visual Basic through developing a newsletter where the readers and, if possible, VB Guru's summit the articles. Summittions could be simple shortcuts, form designs, program code, personal stories relating to VB, advertisements for VB user groups and meetings, etc; if it relates to VB in any way it is included. All writers will definitely be acknowledge. If any is interested in summitting or subscribing, please contact me by email only. Whether this newsletters gets off the ground solely depends on the response I get from this posting. Pure Logic@aol.com Clay Smith Spartanburg, SC USA Home of BMW North America and the Carolina Panthers training camp ================================================================================ Archive-Date: Tue, 03 Jan 1995 07:42:31 CDT Sender: owner-litprog@SHSU.edu From: weiqigao@crl.com (Weiqi Gao) Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: Visual Basic Newsletter Starting Date: Tue, 03 Jan 95 07:39:53 PST Message-ID: <3ebk0d$6p5@nntp.crl.com> MIME-Version: 1.0 To: LitProg@SHSU.EDU In article <3eb2tp$qdm@newsbf02.news.aol.com>, Pure Logic says... > > I am looking to increse my knowledge of Visual Basic through >developing a newsletter where the readers and, if possible, VB Guru's >summit >the articles. Summittions could be simple shortcuts, form designs, >program >code, personal stories relating to VB, advertisements for VB user groups >and >meetings, etc; if it relates to VB in any way it is included. All writers >will definitely be acknowledge. If any is interested in summitting or >subscribing, please contact me by email only. Whether this newsletters >gets >off the ground solely depends on the response I get from this posting. > >Pure Logic@aol.com >Clay Smith >Spartanburg, SC USA > >Home of BMW North America >and the Carolina Panthers training camp > > For the fourth time, this is an inappropriate subject. comop.programming.literate is a usenet news group for the discussion of Literate Programming subjects. By definition, Literate Programming is the kind of programming that inputs one source and produce two different out puts, usually a compilable program source and a text-processable documentation. Visual BASIC hardly qualifies for this definition. I suspect the poster is posting to all the comp. groups though the AOL USENET POSTING PROGRAM. In that case, GET LOST would be my answer to the poster. In case the poster is genuinly trying to find a place to post his VB related articles, my I suggest comp.languages.basic.visual as the appropriate forum. On a different note, let me just mention the Wilkinson's rule: NO VISUAL BASIC NEWSLETTER WILL LAST FOR MORE THAN TWO ISSUES! The first issue will be "How do I get rid of the BEEP", the second issue will be "How do I UPGRADE to Visual C--" :^) Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Tue, 03 Jan 1995 08:54:10 CDT Sender: owner-litprog@SHSU.edu From: weiqigao@crl.com (Weiqi Gao) Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: Computer Programmer needed to interview about career. Date: Tue, 03 Jan 95 08:46:02 CST Message-ID: <3ebo05$8fh@nntp.crl.com> MIME-Version: 1.0 To: LitProg@SHSU.EDU In article <3ea3t4$lr3@newsbf02.news.aol.com>, tobeyp@aol.com says... > > I'm looking for a computer programmer to e-interview about his/her >career. I'm doing this interview for part of a research paper about my >current career choice, computer programming. If anyone fits the criteria >of being employed as a computer programmer and would be willing to respond >to a questionair about their career via e-mail I would greatly appreciate >a message sent to tobeyp@aol.com expressing their willingness to >participate. Thanks much. >Tobey For the fifth time, this is an inappropriate subject. comp.programming.literate is a usenet news group for the discussion of Literate Programming subjects. By definition, Literate Programming is the kind of programming that inputs one source and produce two different out puts, usually a compilable program source and a text-processable documentation. On a different note, your e-interview scheme could be described from "naive mistake" to "fraud" in any scientific sense. The result you get would be anecdotal at best, and could not be thought of to be useful in any sense. Take a course in statistics and survey sampling and you'll know why! [What if I answered your e-mail and told you I'm Al Gore.] ** On to LitProg matters: A while back I posted an query about noweb and Linux. I'm happy to report that I have got it to work. [Out of the box as claimed.] Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Tue, 03 Jan 1995 09:12:52 CDT Sender: owner-litprog@SHSU.edu From: maavl@cwi.nl (Marc van Leeuwen) Reply-To: LitProg@SHSU.edu, maavl@CWI.NL Subject: Announcement of release of CWEBx3.0 Message-ID: Date: Tue, 3 Jan 1995 14:59:36 GMT To: LitProg@SHSU.EDU Release of CWEBx3.0, another implementation of CWEB =================================================== After several versions with beta status, CWEBx is now officially released as version CWEBx3.0. The system is available at ftp://ftp.cwi.nl/pub/cweb and will hopefully also be available soon at the Literate Programming Archive (ftp://ftp.th-darmstadt.de/pub/programming/literate-programming/c.c++) and at the CTAN sites. An earlier version was released last year under the name `CWEB 3.x'. With respect to that version the main changes are improved compatibility with Levy/Knuth CWEB, and greater reliability. All extras that were added in Levy/Knuth CWEB have been incorporated, and a compatibility mode is added in which the external behaviour of Levy/Knuth CWEB is simulated exactly. The main version number `3' now indicates compatibility with the corresponding major version of Levy/Knuth CWEB, which was not the case for CWEB 3.x. (The minor version numbers of Levy/Knuth CWEB only involve bug fixes that are usually not relevant to CWEBx; all bugs that are repaired in Levy/Knuth CWEB 3.3, and many that are not, are absent in CWEBx3.0). A few new features have also been added, mainly to increase flexibility of use. As a reminder, here is a summary of the new aspects that were already present in CWEB 3.x. - The effect of typedef declarations on formatting extends over the complete source text, rather then starting at the declaration itself. - A control code for inclusion of header files, which causes any typedef declarations in the header file to be taken into account in formatting. - A mechanism for referring to section numbers using symbolic labels. - A control code to start a section without allowing a page break. - A control code to denote the bitwise-or operator `|' within `|...|'. - A control code to force a negative indentation by one unit on a line. - The size of an indentation can be controlled by a parameter. - A defaulting mechanism on command line to use change file if it is present. - CTANGLE matches parentheses and braces in macros and modules bodies. - Several layout styles may be selected from the command line. - Irreducible scrap sequences can be shown without changing the source files. - Automatic breaking of long expressions using precedence rules. - New and modular set of grammar rules, based directly on the ANSI C syntax. - Syntax category of module names can be controlled; default is statement. - A completely new manual, with a one-page table of all control codes. - CWEB programs are system independent, no change files needed. - Organisation of programs is much more C-like, using ordinary header files for communication between compilation units. - Documentation of source code is improved, programs are more literate. The following features are the main additions made since CWEB 3.x - Control codes @s, @q, @l, @h, from Levy/Knuth CWEB. - Relaxation of the rules, e.g. for module names, as in Levy/Knuth CWEB. - Compatibility mode with Levy/Knuth CWEB. - Possibility to send index and module names to separate files. - Possibility to get human-oriented output from CTANGLE, omitting #line, but retaining comments and indentation. - Possibility to specify search path for header files on command line. - Possibility to indicate that a typedef identifier is used as an ordinary one, e.g., as a field in a structure. - Possibility to treat short compound statments as simple ones in formatting. - An improved and even more complete manual (now 32 pages). Marc van Leeuwen CWI, Amsterdam ================================================================================ Archive-Date: Wed, 04 Jan 1995 14:12:36 CDT Sender: owner-litprog@SHSU.edu From: noof@aol.com (Noof) Subject: Text Compressor Date: 4 Jan 1995 13:14:39 -0500 Message-ID: <3eeoif$7j2@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, noof@aol.com (Noof) To: LitProg@SHSU.EDU We are looking for a text compressor C++ class or C library. The compressor must be able to achieve 2 to 1 compression. We plan on using it to compress text prior to storing it in the Sybase data type of image. Speed is important as the compressions/expansions will be done on the fly. The data will proabably be less than 8 kB, but will likely be around 2.5 kB. The applications that will use this are built with MacApp. Can anyone suggest a vendor for this? Also, please suggest a better newsgroup if this one isn't appropriate. Thanks, Dave Knuth knuth@lmis.loral.com ================================================================================ Archive-Date: Thu, 05 Jan 1995 09:14:18 CDT Sender: owner-litprog@SHSU.edu From: t7846aj@cd1.lrz-muenchen.de (Thomas Huber) Reply-To: LitProg@SHSU.edu, t7846aj@CD1.LRZ-MUENCHEN.DE Subject: FWEB under MPW? Date: 5 Jan 1995 14:58:22 GMT Message-ID: <3eh1ee$bgj@sunserver.lrz-muenchen.de> Keywords: Lterate Programming, FWEB, Macintosh, MPW. To: LitProg@SHSU.EDU Hello everyone out there, quite recently I got convinced, that Literate Programming shall be a must in the future for our software development team. As a newbie to this field I tried to figure out what the optimal system for our needs could be, and finally found my way to FWEB. This seemed reasonable to me (is it?), because many of us still code in FORTRAN 90, and we mostly work on UNIX platforms. As a Macintosh fan I tried to port FWEB to MPW, just to make it availiable for our Mac-users, but didn't succeed. (I thought ANSI-C and some kind of shell should be enough to run FEWB) Insteed I ran into some mystic Link-errors, and finally (after overcoming the mentioned link-problem) ended with a non working tool. My questions: Has anyone tried to port FWEB to MPW? Does someone know, why this should or should not work? Any comments are appreciated. Thanks. Thomas ================================================================================ Archive-Date: Thu, 05 Jan 1995 15:19:39 CDT Sender: owner-litprog@SHSU.edu From: pbewig@netcom.com (Phil Bewig) Reply-To: LitProg@SHSU.edu, pbewig@NETCOM.COM Subject: Literate Programming for Troff Message-ID: Date: Thu, 5 Jan 1995 20:21:19 GMT To: LitProg@SHSU.EDU Are there any literate programming tools for troff users? -- Phil Bewig ... pbewig@netcom.COM ================================================================================ Archive-Date: Fri, 06 Jan 1995 09:48:49 CDT Sender: owner-litprog@SHSU.edu From: norman@flaubert.bellcore.com (Norman Ramsey) Reply-To: LitProg@SHSU.edu, norman@FLAUBERT.BELLCORE.COM Subject: Re: Literate Programming for Troff Date: 6 Jan 1995 15:12:30 GMT Message-ID: <3ejmku$3sq@lowell.bellcore.com> To: LitProg@SHSU.EDU In article , Phil Bewig wrote: >Are there any literate programming tools for troff users? Thimbleby's cweb supported c and troff, but I don't know if it is still available. I have a standing offer to noweb users that I will make noweb work with troff if they will (a) tell me what the output should look like, and (b) use the results. I might need some help with troff, too, although we have some pretty good experts here. Norman Ramsey ================================================================================ Archive-Date: Sat, 07 Jan 1995 21:49:51 CDT Sender: owner-litprog@SHSU.edu Message-ID: Date: Sat, 7 Jan 95 18:05 PST To: LitProg@SHSU.edu, marcus@ifh.de Subject: WWW Virtual Library Maintainer sought! References: From: Kayvan Sylvan Reply-To: LitProg@SHSU.edu, kayvan@SYLVAN.COM Marcus, If no one else takes the WWW page and associated docs, I'll store it until a suitable volunteer shows up. I'm too busy myself to maintain it, but would hate to see it go to waste. ---Kayvan "The trust and respect of a child is an honor to be earned, not demanded." Kayvan Sylvan | Sylvan Associates | Proud Dad of: kayvan@Sylvan.COM | Training, Consulting | Katherine Yelena (8/8/89) (408) 978-1407 can PGP | Ask me about Avatar. | Robin Gregory (2/28/92) ================================================================================ Archive-Date: Sun, 08 Jan 1995 10:47:42 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: TEXT PROCESSING IN LANGUAGES THAT FLOW FROM RIGHT TO LEFT Date: 8 Jan 1995 16:45:26 GMT Message-ID: <3ep4r6$6cm@gap.cco.caltech.edu> To: tex-news@SHSU.EDU I will soon be writing documents in two languages. They will be English, Hebrew, and Arabic or Chinese. Unfortunately, these languages write in opposite directions. I am looking for ways, in which I can do this scientific text processing using LaTeX/TeX system. I would highly appreciate any help on this. This would help many other users. Lily Liao pls reply via email. ================================================================================ Archive-Date: Mon, 09 Jan 1995 18:21:52 CDT Sender: owner-litprog@SHSU.edu From: yosi@lrdc5.lrdc.pitt.edu (David Heyman) Reply-To: LitProg@SHSU.edu, yosi@LRDC5.LRDC.PITT.EDU Subject: Re: TEXT PROCESSING IN LANGUAGES THAT FLOW FROM RIGHT TO LEFT Date: Mon, 9 Jan 1995 21:26:33 GMT Message-ID: To: tex-news@SHSU.EDU In article <3ep4r6$6cm@gap.cco.caltech.edu>, lbliao@alumni.caltech.edu (lbliao) wrote: :I will soon be writing documents in two languages. They will be English, :Hebrew, and Arabic or Chinese. Unfortunately, these languages write in opposite :directions. I am looking for ways, in which I can do this scientific text :processing using LaTeX/TeX system. I would highly appreciate any help on :this. This would help many other users. : :Lily Liao : :pls reply via email. I have seen discussions on TeX in Hebrew on the il.board which you can send to via il-board@vm.tau.ac.il It is a Usenet group so be sure to specify that you don't read the group and need the info sent to you. Also I think that at http://www.huji.ac.il (Hebrew U. in Jerusalem) you can find TeX Hebrew resources. Good Luck! David ================================================================================ Archive-Date: Tue, 10 Jan 1995 00:33:48 CDT Sender: owner-litprog@SHSU.edu From: brothers@mdd.comm.mot.com (Joseph Brothers) Reply-To: LitProg@SHSU.edu, brothers@MDD.COMM.MOT.COM Subject: ANSWER: noweb -> ASCII text Date: 9 Jan 1995 22:05:07 -0800 Message-ID: <3et82j$vi@bb13c.mdd.comm.mot.com> Keywords: noweb, dvi, latex, dvi2tty To: LitProg@SHSU.EDU December 27, 1994 1 Making noweb Produce ASCII Text This little answer is produced using itself, that is, what you are reading in the newsgroup or mailer was authored in noweb and postprocessed into formatted text. The noweb source is included as a uuencoded gzip file. If you have noweb, you might choose to create .ps format output. You can read either of these formats, follow its instructions, and reproduce the original posting. 1 Yet Another Frequently Asked Question (FAQ) This is the question as originally posted to comp.programming.literate: Can anyone suggest a way to derive formatted ASCII text from noweb source? The answer may be as simple as locating a TeX-to-nroff filter. Nroff-style output would be fine. 2 Some Frequently Offered Suggestions (FOS) I received a number of interesting and informative replies while I was prowling about with ftp. They amounted to: o [noweb author] Norman Ramsey has a standing offer to build a troff/nroff back-end for noweb if someone will specify and use it o use dvidoc from CTAN o use dvi2tty from CTAN; in the US it's pip.shsu.edu (192.92.115.10) o use dvi2tty from sol.cs.bucknell.edu:droms/txt-dist.tar 2.1 Don't Ask Norman To Build One I don't know enough about either roff to specify a new backend for noweb, and Norman has commented before how nasty cross-referencing would be in nroff. Also, this could take a while. 2 December 27, 1994 2.2 Don't Use dvidoc dvidoc from CTAN is a Pascal program. I don't have Pascal. I don't want it. I've reformed. Also, this is the oldest translator from .dvi to .txt I could find. 2.3 Don't Use dvi2tty from CTAN dvi2tty from CTAN is an improved C version of dvidoc. I tried it. It produces pages that are a little ragged. On the other hand, you do get your pagination, including header text and page numbers, and a fairly decent looking table of contents. On the other, other hand, code chunk labels get almost too ugly to recognize because the ``<<'', ``>>'', and ``='' are converted to something else. Shell script and C lose readability too, because ``'' and ``'' get lost, as does ``:''. As a formatter of noweb literate C programs, this is not going to work. 2.4 Use dvi2tty from sol.cs.bucknell.edu To get the tool that works, ftp to sol.cs.bucknell.edu (134.82.1.8). The version of dvi2tty that works best with noweb is in /droms/txt-dist.tar. It's pretty simple to compile, just check the README. To use it, add the two included style guides to the \\documentstyle after all others. Make sure txt is the very last style listed. It sets most everything back to 12 point type. % for typesetting %\documentstyle[noweb,twoside]{article} % for ASCII text \documentstyle[noweb,twoside,myparms,txt]{article} With the text style guides in place, use noweb as usual, allowing it to default to LaTeX output. This will produce a .dvi file for dvi2tty. Use dvi2tty with the undocumented -e option to alter the width of spaces. These are the commands that produced the text you are reading. noweb notext.nw latex notext latex notext December 27, 1994 notext.nw 3 dvi2tty -e12 notext -onotext.txt With a negative value the number of spaces between words becomes less. With a positive value it becomes more. It may be needed to reduce the prevalence of words jamming together. The problem is worse without -e. -e12 worked well enough for me. Margins in the text output seem a bit uncertain, too. 3 Future References This may all be moot. Two other toolsets capable of both typeset and text output from the same source exist. Neither is yet integrated with a literate programming tool, but that may change. Here is a scrap from ftp.cs.cornell.edu:/pub/mdw/Linuxdoc-SGML.README Linuxdoc-SGML is a text-formatting package based on SGML (Standard Generalized Markup Language), which allows you to produce LaTeX, groff, HTML, and plain ASCII (via groff) from a single source. Texinfo support is forthcoming; due to the flexible nature of SGML many other target formats are possible. It's easy to learn and use and greatly simplifies writing documents to be produced in multiple formats. 4 UUencoded Source 3 begin 640 notext.nw.gz M'XL("-5M`"\``VYO=&5X="YN=P"=6.]OW#82_:Z_@E^"C8%=^9R[`WIIFJO/ M;5H#=M+&#NX*VX"Y$J5EER)5_K"\,?R_WYNAY%V[3G`XPQ]DB1S.O'GS9N@7 ME[6K4J=L#'%CU(5U@UK.X^""KM75G?115T;=%U];-N\VO?1=F,?;N+/EQ26O MT\=-*8RL%.6.DFWHOB^F(W%Z M+UO%)]^Q37[CX]VI7&O;BHOLS]65^,6[.E5*')X='1^+XX9]7(Y'2"(H)9%<1D4K[_[345Q:!T?\LZK/Q!7 M-!MQ&-:([=>$=&.5>/GN\->],8?X):-_3-^`^'0`-M(1!*83E>OZ$FZT7G8= MG8KD*X^@7Q<3M6Z47\JHN_M"X.<(,4N[<5:)D%IBFI!(Z(:,UL-/QE62T,`AY^H_B^@6UKNF81O( M)WQ%+M[3JP5S?DR0&%PR-5EKM%5E<:ELO1/(%MDSUZE=2#\TC2)6GN78*%G` M]<,9<#U&PBJ%`,$N85.WS!D'0;$C9"5 M;C8<8@+%=1R=H3\N+NH;#0G"/L[ST?GA^Z>?7\6XV?W^[:00G\Y@;`:5T7T9 M5B&5JD[BY<$_7I7X/3CX>WGPE[VO&0O.E%4HEZE:6V4,;7]=XT/8A\8N:AUB M&:7/%'@`$@Q(RXD$/S@[BU1-$XSG3OR+H?I@%26^Y@5K8".4=:E=CPL"!1J]57>1H MXM0"P5+JKKGUH=L!H[%;>@G!H%`_9%9GL5XAV_."6DOM1*NX2WJR`2&F..9C MQZ(J7:&34)F26A))Z*119W+#0$=KI/90J1I"!*B-<]S3HUR2\C6`"TS"W`&P M=MV8[WHCJ",*GBZ$D4ME`CLF3>7W__ MYLUL-J>'MV_I@9R]OOYN-F-$X`-`S0I6D(0@Z_`1YU#S/5LI$I/*ZSY'>80H M@N(V*I<:8-+1X,ITY/7UW6Q6Y"/N<03YBAUQ3MVA=LC%]?7KV0P1'Q)CI][C M-^/,^B-U?_U9^`[$KO]DK"^J(3VDYGKRU!WS"V#QV-)NFC&+_S^+''":) M]0J&IO8ZMG_(Q%S\G@(-/JI:D_?%QQ\/?SC]$3@@HJSVP+NNFV M":-M((.1![/+QR/PU55Q!P$7LD$6[D$UDPD9X->W_^.`O[6P'7#XY?\Q^3^=3/Y-*66820<>P0O1[XVLD*WL&BD;'/(\U,AE^/)$8G[;3*\^(W->G$51FZ:49>>Q8#[3#^J)CN% M##)<7"R0:Y%O,53^D@8T7C?H&CM`Y]`C@I"G'1@EQ:#OU`91Y*.R/EPXB(L, MQ'B[$./MXDMY94BHH.F:8`=^A^ZB;L=WS[\8XQ(+!?+D]V+A1BM(U_-)HB[? MYCGO1IJ4X]C.A3E0U&DO*,60&1PUD%Z/0P\QOJ.:.I4>V(=I@F/`QL$[*)B78HDH$CSR M46IT.:CA[GWF78I4\1_'T48%8,J4I#!)'A!JYQPS%6J3NQH&9)";EO&SNV( M?4!O2C'SE-RMT%5;RM+/B"6/36AOLN?COT!3FO?1!"KG'R;6_3XM][MZV#_1 M-MVBJ!9G/YV>E%F("][UZ$L^B<)=C#V/_`/GUC0V+"7=G5&$O/3E&=T$I*_9 MS$_*(C"#OEY#??T:5_,3A)"P;X_N\KI:92$)7'7@VJ01+")S-M+2]#D7/Y^? MGN0,H$-F0]?'FC95ZQEY,`2."=F9)0LHESI`)W)8A_WSM/_TD@@L45J(_% MWXHZJ:FC-`9K*>68FH@XR#P%QF8@&YN)(:`EOEDO4%N!=DX=4,G`5U6C MI+?398;MT'-+]WTS-DC=\-7-:T;V0=GY'J6V$H6H.XBL1D?-NW;[XKO1Q/;_^W\%WS]$WZ"$@`` ` end This code is written to file notext.nw.gz.uu. -- Joseph L. Brothers brothers@mdd.comm.mot.com uunet!mdisea!brothers "I am speaking solely for my self, not my employer." ================================================================================ Archive-Date: Tue, 10 Jan 1995 01:04:25 CDT Sender: owner-litprog@SHSU.edu From: muzaffer@smixedsignal.com Reply-To: LitProg@SHSU.edu, muzaffer@SMIXEDSIGNAL.COM Subject: idea is good but ... Date: Mon, 09 Jan 95 22:46:19 PDT Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII To: LitProg@SHSU.EDU IMHO implementation is not very great. From what I understand from literate programming, I can speculate what is needed is a WYSIWYG editing environment. The idea of having to type all those bolds, underlines, boxes and font changes with macros and not seeing what it will look like gives me the shudders. Am I missing something, am I expecting to much or what ? my ideal environment is a full WYSIWYG editing environment (with smart indenting/coloring/font changing capabilities) supplemented with a debugger which can work within this environment and a hyper-text browsing system which can just show me what is variable/function/prototype is/does with just a click. Muzaffer standard disclaimer ================================================================================ Archive-Date: Tue, 10 Jan 1995 11:52:58 CDT Sender: owner-litprog@SHSU.edu From: utcke@gene.ti1.tu-harburg.de (Sven Utcke) Reply-To: LitProg@SHSU.edu, utcke@GENE.TI1.TU-HARBURG.DE Subject: Re: idea is good but ... Date: 10 Jan 1995 11:15:59 GMT Message-ID: <3etq9f$43a@rztsun.tu-harburg.de> To: LitProg@SHSU.EDU In article , muzaffer@smixedsignal.com writes: |> |> IMHO implementation is not very great. From what I understand from literate |> programming, I can speculate what is needed is a WYSIWYG editing environment. |> The idea of having to type all those bolds, underlines, boxes and font changes |> with macros and not seeing what it will look like gives me the shudders. Well, this might be true for you! However, the mere thought of having to use the mouse whenever I intend to do something so very simple as, say, changing to bold, drives me crazy (I find it several times faster --- and therefore much more convenient --- to type "\bf" then to take my right hand from the keyboard, grab the mouse, mark whatever I want in boldface using the mouse, then, still using the mouse, press the [Bold] button and finally resume typing. Takes much to much time. Same, btw, goes for pretty much anything else --- no way you're going to be faster with a formula-editor then I'm by just typing in what I want). And if you want to know what it looks like --- just compile it. This can even be automated using something like latexmk, and should only take a few seconds. |> my ideal environment is a full WYSIWYG editing environment (with smart |> indenting/coloring/font changing capabilities) Well, I'll grant you that I would like an emacs-mode that does this (i.e. knows about C, knows about LaTeX, knows about FWEB and uses hilit19). |> supplemented with a debugger |> which can work within this environment Borland-Style like? Yup, would be handy. (However, I thing something like this is actually possible using emacs and the gnu-debugger, isn't it?) |> and a hyper-text browsing system which |> can just show me what is variable/function/prototype is/does with just a click. Yeah, that would be way cool! Sven -- e-mail: utcke@tu-harburg.d400.de finger: utcke@kirk.ti1.tu-harburg.de WWW : http://bashir.ti1.tu-harburg.de/~utcke/utcke.html ================================================================================ Archive-Date: Tue, 10 Jan 1995 14:31:32 CDT Sender: owner-litprog@SHSU.edu From: iggjacob@sgi03 (Jacob Nielsen (c898594)) Subject: Re: idea is good but ... Date: 10 Jan 1995 14:56:11 GMT Message-ID: <3eu76b$jjg@unidhp.uni-c.dk> Reply-To: LitProg@SHSU.edu, iggjacob@bbar.dtu.dk To: LitProg@SHSU.EDU muzaffer@smixedsignal.com wrote: > IMHO implementation is not very great. From what I understand from > literate programming, I can speculate what is needed is a WYSIWYG > editing environment. The idea of having to type all those bolds, > underlines, boxes and font changes with macros and not seeing what > it will look like gives me the shudders. Am I missing something, am > I expecting to much or what ? You are missing something. No literate programming tool expects you to type font changing commands etc. [see note 1]; in fact, the tools either do that themselves or not at all. I agree that an integrated tool would be nice but until such a beast comes to my computing system (NEXTSTEP) I, for one, will do just fine with manual markup of identifiers in nuweb/noweb and use LaTeX for the typesetting. Besides, I'm quite fond of emacs (an editor) by now :-) > my ideal environment is a full WYSIWYG editing environment (with > smart indenting/coloring/font changing capabilities) supplemented > with a debugger which can work within this environment and a > hyper-text browsing system which can just show me what is > variable/function/prototype is/does with just a click. Most debuggers understand the #line directive and most literate programming tools can emit it, so that is not really a problem. And you can program emacs to do the hypertext browsing --- then you only have to get emacs and like it :-) :-) :-) Despite all that I have said, I'm all for a WYSIWYG literate programming tool but, IMHO, to gain acceptence, such a system must be run on the major systems (X-windows, Windows, ...), allow for markup of different languages (C, C++, lex, yacc, ...) *and* allow you to use your favorite editor. Anyone have such a beast lying around? [1] : This is not entirely true with the current tools based on WYSIWYG systems. Most literate programming tools, however, are based on the TeX model and not the WYSIWYG model. I would describe the differences between the TeX and WYSIWYG model like this: TeX model: |-> _formatter_ -> _typeset text_ web -> _literate programming tool_ -| |-> _code_ WYSIWYG model: _typeset text_ -> _literate programming tool_ -> code Regards, Jacob -- Jacob Nielsen iggjacob@bbar.dtu.dk ================================================================================ Archive-Date: Tue, 10 Jan 1995 21:38:40 CDT Sender: owner-litprog@SHSU.edu Date: Tue, 10 Jan 1995 22:38:59 -0500 (EST) From: "Mario U. Izurieta M.D." Reply-To: LitProg@SHSU.edu, ealcivar@gu.pro.ec Message-ID: <81544.ealcivar@gu.pro.ec> To: LitProg@SHSU.edu Subject: Cobol 8x software Hello friends: I'm new in this list. I hope anyone of you can help with my little big problem. I use Cobol-8x software of Ryan MacFarland in my officce for my bussiness acounts. I use indexed files and for electric shock I lost those indexes. So now I can not recover data by conventional methods (recovery). I would like to know about how this files are indexed in order to recover data through a program in C++ or Turbo Pascal. I will appreciate very much if you can help me. If you have any other idea about how to resolve my problem please tell me about it. And if you know any one who can help. Thanks Mario Izurieta MD ================================================================================ Archive-Date: Tue, 10 Jan 1995 21:40:27 CDT Sender: owner-litprog@SHSU.edu From: dodger@gcr.com (Roger Labbe) Reply-To: LitProg@SHSU.edu, dodger@GCR.COM Subject: Q: installing cweb on DOS Date: 10 Jan 1995 21:52:20 -0500 Message-ID: <3evh54$j35@lute.gcr.com> To: LitProg@SHSU.EDU I downloaded the dos version of CWEB, modified the makefike, and ran make (using the gcc DOS compiler). I ended up with a ctangle executable that works only when there is both a .w and .ch file present. If I try `ctangle demo.w' ctangle informs me that it couldn't produce the change file /dev/null and quits. Now I know that /dev/null is Unix specific, but I tried creating that directory in dos and rerunning ctangle. I got the same result. Any suggestions? Roger Labbe BTW, I believe I downloaded version 3.10. ================================================================================ Archive-Date: Wed, 11 Jan 1995 09:22:43 CDT Sender: owner-litprog@SHSU.edu From: serasset@imag.fr (Gilles Serasset) Subject: Re: TEXT PROCESSING IN LANGUAGES THAT FLOW FROM RIGHT TO LEFT Date: 11 Jan 1995 09:17:01 GMT Message-ID: <3f07md$i48@imag.imag.fr> Reply-To: LitProg@SHSU.edu, Gilles.Serasset@imag.fr MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 8bit To: tex-news@SHSU.EDU In article , yosi@lrdc5.lrdc.pitt.edu (David Heyman) writes: |>In article <3ep4r6$6cm@gap.cco.caltech.edu>, lbliao@alumni.caltech.edu |>(lbliao) wrote: |> |>:I will soon be writing documents in two languages. They will be English, |>:Hebrew, and Arabic or Chinese. Unfortunately, these languages write in opposite |>:directions. I am looking for ways, in which I can do this scientific text |>:processing using LaTeX/TeX system. I would highly appreciate any help on |>:this. This would help many other users. |>: |>:Lily Liao |>: |>:pls reply via email. |> |> I have seen discussions on TeX in Hebrew on the il.board which you can send |>to via il-board@vm.tau.ac.il It is a Usenet group so be sure to specify |>that you |>don't read the group and need the info sent to you. Also I think that at |>http://www.huji.ac.il (Hebrew U. in Jerusalem) you can find TeX Hebrew |>resources. This will perhaps solve the problem for Hebrew, but you will have to install the arabic TeX also and (if it exists), a Chinese Tex. The best choice to make real multilingual documents (not just english and another language) is to have a Macintosh. Since system 7.1, this is the best multilingual computer. With an appropriate editor and the appropriate scripts (arabic, Hebrew and Chinese), you will be able to build a multilingual document (even with the four languages in the same document) without any problems. You should contact Winsoft which has built a multilingual text processor called WinText. Winsoft 34 Bd de l'esplanade 38000 Grenoble France Tel: +33 76 87 56 01 Fax: +33 76 87 83 10 e-mail: winsoft.tech@applelink.apple.com -- Gilles Se'rasset Gilles.Serasset@imag.fr GETA-IMAG (UJF & CNRS) Tel: +33 76 51 43 80 BP 53 Fax: +33 76 51 44 05 38041 Grenoble Cedex 9 ================================================================================ Archive-Date: Wed, 11 Jan 1995 10:30:28 CDT Sender: owner-litprog@SHSU.edu From: claudia@artemis.informatik.unibw-muenchen.de (Claudia Hattensperger) Reply-To: LitProg@SHSU.edu, claudia@ARTEMIS.INFORMATIK.UNIBW-MUENCHEN.DE Subject: cweb: Output without c-code Date: 11 Jan 1995 12:29:06 GMT Message-ID: To: LitProg@SHSU.EDU Who can help me? To get a good documented C-code, I'd like to use a literate-programming tool to have documentation and C-code together in one file and I tried cweb together with the LaTeX-style (cweb.sty). All worked very well, apart I didn't succeed in getting only the documentation without the C-code as output from cweave. As the program is part of a master thesis, and it is unusual to include all the code in a thesis, I'd like to have the possibility telling cweave to ignore special procedures or all code. I tried 1. defining \def\ignore#1{} in the limbo and the text following '@c' as argument. But I couldn't find a place for the closing bracket: before the next '@ ' was impossible because the compiler couldn't parse the code produced by ctangle, after the next '@ ' didn't work as ctangle complained. 2. changing cweb.sty or cwebmac.tex Who can tell me a solution to my problem? Thanks, Claudia ================================================================================ Archive-Date: Wed, 11 Jan 1995 10:30:41 CDT Sender: owner-litprog@SHSU.edu From: claudia@artemis.informatik.unibw-muenchen.de (Claudia Hattensperger) Reply-To: LitProg@SHSU.edu, claudia@ARTEMIS.INFORMATIK.UNIBW-MUENCHEN.DE Subject: cweb: Output without c-code Date: 11 Jan 1995 12:31:05 GMT Message-ID: To: LitProg@SHSU.EDU Who can help me? To get a good documented C-code, I'd like to use a literate-programming tool to have documentation and C-code together in one file and I tried cweb together with the LaTeX-style (cweb.sty). All worked very well, apart I didn't succeed in getting only the documentation without the C-code as output from cweave. As the program is part of a master thesis, and it is unusual to include all the code in a thesis, I'd like to have the possibility telling cweave to ignore special procedures or all code. I tried 1. defining \def\ignore#1{} in the limbo and the text following '@c' as argument. But I couldn't find a place for the closing bracket: before the next '@ ' was impossible because the compiler couldn't parse the code produced by ctangle, after the next '@ ' didn't work as ctangle complained. 2. changing cweb.sty or cwebmac.tex Who can tell me a solution to my problem? Thanks, Claudia ================================================================================ Archive-Date: Wed, 11 Jan 1995 14:19:44 CDT Sender: owner-litprog@SHSU.edu From: ks@obelix.buva.sowi.uni-bamberg.de (Klaus Schwab) Reply-To: LitProg@SHSU.edu, ks@OBELIX.BUVA.SOWI.UNI-BAMBERG.DE Subject: Literate Programming for Prolog Date: Wed, 11 Jan 1995 16:29:20 GMT Message-ID: <3f1110E94p@uni-erlangen.de> To: LitProg@SHSU.EDU Hallo, I am working with Prolog for quite a while and I am looking for a literate-programming tool for Prolog. I was using Nuweb and Noweb but with poor results. Prolog has a totally different structure compared with procedural or object-oriented languages. My questions are: - Who uses Prolog together with literate programming ? - Which tools fit for this purpose ? - How does one use these tools, i.e., how to program literate with these tools ? A piece of literate programmed source code would be useful for me. Thanks Klaus ================================================================================ Archive-Date: Wed, 11 Jan 1995 14:20:31 CDT Sender: owner-litprog@SHSU.edu From: nancyt7043@aol.com (NancyT7043) Subject: Message from Philippe Kahn Date: 11 Jan 1995 10:35:58 -0500 Message-ID: <3f0tsu$brh@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, nancyt7043@aol.com (NancyT7043) To: LitProg@SHSU.EDU Philippe Kahn asked me to pass along this message from him on this newsgroup. This will be released on the newswires later today: This is today's news release from our company: ********************************************** BORLAND NAMES GARY WETSEL PRESIDENT Philippe Kahn Resigns as President and CEO SCOTTS VALLEY, Calif. -- January 11, 1995 -- Borland International Inc. today announced that Gary Wetsel, 49, executive vice president of operations and CFO, has been named president and appointed to Borland's board of directors. The company also announced that Philippe Kahn, 42, chairman, president and CEO, has resigned as president and CEO. Mr. Kahn, remains chairman of the board and remains in the employ of the company. Mr. Kahn, who founded Borland in 1983, will focus on long-term planning, international business and other special projects. Mr. Kahn said, "It has become clear that my continuing as president and CEO has become a distraction at a time when Borland needs to be fully focused on the challenges ahead of it. The board of directors has full confidence in Gary Wetsel and the rest of the management team to design and implement a successful restructuring plan." Gary Wetsel said, "Philippe Kahn is a true technology visionary who has been an integral part of the birth and success of the personal computer industry. His skills and vision will continue to be a valuable asset to the board of directors and the industry as a whole. "Our senior management team has made tremendous progress in building a long-term, customer- focused strategic plan aimed at significantly reducing our cost structure. I am eager to spearhead the implementation of the plan, which we expect to announce in the near future," added Wetsel. David Heller, a member of Borland's board of directors said, "On behalf of the board I would like to express our gratitude for Philippe's outstanding contributions. Philippe's ability to anticipate customer needs and translate them into high-quality products has resulted in significant innovation and increased competition in the industry. We look forward to his continued contributions." The company also announced the resignation of Doug Chance from its board of directors. Mr. Chance said he resigned in order to devote more time to his role as president and CEO of Wyse Technology. Chance said, "The demands of my personal time and energy as a Borland director detracts from my obligations to the shareholders, employees and customers of Wyse, where we are implementing our own turnaround plan." Gary Wetsel: Background Wetsel joined Borland as its chief financial officer in 1994 from Octel Communications Corporation where he was executive vice president and CFO. During his four years with Octel, Wetsel was responsible for managing the company's operations, including finance, information systems, investor relations, business development and facilities. He also managed Octel's engineering organization and several subsidiaries on an interim basis. In addition to his experience at Octel, Wetsel has over 20 years of management experience with a wide variety of companies, including American President Companies; Ungerman-Bass, Inc.; Rolm Corporation; and Peat, Marwick, Mitchell & Company. Philippe Kahn: Background Philippe Kahn, a French mathematician is one of the software industry pioneers. In the 1970s, he worked in Zurich, Switzerland under Niklaus Wirth on Pascal, the computer programming language. Along with Andre Truong he developed software for the Micral, the first ever non-kit personal computer. After moving to the United States in 1982, Kahn founded Borland in 1983 with the mission to deliver software craftsmanship to customers worldwide, as well as advance the industry through technological innovation. Under his direction, Borland established leadership positions with products such as Turbo Pascal, Paradox and Borland C++. Concurrently, he spearheaded the object computing revolution. Without venture capital funding, Borland grew from a garage start-up to one of the largest software companies in the world. Philippe is an accomplished flutist, pilot, and sailor. Borland International Inc. Borland International Inc. (NASDAQ:BORL) is a leading supplier of software engineering tools. A pioneer in the use of object-oriented technology, Borland is focused on delivering tools and services that help customers "upsize" to networked and client-server environments. Borland's award-winning products are supported through programs for software developers, value added resellers, systems integrators, corporate customers, computer software retailers and end users. Headquartered in Scotts Valley, California, Borland's products include dBASE, Paradox, InterBase, ReportSmith, Borland C++, Borland Pascal, Sidekick and Dashboard. This is my letter to fellow Borlanders: *************************************** TO: All Borland Employees FR: Philippe Kahn DATE: January 11, 1995 SUBJ: Executive Changes ======================================== I am writing to inform you of my decision to resign as president and CEO of Borland. While this was a difficult decision, I would like to briefly explain why I feel my decision is in the best interests of the employees, shareholders, and customers of Borland. As most of you have seen, there have been a number of articles in the business and trade press discussing Borland and its future. Understandably, most of the attention and criticism has been directed toward me. While this type of coverage can be expected any time a company is going through a transition period, it is clear that the recent intensity of the criticism has become a major distraction to both employees and customers -- something we just cannot afford as the company begins to implement the strategic plan recently developed by the management team. I am hopeful that this decision will shift the focus away from me and toward our innovative technology and plans for the future. Customers, innovation and quality should be the issues driving the company. Now that our products can receive all the attention they truly deserve, I am convinced that Borland will be back on the road to success. In allowing new management to lead the company into the future, I will continue to serve as chairman of the board, but all operational responsibilities will be assumed by Gary Wetsel, who has been promoted to president. Gary has demonstrated tremendous leadership since he joined the company and my confidence in his ability helped me feel comfortable making this decision. I will continue to work with Gary and the rest of the management team on long-term planning, international issues and other special projects. Attached is the press release announcing these changes. I understand your managers will be meeting with Gary shortly to receive further details and they should be able to answer any specific questions you may have. Finally, I would like to thank each one of you for your hard work and dedication to Borland. I am proud of the accomplishments we have made and I know that under Gary's leadership we have a bright future ahead of us. Philippe This is the answer to some questions: ************************************* PS Why isn't Philippe talking to the press? Philippe really means it when he says that press reports about his role has become a major distraction to the company and its customers, and any comments he would make at this point would be contrary to the very objective of today's announcement. ================================================================================ Archive-Date: Wed, 11 Jan 1995 19:54:35 CDT Sender: owner-litprog@SHSU.edu From: bcf@ccadfa.cc.adfa.oz.au (Ben C Freasier -- Chem.) Reply-To: LitProg@SHSU.edu, bcf@CCADFA.CC.ADFA.OZ.AU Subject: nuweb on OS/2 Message-ID: <1995Jan11.224913.13030@sserve.cc.adfa.oz.au> Keywords: nuweb, OS2 Date: Wed, 11 Jan 1995 22:49:13 GMT To: LitProg@SHSU.EDU Has anyone compiled nuweb as an OS/2 native application? I didn't have much luck with the modified DOS source when I compiled it with gcc. Any hints would be welcome. Ben Freasier ================================================================================ Archive-Date: Wed, 11 Jan 1995 19:56:34 CDT Sender: owner-litprog@SHSU.edu From: zaven@also.hooked.net (Deborah Boni) Reply-To: LitProg@SHSU.edu, zaven@ALSO.HOOKED.NET Subject: I Want to LEARN! Date: 11 Jan 1995 16:25:00 -0800 Message-ID: <3f1sss$u3@also.hooked.net> To: LitProg@SHSU.EDU Hello! I'm totally new to programming (as if you didn't already guess) and I would like to learn some languages for IBM/DOS. I just want to start out with something basic. (excuse the pun) So If you have any Ebooks, guides, programs etc. that are sorta simple and you have the time to email 'em to me, it would be much appreciated! Thanks! zaven@hooked.net ================================================================================ Archive-Date: Wed, 11 Jan 1995 19:59:28 CDT Sender: owner-litprog@SHSU.edu From: nancyt7043@aol.com (NancyT7043) Subject: Important Message Re: Philippe Kahn Date: 11 Jan 1995 20:29:46 -0500 Message-ID: <3f20ma$h5u@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, nancyt7043@aol.com (NancyT7043) To: LitProg@SHSU.EDU Date: Wed Jan 11, 1995 5:47 pm EST From: Nancy Tamosaitis, Computer Life magazine, contributing editor Philippe Kahn resigned from his post as CEO and President of Borland International today. This is a case where I think it is vital for the high tech community - from the reporters to the programmers - to understand all the issues here, and present a full picture. I want to make it clear that I am not working for Philippe Kahn now. He is not a client. I did work for him back in 1992, as his music manager, and the experience was life- enhancing on many levels. And hair-raising too... Working for intensely creative, brilliant people inevitably has its darker moments....but, I think he's touched a lot of lives in very positive ways, and I'm here speaking independently on his behalf because I feel it is important for the entire high tech community to look at the "big picture." And as the Borland PR machinery is probably in overdrive touting the charms of the new leader, I just thought you might just want to keep in mind some vital historical background information on Philippe. On behalf of Philippe, I'm reaching out to the programming community as well as select news media on his behalf *only* digitally. Thus far, I've posted the following news on the Pascal and programming Usenet newsgroups on the net. Please feel free to disseminate this information widely. And if I've left out important career highlights, kindly tack them on to future issues of this material. Why isn't Philippe talking to the press? You won't see any comments from Philippe in tomorrow's newspapers. I think that Philippe really means it when he says that press reports about his role has become a major distraction to the company and its customers, and any comments he would make at this point would be contrary to the very objective of today's announcement. However, speaking independently as someone who has known Philippe - digitally, at least - for years, *I* thought it was important to present the whole picture, not just the plot plots. Here is the Borland press release, followed by some historical facts I've assembled over the years about Philippe's amazing career. Please forgive any spelling errors...it's been a long day!: This is today's news release from Borland International: ********************************************** BORLAND NAMES GARY WETSEL PRESIDENT Philippe Kahn Resigns as President and CEO SCOTTS VALLEY, Calif. -- January 11, 1995 -- Borland International Inc. today announced that Gary Wetsel, 49, executive vice president of operations and CFO, has been named president and appointed to Borland's board of directors. The company also announced that Philippe Kahn, 42, chairman, president and CEO, has resigned as president and CEO. Mr. Kahn, remains chairman of the board and remains in the employ of the company. Mr. Kahn, who founded Borland in 1983, will focus on long-term planning, international business and other special projects. Mr. Kahn said, "It has become clear that my continuing as president and CEO has become a distraction at a time when Borland needs to be fully focused on the challenges ahead of it. The board of directors has full confidence in Gary Wetsel and the rest of the management team to design and implement a successful restructuring plan." Gary Wetsel said, "Philippe Kahn is a true technology visionary who has been an integral part of the birth and success of the personal computer industry. His skills and vision will continue to be a valuable asset to the board of directors and the industry as a whole. "Our senior management team has made tremendous progress in building a long-term, customer- focused strategic plan aimed at significantly reducing our cost structure. I am eager to spearhead the implementation of the plan, which we expect to announce in the near future," added Wetsel. David Heller, a member of Borland's board of directors said, "On behalf of the board I would like to express our gratitude for Philippe's outstanding contributions. Philippe's ability to anticipate customer needs and translate them into high-quality products has resulted in significant innovation and increased competition in the industry. We look forward to his continued contributions." The company also announced the resignation of Doug Chance from its board of directors. Mr. Chance said he resigned in order to devote more time to his role as president and CEO of Wyse Technology. Chance said, "The demands of my personal time and energy as a Borland director detracts from my obligations to the shareholders, employees and customers of Wyse, where we are implementing our own turnaround plan." Gary Wetsel: Background Wetsel joined Borland as its chief financial officer in 1994 from Octel Communications Corporation where he was executive vice president and CFO. During his four years with Octel, Wetsel was responsible for managing the company's operations, including finance, information systems, investor relations, business development and facilities. He also managed Octel's engineering organization and several subsidiaries on an interim basis. In addition to his experience at Octel, Wetsel has over 20 years of management experience with a wide variety of companies, including American President Companies; Ungerman-Bass, Inc.; Rolm Corporation; and Peat, Marwick, Mitchell & Company. Philippe Kahn: Background Philippe Kahn, a French mathematician is one of the software industry pioneers. In the 1970s, he worked in Zurich, Switzerland under Niklaus Wirth on Pascal, the computer programming language. Along with Andre Truong he developed software for the Micral, the first ever non-kit personal computer. After moving to the United States in 1982, Kahn founded Borland in 1983 with the mission to deliver software craftsmanship to customers worldwide, as well as advance the industry through technological innovation. Under his direction, Borland established leadership positions with products such as Turbo Pascal, Paradox and Borland C++. Concurrently, he spearheaded the object computing revolution. Without venture capital funding, Borland grew from a garage start-up to one of the largest software companies in the world. Philippe is an accomplished flutist, pilot, and sailor. *Borland International Inc.* Borland International Inc. (NASDAQ:BORL) is a leading supplier of software engineering tools. A pioneer in the use of object-oriented technology, Borland is focused on delivering tools and services that help customers "upsize" to networked and client-server environments. Borland's award-winning products are supported through programs for software developers, value added resellers, systems integrators, corporate customers, computer software retailers and end users. Headquartered in Scotts Valley, California, Borland's products include dBASE, Paradox, InterBase, ReportSmith, Borland C++, Borland Pascal, Sidekick and Dashboard. This is Philippe Kahn's letter to fellow Borlanders: *************************************** TO: All Borland Employees FR: Philippe Kahn DATE: January 11, 1995 SUBJ: Executive Changes ======================================== I am writing to inform you of my decision to resign as president and CEO of Borland. While this was a difficult decision, I would like to briefly explain why I feel my decision is in the best interests of the employees, shareholders, and customers of Borland. As most of you have seen, there have been a number of articles in the business and trade press discussing Borland and its future. Understandably, most of the attention and criticism has been directed toward me. While this type of coverage can be expected any time a company is going through a transition period, it is clear that the recent intensity of the criticism has become a major distraction to both employees and customers -- something we just cannot afford as the company begins to implement the strategic plan recently developed by the management team. I am hopeful that this decision will shift the focus away from me and toward our innovative technology and plans for the future. Customers, innovation and quality should be the issues driving the company. Now that our products can receive all the attention they truly deserve, I am convinced that Borland will be back on the road to success. In allowing new management to lead the company into the future, I will continue to serve as chairman of the board, but all operational responsibilities will be assumed by Gary Wetsel, who has been promoted to president. Gary has demonstrated tremendous leadership since he joined the company and my confidence in his ability helped me feel comfortable making this decision. I will continue to work with Gary and the rest of the management team on long-term planning, international issues and other special projects. Attached is the press release announcing these changes. I understand your managers will be meeting with Gary shortly to receive further details and they should be able to answer any specific questions you may have. Finally, I would like to thank each one of you for your hard work and dedication to Borland. I am proud of the accomplishments we have made and I know that under Gary's leadership we have a bright future ahead of us. ---Philippe Now, here's some vital facts -some known, some not so well-known - on his startling career that I've learned over the years: 1. In 1971 under Nikalus Wirth in Zurich at the ETH University he worked on the first Pascal Compiler at age 19. 2. Unlike what a lot of people thought, the first ever non- kit personal computer was the Micral and came out in 1973/4, essentially 1 year before US models such as the Altair. It was built by the French Company R2E by a fellow called Andre Truong. Philippe did the first software programs for it. (The Boston Computer Museum now has those facts... funny this was in the "French Silicon Valley") 3. With a couple of colleagues Philippe devised a program called Turbo Pascal, which changed the ways tools worked in 1983. For the first time there was an integrated high speed compiler, coupled with an integrated editor and an built in debugging system. All in one fast turnaround development system. Turbo Pascal was important because it showed that a new generation tool was coming. At the time what was there were slow, bulky command line compilers. 4. At a time when Microsoft was already big, and with an IBM contract, and Lotus was backed with Venture Capital, Philippe showed at Borland that there was "a way" to build a company from garage startup without any venture capital which I think has become an inspiration to lots of software entrepreneurs. 5. Borland's next products were toolboxes for Turbo Pascal, pioneering a form of marketing in the software industry which was: Sell customers Turbo Pascal and then sell them multiple add-ons: razors and razor blades creating a whole industry around Turbo Pascal and from a marketing standpoint lowering marketing costs by selling multiple products per customer. Nobody had done that before. 6. Inventing desktop organizers and PIMs with Sidekick in early 1984 7. Making the stand on objects as early as 1987 but really pushing on it on the PC space in 1989 when introducing Object Pascal and Turbo C++. 8. Really putting C++ on the map (2 years before Microsoft got there) 9. Declaring the Object Computing revolution at Borland's Comdex keynote in 1991, the third wave: Character, graphics/visual and then Object Computing: Components/Interactive etc.... 10. Philippe believes the next really big thing is Delphi95 and that's really why this is going out only digitally, so that people can appreciate this unbelievable technology and not print another *Philippe* Story. Thanks for listening, Nancy Tamosaitis ================================================================================ Archive-Date: Wed, 11 Jan 1995 21:59:07 CDT Sender: owner-litprog@SHSU.edu From: bbs.america@loa.com (BBS AMERICA) Subject: Run a BBS? Want full Internet for $24.95/mo? Message-ID: <8A16469.054500001B.uuout@loa.com> Date: Wed, 11 Jan 95 18:49:00 -0400 Reply-To: LitProg@SHSU.edu, bbs.america@loa.com (BBS AMERICA) To: LitProg@SHSU.EDU Hello there! Right about now you're probably wondering just what it is you've gone and downloaded. Well, first off, I'll be honest with you... if you're not a SysOp, it's more than likely just something to upload to various BBSes for the credit. But, if you're a SysOp then you have heard all the rage about the Internet that's come up recently. I'll bet you even considered looking into getting full access Internet for your own system! Well, more than likely you eventually realized that full access Internet was way too expensive for your BBS to support.... Until now. Log On America is now offering full access internet for any BBS in the nation for the amazingly low price of $24.95 per month. That's right, this is no joke... All you need is a BBS and at least 2 modems... It's simple, you merely set up the transport door (included as CST54.ZIP) to run from your BBS software. Once you contact us, we will give you the LOCAL phone number that you will need and set up your account. Here's how it works. Your users call your BBS as normal, when they run the Cyberspace Transporter door, it will have your user wait while it dials Log On America. Your user will then get full access to Telnet, FTP, Finger, Whois, World Wide Web. Using the Telnet client, your users can access IRC, MUDs, schools, libraries, and more! With FTP, millions of files from all over the world become available! Easy-to-use hypertext interfaces make surfing the Internet simple with Gopher and the World Wide Web! You can find out information about both people and systems with the Finger and Whois clients! For as much time as you care to allow them... Then, when the user types EXIT, the software will drop carrier and return control to your BBS -- without the user EVER SEEING Log On America. It's that easy! For more information or to sign up, you can contact us by any of the following: Phone: (401)453-6100 M-F 9a-5p EST Fax: (401)459-6222 BBS: (401)459-6200 E-Mail: david.paolo@loa.com Mail: Log On America, Inc. 3 Regency Plaza Providence, RI 02903 ATTN: Internet BBS -------------------------------------------------------------------------- This article was an automated post. Any posting in unrelated newsgroups is an error, please disregard this article if it is off-topic. ================================================================================ Archive-Date: Wed, 11 Jan 1995 22:51:13 CDT Sender: owner-litprog@SHSU.edu Date: Thu, 12 Jan 1995 03:59:00 -0700 (PDT) From: "Stephen Boyan (510) 926-3291/fax 926-3604" Reply-To: LitProg@SHSU.edu, BOYANST@NCAL.KAIPERM.ORG Subject: RE: nuweb on OS/2 To: LitProg@shsu.edu > compiling nuweb under OS/2 I'd be interested in giving it a try if I understood the difference between nuweb and noweb, and there were sufficient benefits to nuweb. I've enjoyed noweb, but it can in .exe form, so I didn't need to compile it. I would use Watcom C++ 9.5. So, aplogies for not doing the research myself, but what does nuweb bring to the table? Thanks. Stepehn Boyan boyanst@ncal.kaiperm.org ================================================================================ Archive-Date: Thu, 12 Jan 1995 07:33:46 CDT Sender: owner-litprog@SHSU.edu From: jch@garfield.isode.com (John Haxby) Reply-To: LitProg@SHSU.edu, jch@GARFIELD.ISODE.COM Subject: Zeller's Congruency -- a slightly odd question Date: 12 Jan 1995 09:19:27 GMT Message-ID: To: LitProg@SHSU.EDU I know that this isn't quite the right group to ask this question, but I also know that there's a wide and varied audience that read this group with a wide and varied knowledge of the unusual. I trust that you are also amenable to grovelling :-) The question: many years ago I came across an algorithm for finding the day of the week known as "Zeller's Congruency". All I can remember about the algorithm is that it (a) iterating through the years from a known starting point and (b) it uses 30.5 as the average number of days in the year. If anyone has more information, I'd be most grateful. -- -- John Haxby J.Haxby@isode.com ISODE Consortium +44 181 332 9091 These are my opinions and have nothing to do with my employer. ================================================================================ Archive-Date: Thu, 19 Jan 1995 06:12:06 CDT Sender: owner-litprog@SHSU.edu From: goer@quads.uchicago.edu (Richard L. Goerwitz) Subject: Re: TEXT PROCESSING IN LANGUAGES THAT FLOW FROM RIGHT TO LEFT Message-ID: <1995Jan16.014401.24951@midway.uchicago.edu> Reply-To: LitProg@SHSU.edu, goer@midway.uchicago.edu Date: Mon, 16 Jan 1995 01:44:01 GMT To: tex-news@SHSU.EDU In yosi@lrdc5.lrdc.pitt.edu (David Heyman) writes: >:I will soon be writing documents in two languages. They will be English, >:Hebrew, and Arabic or Chinese. Unfortunately, these languages go in opposite >:directions. I am looking for ways, in which I can do this scientific text >:processing using LaTeX/TeX system. I would highly appreciate any help on >:this. This would help many other users. > > I have seen discussions on TeX in Hebrew on the il.board which you can send >to via il-board@vm.tau.ac.il It is a Usenet group so be sure to specify >that you >don't read the group and need the info sent to you. Also I think that at >http://www.huji.ac.il (Hebrew U. in Jerusalem) you can find TeX Hebrew >resources. Yes, but I think he's talking about more than just Hebrew. I think what he wants is a multilingual TeX that can mix any two of English, Hebrew, Arabic, and possibly Chinese - and so so arbitrarily. David, correct me if I'm wrong. -- Richard L. Goerwitz *** goer@midway.uchicago.edu ================================================================================ Archive-Date: Thu, 19 Jan 1995 06:12:19 CDT Sender: owner-litprog@SHSU.edu From: goer@quads.uchicago.edu (Richard L. Goerwitz) Subject: Re: TEXT PROCESSING IN LANGUAGES THAT FLOW FROM RIGHT TO LEFT Message-ID: <1995Jan16.014615.25131@midway.uchicago.edu> Reply-To: LitProg@SHSU.edu, goer@midway.uchicago.edu Date: Mon, 16 Jan 1995 01:46:15 GMT To: tex-news@SHSU.EDU In article <3f07md$i48@imag.imag.fr> Gilles.Serasset@imag.fr writes: > >The best choice to make real multilingual documents (not just >english and another language) is to have a Macintosh. Since system 7.1, >this is the best multilingual computer. Oh if Apple could patent the sunrise, I'm sure it would. Or have they tried? Their language support, whatever you may say about it, doesn't involve Unicode or any international standard I'm aware of, and it has to be purchased separately, by modules. -- Richard L. Goerwitz *** goer@midway.uchicago.edu ================================================================================ Archive-Date: Thu, 19 Jan 1995 06:48:33 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: Need references from Tugboat, & other journals on TeX-XeT Date: 17 Jan 1995 20:05:29 GMT Message-ID: <3fh7u9$chr@gap.cco.caltech.edu> To: tex-news@SHSU.EDU Dear Tex Users, I am in dire need of references on TeX-XeT and bilingual text processing from TugBoat, UKTeXTUG, and other journals in English. I donot have a library with these to browse thru. If there is a database at the publishers etc. or any you remember, kindly provide a reference. Many thanks Lily Liao ================================================================================ Archive-Date: Thu, 19 Jan 1995 06:49:41 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: Looking for a copy of the TEX book by Knuth Date: 17 Jan 1995 23:07:02 GMT Message-ID: <3fhiim$mpb@gap.cco.caltech.edu> To: tex-news@SHSU.EDU I am looking for a cheap copy of the TeX book. If someone has had enough of his TeX book, and would like to sell it cheap, or if someone company wants to sell it at a competitive price, pls contact me via email soon. I am aware of the going price. Thanks ================================================================================ Archive-Date: Thu, 19 Jan 1995 06:51:15 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: Need references from Tugboat, & other journals on TeX-XeT Date: 18 Jan 1995 02:03:45 GMT Message-ID: <3fhsu1$2nk@gap.cco.caltech.edu> To: tex-news@SHSU.EDU Dear Tex Users, I am in dire need of references on TeX-XeT and bilingual text processing from TugBoat, UKTeXTUG, and other journals in English. I donot have a library with these to browse thru. If there is a database at the publishers etc. or any you remember, kindly provide a reference. Many thanks Lily Liao ================================================================================ Archive-Date: Thu, 19 Jan 1995 06:59:16 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: META font gurus, Mathematicians, Bernshtein Polynomials Date: 18 Jan 1995 20:38:01 GMT Message-ID: <3fju79$mto@gap.cco.caltech.edu> To: tex-news@SHSU.EDU If any metafont gurus, font experts, and mathematician know of any references, easily readable, but with useful info, and not the story books that teach you nothing, please let me know. I am looking for info on that. Lily Liao ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:01:55 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: META font gurus, Mathematicians, Bernshtein Polynomials Date: 19 Jan 1995 02:34:38 GMT Message-ID: <3fkj3u$a6k@gap.cco.caltech.edu> To: tex-news@SHSU.EDU If any metafont gurus, font experts, and mathematician know of any references, easily readable, but with useful info, and not the story books that teach you nothing, please let me know. I am looking for info on that. Lily Liao ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:02:17 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: Need references from Tugboat, & other journals on TeX-XeT Date: 19 Jan 1995 02:37:01 GMT Message-ID: <3fkj8d$ad6@gap.cco.caltech.edu> To: tex-news@SHSU.EDU Dear Tex Users, I am in dire need of references on TeX-XeT and bilingual text processing from TugBoat, UKTeXTUG, and other journals in English. I donot have a library with these to browse thru. If there is a database at the publishers etc. or any you remember, kindly provide a reference. Many thanks Lily Liao ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:02:21 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: Need references from Tugboat, & other journals on TeX-XeT Date: 19 Jan 1995 02:37:33 GMT Message-ID: <3fkj9d$ads@gap.cco.caltech.edu> To: tex-news@SHSU.EDU Dear Tex Users, I am in dire need of references on TeX-XeT and bilingual text processing from TugBoat, UKTeXTUG, and other journals in English. I donot have a library with these to browse thru. If there is a database at the publishers etc. or any you remember, kindly provide a reference. Many thanks Lily Liao ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:02:32 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: TEXT PROCESSING IN LANGUAGES THAT FLOW FROM RIGHT TO LEFT Date: 19 Jan 1995 02:43:37 GMT Message-ID: <3fkjkp$aq0@gap.cco.caltech.edu> To: tex-news@SHSU.EDU I will soon be writing documents in two languages. They will be English, Hebrew, and Arabic or Chinese. Unfortunately, these languages write in opposite directions. I am looking for ways, in which I can do this scientific text processing using LaTeX/TeX system. I would highly appreciate any help on this. This would help many other users. Lily Liao pls reply via email. ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:05:03 CDT Sender: owner-litprog@SHSU.edu From: maavl@cwi.nl (Marc van Leeuwen) Reply-To: LitProg@SHSU.edu, maavl@CWI.NL Subject: Re: Zeller's Congruency -- a slightly odd question Message-ID: Date: Fri, 13 Jan 1995 09:02:39 GMT To: LitProg@SHSU.EDU In article , jch@garfield.isode.com (John Haxby) writes: |> ... I came across an algorithm for finding the day of |> the week known as "Zeller's Congruency". All I can remember about the |> algorithm is that ... |> (b) it uses 30.5 as the average number of days in the year. I that case, don't use the algorithm! Marc van Leeuwen ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:05:05 CDT Sender: owner-litprog@SHSU.edu From: preston@Tera.COM (Preston Briggs) Reply-To: LitProg@SHSU.edu, preston@TERA.COM Subject: Re: nuweb on OS/2 Date: 12 Jan 1995 14:05:36 -0800 Message-ID: <3f493g$10a@sparrow.tera.com> Keywords: nuweb, OS2 To: LitProg@SHSU.EDU bcf@ccadfa.cc.adfa.oz.au (Ben C Freasier -- Chem.) writes: >Has anyone compiled nuweb as an OS/2 native application? I didn't have much >luck with the modified DOS source when I compiled it with gcc. Any hints >would be welcome. Start with the original source (anonymous ftp from cs.rice.edu, in the directory public/preston). The readme points to a couple of places you might have to patch, but usually it just compiles and runs, especially under gcc. Preston Briggs ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:05:18 CDT Sender: owner-litprog@SHSU.edu From: przemek@rrdjazz.nist.gov (Przemek Klosowski) Reply-To: LitProg@SHSU.edu, przemek@RRDJAZZ.NIST.GOV Subject: Re: cweb: Output without c-code Date: 13 Jan 1995 16:29:00 GMT Message-ID: To: LitProg@SHSU.EDU In article claudia@artemis.informatik.unibw-muenchen.de (Claudia Hattensperger) writes: To get a good documented C-code, I'd like to use a literate-programming tool ... As the program is part of a master thesis, and it is unusual to include all the code in a thesis, I'd like to have the possibility telling cweave to ignore special procedures or all code. And what is wrong with including source code in your thesis? My PhD thesis had code in it, allright, and it wasn't even about computer science (physics, actually). I structured it such that the code ended up in an appendix. -- przemek klosowski (przemek@rrdstrad.nist.gov) Reactor Division (bldg. 235), E111 National Institute of Standards and Technology Gaithersburg, MD 20899, USA (301) 975 6249 ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:05:29 CDT Sender: owner-litprog@SHSU.edu From: jch@garfield.isode.com (John Haxby) Reply-To: LitProg@SHSU.edu, jch@GARFIELD.ISODE.COM Subject: Re: Zeller's Congruency -- a slightly odd question Date: 16 Jan 1995 09:05:21 GMT Message-ID: To: LitProg@SHSU.EDU In article maavl@cwi.nl (Marc van Leeuwen) writes: In article , jch@garfield.isode.com (John Haxby) writes: |> ... I came across an algorithm for finding the day of |> the week known as "Zeller's Congruency". All I can remember about the |> algorithm is that ... |> (b) it uses 30.5 as the average number of days in the year. I that case, don't use the algorithm! That's a good idea, it should've said month. Anyway, thanks for the replies, I used "16Q" from the sci.math FAQ to construct this wonderful (?) piece of PostScript, if anyone is interested: /DayOfWeek { % year month 1 sub 10 add 12 mod 1 add dup 11 ge exch 2.6 mul 0.2 sub exch {exch 1 sub} {exch} ifelse dup 100 idiv dup 4 idiv exch dup add sub exch 100 mod dup 4 idiv add 1 add add add abs cvi 7 mod % 0=sunday, 1=monday, ... 6 add 7 mod % 0=monday, 1=tuesday, ... } def -- -- John Haxby J.Haxby@isode.com ISODE Consortium +44 181 332 9091 These are my opinions and have nothing to do with my employer. ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:06:07 CDT Sender: owner-litprog@SHSU.edu From: thompson@sun1.coe.ttu.edu Subject: comp.programming.literate FAQ Date: 16 Jan 1995 10:46:05 GMT Message-ID: Reply-To: LitProg@SHSU.edu, thompson@sun1.coe.ttu.edu To: LitProg@SHSU.EDU Archive-name: literate-programming-faq Last-modified: 1994/08/23 Version: 1.1.10 Welcome to the Literate Programming Frequently Asked Questions List ------------------------------------------------------------------- This version was created Tuesday, August 23, 1994, and should considered stale after 90 days. Information contained in this document is the best available at preparation. The original file was dated October 15, 1993 (just for historical purposes). Disclaimer: "This FAQ is presented with no warranties or guarantees of ANY KIND including correctness or fitness for any particular purpose. The author of this document has attempted to verify correctness of the data contained herein; however, slip-ups can and do happen. If you use this data, you do so at your own risk." Copyright 1993, 1994 David B. Thompson. All rights reserved worldwide. Permission is granted to copy this document for free distribution so long as it remains intact and unmodified. For other arrangements, contact the author/maintainer via email: thompson@sun1.coe.ttu.edu. What's New? ----------- + Add Fold2Web entry. + Correct noweb.el entry. (Thanks Dominique!) + Update nuweb.el entry. + Update SchemeWEB entry. + Update WWW and literate programming entry. + Update c2cweb entry. = ====================================================================== * Introduction or "What's this all about?" ------------------------------------------ This document is for new and experienced users of literate programming tools. The purpose is to explain the concept of literate programming and to provide a resource for locating files of interest to literate programmers and those interested in literate programming. The Literate Programming (LitProg) Frequently Asked Questions (FAQ) list is maintained by Dave Thompson, who can be reached at: thompson@sun1.coe.ttu.edu * Preferred mailing address for FAQ related comments/questions. wqdbt@ttacs1.ttu.edu * Forwarded to my pc. Comment and constructive criticism is welcome. Direct flames to /dev/null (or > nul if you're a msdos user! ;-) If you find an error, please report it. I'm particularly interested in establishing the locations of generally available literate programming tools. If you are the author of such a tool and wish to have it included in this list, please send email. Please note this is a work-in-progress. It is *not* complete, and probably will not be complete for some months. Nevertheless, the information contained herein may be useful to some. Use it as it is intended. - ---------------------------------------------------------------------- - Typography ------------ Major sections of the FAQ are divided by double lines (====). Minor sections and other divisions are separated by single lines (----). Major topics use a "* " as a leader. Minor topics use a "- " as a leader. This should simplify searching for topics. = ====================================================================== Table of Contents: ------------------ * Introduction, or "What's this all about?" - Typography * How do I get the FAQ? - Literate Programming FAQ - FWEB FAQ * Is there a newsgroup? (The comp.programming.literate newsgroup) * What internet nodes are of interest to literate programmers? * What is literate programming? * How do I begin literate programming? * What literate programming tools are available and where are they? - APLWEB - AWEB - CLiP - CWEB - FunnelWeb - FWEB - IMPACT - lit2x - Literate Programmer's Workshop (LPW) - MapleWEB - MWEB (Schrod/Detig) - MWEB (Sewell) - noweb - nuweb - ProTeX - RWEB - SchemeWEB - Spidery WEB - WEB - WinWordWEB * Are there other tools I should know about? - C2LaTeX - c2cweb - c2man - cnoweb - Fold2web - FunnelWeb mode - noweb.el - nuweb.el - TIE - Web mode * What other resources are available? - World Wide Web - TeX Resources - Virtual Coursework * Are there any code examples? - Examples included with developer's tools - Cameron Smith's KR-CWEB - Stanford GraphBase * Bibliographies. * How to anonymously ftp. * Acknowledgements. * End notes. = ====================================================================== * How do I get the FAQ? ----------------------- - Literate Programming FAQ -------------------------- You have many ways to get a current copy of this FAQ. One is to use anonymous ftp (if you don't know how, see a later section in this FAQ) to connect to one of the Comprehensive TeX Arvchive Network (CTAN) sites or the Literate Programming Archive and retrieve a copy of the file. Open an ftp connection to one of the CTAN sites and retrieve the file: help/LitProg-FAQ (For more information on CTAN and the literate programming archive, see the section below entitled "Internet Nodes of Interest to Literate Programmers.") An alternative is to use the fileserver at Sam Houston State University (SHSU). Send a message to FILESERV@SHSU.EDU and include in your message: SENDME LITPROG.FAQ The file server will forward a copy of the file to you via email. - ---------------------------------------------------------------------- - FWEB FAQ ---------- Marcus Speh maintains the FWEB FAQ. The current version number is 1.29. It can be retrieved in the same way as this FAQ; either by anonymous ftp or through the SHSU file server. On the SHSU server, the file name is FAQ.FWEB. Invoke your ftp software, open a connection to NIORD.SHSU.EDU [192.92.115.8], attach to the directory FAQ, and transfer the file FAQ.FWEB. Alternatively, send a message to the file server, FILESERV@SHSU.EDU, and include the following text in a one line message: SENDME FAQ.FWEB The file server will send the current version of the file via email. The FWEB FAQ exists in various formats, including HyperText (see other resources below). In Europe, the complete distribution can also be obtained from ftp.desy.de [131.169.10.115] in directory /pub/faq/web/fweb/. It is also available from the literate programming archive (LPA) in the directory LPA/Documentation/faq/fweb (see the references to LPA below for more information). Also, Marcus Speh is looking for someone willing to take over the FWEB FAQ. The text of his email message follows... "Please add to the FWEB FAQ the note that I am looking for someone to take the maintenance of the FAQ over - I am ready to assist in any way whatsoever, including tons of mail, notes for v1.29->v1.30, Texinfo sources, a WWW server and Hypertextification etc." If you're interested, send mail to marcus@x4u2.desy.de and express your willingness to serve. = ====================================================================== * Is there a newsgroup? ----------------------- One of the most important resources is the literate programming newsgroup, comp.programming.literate. You can read this newsgroup using your standard reader. Altenatively, the newsgroup is gated to a mailing list hosted by George Greenwade and Sam Houston State University. You can subscribe by sending mail to the list-server, LISTSERV@SHSU.EDU, and include in the message one line of text: SUBSCRIBE LITPROG "your name in quotes" The list is unmoderated; messages sent to litprog@shsu.edu are automatically distributed to all subscribers and cross-posted to comp.programming.literate. Archives of the mailing list and newsgroup are maintained on niord.shsu.edu [192.92.115.8] in the directory litprog. = ====================================================================== * What internet nodes are of interest to literate programmers? -------------------------------------------------------------- The principal nodes of interest to literate programmers are the Literate Programming Archive (LPA hereafter) and the CTAN (Comprehensive TeX Archive Network). The Literate Programming Archive (LPA) is: Node: ftp.th-darmstadt.de [130.83.55.75] Directory: programming/literate-programming Notes: Fastest response during off-U.S. [yep] business hours. The CTAN sites are: ftp host IP CTAN root Institution and Sponsor ------------------------------------------------------------------------- ftp.tex.ac.uk 134.151.79.32 pub/archive Aston Univ./UK TeX U.G. ftp.dante.de 129.206.100.192 soft/tex DANTE e.V. ftp.shsu.edu 192.92.115.10 tex-archive Sam Houston State Univ. Other nodes and directories of interest include: Node: niord.shsu.edu [192.92.115.8] Directory: various (do some snooping!) Notes: Has a gopher server. Node: ftp.desy.de [131.169.10.115] Directory: pub/web. Various documents, samples, and the FWEB FAQ. Notes: Has a www server, http://info.desy.de:80/ = ====================================================================== * What is Literate Programming? ------------------------------- Literate programming is the combination of documentation and source together in a fashion suited for reading by human beings. In fact, literate programs should be enjoyable reading, even inviting! (Sorry Bob, I couldn't resist!) In general, literate programs combine source and documentation in a single file. Literate programming tools then parse the file to produce either readable documentation or compilable source. The WEB style of literate programming was created by D.E. Knuth during the development of his TeX typsetting software. All the original work revolves around a particular literate programming tool called WEB. Knuth says: The philosophy behind WEB is that an experienced system programmer, who wants to provide the best possible documentation of his or her software products, needs two things simultaneously: a language like TeX for formatting, and a language like C for programming. Neither type of language can provide the best documentation by itself; but when both are appropriately combined, we obtain a system that is much more useful than either language separately. The structure of a software program may be thought of as a web that is made up of many interconnected pieces. To document such a program we want to explain each individual part of the web and how it relates to its neighbours. The typographic tools provided by TeX give us an opportunity to explain the local structure of each part by making that structure visible, and the programming tools provided by languages such as C or Fortran make it possible for us to specify the algorithms formally and unambigously. By combining the two, we can develop a style of programming that maximizes our ability to perceive the structure of a complex piece of software, and at the same time the documented programs can be mechanically translated into a working software system that matches the documentation. Another author (Eric W. van Ammers) wrote me a short article treating his opinions on literate programming. The text follows: First observation on LP About 90% of the disussion on this list is about problems with applying some WEB-family member to a particular programming language or a special documentation situation. This is ridiculous, I think. Let me explain shortly why... Lemma 1: I have proposed for many years that programming has nothing to do with programming langauges, i.e. a good programmer makes good programs in any language (given some time to learn the syntax) and a bad programmer will never make a good program, no matter the language he uses (today many people share this view, fortunately). Lemma 2: Literate Programming has (in a certain way not yet completely understood) to do with essential aspects of programming. Conclusion 1: A LP-tool should be independent of programming language. Lemma 3: It seems likely that the so called BOOK FORMAT PARADIGM [ref. 1] plays an important role in making literate programs work. Lemma 4: There are very many documentation systems currently being used to produce documents in the BOOK FORMAT. Conclusion 2: A LP-tool should be independent of the documentation system that the program author whishes to use. My remark some time ago that we should discuss the generic properties of an LP-tool was based on the above observation. References: [1] Paul W. Oman and Curtus Cook. Typographical style is more than cosmetic. CACM 33, 5, 506-520 (May 1990) Second observation on LP The idea of a literate program as a text book should be extendend even further. I would like to see a literate program as an (in)formal argument of the correctness of the program. Thus a literate program should be like a textbook on mathematicics. A mathematical textbook explains a theory in terms of lemma and theorems. But the proofs are never formal in the sense that they are obtaind by symbol manipulation of a proof checker. Rather the proofs are by so called "informal rigour", i.e. by very precise and unambiguous sentences in a natural language. Eric W. van Ammers Department of Computer Science Wageningen Agricultural University Dreijenplein 2 E-mail: ammers@rcl.wau.nl 6703 HB Wageningen voice: +31 (0)8370 83356/84154 The Netherlands fax: +31 (0)8370 84731 = ====================================================================== * How do I begin literate programming? -------------------------------------- A recommended book is D.E. Knuth's collection of articles (1992) "Literate Programming," Center for the Study of Language and Information, Stanford University, ISBN 0-937073-80-6 (pbk). This book gives insight into Knuth's thoughts as he developed the web system of literate programming (and TeX for typesetting). It does not document methods for literate programming. A recommended book is Wayne Sewell's (1989) "Weaving a Program: Literate Programming in WEB," Van Nostrand Reinhold, ISBN 0-442-31946-0 (pbk). This book focuses on using Knuth's web system. Some talk exists in the newsgroup/mailing list for a Usenet University course in literate programming. I'm sure discussion of this topic will be welcomed. If you are interested, please participate. = ====================================================================== * What literate programming tools are available and where are they? ------------------------------------------------------------------- A significant number of tools for literate programming are available. Most have been ported from their original systems, so support multiple computer platforms. If you are the developer of such a tool, and would like to make the software freely available, please send me email and I'll reply with a form (like those below) for you to fill in. (Or short-circuit the process and kludge a form from below. :-) - ---------------------------------------------------------------------- - APLWEB -------- Developer: Christoph von Basum Version: Unknown Hardware: MSDOS Languages: IBM APL2 and STSC APL Formatter: Plain TeX Availability: Anonymous ftp from: LPA:/apl watserv1.uwaterloo.ca:/languages/apl/aplweb Readme: Unknown Description: None available. Support: Unknown Note: The status of this particular package is unknown. - ---------------------------------------------------------------------- - AWEB ------ Developer: Unknown Version: Unknown Hardware: Unknown Languages: Ada Formatter: Unknown Availability: Anonymous ftp from: LPA:/ada/web Readme: Unknown Description: None available Support: Not supported. - ---------------------------------------------------------------------- - CLiP ------ Developer: E.W. van Ammers and M.R. Kramer Version: Unknown Hardware: Vax/VMS, Unix, and MS-DOS Languages: Any programming language. Formatter: Any formatter (TeX, LaTeX, Troff, Runoff, etc) or any wordprocessor including WYSIWYG systems (Word Perfect, Win Word, Ami Pro, Word, etc.) Availability: Anonymous ftp from: sun01.info.wau.nl:/CLIP/ms_dos MS-DOS version sun01.info.wau.nl:/CLIP/vax_vms VAX/VMS version CTAN:/web/clip LPA:/machines/ms-dos LPA:/machines/vax Readme: With bundle above Description: CLiP does not use explicite commands to perform the extraction process. Rather it recognizes pseudostatemens written as comments in the programming language in question. CLiP distinguishes pseudostatments from ordinary comments because the former comply with a a particular style. This style can be adjusted to suit virtually any programming language. The CLiP approach to LP makes the system extremely versatile. It is independent of programming language and text processing environment. We designed CLiP to be compatible with hypertext systems as well but we have not yet experimented with this form of documentation. Features: + CLiP imposes virtually no limitations on the text-processing system used to produce the documentation. If the text-processor supports these items you can + structure the documentation according to your own taste. + include drawings, pictures, tables etc. + disclose your documentatio my means of X-ref tables, Indexes, Table of contents, Table of tables, Table of figures, etc. + typeset the documented code. + Extracts any number of modules from a maximum of 64 source files. + No pretty-printing. Code from the source files is copied "as is" to the module. + Appearance of code segments in the documentation matches those of the modules to ease the identification of code segements. + Supports partially specified data types. + Comprehensive user manual (preliminary version) and technical description. - No automatic generation of a X-ref table for program identifiers. Support: Bugs, problems and assistance by e-mail: ammers@rcl.wau.nl - ---------------------------------------------------------------------- - CWEB ------ Developer: Silvio Levy and D.E. Knuth Version: 3.0 Hardware: Unix systems (dos and amiga ports available) Languages: C and C++ Formatter: Plain TeX and LaTeX. Availability: Anonymous ftp from: labrea.stanford.edu:/pub/cweb LPA:/c.c++ CTAN:/web/c_cpp/cweb DOS version in CTAN:/web/c_cpp/cwb30p8c DOS version in LPA:/machines/ms-dos Amiga version CTAN:/web/c_cpp/AmigaCWEB Mac port of CTANGLE in LPA:/machines/mac LaTeX support in LPA:/c.c++ Readme: Bundled with above Description: No description provided. Support: Bugs to levy@math.berkeley.edu Note: A fork of CWEB 3.x was developed by Marc van Leeuwen which implements several changes to CWEB. It is available for anonymous ftp from ftp.cwi.nl:pub/cweb. The principle changes are: - Scans include files for typedef definitions - Grammar and formatting rules are well separated, allowing for run-time selection of a rule set (via command line option) - New manual. - ---------------------------------------------------------------------- - FunnelWeb ----------- Developer: Ross N. Williams: ross@guest.adelaide.edu.au Version: Unknown Hardware: MSDOS, Mac, VMS, Sun. Other ports reported. Languages: No restrictions. Formatter: Plain TeX for printing. Otherwise, no restrictions. Availability: Anonymous ftp from: CTAN:/web/funnelweb LPA:/independent ftp.adelaide.edu.au:/pub/funnelweb Readme: With bundle above. Description: FunnelWeb is a production-quality literate-programming tool that emphasises simplicity and reliability. Everything about FunnelWeb, from the simplicity of its language to the comprehensive tutorial in the user's manual, has been designed to make this as simple, as practical, and as usable a tool as possible. Features: + Provides a simple macro preprocessor facility. + Can produce typeset documentation. + Runs on Sun, VMS VAX, Macintosh, PC, and others. + Portable C source code distributed under GNU licence. + Comprehensive user's manual including tutorial. + Programming-language independent. + Can generate multiple output files. + Allows complete control over the output text. + Regression test suite with over 200 tests. + Fully worked example (in /pub/funnelweb/examples). - Requires TeX to produce typeset documentation. - Typesets program code using TT font only. Support: No formal support available. Mailing list maintained with about 50 subscribers. Informal assistance available from mailing list. - ---------------------------------------------------------------------- - FWEB ------ Developer: John A. Krommes Version: 1.30a (1.40 for the experienced, patient, and brave) Hardware: Unix, VMS, and DOS platforms (anything with ANSI C) Languages: C, C++, Fortran-77, Fortran-90, Ratfor, TeX; also, a language-independent mode. Formatter: Plain TeX and LaTeX. Availability: Anonymous ftp from: ftp.pppl.gov:/pub/fweb CTAN:/web/fweb LPA:/fweb DOS version in LPA:/machines/ms-dos Readme: In bundle with above. Description: It also has a well-developed user's manual and its own FAQ (see above). Beginning with 1.40, documentation is maintained in gnu texinfo format. It runs on most platforms: VMS, PC, UNIX, and pretty much anything that the GNU C compiler (GCC) is supported for. Features: + Processes multiple languages during a single run (so one can mix C and Fortran, for example). + Language-independent mode (v1.40). + Ability to turn off pretty-printing (v1.40). + Built-in Ratfor translator. + Built-in macro preprocessor (closely follows ANSI C, with extensions). + A style file that allows the user to adjust many parameters and behavior patterns of FWEB. + Various operator-overloading features that provide additional pretty-printing capabilities to languages such as C++ and Fortran-90. + Numerous miscellaneous features and command-line options. Support: Bug reports and suggestions to krommes@princeton.edu - ---------------------------------------------------------------------- - IMPACT -------- Developer: Timothy Larkin, from Levy/Knuth CWEB 3.1 Version: 1.0 Hardware: Macintosh; requires AppleEvents. Languages: C, C++ Formatter: TeX Availability: CTAN archives Readme: A short readme file is included in the SEA archive. Description: IMPACT implements CTangle from the Levy/Knuth CWEB 3.1. It operates as a foreground program, tangling files selected from the Mac File Picker. Or it can operate in the background, tangling files in response to odoc events sent by other applications, such as editors. Support: I welcome any reports of bugs. The product will be updated as new versions of the CWEB appear. Other features may be added as users suggest them. - ---------------------------------------------------------------------- - lit2x ------- Developer: Unknown Version: Unknown Hardware: Unknown Languages: Unknown Formatter: Unknown Availability: Anonymous ftp from: LPA:/independent Readme: Unknown Description: None available Support: Unknown - ---------------------------------------------------------------------- - Literate Programmer's Workshop (LPW) -------------------------------------- Developer: Norbert Lindenberg Version: 1.1 Hardware: Apple Macintosh Languages: C++, Object Pascal & others Formatter: self-contained WYSIWYG system Availability: Anonymous ftp from: LPA:/machines/mac CTAN:/web/lpw ftp.apple.com:/pub/literate.prog Readme: With bundle above. Also comes with 38-page manual. Description: The Literate Programming Workshop is an environment for the integrated development of program source text and documentation in combined documents. It consists of a WYSIWYG word processor based on a style sheet approach, a mechanism to extract parts of the text in a document, and a project management system that handles multi-document projects. The system is designed to be used in conjunction with the Macintosh Programmer's Workshop: it prepares raw source text for the MPW compilers, accepts MPW error messages, and shows them in the context of the original documents. Automatic indexing and hypertext features allow for easy access to both source text and documentation. LPW is shareware. Support: Bugs, problems, and questions to lpw@aol.com. - ---------------------------------------------------------------------- - MapleWEB ---------- Developer: Unknown Version: Unknown Hardware: Unknown Languages: Maple Formatter: Unknown Availability: Anonymous ftp from: LPA:/maple Readme: Unknown Description: None Support: Unknown - ---------------------------------------------------------------------- - MWEB (Schrod/Detig) --------------------- Developer: Joachim Schrod Version: Unknown Hardware: Unknown Languages: Modula-2 Formatter: Unknown Availability: Anonymous ftp from: LPA:/modula-2 Readme: Unknown Description: None Support: Not supported. - ---------------------------------------------------------------------- - MWEB (Sewell) --------------- Developer: Sewell Version: Unknown Hardware: Unknown Languages: Modula-2 Formatter: Unknown Availability: Anonymous ftp from: LPA:/modula-2 Readme: Unknown Description: None Support: Not supported. - ---------------------------------------------------------------------- - noweb ------- Developer: Norman Ramsey Version: 2.6 Hardware: Unix and DOS platforms. Languages: All programming languages. Formatter: Plain TeX, LaTeX, and HTML (Mosaic) formatters. Availability: Anonymous ftp from: CTAN:/web/noweb LPA:/independent DOS version also in LPA:/machines/ms-dos also bart.kean.edu:/pub/leew Last recourse, use bellcore.com:/pub/norman Readme: With bundle above. Description: noweb is designed to meet the needs of literate programmers while remaining as simple as possible. Its primary advantages are simplicity, extensibility, and language-independence. noweb uses 5 control sequences to WEB's 27. noweb now supports indexing and identifier cross-reference, including hypertext ``hot links'' courtesy of Mosaic. The simple noweb manual is only 2 pages; documenting the full power of noweave and notangle requires another 3 pages. noweb works ``out of the box'' with any programming language, and its formatter-dependent part is a 60-line nawk program. The primary sacrifice relative to WEB is the loss of prettyprinting. Support: email to the author - ---------------------------------------------------------------------- - nuweb ------- Developer: Preston Briggs: preston@cs.rice.edu Version: 0.87 Hardware: Unix systems: Sparcs, RS/6000s, HPs; (!) MSDOS and Amiga. Languages: Any programming language or combination of programming languages. Formatter: Latex Availability: Anonymous ftp from: Unix: CTAN:/web/nuweb DOS: CTAN:/web/nuweb-pc LPA:/independent Amiga: CTAN:/web/nuweb/nuweb_ami Amiga: wuarchive.wustl.edu/pub/aminet Readme: Send mail to preston@cs.rice.edu Description: A single program that takes a web file written in a combination of latex and any programming language(s) and produces a latex file that can be pretty printed and a set of files containing code for compilation/interpretation by the appropriate language processors. Strengths include speed, simplicity, multiple languages, nice indices and cross-references, latex. Doesn't require any special macros or macro files. Drawbacks: latex-dependent, no code pretty printing, harder to make indices than cweb. More good stuff: nice support for make, doesn't reformat source files, so they're easy to debug. Lots of control without too much effort. That is, it doesn't do too much! Future directions... Very little change planned, except perhaps refinements in the indexing software. Support: Hack it yourself or send e-mail to preston@cs.rice.edu - ---------------------------------------------------------------------- - ProTeX -------- Developer: Eitan Gurari Version: 1.1 (AlProTeX 1.2) Hardware: Any platform with TeX (ProTeX is written in TeX) Languages: Any language Formatter: TeX and LaTeX Availability: Anonymous ftp from: ftp.cis.ohio-state.edu : pub/tex/osu/gurari/ LPA:/independent Readme: Unknown Description: There is a book published on using ProTeX, @Book{Gurari:TLD94, author = "Eitan M. Gurari", title = "{\TeX} and {\LaTeX}: Drawing and Literate Programming", publisher = pub-MH, year = "1994", address = pub-MH:adr, bibdate = "Wed Sep 29 17:55:14 1993", acknowledgement = ack-nhfb, } Support: gurari@cis.ohio-state.edu - ---------------------------------------------------------------------- - RWEB ------ Developer: Unknown Version: Unknown Hardware: Unknown Languages: Unknown Formatter: Unknown Availability: Anonymous ftp from: LPA:/reduce Readme: Unknown Description: Web generator in AWK. Support: Unknown - ---------------------------------------------------------------------- - SchemeWEB ----------- Developer: John D. Ramsdell Version: 2.1 Hardware: Unix and DOS platforms Languages: Any dialect of Lisp. Formatter: LaTeX. Availability: The Unix version is in the Scheme Repository and it is available via anonymous ftp from: cs.indiana.edu:/pub/scheme-repository/utl/schemeweb.sh LPA:/lisp CTAN:/tex-archive/web/schemeweb The DOS version is part of the PCS/Geneva Scheme system which is available via anonymous ftp from: cui.unige.ch:/pub/pcs LPA:/machines/ms-dos Readme: In bundle with above. Description: SchemeWEB is a Unix filter that allows you to generate both Lisp and LaTeX code from one source file. The generated LaTeX code formats Lisp programs in typewriter font obeying the spacing in the source file. Comments can include arbitrary LaTeX commands. SchemeWEB was originally developed for the Scheme dialect of Lisp, but it can easily be used with most other dialects. Support: Bug reports to ramsdell@mitre.org. - ---------------------------------------------------------------------- - SpideryWEB ------------ Developer: Norman Ramsey Version: Unknown Hardware: Unix and DOS platforms Languages: Most Algol-like languages, including C, Ada, Pascal, Awk, and many others. Formatter: Plain TeX and latex for text formatters. Availability: Anonymous ftp from: CTAN LPA:/spiderweb Readme: In distribution. Description: A system for building language-dependent WEBs. Spider is frozen; no further development is planned. Support: Bug reports to spider-bugs@oracorp.com. - ---------------------------------------------------------------------- - WEB ----- Developer: Donald Knuth Version: Unknown Hardware: Unknown Languages: Pascal Formatter: TeX (of course! ;-) Availability: Anonymous ftp from: LPA:/pascal Readme: Unknown Description: This is the original software that started it all. The original TeX processor was written in WEB. Support: None known. - ---------------------------------------------------------------------- - WinWordWEB ------------ Developer: Lee Wittenberg Version: Unknown Hardware: Needs Microsoft Word for Windows, v.2.x, and, of course, MS-Windows 3.x. Languages: Any programming language. Formatter: Word for Windows 2.x for text formatting and file maintenance. Availability: Anonymous ftp from: bart.kean.edu:pub/leew LPA:/machines/ms-dos World-Wide Web (WWW) Readme: WORDWEB.DOC in the downloadable package describes the system. Description: WinWordWEB is a set of a Word for Windows macros (plus a paragraph style) that provide a crude literate programming environment. The ``look and feel'' of the system is based on Norman Ramsey's noweb, but can easily be modified to suit individual tastes. Support: None. WinWordWEB was written as a prototype to see if a WYSIWYG literate programming system was possible. It is intended as a jumping off point for future work by others. However, the system is surprisingly usable as it stands, and the author is interested in hearing from users (satisfied and dissatisfied). Anyone interested in actively supporting (and improving) the product should contact the author via email. = ====================================================================== * Are there other tools I should know about? -------------------------------------------- First of all, I'll list some not-quite-literate-programming tools. Some may consider these to be pretty-printers. Others may call them literate programming tools. In any event, they don't seem to be quite in the same category as the tools listed above, so I'll include them here. - C2LaTeX --------- Developer: John D. Ramsdell Version: Unknown Hardware: Unix Languages: C Formatter: LaTeX but it's easy to change the formatter. Availability: Anonymous ftp from omnigate.clarkson.edu:/pub/tex/tex-programs/c2latex. Readme: Absent. Documentation is in the C source for c2latex. Description: C2latex provides simple support for literate programming in C. Given a C source file in which the comments have been written in LaTeX, c2latex converts the C source file into a LaTeX source file. It can be used to produce typeset listings of C programs and/or documentation associated with the program. C2latex produces LaTeX source by implementing a small number of rules. A C comment that starts at the beginning of a line is copied unmodified into the LaTeX source file. Otherwise, non-blank lines are surrounded by a pair of formatting commands (\begin{flushleft} and \end{flushleft}), and the lines are separated by \\*. Each non-blank line is formatted using LaTeX's \verb command, except comments within the line are formatted in an \mbox. Support: Send bug reports to ramsdell@mitre.org. - ---------------------------------------------------------------------- - c2cweb -------- Developer: Werner Lemberg Version: 1.4 Hardware: DOS, OS/2, Unix (gcc) - CWEB source included Languages: C, C++ Formatter: TeX Availability: Anonymous ftp from CTAN:/web/c_cpp/c2cweb Readme: In distribution. Description: c2cweb will transform plain C or C++ code into a CWEB file to get a pretty formatted output. A modified CWEAVE (which transforms the CWEB file into a TeX file, see below) is included also. Support: Werner Lemberg - ---------------------------------------------------------------------- - c2man ------- Developer: Graham Stoney Version: 2.0 patchlevel 26 Hardware: Unix, MSDOS, OS/2. Languages: C Formatter: nroff -man, texinfo (requires yacc/byacc/bison, lex/flex, and nroff/groff/texinfo/LaTeX). Availability: Anonymous ftp from ftp.wustl.edu: /usenet/comp.sources.reviewed/volume03/c2man* ftp.informatik.uni-stuttgart.de: /pub/archive/comp.sources/reviewed/c2man* Readme: See distribution. Description: The primary philosophy here is to use the programming language as far as possible to express the programmer's intentions, and to use comments only when the programming language is not sufficiently expressive. A comment can then become part of the language grammar which is recognised by a "documentation compiler". This tool parses a superset of the programming language and can automatically generate documentation in human-readable form by associating the programmer's comments with the objects in the code by their context. Support: Actively supported; mailing list available: send "subscribe c2man " (in the message body) to listserv@research.canon.oz.au. - ---------------------------------------------------------------------- - cnoweb -------- Developer: Jim Fox Version: 1.4 (January 4, 1991) Hardware: Anything with C and TeX. Languages: C Formatter: Plain TeX. Availability: Anonymous ftp from: CTAN LPA:/c.c++ Readme: Unknown, cnoweb.tex contains documentation. Description: cnoweb is as it's name describes: write C, not web. No tangling or weaving is implemented. Documentation (between standard /* */ delimiteres) is written in TeX. cnoweb provides typesetting of documentation, an table of contents of routines, and pretty-printing of C source. Support: None known. - ---------------------------------------------------------------------- - Fold2Web ---------- Developer: Bernhard Lang Version: V0.8 Hardware: MSDOS Languages: All (must allow comment lines) Formatter: LaTeX Availability: Anonymous ftp from: kirk.ti1.tu-harburg.de (134.28.41.50) /pub/fold2web/readme /pub/fold2web/fold2web.zip Readme: In distribution Description: The idea behind the Fold2Web tool is the following: A programmer can write his program source with a folding editor and later map the folded source files automatically to WEB-files. The generated WEB-files can then be modified by inserting required documentations. The advantage by starting program developement with original sources is to get short design cycles during the compile/debug steps. By using a folding editor the global structuring information can be already captured in folds during this developement phase. Fold information is typically stored in comment lines and thus will not affect the efficiency of the compile/debug design cycle. Some folding editors and a folding mode for the emacs are available (e.g. see our FUE folding editor for MSDOS machines which is a modified micro emacs. Pick it at kirk in directory /pub/fold2web). After reaching a stable version of a program source its time to convert the source file to a WEB-file and do the program documentation. Fold2Web is written to convert folded source text of any programming language to nuweb files. The folded structure is kept by mapping folds to scraps. Fold markers which differ between languages due to different ways of specifying comments can be configured for each language. Good results can also achived when given but poor documented program sources have to be modified. Such sources can be folded using a folding editor to extract the global structures. This offers a global view to the program structures and help to understand its functionality. Furthermore the program code is not affected, only comment lines are inserted. Once folded the program source can be automatically translated to a WEB document using the above tool. Support: email to lang@tu-harburg.d400.de - ---------------------------------------------------------------------- - Funnelweb Mode ---------------- Developer: Daniel Simmons Version: Unknown Availability: Litprog archives (was in email) Anonymous ftp from: ftp.imada.ou.dk Description: The other day I did a quick hack to nuweb.el as included with the nuweb distribution so as to make a funnelweb-mode.el. I've only used it briefly, and I'm sure that it can be improved quite a bit. I've been thinking about adding support for folding on sections, a pull-down menu to select macro definitions (like the recent functions posted to gnu.emacs.sources for a C function definition pull-down menu) and some kind of tags support for funnelweb. Support: Unknown - ---------------------------------------------------------------------- - noweb.el ---------- Developer: Bruce Stephens Version: Unknown. Availability: LitProg archives (in an email message). Description: This is a very simple mode I just hacked up. There's a lot wrong with it, but I thought others may be interested, even as it stands. It *requires* text properties, and assumes those used in GNU Emacs 19.22; it'll quite likely work with Lucid Emacs, but I haven't tried it. I use it with auctex8.1 and cc-mode 3.229, both of which are loaded separately (I think my emacs is dumped with them, in fact). The idea is to have one mode (which calls itself c-mode, but actually has LaTeX-mode keybindings) generally (this means that the code is hilighted nicely), and have the code chunks use a different keymap. Support: Email to bruce@liverpool.ac.uk - ---------------------------------------------------------------------- - nuweb.el ---------- Developer: Dominique de Waleffe Version: 1.99 Availability: Anonymous ftp from: LPA CTAN Description: Provides a major mode extending Auctex for editing nuweb files. Main features (in 2.0): - Edit scrap bodies in a separate buffer in a different mode (selected using emacs defaults for files, specific indication -*-mode-*-, or a buffer-local variable) - Extends Auctex commands so that nuweb is called before LaTeX, - Easy navigation on scrap definition and use points. - Now creates an imenu (C-M-mouse1) with user index entries, macro definition positions and file definition positions. Support: Email to ddw@sunbim.be - ---------------------------------------------------------------------- - TIE ----- Developer: Unknown Version: Unknown Hardware: Unknown Availability: Anonymous ftp from: LPA:/Tools Readme: Unknown Description: This software merges change files. Support: Unknown - ---------------------------------------------------------------------- - Web mode ---------- Developer: Bart Childs Version: Unknown Tools supported: web, fweb, cweb, funnelweb Availability: Anonymous ftp from ftp.cs.tamu.edu:pub/tex-web/web/EMACS.web-mode thrain.anu.edu.au:pub/web/EMACS.web-mode Description: This version works with versions 18 and 19 of Emacs to be best of my knowledge. I have cleaned up a number of documentation items ... In the same directory is wm_refcard.tex which is an edited version of the famous one to include some web-mode commands. The files limbo* are related to its use and notice that half them have an uppercase L in them for LaTeX. The setup is based upon the fact that we (I am not alone here) primarily use FWEB for C and Fortran programming. We are using version 1.40 of FWEB although John Krommes warns that it is not mature and the manual is not yet updated. The info files are! We are using LaTeX almost exclusively. That will likely change and we will revert to version 1.30 if the final form of 1.40 cannot return to the simple section numbers and avoid the HORRIBLE LATEX 0.1.7.2.4.6 type section numbers. Support: Unknown = ====================================================================== * What other resources are available? ------------------------------------- - World Wide Web ---------------- An untapped resource (by me anyway ;-) is the World Wide Web. Marcus Speh has expended considerable effort in this regard. If you're connected to WWW, then access: http://info.desy.de:80/user/projects/LitProg.html If you aren't connected to WWW, telnet to info.cern.ch and explore. You can reach Marcus' literate programming pages by typing: go http://info.desy.de:80/user/projects/LitProg.html Help for people who have only Email and neither WWW nor telnet, can be obtained by Email from TEST-LIST@INFO.CERN.CH by sending a message, SEND , for example, SEND http://info.desy.de:80/user/projects/LitProg.html to retrieve the LitProg library page. A help file can be retrieved by sending a message to the list server above with the text HELP in the body of the message. Instructions will be returned by email. For literate programming documents, you can try anonymous ftp to ftp.desy.de [131.169.10.115] and get the file: /pub/userWWW/projects/Announce/LitProg.txt - ---------------------------------------------------------------------- - TeX Resources --------------- Another resource of interest to literate programmers is the info-tex mailing list. If you're using (La)TeX as your typsetting system and have access to internet, then you should investigate this mailing list. Mail list service is available through the SHSU list-server. To subscribe, send a message to LISTSERV@SHSU.EDU, and include in the message one line of text: SUBSCRIBE INFO-TEX "your name in quotes" The list is unmoderated; messages sent to info-tex@shsu.edu are automatically distributed to all subscribers and cross-posted to comp.text.tex. Archives of the mailing list and newsgroup are maintained on niord.shsu.edu [192.92.115.8] in the directory info-tex. Another reason the TeX resources should be important is that so many of the literate programming tools rely on either plain TeX or LaTeX as their text formatter. (La)TeX software systems exist for most computing platforms. These systems can be found on CTAN and other major archive sites. Use archie to find them or simply ftp to one of the CTAN sites and browse. - ---------------------------------------------------------------------- - Virtual Coursework -------------------- Marcus Speh plans an introductory course on Literate Programming on the Internet, part of the first semester of "Global Network Academy" [GNA], a non-profit corporation incorporated in the state of Texas, affilated with the Usenet University project. The texts/sample programs for this class will be made available via the World-Wide Web. A special room on GNA Virtual Campus will be staffed by a consultant in one to two hour shifts. Students with questions can telnet to the virtual campus and ask questions of the staff there. If you are interested in registering for the course either as a student or as a consultant, please contact marcus@x4u.desy.de. You will receive a standard reply message; no further action will be taken until June 94. Interested parties can check the hypertext notes for the completed C++ Course done in a similar fashion, at URL http://info.desy.de:80/pub/uu-gna/html/cc/index.html [Editor's note: Because of workload, Marcus requests that email inquiries be limited to a statement of interest for either a student or consultant position until June 1994.] = ====================================================================== * Are there any code examples? ------------------------------ Examples of web programs are included with the FWEB, CWEB, and noweb distributions. nuweb is written in itself. Cameron Smith converted the K&R calculator program into a literate program. It can be retrieved by anonymous ftp from: niord.shsu.edu [192.92.115.8] directory kr-cweb-sample as krcwsamp.zip or from LPA/Documentation Ross Williams has released a funnelweb example. You can retrieve this file from node ftp.adelaide.edu.au [129.127.40.3] as /pub/funnelweb/examples/except.* This file should be on CTAN as well. Lee Wittenberg has posted a few litprog examples. They are available via anonymous ftp from: bart.kean.edu:/pub/leew/samples.LP The Stanford GraphBase is a large collection of programs by Don Knuth for doing all kinds of computations and games with graphs; it is written in (Levy/Knuth) CWEB. More details in the distribution. It is available via anonymous ftp from: labrea.stanford.edu:/pub/sgb = ====================================================================== * Bibliographies ---------------- Nelson Beebe has collected an extensive bibliography treating literate programming. His work is available for anonymous ftp from ftp.math.utah.edu [128.110.198.2] in directory /pub/tex/bib as files: litprog.bib litprog.ltx litprog.twx. Although I have not verified this, LPA is an alternate source for these files. Note that they are updated frequently (Nelson says several times each week), so be sure to get a fresh copy before extensive use. Joachim Schrod indicates that these files may be updated daily and can be retrieved via anonymous ftp at LPA/documentation. = ====================================================================== * How to anonymously ftp ------------------------ Pretty much everything mentioned here is available by anonymous FTP. FAQ lists cross-posted to news.answers and rec.answers can be gotten from rtfm.mit.edu [18.181.0.24], under /pub/usenet/news.answers or under /pub/usenet/more.specific.group.name "anonymous FTP" is just a way for files to be stored where anyone can retrieve them over the Net. For example, to retrieve the latest version of the literate programming FAQ, do the following: > ftp rtfm.mit.edu /* connect to the site; message follows */ > anonymous /* type this when it asks for your name */ > /* type your address as the password */ > cd /pub/usenet /* go to the directory you want to be */ > cd comp.programming.literate /* one level down (no slash). */ > dir /* look at what's there */ > get literate-progamming-faq /* get the file; case-sensitive */ > quit /* stop this mysterious thing */ If your FTP program complains that it doesn't know where the site you want to use is, type the numerical address instead of the sitename: > ftp 18.181.0.24 /* connect with numerical address */ If you don't have ftp access, send e-mail to mail-server@rtfm.mit.edu with the single word "help" in the body of the message. Getting binary files (executables, or any compressed files) is only slightly more difficult. You need to set binary mode inside FTP before you transfer the file. > binary /* set binary transfer mode */ > ascii /* set back to text transfer mode */ FAQs and spoiler lists are generally ascii files; everything else is generally binary files. Some common extensions on binary files in archive sites are: .Z Compressed; extract with uncompress .tar.Z Compressed 'tape archive'; uncompress then untar or tar -xvf .gz or .z Gnu gzip; use gunzip (available from prep.gnu.ai.mit.edu) .sit (Mac) StufIt archive .zip Extract with Zip or Unzip .zoo Yet another archive/compress program .lhe (Amiga) ? .lzh Lha archive program. .arj (PC) Arj archive program. .exe (PC) Sometimes self-extracting archives-just execute them. .uue or .UUE Transfer as text file; use uudecode to convert to binary .hqx (Mac) BinHex format; transfer in text mode Generic help can be found in the FAQs of comp.binaries. for how to transfer, extract, and virus-check binary files. (At rtfm.mit.edu) If you can't FTP from your site, use one of the following ftp-by-mail servers: ftpmail@decwrl.dec.com ftpmail@src.doc.ic.ac.uk ftpmail@cs.uow.edu.au ftpmail@grasp.insa-lyon.fr For complete instructions, send a message reading "help" to the server. If you don't know exactly what you're looking for, or exactly where it is, there are programs and servers that can help you. For more info, send e-mail to mail-server@rtfm.mit.with with the body of the message reading send usenet/news.answers/finding-sources Thanks to Aliza R. Panitz (the "buglady") for this text. I copied it verbatim from her post on faq-maintainers with only minor modifications. = ====================================================================== * Acknowledgements ------------------ This document would not have happened without the help of many people. Among them are Marcus Speh, George Greenwade, Rob Beezer, Joachim Schrod, Piet van Oostrum, and Ross N. Williams. A special thanks to Aliza R. Panitz for the text describing how to execute an anonymous ftp for files of interest. Any omissions from these acknowledgements should be considered an act of stupidity on my part. Of course, the authors of literate programming tools mentioned above all play a vital role in the vitality of literate programming. Furthermore, participants in the comp.programming.literate newsgroup (and associated mailing list) all contributed in various fashions. Thank all of you. = ====================================================================== * End notes ----------- This document will continue to evolve. I'm planning on adding entries for additional literate programming tools and will expand the sections on examples as more examples become available. Tools I will include are WEB (the original pascal version) for starters. Others will be added as I find and document them. Omission of a particular tool should not be considered a snub in any sense--simply an error or oversight on my part. = End of File ========================================================== ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:06:19 CDT Sender: owner-litprog@SHSU.edu Subject: Advice Needed Message-ID: <1995Jan16.111924.27472@wisipc.weizmann.ac.il> From: oren@marganit.weizmann.ac.il (Ben-Kiki Oren) Reply-To: LitProg@SHSU.edu, oren@MARGANIT.WEIZMANN.AC.IL Date: Mon, 16 Jan 1995 11:19:24 GMT To: LitProg@SHSU.EDU First, I would like to thank all the people who answered my query. I have received quite a few answers (literate programming must be popular :-). I found that the trick to extracting useful information from ads is to look for the description of the missing features in the competitor's products. (I assume that if a company dares to advertise a deficiency in another product, they are willing to back it up in court). By trivial extension, I payed more attention the problems described for each tools then to the strengths. To prevent the flame-wars that would result, I'll omit the more blunt descriptions. In essence, most tools were described as too complicated / hard to learn / hard to use and / or technically deficient in some major way. Surprisingly, there were two tools whose only faults mentioned was the lack of pretty printing and automatic indexing for C++. Pretty-printing I can live without. I suppose manual indices can be annoying, but it is minor compared to some of the faults ascribed to the other tools. My compliments to the developers of noweb and nuweb! I'm loading them up now, and will look into both in the next few days. I am a bit hazy on how to integrate them into my environment. Literate programming in C++, using templates and multiple inheritance, seems to call for great care in the partitioning of the source into files (one per class? two per class? how to resolve references to base classes and templates? how to prevent unnecessary 'touch'es of the header files? etc.) There were a few hints on the LitProg html WEB page; I'd appreciate any further advice or references on the subject. Many thanks, Oren. -- ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:06:32 CDT Sender: owner-litprog@SHSU.edu From: mclay@cfdlab.ae.utexas.edu (Robert T. McLay) Reply-To: LitProg@SHSU.edu, mclay@CFDLAB.AE.UTEXAS.EDU Subject: Fweb v1.40: Getting it to understand Tricky Macros Date: 17 Jan 1995 04:47:07 GMT Message-ID: To: LitProg@SHSU.EDU I have a question on getting Fweb 1.40 to understand a macro that I use a lot. I use a macro: #define STRCMP(a,test,b) (strcmp((a),(b)) test 0) So I can have code like this. if (STRCMP(string, == , "ABCD")) ... This is fine except that that fweave gets very confused by the `==' and it will not indent correctly. Does anyone have a trick to get fweave to treat STRCMP(...) as a function and indent correctly? I have playing with @f and making it an fweb macro using @m, none have convinced it to indent correctly. Any clue? -- ______________________________________________________________________________ Robert McLay | Kayak Rules of Life: Manager CFD Lab | a) lose altitude Dept ASE-EM | b) Surf waves and holes. University of Texas at Austin | c) Do enders. WRW 111 | Austin, TX 78712 | | mclay@cfdlab.ae.utexas.edu | ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:06:35 CDT Sender: owner-litprog@SHSU.edu From: Eduardo Suastegui Reply-To: LitProg@SHSU.edu, esuastegui@AOL.COM Subject: * Borland C++ vs. Visual C++ Date: 16 Jan 1995 18:38:35 GMT Message-ID: <3feefb$kdl@hacgate2.hac.com> To: LitProg@SHSU.EDU I am currently programming for Windows using Borland C++ 4.0 with OWL 2.0. Borland C++ 4.5 has just come out, and I am about to upgrade... I have been looking around, and it seems that Visual C++ has become very popular. I am thinking that maybe I should make the switch? If any one has some relevant comparison information about these two compilers, I would appreciate if you could email it to me. In particular I am concerned about the Win32 implications, since I want to start programming for Windows NT and 95. I would also like to know how the Microsoft Foundational Classes compare with OWL 2.0. Thanks in advance, Ed Suastegui esuastegui@aol.com ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:06:48 CDT Sender: owner-litprog@SHSU.edu From: evans@cs.mun.ca (Geoff Evans) Reply-To: LitProg@SHSU.edu, evans@CS.MUN.CA Subject: Literate programming in S-plus Message-ID: <1995Jan17.110524.20449@cs.mun.ca> Date: Tue, 17 Jan 1995 11:05:24 GMT To: LitProg@SHSU.EDU Does anybody do literate programming in S-plus (or S), and what tool do you use for it? It would be really nice to get pretty printing at least to the stage of putting key words in bold face and using \leftarrow for the two assignment operators "_" and "<-". (The fact that "<-" is two non-alphanumeric characters gives me problems.) Indenting isn't so important - I can always do that to suit myself. Thanks for any suggestions, geoff evans@mrspock.nwafc.nf.ca ================================================================================ Archive-Date: Thu, 19 Jan 1995 07:06:51 CDT Sender: owner-litprog@SHSU.edu Subject: S-Plus and Literate Programming Message-ID: <1995Jan18.093145.3236@debet> From: SNF_HOH@KREDIT.nhh.no (HUSUM, HANS OLAV) Reply-To: LitProg@SHSU.edu, SNF_HOH@KREDIT.NHH.NO Date: 18 Jan 95 09:31:45 MET To: LitProg@SHSU.EDU Hello! I use S-Plus, and have recently started looking into literate programming. I looked as several tools, and decided to go with noweb, because: o it's simple o it has an up-to-date DOS version o it is designed to be easy to extend In the source distribution under contrib/kaelin you will find Icon code for a pretty printer for C++. The code is designed in a way that makes it very easy to adapt for a new language. Personally I am not keen on prettyprinting, but I imagine it should be possible for you to hack up an S-Plus version over a weekend. Good luck! Hans Olav ================================================================================ Archive-Date: Thu, 19 Jan 1995 12:00:50 CDT Sender: owner-litprog@SHSU.edu From: norman@flaubert.bellcore.com (Norman Ramsey) Reply-To: LitProg@SHSU.edu, norman@FLAUBERT.BELLCORE.COM Subject: Re: cweb: Output without c-code Date: 19 Jan 1995 05:10:29 GMT Message-ID: <3fks85$g9e@lowell.bellcore.com> CC: claudia@artemis.informatik.unibw-muenchen.de To: LitProg@SHSU.EDU In article , Claudia Hattensperger wrote: >Who can help me? I can :-) >As the program is part of a master thesis, and it is unusual to include all >the code in a thesis, I'd like to have the possibility telling cweave to >ignore special procedures or all code. I've set up a noweb filter to do this in noweb. It omits any code chunk whose name matches a globbing pattern given on the command line. I have found to to be useful for writing papers in which it is not appropriate to show all the code. This `elide' filter will appear in the 2.6d distribution, which I'll release the moment I believe I have half an hour free to ship it. Be warned: noweb does no prettyprinting; if you want soething other than \tt font, you need Kostas Oikonomou's prettyprinting package (a new version of which is delaying 2.6d...), which is distributed with noweb. Norman ================================================================================ Archive-Date: Thu, 19 Jan 1995 13:14:43 CDT Sender: owner-litprog@SHSU.edu From: smurf@rbhp77.rbg.informatik.th-darmstadt.de (christian kumpf) Reply-To: LitProg@SHSU.edu, smurf@RBHP77.RBG.INFORMATIK.TH-DARMSTADT.DE Subject: Emacs Mode for Literate Programming Date: 19 Jan 1995 17:32:19 GMT Message-ID: To: LitProg@SHSU.EDU Recently posted to gnu.emacs.sources: (C-)WEB-Mode ************ Cweb-Mode is a minor mode to support literate programming in GNU-Emacs Version 19. FILES: cweb-mode.el (the program in emacs-lisp) cweb-mode.texi (the user manual in texinfo-format) To get full documentation, run cweb-mode.texi either through texi2dvi for a printable manual or through makeinfo for online help. ------------------------------------------------------------------------ Taken from cweb-mode.texi: Features ======== Like every literate programer, I appreciate the different treatment of *C*- and TeX-parts in a CWEB-document. But I missed support for different kinds of writing in my favorite editor. So here it is * *C-mode*-like editing in C-parts of a program * (La)TeX-like editing in documentation-parts of a program * Hilighting of program-parts * CWEB-orientated cursor movement * Indexing of your refinements and your main sections, even for multiple input files Why a Minor Mode ================ First of all, it's less work :-). But more seriously, writing a major mode would have the drawback of disabling the advanced features of major modes designed by others to enhance Emacs treatment of TeX input. It would reduce flexibility too, because it would be either a TeX or a LaTeX mode. Bug Reports =========== I strongly encourage every user of Cweb Mode to report bugs, suggestions, enhancements, goals, ideas, acknowledgements, for short everything that belongs to Cweb Mode via e-mail to me personally. My e-mail-adress is `kumpf@igd.fhg.de' -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Christian Kumpf Email: smurf@rbg.informatik.th-darmstadt.de Computer Science Department Technical University of Darmstadt, Germany ================================================================================ Archive-Date: Thu, 19 Jan 1995 16:33:08 CDT Sender: owner-litprog@SHSU.edu From: concord@ix.netcom.com (David Demyan) Reply-To: LitProg@SHSU.edu, concord@IX.NETCOM.COM Subject: Re: META font gurus, Mathematicians, Bernshtein Polynomials Date: 19 Jan 1995 22:25:02 GMT Message-ID: <3fmoru$4cf@ixnews3.ix.netcom.com> To: tex-news@SHSU.EDU In <3fju79$mto@gap.cco.caltech.edu> lbliao@alumni.caltech.edu (lbliao) writes: > >If any metafont gurus, font experts, and mathematician know of any >references, easily readable, but with useful info, and not the story >books that teach you nothing, please let me know. > (snip) >Lily Liao Take a breath, Lily! ================================================================================ Archive-Date: Thu, 19 Jan 1995 17:35:48 CDT Sender: owner-litprog@SHSU.edu From: kinch@ios.com (Richard J. Kinch) Reply-To: LitProg@SHSU.edu, kinch@IOS.COM Subject: Re: META font gurus, Mathematicians, Bernshtein Polynomials Date: 19 Jan 1995 21:34:11 GMT Message-ID: <3fmlsj$rpb@ankh.iia.org> To: tex-news@SHSU.EDU lbliao (lbliao@alumni.caltech.edu) wrote: : If any metafont gurus, font experts, and mathematician know of any : references, .. References to what? ================================================================================ Archive-Date: Thu, 19 Jan 1995 20:07:49 CDT Sender: owner-litprog@SHSU.edu From: Frank Dunn Subject: NoWeb crossindex Message-ID: Reply-To: LitProg@SHSU.edu, frank.dunn@waterloo.attgis.com Date: Thu, 19 Jan 1995 20:03:25 GMT To: LitProg@SHSU.EDU Can anybody help me? I am running the MSDOS version of NoWeb version 2.5 and have the following problem: I type "noweave -x test.nw > test.tex" which runs all right, however, LaTex (emtex to be specific) gives errors on the crossreferences and the numbering shows up as in the printout of the test.dvi file. I'm new to all this and would appreciate any suggestions. What am I missing? It runs fine without the -x option. But crossreferencing sure looks nice. ================================================================================ Archive-Date: Fri, 20 Jan 1995 00:31:59 CDT Sender: owner-litprog@SHSU.edu From: sunways@aol.com (SUNWAYS) Subject: SQLWindows Rapid Application Development Tool GEN/A/SYS 2.01 Date: 20 Jan 1995 01:08:06 -0500 Message-ID: <3fnk06$m71@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, sunways@aol.com (SUNWAYS) To: LitProg@SHSU.EDU SQLWindows Rapid Application Development Tool GEN/A/SYS 2.01 RAPID APPLICATION DEVELOPMENT CLIENT/SERVER lower CASE TOOL/ DESIGN METHODOLOGY SQLWindows (by Gupta) and GEN/A/SYS (by Vital Technologies) provide the most extensive, user friendly, and fastest Client-Server GUI RAD CASE tool development methodology available today! (An opinion supported by an articicle in PC Magazine. Received Editors Choice!) Nov. 94' Vital Technologies Group, Inc. a client-server software and human resource company announced GEN/A/SYS II for SQL Windows, the innovative Rapid Application Development environment. GEN/A/SYS 2.0 is a new client-server Rapid Application Development methodology designed for all Object Oriented Development languages, (i.e., Gupta's SQL Windows, PowerBuilder, etc...) GEN/A/SYS is a "rational" development methodology which when combined with its lower CASE tools for SQL Windows, increases application productivity 20 to 50 times, while decreasing code size by a factor of 10 to 100 times. (compared to strict object-oriented approaches or advanced foundational class approaches) In addition, the GEN/A/SYS tools produce interactive working prototypes with no coding, and advanced applications through windows "cut and paste operations". Independent of the number of tables, or fields in a table or the objects which represent them, complete projects can be done with a total maintenance exposure of less than 800 lines of code. The project's GEN/A/SYS code (which becomes the core production code) is 100% reused. GEN/A/SYS sets a new standard for client-server application development methodologies. The development process and tools work together to virtually eliminate rework and accelerates development beyond any traditional time or maintenance expectations. The concept having of an accelerator put on top of another application development tool is very hard to convey through a diskette so please contact us to see if we can arrange a demonstration at your convenience. To request a demo disk and further information please call Joe Teagarden at sunways@aol.com Vital Technologies 116 Barrington Oaks Ridge Roswell, GA. 30075 USA or (404) 641-8155. ================================================================================ Archive-Date: Fri, 20 Jan 1995 16:02:18 CDT Sender: owner-litprog@SHSU.edu From: samus@aol.com (SAMUS) Subject: QBasic Compiler. Date: 20 Jan 1995 14:39:41 -0500 Message-ID: <3fp3ht$r3s@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, samus@aol.com (SAMUS) To: LitProg@SHSU.EDU I have written several fairly complex programs in QBasic. I do not want to go through the hassle of translating them to Visual Basic (for which I have a compiler), nor do I want to shell out the money to get a copy of QuickBasic with a compiler. I have pretty much reached the limits of Qbasic, and this would be for the most part a waste of my already strained financial resources. Does anyone know where I can Find a Qbasic (or QuickBasic) Compiler? Free? Thanks, Samus ================================================================================ Archive-Date: Fri, 20 Jan 1995 16:02:52 CDT Sender: owner-litprog@SHSU.edu From: samus@aol.com (SAMUS) Subject: Re: I Want to LEARN! Date: 20 Jan 1995 14:34:13 -0500 Message-ID: <3fp37l$r27@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, samus@aol.com (SAMUS) To: LitProg@SHSU.EDU in <3f1sss$u3@also.hooked.net> you state >I'm totally new to programming (as if you didn't already >guess) and I would like to learn some languages for IBM/DOS. I >just want to start out with something basic. (excuse the pun) Actually, your pun is acurate. Start with QBasic. If your Machine runs DOS, you have Qbasic right there just waiting to be explored. Online Help (for DOS versions 5.0 or later) is very good, and you can get started with little or no previous knowledge. THere are good books on QBasic (Microsoft QuickBasic Primer PLus) at any decent library. Next Step I would recommend would be Visual Basic. After learning QBAsic, VBasic is a breeze, and you can create really snappy, proffessional looking programs for Windows in no time. A good book for this one is "THe POWER of Visual Basic". After that, you need to choose. Probably C++, or something, although those looking to really get hardcore should consider gaining some familiarity with Assembly (machine) language. ================================================================================ Archive-Date: Fri, 20 Jan 1995 23:06:41 CDT Sender: owner-litprog@SHSU.edu From: dalavigne@aol.com (DaLavigne) Subject: Re: SQLWindows Rapid Application Development Tool GEN/A/SYS 2.01 Date: 20 Jan 1995 22:47:00 -0500 Message-ID: <3fq03k$360@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, dalavigne@aol.com (DaLavigne) To: LitProg@SHSU.EDU I have purchased the SQL Windows Solo and feel that it is probably the best $35 I'll ever spend. I am currently a Student at Columbus College, Columbus GA and would like to know more about what your company does..?? DaLavigne@aol.com 74404,172@compuserve.com ================================================================================ Archive-Date: Sat, 21 Jan 1995 00:48:15 CDT Sender: owner-litprog@SHSU.edu From: weiqigao@crl.com (Weiqi Gao) Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: I Want to LEARN! Date: 21 Jan 1995 06:36:22 GMT Message-ID: <3fqa16$75t@nntp.crl.com> MIME-Version: 1.0 To: LitProg@SHSU.EDU In article <3f1sss$u3@also.hooked.net>, zaven@also.hooked.net says... > > > >Hello! > I'm totally new to programming (as if you didn't already >guess) and I would like to learn some languages for IBM/DOS. I >just want to start out with something basic. (excuse the pun) > So If you have any Ebooks, guides, programs etc. that are >sorta simple and you have the time to email 'em to me, it would >be much appreciated! For the seventh time, this is an inappropriate topic. The comp.programming.literate group is for the discussion of Literate Programming---the art of producing a text-processor readable documentation and compiler readable programming files from the same source file. Check out the www site http://info.desy.de/www/LitProg.html for the FAQ. As for IBM/DOS programming languages, you can always start with the QBasic that comes with DOS. The e-books that I've found on the net are invariably either too simplistic or too out-dated. [The only good ones I found so far are: "A Gentle Introduction to TeX", "The Hacker's guide to noweb ", and something called "PCLearn", a tutorial for DOS 3.1] But the "For Dummies" series from IDG are actually pretty good, inexpensive too. Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Sat, 21 Jan 1995 02:26:19 CDT Sender: owner-litprog@SHSU.edu From: jellis416@aol.com (JELLIS416) Subject: Re: I Want to LEARN! Date: 21 Jan 1995 03:02:33 -0500 Message-ID: <3fqf2p$62b@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, jellis416@aol.com (JELLIS416) To: LitProg@SHSU.EDU A perfect place to start is the Clarion products -- Personal Developer is a perfect beginning place. The latest is Clarion Database Developer which produces very professional programs. You design the data file and screens and the compiler generates the code which can be modified. The code is compiler with a C++ compiler. I stumbled across this product about two years ago and the results have been remarkable. ================================================================================ Archive-Date: Sun, 22 Jan 1995 05:05:09 CDT Sender: owner-litprog@SHSU.edu From: iec@netcom15.netcom.com (Interstate Electronics Corp) Subject: gnus and AOL postings to comp.programming.literate Message-ID: Reply-To: LitProg@SHSU.edu, mre@lpf.org (Mike Elliott) Date: Sun, 22 Jan 1995 08:59:52 GMT To: LitProg@SHSU.EDU There has been a recent flurry of profoundly clueless postings to comp.programming.literate lately. I use gnus in emacs as my newsreader. Is there a simple way of having it ignore all postings from aol.com? Thanks for your indulgence. -- -- ======================================================================== Mike Elliott mre@emerald.ccss.com mre@lpf.org ======================================================================== ================================================================================ Archive-Date: Sun, 22 Jan 1995 10:15:49 CDT Sender: owner-litprog@SHSU.edu From: Weiqi Gao Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: gnus and AOL postings to comp.programming.literate Date: 22 Jan 1995 16:12:27 GMT Message-ID: <3fu05b$kh1@nntp.crl.com> To: LitProg@SHSU.EDU iec@netcom15.netcom.com (Interstate Electronics Corp) wrote: > > There has been a recent flurry of profoundly clueless postings to > comp.programming.literate lately. I use gnus in emacs as my > newsreader. Is there a simple way of having it ignore all postings > from aol.com? > > Thanks for your indulgence. > -- > -- > ======================================================================== > Mike Elliott mre@emerald.ccss.com mre@lpf.org > ======================================================================== I don't use GNUS. But I tend to think that it is possible to do it. Read the manual pages, or info files. You can kill all files sent by a particular poster even in rn : just put /clueless@aol.com/h:j in your kill file. (Check the man pages, I haven't used rn for a long time now.) I guess our group name is partly to blame for these postings. Until we find a less ambiguous name, I'll try to point out the inappropriate- ness of the subject for each such article. I feel that's the only way by which we can protect this group from space aliens. FOR THE NEW USERS of internet: the comp.programming.literate usenet group is dedicated to the discusstions of topics related to the literate programming methods---ones in which a text processor readable documentation and compiler readable program files are produced from a common source file. Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Sun, 22 Jan 1995 11:32:25 CDT Sender: owner-litprog@SHSU.edu From: wcheng@cln.etc.bc.ca (Winnie Cheng) Subject: Enlarging and Reducing Graphics Message-ID: <1995Jan22.171250.16190@news.etc.bc.ca> Reply-To: LitProg@SHSU.edu, wcheng@cln.etc.bc.ca (Winnie Cheng) Date: Sun, 22 Jan 1995 17:12:50 GMT To: LitProg@SHSU.EDU Can someone give me some advices on how to make a program in C++/QBASIC that can perform graphical image enlarging and reducing? (Kind of like zooming in on the Mandelbrot set) ================================================================================ Archive-Date: Sun, 22 Jan 1995 12:30:48 CDT Sender: owner-litprog@SHSU.edu From: preston@Tera.COM (Preston Briggs) Reply-To: LitProg@SHSU.edu, preston@TERA.COM Subject: Re: META font gurus, Mathematicians, Bernshtein Polynomials Date: 21 Jan 1995 10:14:06 -0800 Message-ID: <3frite$5tt@sparrow.tera.com> To: tex-news@SHSU.EDU In article <3fmlsj$rpb@ankh.iia.org> kinch@ios.com (Richard J. Kinch) writes: >lbliao (lbliao@alumni.caltech.edu) wrote: >: If any metafont gurus, font experts, and mathematician know of any >: references, .. > >References to what? She's asking for references to Bernshtein polynomials (really Bernshte\u{\i}), as mentioned in her subject line and Knuth's book, METAFONT: The Program Section 303 Not that I can find any other references... Surely there's a better group for this question; e.g., one of more math-oriented groups. Preston Briggs ================================================================================ Archive-Date: Sun, 22 Jan 1995 15:25:26 CDT Sender: owner-litprog@SHSU.edu From: weiqi@gao.stlouis.mo.us (Weiqi Gao) Reply-To: LitProg@SHSU.edu, weiqi@GAO.STLOUIS.MO.US Subject: Re: Enlarging and Reducing Graphics Date: 22 Jan 1995 21:16:18 GMT Message-ID: <3fuhv2$80@nntp.crl.com> To: LitProg@SHSU.EDU In article <1995Jan22.171250.16190@news.etc.bc.ca>, Winnie Cheng wrote: > >Can someone give me some advices on how to make a program in C++/QBASIC >that can perform graphical image enlarging and reducing? (Kind of like >zooming in on the Mandelbrot set) For the eighth time, this is an inappropriate topic for this news group. comp.programming.literate is a usenet newsgroup dedicated to the discussion of literate programming issues---the issue of producing text-processor readable documentation and compiler readable program files from the same source file. The image processing question is hereby redirected to the appropriate news groups: alt.binaries.pictures.fine-art.graphics alt.corel.graphics alt.graphics alt.graphics.pixutils comp.graphics comp.graphics.algorithms comp.graphics.animation comp.graphics.avs comp.graphics.data-explorer comp.graphics.explorer comp.graphics.gnuplot comp.graphics.opengl comp.graphics.packages.alias comp.graphics.packages.lightwave comp.graphics.raytracing comp.graphics.research comp.graphics.visualization comp.os.ms-windows.programmer.graphics comp.sys.amiga.graphics comp.sys.mac.graphics comp.sys.sgi.graphics dc.graphics dc.graphics.avs triangle.graphics comp.graphics.rendering.renderman Weiqi Gao weiqigao@crl.com -- Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Sun, 22 Jan 1995 19:09:30 CDT Sender: owner-litprog@SHSU.edu From: sp106@york.ac.uk (Stephen Parker) Reply-To: LitProg@SHSU.edu, sp106@YORK.AC.UK Subject: C++/CWEB Date: 23 Jan 1995 00:13:53 GMT Message-ID: <3fusc1$ar@castle.york.ac.uk> To: LitProg@SHSU.EDU I am interested in using CWEB to produce C++/TeX output where the C++ header information (declarations etc) and the C++ implementation information is held in the the same file (.w). I believe I can do this in CWEB via the @(file@> command but I cannot quite get it to work. Could someone please send me a small example for a WEB file which produces both header and implementation files for C++. Thank you, stephen. -- #################################################### # sp106@york.ac.uk # http://www.york.ac.uk/~sp106 # # Each set includes a turntable, nine inch icing # # bag, six high definition nozzles... # #################################################### ================================================================================ Archive-Date: Sun, 22 Jan 1995 20:13:20 CDT Sender: owner-litprog@SHSU.edu From: coates@kelvin.physics.uq.oz.au (Tony Coates) Subject: Release of FunnelWeb 3.0AC Date: 23 Jan 1995 01:43:10 GMT Message-ID: Reply-To: LitProg@SHSU.edu, coates@physics.uq.edu.au CC: To: LitProg@SHSU.EDU =============== FUNNELWEB 3.0AC =============== For some time now, I have been working on enhancing FunnelWeb 3.0 by adding features. Ross Williams, the creator of FunnelWeb, has now allowed me to distribute my enhanced version of FunnelWeb 3.0 as FunnelWeb 3.0AC. (For those unfamiliar with FunnelWeb, see the brief description at the end of this posting.) To the usual FunnelWeb 3.0 features, FunnelWeb 3.0AC adds the following major features: (i) HTML output support (ii) line directive support (auto or manual insertion) (iii) support for OS/2 and Linux plus other miscellaneous features. FunnelWeb 3.0AC is completely compatible with FunnelWeb 3.0 sources (provided they don't define macros starting with '#'; details are provided in the file README.ABC in the FunnelWeb 3.0AC distribution), at least to the best of my current knowledge. Extra features must be explicitly asked for by using pragmas in the FunnelWeb source files. You can get FunnelWeb 3.0AC by going to my WWW LitProg page //http:www.physics.uq.oz.au:8001/people/coates/funnelweb.html or by FTPing one of the following files from ftp.physics.uq.oz.au : (i) for existing FunnelWeb users, `fw950115.tar.gz' contains the new sources which can be unpacked in the `funnelweb/sources' directory or in an alternate source directory if you wish to keep both sets of source code available. You should read the file `README.ABC' which comes with the new sources. (ii) if you don't have FunnelWeb, FTP `funnelweb30AC.tar.gz' which contains a FunnelWeb 3.0 distribution to which my changes have been added. Print out the users manual (in the `fwAC30/userman' directory) for installation instructions. Also read the file `README.ABC' in the `fwAC30/sources' directory. If you have any questions or comments, please feel free to email them to me at `coates@physics.uq.edu.au'. Cheers, Tony. -------------------------------------------------------------------- FunnelWeb is language-independent and formatter-independent literate programming tool. It does not parse the source code sections, leaving the author's formatting intact, but as a consequence it is easy to mix different languages (or makefiles, etc.) in the one FunnelWeb source file. FunnelWeb provides typesetting commands so that the user does not need to understand TeX (or HTML for FunnelWeb 3.0AC) formatting commands, though these commands can be used directly is desired. FunnelWeb also provides parameterised macros, which can be a powerful feature for code with repetitive elements. FunnelWeb is very portable, and runs on a wide variety of machines and operating systems: Mac, DOS, Sun(Unix), and VMS (+ OS/2, Linux, and DEC Alpha(Unix) for 3.0AC), and is easily ported to new systems by changing a few machine-dependent files. The closest LitProg tools to FunnelWeb in spirit are probably noweb and nuweb. -- _____________________________________________________________________________ A.B.Coates, Dept. of Physics, The University of Queensland QLD 4072 Australia. Email: coates@physics.uq.oz.au Phone: (07/+617) 365-3424 Fax: (07/+617) 365-1242 Disclaimer: The University is ignorant of my opinions, let alone guilty ... _____________________________________________________________________________ ================================================================================ Archive-Date: Sun, 22 Jan 1995 22:53:09 CDT Sender: owner-litprog@SHSU.edu From: randyr2229@aol.com (RandyR2229) Subject: CodeWarrior Gold Date: 22 Jan 1995 23:43:49 -0500 Message-ID: <3fvc65$sc7@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, randyr2229@aol.com (RandyR2229) To: LitProg@SHSU.EDU Does anyone out there use this product? I'd like to know your opinions of it. Thanks. (c= Michael Randolph Rowan Owner --> Dolphx Dreamers Guild Staff ---> Investors' Network, AOL If you'd like, please respond via eMail to "randyr2229@aol.com" ================================================================================ Archive-Date: Mon, 23 Jan 1995 19:29:25 CDT Sender: owner-litprog@SHSU.edu From: przemek@rrdjazz.nist.gov (Przemek Klosowski) Reply-To: LitProg@SHSU.edu, przemek@RRDJAZZ.NIST.GOV Subject: Re: gnus and AOL postings to comp.programming.literate Date: 23 Jan 1995 16:31:33 GMT Message-ID: To: LitProg@SHSU.EDU In article <3fu05b$kh1@nntp.crl.com> Weiqi Gao writes: I guess our group name is partly to blame for these postings. Until we find a less ambiguous name, I'll try to point out the inappropriate- ness of the subject for each such article. I feel that's the only way by which we can protect this group from space aliens. I disagree :^)---you may remember that Don Knuth wrote in one of his articles introducing literate programming that he selected the name purposedly, to shame people into adopting the literate programming method ('no-one wants to do illiterate programing'). Therefore, the name was designed to be confusing, and we are stuck with it. -- przemek klosowski (przemek@rrdstrad.nist.gov) Reactor Division (bldg. 235), E111 National Institute of Standards and Technology Gaithersburg, MD 20899, USA (301) 975 6249 ================================================================================ Archive-Date: Tue, 24 Jan 1995 01:50:52 CDT Sender: owner-litprog@SHSU.edu From: mimnagh@sfu.ca Subject: FWEB and HTML Date: 24 Jan 1995 05:17:17 GMT Message-ID: <3g22gt$g17@seymour.sfu.ca> Reply-To: LitProg@SHSU.edu, mimnagh@sfu.ca To: LitProg@SHSU.EDU Has anybody tried this yet? Presumably you could generate LaTeX from FWEB v1.4 ( would 1.3 work ? ) then use a program (LATEX2HTML) to convert this to HTML. Hypertext is pretty seductive, I'd like to see it in action. I'm using FWEB v1.3 and haven't tried LATEX2HTML so I wanted to hear if anyone has tested the waters before I jump. Dominic Mimnagh (mimnagh@sfu.ca) ================================================================================ Archive-Date: Tue, 24 Jan 1995 08:12:28 CDT Sender: owner-litprog@SHSU.edu From: mbuya@cs.joensuu.fi (Fredrick Mbuya) Reply-To: LitProg@SHSU.edu, mbuya@CS.JOENSUU.FI Subject: Re: NoWeb crossindex Message-ID: <1995Jan24.115215.10066@cs.joensuu.fi> Date: Tue, 24 Jan 1995 11:52:15 GMT To: LitProg@SHSU.EDU Frank Dunn (frank.dunn@waterloo.attgis.com) wrote: : Can anybody help me? I am running the MSDOS version of NoWeb version 2.5 and : have the following problem: : : I type "noweave -x test.nw > test.tex" which runs all right, however, LaTex : (emtex to be specific) gives errors on the crossreferences and the numbering : shows up as in the printout of the test.dvi file. I'm new to all this and : would appreciate any suggestions. What am I missing? It runs fine without the : -x option. But crossreferencing sure looks nice. : : Try texing the document more than once, the crosrefrence information is fromthe *last* run of tex. References that were undefined on the previous run are cited as ??. Hope this helps Eric *not* like the headder says. Eric: : : : : : : -- ------------------------------ Frederick Mbuya Latolankatu 9 E 44 80160 Joensuu 16 ================================================================================ Archive-Date: Tue, 24 Jan 1995 08:39:16 CDT Sender: owner-litprog@SHSU.edu From: dahlman@joensuu.fi (Eric Dahlman) Reply-To: LitProg@SHSU.edu, dahlman@JOENSUU.FI Subject: Newbie question *NOT* from AOL Message-ID: <1995Jan24.125449.13657@cs.joensuu.fi> Date: Tue, 24 Jan 1995 12:54:49 GMT To: LitProg@SHSU.EDU I understand the concept of literate programming in a somewhat abstract sence and I think that I was going about it from the wrong direction. First off I am very impressed with the way that documentation and code are mixed in .dtx files in LaTeX and the results that are produced by these files. Now I was wondering if and how one would go about finding a similar system for non-(La)TeX files, I looked at some of the web files on CTAN and to be hones I was a bit confused. Where does one start??? What bits are necessary and which are just extra fluff? So would one of the kind soles that reads this group help a babe-in-the-woods and tell me how to get the whole thing up and running. Thanks in advance, Eric ================================================================================ Archive-Date: Tue, 24 Jan 1995 09:07:54 CDT Sender: owner-litprog@SHSU.edu From: Alistair McEwan Reply-To: LitProg@SHSU.edu, A.McEwan@LPAC.AC.UK Subject: Technical Reports/Papers Date: 24 Jan 1995 14:53:58 GMT Message-ID: <3g34a6$s50@epsilon.qmw.ac.uk> To: LitProg@SHSU.EDU I am looking for any Technical Reports, Conference Presetations or Journal papers on the subject of literate programming systems. Any papers which anyone can refer me to on the subject (in any area of literate programming) would be gratefully received. If anyone can also recommend any books/texts on the subject, I would also appreciate a reference. Thanks, Alistair McEwan -- ________________________________________ London Para||el Applications Centre A.McEwan@lpac.ac.uk +44 71 775 3234 ---------------------------------------- ================================================================================ Archive-Date: Tue, 24 Jan 1995 09:40:20 CDT Sender: owner-litprog@SHSU.edu From: weiqigao@crl.com (Weiqi Gao) Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: Newbie question *NOT* from AOL Date: Tue, 24 Jan 95 09:33:03 CST Message-ID: <3g36kp$9j6@nntp.crl.com> MIME-Version: 1.0 To: LitProg@SHSU.EDU In article <1995Jan24.125449.13657@cs.joensuu.fi>, dahlman@joensuu.fi says... > >I understand the concept of literate programming in a somewhat abstract >sence and I think that I was going about it from the wrong direction. >First off I am very impressed with the way that documentation and code >are mixed in .dtx files in LaTeX and the results that are produced by >these files. Now I was wondering if and how one would go about finding a >similar system for non-(La)TeX files, I looked at some of the web files >on CTAN and to be honest I was a bit confused. Where does one start??? >What bits are necessary and which are just extra fluff? > >So would one of the kind soles that reads this group help a >babe-in-the-woods and tell me how to get the whole thing up and running. The way I started on Literate Programming is through the original WEB system by Knuth. It is included in the emTeX package for DOS. The document in the package is an excerpt from a technical report, so it is terse. One drawback at the time is that I don't have a PASCAL compiler, so I jsut wrote some junk webs and ran them through WEAVE and TANGLE. WEAVE outputs a *.tex file which, when processed and printed out, is a beautifully formatted document. TANGLE produced a PASCAL program that looks more like a uuencoded executable. If you want to get the original ideas of the great one, get the original WEB for PASCAL and just try to figure it out. I guess no-body writes in PASCAL any more, so there won't be any prectical use of it. However if you try to learn any other Literate Programming tool, the first paragraph of the documentation will invariably have a reference to the original WEB, saying something like: "The original WEB is great, but it is for PASCAL only..." or "The original WEB is great, but it has `TOO MANY NOTES'...". So you will be at a loss if you don't know what the original WEB is. You can see the output of the original WEB everyday: the TeX/Metafont system was written in WEB---the programs you are using, and the `TeX: the program' you are reading are produced by WEB. Then you go ahead and choose a real LitProg tool. And here is where the fun begins. If you are like most other people---who discovered LitProg by them- self and not by a department policy---you will go around and evaluate a list of tools available on the net, and arrive at the one that works. The one for me is noweb . (Don't ask why, or you'll start religious war #19.) For other people it might be different. I read an interview with DEK on WWW (O'reily pages?), in which he claims CWEB is the best system if you're programming in C. The biggist trouble for LitProg is that the tools aren't used on a day to day basis. There is also a tendency for everybody to write his own LitProg tool. Another hassle for using a LitProg tool is that they are usualy not well integrated with the development environment, especially the debugging tools. Once you've decided which package to try---be it CWEB, FWEB, noweb, nuweb, FlannelWeb, Spider Web---you can usually get the source from CTAN. Installation is usually easy, unless you have to use DOS. Executables for DOS are usually available. Each LitProg tool is usually written in its own brand of WEB. The LaTeX3 projects doc system differs from an ordinary LitProg system in that with it, the text-processor that produces the documentation and the `compiler' that produces the `executable' are the same system. Here again, in summary, are the steps people take on LitProg: 1. Be impressed by a LitProg tool---in particular the TeX-ed out documentation. 2. Experiement with different tools. 3. Settle down on noweb, and don't think about it any more. Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Tue, 24 Jan 1995 09:56:25 CDT Sender: owner-litprog@SHSU.edu From: weiqigao@crl.com (Weiqi Gao) Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: FWEB and HTML Date: Tue, 24 Jan 95 09:40:43 CST Message-ID: <3g3731$9j6@nntp.crl.com> MIME-Version: 1.0 To: LitProg@SHSU.EDU In article <3g22gt$g17@seymour.sfu.ca>, mimnagh@sfu.ca says... > > Has anybody tried this yet? Presumably you could generate LaTeX >from FWEB v1.4 ( would 1.3 work ? ) then use a program (LATEX2HTML) FWEB v1.30 and v1.40 generate LaTeX 2.09 documents. And yes it does work. >to convert this to HTML. Hypertext is pretty seductive, I'd like to see it >in action. I doubt LaTeX2HTML will work well with FWEB created LaTeX files. It's hard enough to work with straight LaTeX files. (But I haven't tried.) > > I'm using FWEB v1.3 and haven't tried LATEX2HTML so I wanted to >hear if anyone has tested the waters before I jump. > >Dominic Mimnagh (mimnagh@sfu.ca) > noweb can has a tool that generates HTML documents from the web. But there is NO ACTION, just afew jumps here and there. And the code is as boring as you can make them. Weiqi Gao ================================================================================ Archive-Date: Tue, 24 Jan 1995 20:16:55 CDT Sender: owner-litprog@SHSU.edu From: j_mcarthur@BIX.com (Jeffrey McArthur) Reply-To: LitProg@SHSU.edu, j_mcarthur@BIX.COM Subject: Re: Newbie question *NOT* from AOL Date: Tue, 24 Jan 1995 21:30:25 Message-ID: <3g4bi9$qo@news1.delphi.com> To: LitProg@SHSU.EDU >If you want to get the original ideas of the great one, get the original >WEB >for PASCAL and just try to figure it out. I guess no-body writes in PASCAL >any more, so there won't be any prectical use of it. I use PASCAL WEB all the time. We now have several large projects written in Pascal WEB. ---- Jeffrey M\kern-.05em\raise.5ex\hbox{\b c}\kern-.05emArthur a.k.a. Jeffrey McArthur email: j_mcarthur@bix.com work: (301) 306-5188 home: (410) 290-6935 The opinions express are mine. They do not reflect the opinions of my employer. My access to the Internet is not paid for by my employer. ================================================================================ Archive-Date: Tue, 24 Jan 1995 22:34:23 CDT Sender: owner-litprog@SHSU.edu From: mds8539@tam2000.tamu.edu (Michael David Slater) Reply-To: LitProg@SHSU.edu, mds8539@TAM2000.TAMU.EDU Subject: Screen Saver Date: 25 Jan 1995 04:23:53 GMT Message-ID: <3g4joq$6bf@news.tamu.edu> To: LitProg@SHSU.EDU I am interested in writing a screen saver. I don't know what the standard mechanics of them are. How does a DOS screen saver differ from a WINDOWS based (is there a difference). How do you time idleness? Do you keep the bit-blasted images and all code but small mem- resident bootstrap system on disk? Are there any templates or sample screen savers around? thanks. mds8539@tam2000.tamu.edu ================================================================================ Archive-Date: Wed, 25 Jan 1995 00:28:08 CDT Sender: owner-litprog@SHSU.edu From: Weiqi Gao Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: Screen Saver Date: 25 Jan 1995 06:22:30 GMT Message-ID: <3g4qn6$4gt@nntp.crl.com> To: LitProg@SHSU.EDU mds8539@tam2000.tamu.edu (Michael David Slater) wrote: > > I am interested in writing a screen saver. I don't know what the standard > mechanics of them are. How does a DOS screen saver differ from a > WINDOWS based (is there a difference). How do you time idleness? Do you > keep the bit-blasted images and all code but small mem- > resident bootstrap system on disk? Are there any templates or sample > screen savers around? > > thanks. > > mds8539@tam2000.tamu.edu > > For the nineth time, this is an inappropriate subject for the usenet group comp.programming.literate. This group is dedicated to the discussion of the leterate programming methods---a methos by which a text-processor readable documentation and compiler readable program files are generated from the same source file. As for your screen savers, Microsoft C 5.0 and Windows 2.0 SDK has an article about it. They even have a sample file. :) Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Wed, 25 Jan 1995 06:09:24 CDT Sender: owner-litprog@SHSU.edu From: norman@flaubert.bellcore.com (Norman Ramsey) Reply-To: LitProg@SHSU.edu, norman@FLAUBERT.BELLCORE.COM Subject: Re: Newbie question *NOT* from AOL Date: 24 Jan 1995 20:40:13 GMT Message-ID: <3g3ojd$dlm@lowell.bellcore.com> CC: To: LitProg@SHSU.EDU Well, let me just dust off my flame-proof suit... (David Thompson, I think some of these recommendations ought to go in the FAQ.) In article <3g36kp$9j6@nntp.crl.com>, Weiqi Gao wrote: >In article <1995Jan24.125449.13657@cs.joensuu.fi>, dahlman@joensuu.fi >says... >> >>First off I am very impressed with the way that documentation and code >>are mixed in .dtx files in LaTeX and the results that are produced by >>these files. Now I was wondering if and how one would go about finding a >>similar system for non-(La)TeX files, I looked at some of the web files >>on CTAN and to be honest I was a bit confused. Where does one start??? >>What bits are necessary and which are just extra fluff? Some of us think that .dtx and docstrip omit an essential capability, viz., that of writing fragments of code in any order. Religious war #21? Unlike Weiqi Gao, I suggest a good place to begin is in your library, not by playing around with different tools. ``Sometimes two weeks' hacking can save a whole afternoon in the library.'' Don Knuth has written a book entitled ``Literate Programming,'' which I think is mostly of historical interest, but does contain a smorgasbord of good stuff, including the original 1984 Computer Journal article that started this business. Don's ``Stanford GraphBase'' book contains literate programs that I find more accessible than TeX and METAFONT. But the easiest way to begin is probably to explore back issues of Communications of the ACM, where you can find John Bentley's columns on literate programming, plus the columns moderated by Chris van Wyk. (It's not desirable to read all the van Wyk columns unless you want an idea of the range of crazy things people [including me!] have tried and called literate programming.) If you want to understand the issues a little more deeply, you can read my SPE article, which describes some problems encountered using WEB in practice, and my IEEE Software article, which explains how you can get the features you want without having to use a complicated tool. Spend an afternoon this way and you will be the local expert on literate programming (bibliography at end). >The biggist trouble for LitProg is that the tools aren't used on a day to >day basis. Huh? Evidence? Tools range in popularity from daily used worldwide to dead and best forgotten. >There is also a tendency for everybody to write his own LitProg tool. Yes. It's much more easy and fun to write a literate-programming tool than to write a literate program. >Another hassle for using a LitProg tool is that they are usualy not >well integrated with the development environment, especially the debugging >tools. Some are, some aren't. To my mind the major lack of integration is not with compiling and debugging tools, but with WYSIWYG word processors. CLiP comes close, but at the cost of some ugly syntactic conventions (in the eye of this beholder), and without the ability to support automatic indexing. >Once you've decided which package to try---be it CWEB, FWEB, noweb, nuweb, >FlannelWeb, Spider Web For the beginner, there are only three choices. Sensible people will choose noweb or nuweb. Those who are seduced by Don's pretty C code will choose CWEB. (My article in Software explains why.) Norman Ramsey Selected bibliography: @string{cacm="Communications of the ACM"} @article{bentley:lp1, month=may, pages="364--368", number="5", author="Donald E. Knuth and Jon L. Bentley", title="Programming Pearls: Literate Programming", keywords="literate programming pearls", annote="Bentley introduces literate programming. Knuth gives solution to: print a sort list of $M$ random numbers in the range $1\ldots N$, with no duplicates. Solution in exercise 3.4.2--15 in {\it Seminumerical Algorithms}. Uses ordered hash tables.", journal=cacm, year="1986", volume="29"} @article{bentley:lp2, month=jun, pages="471--483", number="6", author="Donald E. Knuth", title="Programming Pearls: A Literate Program", journal=cacm, year="1986", note="Reviewed by M. Douglas McIlroy", annote="Knuth's ornate solution to the common words problem. Introduces the hash trie data strucuture. Review by McIlroy.", volume="29"} @article{knuth:literate, pages="97--111", number="2", author="Donald E. Knuth", title="Literate Programming", annote="The original article on web and literate programming.", journal="The Computer Journal", year="1984", volume="27"} @article{gries:pearls, month="April", pages="284--290", number="4", author="David Gries and Jon Bentley", title="Programming Pearls: Abstract Data Types", keywords="web literate programming", journal=cacm, year="1987", volume="30"} @article{cvw:assessment, month="March", pages="361--365", number="3", author="Van Wyk, Christopher J.", title="Literate Programming: An Assessment", journal=cacm, year="1990", volume="33"} @article{thimbleby:review, month=jun, pages="752--755", number="6", author="Harold Thimbleby", title="A Review of {Donald} {C}. {L}indsay's Text File Difference Utility, {{\em diff}}", journal=cacm, year="1989", volume="32"} @article{ramsey:literate, author="Norman Ramsey and Carla Marceau", title="Literate Programming on a Team Project", keywords="web", journal="Software---Practice \& Experience", month=jul, volume=21, number=7, pages="677--683", year="1991", refereed=1, also="Princeton tech report CS-TR-302-91"} @article{ramsey:simplified, refereed=1, author="Norman Ramsey", title="Literate Programming Simplified", journal="IEEE Software", month=sep, pages="97--105", volume="11", number="5", year="1994"} %%% Books on literate programming or that include literate programs @book{knuth:literate:book, address="Stanford, California", author="Donald E. Knuth", title="Literate Programming", publisher="Stanford University", annote="A mildly interesting collection of Don's work. Begins with his Turing lecture entitled ``Computer Programming as an Art.'' Has two chapters on structured programming: the ``structured programming with goto statements'' paper, and a structured program to generate all topological sorting arrangements. Follows with the original literate programming paper from the computer journal, then two programming pearls papers (sampling and common words). ``How to read a WEB,'' which first appeared as a preface to TeX: the program (I believe), and some excerpts from the TeX and METAFONT programs. There is a chapter on Mathematical Writing that is transcribed from discussions in a course Don gave at Stanford. Then, the ``errors of TeX,'' including the error log of TeX. Finally, the book closes with a short example of CWEB (word count).", year="1992"} @book{fraser:retargetable:book, author="Christopher W. Fraser and David R. Hanson", title="A Retargetable {C} Compiler: Design and Implementation", publisher="Benjamin/Cummings", address="Redwood City, CA", annote="compiler as a literate program", year=1995, note="ISBN 0-8053-1670-1, in press" } %%% these are worth reading only as curiosities, not as guides to %%% good practice @article{ramsey:building, author="Norman Ramsey", title="{L}iterate Programming: {\hskip 0pt plus 0.5em}{W}eaving a Language-Independent {{\tt WEB}}", journal=cacm, month=sep, volume=32, number=9, refereed=1, pages="1051--1055", year="1989"} @article{cvw:loom, month="July", pages="593-599", number="7", author="David R. Hanson", note="Reviewed by John Gilbert", title="Literate Programming: Printing Common Words", journal=cacm, year="1987", volume="30"} @article{cvw:transactions, month=dec, pages="1000-1010", number="12", author="Michael Jackson", note="Reviewed by David Wall", title="Literate Programming: Processing Transactions", journal=cacm, year="1987", volume="30"} @article{hamilton:expanding, month=dec, pages="1376--1385", number="12", author="Eric Hamilton", note="Reviewed by Don Colner", title="Literate Programming: Expanding Generalized Regular Expressions", journal=cacm, year="1988", volume="31"} @article{denning:announcing, month=jul, pages="593", number="7", author="Peter J. Denning", title="Announcing Literate Programming", annote="Short announcement of the formation of the literate programming column, which brief history.", journal=cacm, year="1987", volume="30"} ================================================================================ Archive-Date: Wed, 25 Jan 1995 08:27:05 CDT Sender: owner-litprog@SHSU.edu From: basile@rosser.serma.cea.fr (Basile STARYNKEVITCH) Reply-To: LitProg@SHSU.edu, basile@ROSSER.SERMA.CEA.FR Subject: Literate Programming without an extra (WEB) language. Date: 25 Jan 1995 09:33:12 GMT Message-ID: To: LitProg@SHSU.EDU Hello all, I'm seeking for a literate programming tool (or set of tools) which 1) don't define a new langage such as Web 2) support (a mix of) several source langages (minimum is: C and Scheme, possibly with Prolog) 3) support for application specific conventions (for instance, I want to be able to produce a table of runtime error and warning messages). 4) if possible, support (or could support) other formatting languages than LaTeX (eg Lout, HTML). The first three requirements are mandatory for me. I've already coded a runtime system (garbage collector + other stuff) for a rule-based language under design. This is done in C and a specific Scheme dialect. I don't want to convert the source foo.c files in foo.web, but i'm willing to add documentory (or formatting or LitProg) specific comments --say with a specific prefix- for literate programming. I don't want to have an enhanced vgrind or tgrind, ie I don't need to output the full code, but I do want to generate, for instance, a chapter "function" containing all (documented, ie specifically tagged) routines with their interface, purpose, caveat, etc... and another chapter "errors" describing error messages and another chapter "files" describing source files. Of course, I'm willing to add specific documenting comments (tagged as such) in my C and Scheme sources. I'm also willing to write (at least) some (documenting) scripts -whatever that means. I'm not willing to convert my C sources to Web. I expect that such a LitProg tool would be configurable by specific scripts. I didn't find anything appropriate (CLiP is closest, but don't fit the bill -and I don't like or have Pascal). If any one have pointers, comments or other information, please email or post. I think I'll have to write my own LitProg tool! But I would rather avoid that. Thanks for reading. -- Basile STARYNKEVITCH ---- Commissariat a l Energie Atomique DRN/DMT/SERMA * C.E. Saclay bat.470 * 91191 GIF/YVETTE CEDEX * France fax: (33) 1- 69.08.23.81; phone: (33) 1- 69.08.40.66 email: basile.starynkevitch@cea.fr; homephone: (33) 1- 46.65.45.53 N.B. Any opinions expressed here are solely mine, and not of my organization. N.B. Les opinions exprimees ici me sont personnelles et n engagent pas le CEA. Please cite a small part of my mail in all answers Veuillez citer une petite partie de mon courrier dans vos reponses ================================================================================ Archive-Date: Wed, 25 Jan 1995 08:40:09 CDT Sender: owner-litprog@SHSU.edu From: norman@flaubert.bellcore.com (Norman Ramsey) Reply-To: LitProg@SHSU.edu, norman@FLAUBERT.BELLCORE.COM Subject: Re: FWEB and HTML Date: 24 Jan 1995 20:08:37 GMT Message-ID: <3g3mo5$ded@lowell.bellcore.com> CC: mimnagh@sfu.ca To: LitProg@SHSU.EDU In article <3g22gt$g17@seymour.sfu.ca>, wrote: > Has anybody tried this yet? Presumably you could generate LaTeX from >FWEB v1.4 ( would 1.3 work ? ) then use a program (LATEX2HTML) >to convert this to HTML. I'm not optimistic, for two reasons: - With noweb, I found that I needed a new back end to have any hope of generating interesting hypertext (thanks to Bill Trost for that first version). Any hypertext generated from the latex form would have been uninteresting. Check out ftp://bellcore.com/pub/norman/www/noweb/wc.html for an example of hypertext I consider interesting. - latex2html is, ummm, well, let's just say I was dissatisfied with latex2html. Both its functionality an performance are weak (can you say 200M process image?). Norman ================================================================================ Archive-Date: Wed, 25 Jan 1995 09:25:26 CDT Sender: owner-litprog@SHSU.edu Subject: WinWord WEB -- another look Message-ID: <1995Jan25.155948.3297@debet> From: SNF_HOH@KREDIT.nhh.no (HUSUM, HANS OLAV) Reply-To: LitProg@SHSU.edu, SNF_HOH@KREDIT.NHH.NO Date: 25 Jan 95 15:59:47 MET To: LitProg@SHSU.EDU Started looking into LitProg a month ago -- seems like a good idea (still does!). When browsing for tools intially I saw WordWeb, Lee Wittenbergs experiment. In the end I settled on noweb. Right now I am using it to document the cleaning of a large data set, accomplished through various AWK programs, batch files that use grep, sed and sorting programs. I hear that MicroSoft are releasing Internet Assistant at the end of this month: a free addon to WinWord 6 that makes into a WYSIWYG html browser/editor. Reputedly it will also have a filter .html -> Windows .hlp. Seems like there are great possibilities here for a new and better WordWEB. Would it make more sense to leave tangling to an external program (notably noweb), and concentrate on producing a simultaneous edit/weave thing? I have no time to pursue this at the present moment (or at any time during the next 6 months), but if there are any WordBASIC/LitProg/html-gurus (this intersection must be pretty small !!) out there I hope they would give this a thought! Hans Olav ================================================================================ Archive-Date: Wed, 25 Jan 1995 14:31:21 CDT Sender: owner-litprog@SHSU.edu From: schrod@iti.informatik.th-darmstadt.de (Joachim Schrod) Reply-To: LitProg@SHSU.edu, schrod@ITI.INFORMATIK.TH-DARMSTADT.DE Subject: Re: Technical Reports/Papers Date: 25 Jan 1995 12:47:28 GMT Message-ID: <3g5h90$jgf@rs18.hrz.th-darmstadt.de> To: LitProg@SHSU.EDU In article <3g34a6$s50@epsilon.qmw.ac.uk>, Alistair McEwan writes: > I am looking for any Technical Reports, Conference > Presetations or Journal papers on the subject of > literate programming systems. Any papers which anyone > can refer me to on the subject (in any area of literate > programming) would be gratefully received. A rather complete set of references was collected by Nelson Beebe, and is available in BibTeX format. It's surely on CTAN, but I don't know where. But I know where it is on the LitProg Archive... ftp.th-darmstadt.de [130.83.47.112] directory pub/programming/literate-programming/Documentation file litprog-bib.tar.gz Enjoy, Joachim -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Joachim Schrod Email: schrod@iti.informatik.th-darmstadt.de THD Literate Programming Archive, maintainer ftp.th-darmstadt.de:/pub/programming/literate-programming/ ================================================================================ Archive-Date: Wed, 25 Jan 1995 18:34:04 CDT Sender: owner-litprog@SHSU.edu From: lbliao@alumni.caltech.edu (lbliao) Reply-To: LitProg@SHSU.edu, lbliao@ALUMNI.CALTECH.EDU Subject: Need References on K-Talk and MathEdit etc. Date: 25 Jan 1995 23:30:19 GMT Message-ID: <3g6mub$2cj@gap.cco.caltech.edu> To: tex-news@SHSU.EDU Dear Software Users, I recently heard of the program called TexPort, and MathEdit by a company called K-Talk. I am trying to get the address of this company or a phone number. I would also like to get in touch with people who have had first hand experience with the product and the company. I dont know how expensive the product is, but if there are cheaper alternatives, please let me know. I am looking for something that can write equations and give a TeX/LateX output. Many thanks Lily Liao ================================================================================ Archive-Date: Wed, 25 Jan 1995 18:48:21 CDT Sender: owner-litprog@SHSU.edu From: ninkid@aol.com (NinKid) Subject: Re: Screen Saver Date: 25 Jan 1995 18:21:58 -0500 Message-ID: <3g6mem$1gu@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, ninkid@aol.com (NinKid) To: LitProg@SHSU.EDU DOS Screen Savers vary GREATLY from Windows screen savers. The two are completely different formats. If you want to know how to program a screen saver for DOS, just e-mail me. I have very little experience in Windows so don't ask me about Windows. NinKid@aol.com ================================================================================ Archive-Date: Thu, 26 Jan 1995 09:59:36 CDT Sender: owner-litprog@SHSU.edu From: neurosis@pine.circa.ufl.edu Subject: Re: FWEB and HTML Date: 26 Jan 1995 12:00:35 GMT Message-ID: <3g82t3$ief@no-names.nerdc.ufl.edu> Reply-To: LitProg@SHSU.edu, neurosis@pine.circa.ufl.edu To: LitProg@SHSU.EDU In article <3g22gt$g17@seymour.sfu.ca>, mimnagh@sfu.ca writes: > Has anybody tried this yet? Presumably you could generate LaTeX from >FWEB v1.4 ( would 1.3 work ? ) then use a program (LATEX2HTML) >to convert this to HTML. Hypertext is pretty seductive, I'd like to see it in action. > > I'm using FWEB v1.3 and haven't tried LATEX2HTML so I wanted to hear >if anyone has tested the waters before I jump. > I also hear that the new windows 95 will support a microsoft word to html conversion. This program is available by ftp from microsoft now I believe. I have not tried it yet. sean u OF f > ================================================================================ Archive-Date: Thu, 26 Jan 1995 19:41:05 CDT Sender: owner-litprog@SHSU.edu From: schrod@iti.informatik.th-darmstadt.de (Joachim Schrod) Reply-To: LitProg@SHSU.edu, schrod@ITI.INFORMATIK.TH-DARMSTADT.DE Subject: Re: Newbie question *NOT* from AOL Date: 26 Jan 1995 11:18:07 GMT Message-ID: <3g80df$tpa@rs18.hrz.th-darmstadt.de> To: LitProg@SHSU.EDU In article <1995Jan24.125449.13657@cs.joensuu.fi>, dahlman@joensuu.fi (Eric Dahlman) writes: > I understand the concept of literate programming in a somewhat abstract > sence and I think that I was going about it from the wrong direction. > First off I am very impressed with the way that documentation and code > are mixed in .dtx files in LaTeX and the results that are produced by > these files. Now I was wondering if and how one would go about finding a > similar system for non-(La)TeX files, MAKEPROG is a system that supports Literate Documentation [*] for arbitrary files, in a fashion similar to Frank's doc system. You can get it from the LitProg Archive, in ftp://ftp.th-darmstadt.de/pub/programming/literate-programming/independent/ [*] As the author of MAKEPROG, I would like to emphasize that neither my system nor the doc system support Literate Programming. I consider the support of refinements (i.e., the ability to explain code abstractions in chunks) and thereby to rearrange code an essential part of tools for this programming method. As an example, for TeX programming it would be really handy to have refinements. Lots of contortions might be saved then. If you want to get the feel of a `real' LitProg tool, I would recommend noweb for a start. It's very lean. Enjoy, Joachim -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Joachim Schrod Email: schrod@iti.informatik.th-darmstadt.de THD Literate Programming Archive, maintainer ftp.th-darmstadt.de:/pub/programming/literate-programming/ ================================================================================ Archive-Date: Fri, 27 Jan 1995 05:36:12 CDT Sender: owner-litprog@SHSU.edu From: norman@flaubert.bellcore.com (Norman Ramsey) Reply-To: LitProg@SHSU.edu, norman@FLAUBERT.BELLCORE.COM Subject: Re: Technical Reports/Papers Date: 25 Jan 1995 20:31:46 GMT Message-ID: <3g6cfi$h3@lowell.bellcore.com> To: LitProg@SHSU.EDU Nelson Beebe of Utah maintains a large bibliography on literate programmming. ITs location should be in the FAQ. Norman ================================================================================ Archive-Date: Sat, 28 Jan 1995 08:55:55 CDT Sender: owner-litprog@SHSU.edu From: sbreem@pipeline.com (Stacy Breem) Reply-To: LitProg@SHSU.edu, sbreem@PIPELINE.COM Subject: Looking for:Mathcad 5.0 for Windows Date: 28 Jan 1995 04:51:43 -0500 Message-ID: <3gd43f$bhc@pipe3.pipeline.com> To: LitProg@SHSU.EDU I need Mathcad 5.0 for Windows...I will trade Elastic Reality or trueSpace professional raytracing software for it...snail mail considered...but much prefered if someone can send it binary to my e-mail address...and if you want we can set up a time for me to call your modem so I can d/l from your computer...if you can meet me in the IRC room called Hooske...give me a time you will be there or ask me when a goodtime for me would be...looking for individuals who would like to stay in contact to trade software every once in awhile...let me know ASAP... -- Stacy Breem Master of Nothing Seer of Nothing Now Thats Something! ================================================================================ Archive-Date: Sat, 28 Jan 1995 10:49:08 CDT Sender: owner-litprog@SHSU.edu From: chalin@cs.concordia.ca (Patrice Chalin) Reply-To: LitProg@SHSU.edu, chalin@CS.CONCORDIA.CA Subject: Getting NOWEB to set code in LaTeX environment XXX. Date: 28 Jan 1995 16:39:03 GMT Message-ID: <3gdrv7$i41@newsflash.concordia.ca> Keywords: noweb, LaTeX To: LitProg@SHSU.EDU Hi, Before I start writing filters or changing noweb, I would like to know if anyone has already managed to get noweb to generate LaTeX with code chunks set in an arbitrary environment instead of the usual \nwbegincode ... \nwendcode. Let me explain what I mean more clearly. When generating LaTeX, noweb will set code chunks in an "environment" defined by \nwbegincode and \nwendcode. For example <>= Line 1 ... Line n @ would be converted to (something like) ...\nwbegincode{n}\moddef... Line 1 ... Line n \nwendcode I would like to be able to specify that certain code chunks are to be set in a LaTeX environment named XXX so that the LaTeX generated for the code chunk would be: \begin{XXX} Line 1 ... Line n \end{XXX} with appropriate handling of the chunk name. I you know of any filters or modified versions of noweb that do this please let me know. If not, well, I'll have to do it myself. It shouldn't be to difficult. Patrice -------------------------------------------------------------------------------- Computer Science Department Concordia University Tel.: (514) 848-3000 1455 de Maisonneuve Blvd. West FAX: (514) 848-2830 Montreal, Quebec, Canada H3G 1M8 E-mail: chalin@cs.concordia.ca -------------------------------------------------------------------------------- ================================================================================ Archive-Date: Sat, 28 Jan 1995 18:59:04 CDT Sender: owner-litprog@SHSU.edu Date: Sat, 28 Jan 95 18:58:01 CST From: dhein@Onramp.NET Reply-To: LitProg@SHSU.edu, dhein@ONRAMP.NET Subject: RE: Looking for:Mathcad 5.0 for Windows To: LitProg@SHSU.edu, sbreem@pipeline.com Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII ---------------Original Message--------------- > I need Mathcad 5.0 for Windows...I will trade Elastic Reality or trueSpace > professional raytracing software for it...snail mail considered...but much This topic is for "Literate Programming", not for programming in general. Try one of the MSDOS or WINDOWS newsgroups instead. ------------------------------------- Name: Dave Hein E-mail: dhein@onramp.net Date: 01/28/95 Time: 18:58:01 ------------------------------------- ================================================================================ Archive-Date: Mon, 30 Jan 1995 19:16:21 CDT Sender: owner-litprog@SHSU.edu From: exciteme@aol.com (ExciteMe) Subject: C++ for 486 PC Date: 29 Jan 1995 03:09:03 -0500 Message-ID: <3gfiev$al4@newsbf02.news.aol.com> Reply-To: LitProg@SHSU.edu, exciteme@aol.com (ExciteMe) To: LitProg@SHSU.EDU Does anyone know where i can get an inexpensive C++ compiler for 486 based intel pc? I want to learn it at home. ================================================================================ Archive-Date: Mon, 30 Jan 1995 19:19:16 CDT Sender: owner-litprog@SHSU.edu From: tim@maths.tcd.ie (Timothy Murphy) Reply-To: LitProg@SHSU.edu, tim@MATHS.TCD.IE Subject: Re: C++ for 486 PC Date: 29 Jan 1995 17:11:57 -0000 Message-ID: <3ggi8t$a1d@hamilton.maths.tcd.ie> To: LitProg@SHSU.EDU exciteme@aol.com (ExciteMe) writes: > Does anyone know where i can get an inexpensive C++ compiler for >486 based intel pc? I want to learn it at home. Have you thought of running Linux ? This is freeware, and comes with g++. -- Timothy Murphy e-mail: tim@maths.tcd.ie tel: +353-1-2842366 s-mail: School of Mathematics, Trinity College, Dublin 2, Ireland ================================================================================ Archive-Date: Mon, 30 Jan 1995 19:31:51 CDT Sender: owner-litprog@SHSU.edu From: jbazuzi@PROBLEM_WITH_INEWS_DOMAIN_FILE (Jay Bazuzi) Reply-To: LitProg@SHSU.edu, jbazuzi@PROBLEM_WITH_INEWS_DOMAIN_FILE Subject: REQUEST: Info on Knuth Date: 30 Jan 1995 02:11:27 GMT Message-ID: <3ghhsf$lk4@solaris.cc.vt.edu> To: LitProg@SHSU.EDU I am writing a biographical work on Donald Knuth for a class. I need any info I can get on him. If you know of any electronic services, that would be great. I also would like to know what he as done. I already know of LitProg (Obviously), TeX, MetaFont, and The Art of Computer Programming. If possible, I'd like to write him email. If anyone knows his address, and you don't think I'd be wasting his time, I'd appreciate it. Thanks for letting me use your bandwidth. ------- Jay Bazuzi jbazuzi@vt.edu jbazuzi@neilyoung.async.vt.edu finger for PGP key PGP fingerprint: = 10 D9 B9 E2 83 28 03 B5 38 E5 81 F7 E5 85 CE C5 ================================================================================ Archive-Date: Mon, 30 Jan 1995 19:48:16 CDT Sender: owner-litprog@SHSU.edu From: sp106@ebor.york.ac.uk (Stephen Parker) Reply-To: LitProg@SHSU.edu, sp106@EBOR.YORK.AC.UK Subject: Re: C++ for 486 PC(Nothing to do with LitProg!) Date: 30 Jan 1995 09:52:02 GMT Message-ID: <3gics2$9se@castle.york.ac.uk> To: LitProg@SHSU.EDU Timothy Murphy (tim@maths.tcd.ie) wrote: : exciteme@aol.com (ExciteMe) writes: : > Does anyone know where i can get an inexpensive C++ compiler for : >486 based Intel pc? I want to learn it at home. : Have you thought of running Linux ? : This is freeware, and comes with g++. But is probably not the simplest environment in which to learn C++ since some of its' mechanisms (templates say) are a little complex. Better to buy Turbo C++ if you can afford it (It's about 50 pounds sterling don't know how much in the USA), and is a nice little compiler if you aren't too bothered by exception handling. stephen . : -- : Timothy Murphy : e-mail: tim@maths.tcd.ie : tel: +353-1-2842366 : s-mail: School of Mathematics, Trinity College, Dublin 2, Ireland -- #################################################### # sp106@york.ac.uk # http://www.york.ac.uk/~sp106 # # Each set includes a turntable, nine inch icing # # bag, six high definition nozzles... # #################################################### ================================================================================ Archive-Date: Mon, 30 Jan 1995 19:51:16 CDT Sender: owner-litprog@SHSU.edu From: anderson@earhart.cs.umass.edu (Scott D. Anderson) Subject: Re: Need References on K-Talk and MathEdit etc. Date: 29 Jan 1995 16:25:48 GMT Message-ID: Reply-To: LitProg@SHSU.edu, anderson@cs.umass.edu To: lbliao@alumni.caltech.edu (lbliao) To: tex-news@SHSU.EDU In article <3g6mub$2cj@gap.cco.caltech.edu> lbliao@alumni.caltech.edu (lbliao) writes: > I recently heard of the program called TexPort, and MathEdit by a company > called K-Talk. I am trying to get the address of this company or a phone > number. I would also like to get in touch with people who have had first > hand experience with the product and the company. I dont know how expensive > the product is, but if there are cheaper alternatives, please let me know. > I am looking for something that can write equations and give a TeX/LateX > output. > > Many thanks > > Lily Liao > I found the following in my archive of messages; it may be useful: > From: KTALK > Newsgroups: comp.text.tex > Subject: Re: TeX -> text conversion? > Date: Tue, 28 Jun 94 23:07:57 -0500 > Organization: Delphi (info@delphi.com email, 800-695-4005 voice) > NNTP-Posting-Host: bos1b.delphi.com > > K-Talk Communications has a DOS program, TexPort, that converts > TeX/LaTeX to WP/Word. I can send more information if you are interested. > -- Lisa, ktalk@aol.com Scott D. Anderson anderson@cs.umass.edu ================================================================================ Archive-Date: Mon, 30 Jan 1995 19:53:53 CDT Sender: owner-litprog@SHSU.edu From: naras@euler.bd.psu.edu (Balasubramanian Narasimhan) Reply-To: LitProg@SHSU.edu, naras@EULER.BD.PSU.EDU Subject: Re: REQUEST: Info on Knuth Date: 30 Jan 1995 13:50:48 GMT Message-ID: To: LitProg@SHSU.EDU >>>>> "Jay" == Jay Bazuzi writes: In article <3ghhsf$lk4@solaris.cc.vt.edu> jbazuzi@PROBLEM_WITH_INEWS_DOMAIN_FILE (Jay Bazuzi) writes: Jay> I am writing a biographical work on Donald Knuth for a class. Jay> I need any info I can get on him. If you know of any Jay> electronic services, that would be great. I also would like Jay> to know what he as done. I already know of LitProg Jay> (Obviously), TeX, MetaFont, and The Art of Computer Jay> Programming. If possible, I'd like to write him email. If Jay> anyone knows his address, and you don't think I'd be wasting Jay> his time, I'd appreciate it. You can start with a wonderful 20-page interview in Mathematical People Profiles and Interview edited by Donald J. Albers and G. L. Alexanderson. ISBN 0-8176-3191-7 ISBN 3-7643-3191-7 I wouldn't e-mail him, unless it were something really important, like an authoritative biography. Besides Knuth's work and philosophy is not undocumented; much can be gleaned from his prolific writings. You could also start for example from his Turing award lecture. -- --- B. Narasimhan naras@euler.bd.psu.edu Division of Science Penn State Erie, The Behrend College Erie, PA 16563-0203 ================================================================================ Archive-Date: Mon, 30 Jan 1995 20:21:40 CDT Sender: owner-litprog@SHSU.edu From: paul@demon.co.uk (Paul Dunne) Reply-To: LitProg@SHSU.edu, paul@DEMON.CO.UK Subject: Re: C++ for 486 PC Message-ID: Date: Mon, 30 Jan 1995 13:48:05 GMT To: LitProg@SHSU.EDU ExciteMe (exciteme@aol.com) wrote: : Does anyone know where i can get an inexpensive C++ compiler for : 486 based intel pc? I want to learn it at home. Read the FAQ, then post. This is NOT an appropriate question for comp.programming.literate. I am somewhat at a loss to understand how anyone could think it so. -- -------------------------------------------------------------------------- Paul Dunne, Consultant & Journalist | "(Deferred: Not a typewriter)" paul@tiny1.demon.co.uk | 0181-522 0308 -------------------------------------------------------------------------- ================================================================================ Archive-Date: Mon, 30 Jan 1995 20:21:49 CDT Sender: owner-litprog@SHSU.edu From: paul@demon.co.uk (Paul Dunne) Reply-To: LitProg@SHSU.edu, paul@DEMON.CO.UK Subject: Re: Looking for:Mathcad 5.0 for Windows Message-ID: Date: Mon, 30 Jan 1995 13:45:24 GMT To: LitProg@SHSU.EDU Stacy Breem (sbreem@pipeline.com) wrote: : I need Mathcad 5.0 for Windows...I will trade Elastic Reality or trueSpace : professional raytracing software for it...snail mail considered...but much : prefered if someone can send it binary to my e-mail address...and if you : want we can set up a time for me to call your modem so I can d/l from your : computer...if you can meet me in the IRC room called Hooske...give me a : time you will be there or ask me when a goodtime for me would be...looking : for individuals who would like to stay in contact to trade software every : once in awhile...let me know ASAP... : -- : Stacy Breem : Master of Nothing : Seer of Nothing : Now Thats Something! This is comp.programming.literate - WHY do people insist on posting irrelevant stuff here? -- -------------------------------------------------------------------------- Paul Dunne, Consultant & Journalist | "(Deferred: Not a typewriter)" paul@tiny1.demon.co.uk | 0181-522 0308 -------------------------------------------------------------------------- ================================================================================ Archive-Date: Mon, 30 Jan 1995 20:24:06 CDT Sender: owner-litprog@SHSU.edu Subject: Separate Compilation Message-ID: <1995Jan30.200706.26129@wisipc.weizmann.ac.il> From: oren@hadar.weizmann.ac.il (Ben-Kiki Oren) Reply-To: LitProg@SHSU.edu, oren@HADAR.WEIZMANN.AC.IL Date: Mon, 30 Jan 1995 20:07:06 GMT To: LitProg@SHSU.EDU Well, I've downloaded noweb and nuweb off the net and looked into both. Both are nice, but probably noweb is the tool for me since both are (alas!) inadequate to my needs, as it is designed to be easily extendible. I'll probably look into the new FWEB release since it supports HTML (which is my target formatter). I'm ``somewhat unhappy'' with LaTeX2HTML. At any rate, my problem is that both tools have zilch support for separate compilation. Now, I typically place each C++ class in its own set of .hh/.cpp files (with a possible .ii for inlines, etc.). I naturally want to write a single '.w' file per class. It seems the current way of supporting this is to include all the .tex files into a single global doc and pass it through LaTeX to get a document. This won't do for me, since I've got over a hundred classes, and if I treat the whole thing as a single document, I'll die of coffee overdose. Even worse, I'm not interested in LaTeX at all. I want HTML documents so I'll be able to browse through the docs with Mosaic (who ever prints these docs, anyway? They are out-of-date the second they are printed). LaTeX2HTML would die horribly trying to eat such a monster document. So, I could simply treat each class as its own separate document, right? Wrong. Because I _do_ want to have reasonable hypertext cross-links between the classes. For example, when one class derives from another, I would like to be able to get to the base class definition. In fact, I would like to be able to click on any class name in the code chunks, and jump to that class definition file. And this currently can't be done when each is in its own document. BTW, I don't have TeX or LaTeX installed at all, and I don't want to. This makes relying on LaTeX-generated .toc files and .aux files impossible. I've given the matter some thought, and what seems to me the best solution is that each document would generate a list of identifier definitions (with the HTML URL anchors) in a separate '.def' file. In each document, I'll need to say something like '@use some-other-document', which will add these anchors to the identifier definitions table. Thus, when the document is weaved, proper cross-links will be generated. A makefile will make sure the '@use'ed '.def' files are up-to-date. A secondary issue is the creation of a global table of contents file, which will reference all the separate documents. This can be trivially performed by a separate program picking at the generated HTML files, and creating a list of all the ... entries. I could also generate an automatic use-graph, so I could jump to all places a class was used or derived from, etc... You get the idea. Simple, in theory. In practice... Well, I'm hampered by the whole LaTeX2HTML mess (I'm desperate enough that writing straight HTML looks really inviting at times). I've just seen the FWEB release post - maybe its use of private formatting commands and HTML support will relieve me of this - but it remains to be seen how easy it would be to integrate such a scheme in it. OK, I'll do it myself if I have to. And if I have the week or two it'll take. I promise to post the result, whichever tool it turns out to be based on. What really worries me is that the matter was not even briefly mentioned in no lit-prog doc I've encountered. Is it because no-one uses literate programming for big projects? Come to think of it, the biggest literate program I know of is TeX, and Knuth is just, eh, out-of-the-ordinary enough to write it as a single .w file, for all I know. This is not an option for a team of five programmers working on a library with >30K of C++ LOC and >100 of C++ classes. So, is there some blessed soul who has already implemented such a scheme? If not, has literate programming ever been implemented for projects with a multitude of cross-referencing source files worked on by multiple programmers? How did they do it, then? Am I missing something obvious? Oren Ben-Kiki -- Life is tough and the hard ships are many. ================================================================================ Archive-Date: Mon, 30 Jan 1995 20:32:58 CDT Sender: owner-litprog@SHSU.edu Date: Sun, 29 Jan 95 10:31:08 CST From: dhein@Onramp.NET Reply-To: LitProg@SHSU.edu, dhein@ONRAMP.NET Subject: EMTEX: fatal format file error ! Please Help ! To: LIST LitProg Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII I am having a problem with emTeX version 3.1415 [3c-beta12] running in an MS-DOS session under Windows 3.1. Everytime I try to TeX a file I get the message "Fatal format file error; I'm stymied". Well I'm stymied too! 3.1415 is not "as easy as pi"! Can anyone help me? Has anyone encountered and solved this problem? Version 3.0[3a] of emTeX seems to work just fine with PLAIN.FMT. But I need to get the upgrade to work. The reason I tried the upgrade to the [3c-beta12] version is that I want to run LaTeX 2e, and I need a version of emTeX which can handle the memory requirements -- the [3a] emTeX couldn't hack it. If you respond by mail, I'll post a summary of the responses. ------------------------------------- Name: Dave Hein E-mail: dhein@onramp.net Houston, TX Date: 01/29/95 Time: 10:31:08 ------------------------------------- ================================================================================ Archive-Date: Tue, 31 Jan 1995 09:45:45 CDT Sender: owner-litprog@SHSU.edu From: weiqigao@crl.com (Weiqi Gao) Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: C++ for 486 PC Date: 31 Jan 1995 13:23:56 GMT Message-ID: <3gldlc$99v@nntp.crl.com> MIME-Version: 1.0 To: LitProg@SHSU.EDU In article , paul@demon.co.uk says... > >ExciteMe (exciteme@aol.com) wrote: >: Does anyone know where i can get an inexpensive C++ compiler for >: 486 based intel pc? I want to learn it at home. >Read the FAQ, then post. This is NOT an appropriate question for >comp.programming.literate. I am somewhat at a loss to understand how >anyone could think it so. AOL apparantly have a News Group guide which tells their people that comp.programming.literate is a group for beginning programmers. I have been trying to curb these AOL posts for quite some time. It seems to me that those people who post clueless articles to this news group never comes back and check for follow-ups. And my finger-pointing posts never get to their intended targets. [Or I would have received at least a couple of thank-you-for-pointing-out-my-mistake mails out of the twenty or so AOLers.] And my postings here become another annoyance (apparently to some.) I can't think of a way of curing this problem, for as soon as one clueless post is taken care of, another three appears. In the next few weeks, I'll try another strategy: mail the FAQ to the sender of these posts. It takes money for AOLers to read their mail, doesn't it? (If you want to join me in these effort, so much the better.) :>) But it's a lost battle. As the saying goes: YOU CAN'T FIX STUPID. Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Tue, 31 Jan 1995 12:07:27 CDT Sender: owner-litprog@SHSU.edu Message-ID: <9501311806.AA14975@us4rmc.pko.dec.com> Date: Tue, 31 Jan 95 13:06:45 EST From: mulp 31-Jan-1995 1303 -0500 Reply-To: LitProg@SHSU.edu, pettengill@STEVMS.ENET.DEC.COM To: litprog@shsu.edu Subject: Re: REQUEST: Info on Knuth >>>>> "Jay" == Jay Bazuzi writes: In article <3ghhsf$lk4@solaris.cc.vt.edu> jbazuzi@PROBLEM_WITH_INEWS_DOMAIN_FILE (Jay Bazuzi) writes: Jay> I need any info I can get on him. If you know of any Jay> electronic services, that would be great. I also would like ... Jay> anyone knows his address, and you don't think I'd be wasting Jay> his time, I'd appreciate it. He doesn't deal with email; his email account sends a response saying, contact him with paper mail. He found that email diverted him from his task of complete The Art, which he believes will take the next 20 or so years to complete. Check out: http://www.clbooks.com/nbb/knuth.html http://info.desy.de/www/LitProg/Start.html mulp ================================================================================ Archive-Date: Tue, 31 Jan 1995 15:36:38 CDT Sender: owner-litprog@SHSU.edu From: weiqigao@crl.com (Weiqi Gao) Reply-To: LitProg@SHSU.edu, weiqigao@CRL.COM Subject: Re: borland or visual c++ ? Date: Tue, 31 Jan 95 15:23:29 CST Message-ID: <3gm9po$n0v@nntp.crl.com> MIME-Version: 1.0 To: LitProg@SHSU.EDU In article <3gm2ma$llc@jhunix1.hcf.jhu.edu>, gk@vangogh.med.jhu.edu says... > >I am about to write c++ software for pc's and I do not know which >compiler to use. The program will have nice Windows interfacing, and will >involve signal acquisition and some digital signal processing. >Does anyone know which is better? Visual C++ or Borland C++? >(or maybe something else) > Don't use C++ for signal processing, period. [By the way, this is not the appropriate group. Have you read my earlier posting today?] Weiqi Gao weiqigao@crl.com ================================================================================ Archive-Date: Tue, 31 Jan 1995 17:59:41 CDT Sender: owner-litprog@SHSU.edu From: gk@vangogh.med.jhu.edu (Gil Kedem) Reply-To: LitProg@SHSU.edu, gk@VANGOGH.MED.JHU.EDU Subject: borland or visual c++ ? Date: 31 Jan 1995 19:22:50 GMT Message-ID: <3gm2ma$llc@jhunix1.hcf.jhu.edu> To: LitProg@SHSU.EDU I am about to write c++ software for pc's and I do not know which compiler to use. The program will have nice Windows interfacing, and will involve signal acquisition and some digital signal processing. Does anyone know which is better? Visual C++ or Borland C++? (or maybe something else) Please help. Thanks Gil Kedem (gk@vangogh.med.jhu.edu) ================================================================================ Archive-Date: Tue, 31 Jan 1995 20:09:20 CDT Sender: owner-litprog@SHSU.edu From: diego@ds5000.dgsca.unam.mx (Diego Zamboni) Reply-To: LitProg@SHSU.edu, diego@DS5000.DGSCA.UNAM.MX Subject: Spidery WEB for Perl? Date: 1 Feb 1995 01:40:25 GMT Message-ID: <3gmoq9$17gk@campus.mty.itesm.mx> To: LitProg@SHSU.EDU Hi: Has somebody done something with Spidery Web for programming in perl? Or does anybody know of some literate programming tool apt for programming in perl? Thanks! Please answer by email if possible, I'll summarize. -- Diego Martin Zamboni Depto. de Administracion de Supercomputo diego@ds5000.dgsca.unam.mx DGSCA, UNAM, Mexico. Tel. (5)622-85-29 WWW home page: http://www.super.unam.mx/~diego/ ================================================================================ Archive-Date: Tue, 31 Jan 1995 20:20:56 CDT Sender: owner-litprog@SHSU.edu From: tjm@i2.co.uk (Tim Meadowcroft) Reply-To: LitProg@SHSU.edu, tjm@I2.CO.UK Subject: Re: Looking for:Mathcad 5.0 for Windows Date: Tue, 31 Jan 1995 17:37:25 +0000 Message-ID: To: LitProg@SHSU.EDU In article , Paul Dunne wrote: >Stacy Breem (sbreem@pipeline.com) wrote: >: I need Mathcad 5.0 for Windows...I will trade Elastic Reality or trueSpace >This is comp.programming.literate - WHY do people insist on posting >irrelevant stuff here? There's a suggestion on alt.best.of.internet that there's a new group of self-satisfied humour merchants that have a mission to "take over" newsgroups in a way similar to the takeover of alt.pets.cats, and they start with "low-level priming" by innocuous mis-posts and hope to provoke a flame war. The number of "valid responses" that mis-postings get in this group suggests either a group of very helpful users, or one of their attacks being in "Level 1" and attempts to escalate. According to their "rules of engagement", this posting recognising a possible attack should blow the whistle on this attack and so end it (appararently it's only fun before anyone realises). If on the other hand the mis-posts are just mis-posts, can I recommend that indignant people reply to offending individuals with direct e-mail rather than posts, this will reduce the noise for everyone else and give them the right idea. (Oh no, no obhack for comp.programming.literate, have I mis-posted ;^) ?) Tim // tjm@i2.co.uk ================================================================================ Archive-Date: Tue, 31 Jan 1995 20:43:12 CDT Sender: owner-litprog@SHSU.edu From: norman@flaubert.bellcore.com (Norman Ramsey) Reply-To: LitProg@SHSU.edu, norman@FLAUBERT.BELLCORE.COM Subject: Clueless newbies on comp.programming.literate Date: 31 Jan 1995 19:15:33 GMT Message-ID: <3gm28l$pme@lowell.bellcore.com> To: LitProg@SHSU.EDU In article <3gldlc$99v@nntp.crl.com>, Weiqi Gao wrote: >In article , paul@demon.co.uk says... >>Read the FAQ, then post. This is NOT an appropriate question for >>comp.programming.literate. I am somewhat at a loss to understand how >>anyone could think it so. > >AOL apparantly have a News Group guide which tells their people that >comp.programming.literate is a group for beginning programmers. > >I have been trying to curb these AOL posts for quite some time. Have you sent mail to postmaster@aol.com and to Steve Case at AOL? My Dad is an AOL subscriber (no Internet providers in the 607 area code). I'll try to remember to check out this rumor and to see if I can't get an email address for Case, who might get annoyed enough to fix it. >And my postings here become another annoyance (apparently to some.) NO! I think we need to pound on *every* *one* of these clueless newbies until they get the point. And we need to ferret out an address of the Authorities at AOL; they don't honor postmaster. >I can't think of a way of curing this problem, for as soon as one clueless >post is taken care of, another three appears. How about a weekly posting of a one-paragraph synopsis of what this group is about? ================================================================================ Archive-Date: Tue, 31 Jan 1995 20:55:11 CDT Sender: owner-litprog@SHSU.edu From: norman@flaubert.bellcore.com (Norman Ramsey) Reply-To: LitProg@SHSU.edu, norman@FLAUBERT.BELLCORE.COM Subject: NOT Separate Compilation -- Separate Documentation! Date: 31 Jan 1995 19:39:43 GMT Message-ID: <3gm3lv$pqi@lowell.bellcore.com> CC: preston@tera.com To: LitProg@SHSU.EDU Ben-Kiki Oren has uncovered a flaw in noweb's HTML support (I have been waiting for this shoe to drop for six months), but he has confused the issue with separate compilation. The problem is that NO current literate-programming tool has good support for inter-document references. (Probably because no TeX variant does this.) Some noweb users have encountered a related but not identical problem: in documentation, chunk names are assumed to denote different `refinements' in different documents. In article <1995Jan30.200706.26129@wisipc.weizmann.ac.il>, Ben-Kiki Oren wrote: >I naturally want to write a single '.w' file per class. > >I want HTML documents so I'll be able to >browse through the docs with Mosaic. LaTeX2HTML would die horribly >trying to eat such a monster document. >I don't have TeX or LaTeX installed at all, and I don't want >to. Indeed. Use noweave -html, and use HTML markup, not latex markup, in your documentation chunks. > I _do_ want to have reasonable hypertext cross-links between [documents] >I've given the matter some thought, and what seems to me the best >solution is... Two questions before you get into solutions 1) do you want cross-links for chunks, or only for identifiers? (My religious preference is that chunks should have file scope, therefore no cross-links for chunks.) 2) Where are you going to get the cross-reference information for identifiers? It is hard to get accurate info for C++. I'd like to see a solution simple enough and general enough that it could be applied to latex or frame or xhdvi documents, not just html documents. Moreover, it ought to be possible to make the solution fit into the nodefs/noweave -indexfrom/noindex framework. > I'm hampered by the whole LaTeX2HTMLmess Don't touch it. You're not using latex; you have no need. Use HTML, or consider something like linuxdoc-sgml. >What really worries me is that the matter was not even briefly mentioned in no >lit-prog doc I've encountered. Is it because no-one uses literate programming >for big projects? Come to think of it, the biggest literate program I know of >is TeX, and Knuth is just, eh, out-of-the-ordinary enough to write it as a >single .w file, for all I know. This is not an option for a team of five >programmers working on a library with >30K of C++ LOC and >100 of C++ classes. Many people use a large number of separate source files, with all the usual separate-compilation goodies, but then format all the source code in one large document. This is not as awkward as it sounds, especially since there are good facilities for excerpting large documents. What has changed is the advent of HTML, plus browsers that are emphatically not designed to handle large documents. >Am I missing something obvious? Well, you seem not to see that separate compilation needn't have anything to do with `separate documentation'. If I wanted this tomorrow, I'd try writing a program to split up a big HTML file on

boundaries, and then the following trick: noweave -html -index -autodefs c *.w > huge.html splitup huge.html This is much easier than what you propose, because the only part that needs thought is converting intra-document to inter-document hrefs when you split the huge.html. If you want to cheat a little, alter tohtml to spit out something suitable when it sees @file. Norman Ramsey P.S. It would be pleasant if the various litprog wizards cooperated to