Newsgroups Main » Newsgroups Directory » Computers – Non-OS » Programming and languages
Literate tools ( comp.programming.literate )
From [email protected] Wed Jul 28 23:33:01 1993 Path: uunet!bounce-back From: [email protected] (Matthias Neeracher) Newsgroups: news.announce.newgroups,news.groups,comp.programming,comp.text.tex,comp.lang.misc,comp.lang.c,comp.lang.c++,comp.lang.fortran,comp.lang.ada,comp.lang.modula3,comp.software-eng Subject: RFD: comp.programming.literate Followup-To: news.groups Date: 28 Jul 1993 23:24:39 -0400 Organization: Integrated Systems Laboratory, ETH, Zurich Lines: 97 Sender: [email protected] Approved: [email protected] Message-ID: <[email protected]> NNTP-Posting-Host: rodan.uu.net Xref: uunet news.announce.newgroups:3890 news.groups:77807 comp.programming:5837 comp.text.tex:34625 comp.lang.misc:13835 comp.lang.c:73719 comp.lang.c++:49258 comp.lang.fortran:15056 comp.lang.ada:12974 comp.lang.modula3:1930 comp.software-eng:15632 Request for Discussion: comp.programming.literate ------------------------------------------------- Proposed name: comp.programming.literate Proposed moderation status: unmoderated Proposed Charter: A forum for the discussion of issues related to literate programming. (1) To share ideas, questions, experiences, and knowledge about the reading and writing of literate programs. (2) To discuss the merits of the currently existing literate programming tools. (3) To discuss the design of new literate programming tools. Background: What is Literate Programming? In an article published in _The Computer Journal_ 27 (1984), 97-111, Donald E. Knuth proposed a "literate" programming style: I believe that the time is ripe for significantly better documentation of programs, and that we can best achieve this by considering programs to be works of literature. Hence, my title: "Literate Programming." Let us change our traditional attitude to the construction of programs: Instead of imagining that our main task is to instruct a *computer* what to do, let us concentrate rather on explaining to *human beings* what we want a computer to do. The practitioner of literate programming can be regarded as an essayist, whose main concern is with exposition and excellence of style. Such an author, with thesaurus in hand, chooses the names of variables carefully and explains what each variable means. He or she strives for a program that is comprehensible because its concepts have been introduced in an order that is best for human understanding, using a mixture of formal and informal methods that reinforce each other. A literate programming system can be characterized by the following properties: - The compilable program and the publishable documentation should be generated *automatically* from a *single* document. - The program can be presented in the order that is best for human understanding, regardless of any requirements of the programming language. - The program should be automatically indexed and cross-referenced. Knuth's original system, called WEB, generated Pascal code and a TeX documentation. Most tools relating to the TeX system have been written using WEB, and the TeX and Metafont programs have been published in book form. Today, there are Literate Programming systems for a wide range of programming languages and documentation systems. Specialized Literate Programming tools have been written for Ada, Awk, C, C++, Fortran, Modula-2, Modula-3, Pascal and Scheme, and generic tools exist that can generate almost any programming language (including Perl and sh). Documentation systems supported include TeX, Troff, and Word for Windows. Existing Resources The mailing list [email protected] has existed for about a year. There are currently more than 300 subscribers and an average of about 80 messages (corresponding to about 150K of traffic) per month in the first 6 months of this year. If a newsgroup is created, mechanisms are already in place to support a mirrored gateway between it and the existing mailing list. For reference purposes, the newsgroup will be fully archived by the host sponsoring the mailing list. Discussion Discussion should be confined to news.groups. Please do not post responses to any other groups. Discussions may also be e-mailed to [email protected] if posting is not possible. Assuming there is a consensus that the group comp.programming.literate should be created, voting will start 21 days from the first posting date of this request. Voting instructions will be published in a Call for Votes to the same newsgroups that see this Request for Discussion. Both this Request for Discussion and the Call for Votes will be crossposted to the "[email protected]" mailing list. Matthias -- Matthias Neeracher [email protected] "For a successful technology, reality must take precedence over public relations, for Nature cannot be fooled." - Richard P. Feynman From [email protected] Tue Aug 24 17:14:34 1993 Path: uunet!bounce-back From: [email protected] (Dave Cornejo) Newsgroups: news.announce.newgroups,news.groups,comp.programming,comp.text.tex,comp.lang.misc,comp.software-eng,comp.lang.c,comp.lang.c++,comp.lang.pascal,comp.lang.fortran Subject: CFV: comp.programming.literate Followup-To: poster Date: 24 Aug 1993 13:58:31 -0400 Organization: Usenet Volunteer Votetakers Lines: 98 Sender: [email protected] Approved: [email protected] Message-ID: <[email protected]> Reply-To: [email protected] NNTP-Posting-Host: rodan.uu.net Xref: uunet news.announce.newgroups:3967 news.groups:79874 comp.programming:6167 comp.text.tex:35806 comp.lang.misc:14045 comp.software-eng:16135 comp.lang.c:76008 comp.lang.c++:51605 comp.lang.pascal:23517 comp.lang.fortran:15414 CALL FOR VOTES (1st of 2) Unmoderated group comp.programming.literate Newsgroups line: comp.programming.literate Literate programs and programming tools. Votes must be received by 14 Sep 1993 23:59:59 GMT. This vote is being conducted by a neutral third party. For voting questions only, contact [email protected] For questions about the proposed group, contact Matthias Neeracher <[email protected]>. A copy of this Call For Votes will be sent to [email protected] after the original Call For Votes appears in news.announce.newgroups. STANDARD VOTING INFO You should send MAIL (posts to a group are invalid) to [email protected] (just replying by MAIL to this message should work). Your mail message should contain one and only one of the following statements: I vote YES on comp.programming.literate or I vote NO on comp.programming.literate You may add a comment, but anything other than a definite statement involving the group name and "yes", "no", "for", or "against" on a single line may be rejected by the automatic vote counting program. If you later change your mind you may also use send in an "abstain" vote in the same manner, using "abstain" in place of "yes" or "no". Standard Guidelines for voting apply - one vote per person (not per account). 100 more YES votes than NO votes and 2/3 of all votes being YES are the requirements for group creation. Votes will be acknowledged by email; a list of bounced acknowledgements will be posted with the second Call For Votes. A mass acknowledgement will NOT be posted. You may inquire about the status of your vote by emailing the vote-taker ([email protected]). After the results have been announced a complete list of the votes will be posted in news.groups and will be mailed on request (email requests to [email protected]). The vote-taker can accept no responsibility for improperly configured mailers. CHARTER Charter: A forum for the discussion of issues related to literate programming. (1) To share ideas, questions, experiences, and knowledge about the reading and writing of literate programs. (2) To discuss the merits of the currently existing literate programming tools. (3) To discuss the design of new literate programming tools. If a newsgroup is created, it will be mirrored to the existing mailing list [email protected] For reference purposes, the newsgroup will be fully archived by the host sponsoring the mailing list. Background: What is Literate Programming? Literate programming is a programming technique invented by Donald. E. Knuth. A literate programming system can be characterized by the following properties: - The compilable program and the publishable documentation should be generated *automatically* from a *single* document. - The program can be presented in the order that is best for human understanding, regardless of any requirements of the programming language. - The program should be automatically indexed and cross-referenced. Knuth's original system, called WEB, generated Pascal code and a TeX documentation. Most tools relating to the TeX system have been written using WEB, and the TeX and Metafont programs have been published in book form. Today, there are Literate Programming systems for a wide range of programming languages and documentation systems. Specialized Literate Programming tools have been written for Ada, Awk, C, C++, Fortran, Modula-2, Modula-3, Pascal and Scheme, and generic tools exist that can generate almost any programming language (including Perl and sh). Documentation systems supported include TeX, Troff, and Word for Windows. -- Dave Cornejo There is nothing so subtle Dogwood Media as the obvious Fremont, California From [email protected] Wed Sep 8 19:42:29 1993 Path: uunet!bounce-back From: [email protected] (Dave Cornejo) Newsgroups: news.announce.newgroups,news.groups,comp.programming,comp.text.tex,comp.lang.misc,comp.software-eng,comp.lang.c,comp.lang.c++,comp.lang.pascal,comp.lang.fortran Subject: 2nd CFV: comp.programming.literate Followup-To: poster Date: 8 Sep 1993 16:26:15 -0400 Organization: Usenet Volunteer Votetakers Lines: 107 Sender: [email protected] Approved: [email protected] Message-ID: <[email protected]> References: <[email protected]> Reply-To: [email protected] NNTP-Posting-Host: rodan.uu.net Xref: uunet news.announce.newgroups:4022 news.groups:81094 comp.programming:6341 comp.text.tex:36466 comp.lang.misc:14078 comp.software-eng:16452 comp.lang.c:77189 comp.lang.c++:52762 comp.lang.pascal:23984 comp.lang.fortran:15667 SECOND CALL FOR VOTES (this is the last Call For Votes) Unmoderated group comp.programming.literate Newsgroups line: comp.programming.literate Literate programs and programming tools. Votes must be received by 14 Sep 1993 23:59:59 GMT SPECIAL NOTE: Due to technical problems, dogwood.com was off the net >from Thursday morning through Saturday afternoon. Some votes may have been returned by your local system, please resend them! This vote is being conducted by a neutral third party. For voting questions only, contact [email protected] For questions about the proposed group, contact Matthias Neeracher <[email protected]>. A copy of this Call For Votes will be sent to [email protected] after the original Call For Votes appears in news.announce.newgroups. STANDARD VOTING INFO You should send MAIL (posts to a group are invalid) to [email protected] (just replying by MAIL to this message should work). Your mail message should contain one and only one of the following statements: I vote YES on comp.programming.literate or I vote NO on comp.programming.literate You may add a comment, but anything other than a definite statement involving the group name and "yes", "no", "for", or "against" on a single line may be rejected by the automatic vote counting program. If you later change your mind you may also use send in an "abstain" vote in the same manner, using "abstain" in place of "yes" or "no". Standard Guidelines for voting apply - one vote per person (not per account). 100 more YES votes than NO votes and 2/3 of all votes being YES are the requirements for group creation. Votes will be acknowledged by email; a list of bounced acknowledgements will be posted with the second Call For Votes. A mass acknowledgement will NOT be posted. You may inquire about the status of your vote by emailing the vote-taker ([email protected]). After the results have been announced a complete list of the votes will be posted in news.groups and will be mailed on request (email requests to [email protected]). The vote-taker can accept no responsibility for improperly configured mailers. CHARTER Charter: A forum for the discussion of issues related to literate programming. (1) To share ideas, questions, experiences, and knowledge about the reading and writing of literate programs. (2) To discuss the merits of the currently existing literate programming tools. (3) To discuss the design of new literate programming tools. If a newsgroup is created, it will be mirrored to the existing mailing list [email protected] For reference purposes, the newsgroup will be fully archived by the host sponsoring the mailing list. Background: What is Literate Programming? Literate programming is a programming technique invented by Donald. E. Knuth. A literate programming system can be characterized by the following properties: - The compilable program and the publishable documentation should be generated *automatically* from a *single* document. - The program can be presented in the order that is best for human understanding, regardless of any requirements of the programming language. - The program should be automatically indexed and cross-referenced. Knuth's original system, called WEB, generated Pascal code and a TeX documentation. Most tools relating to the TeX system have been written using WEB, and the TeX and Metafont programs have been published in book form. Today, there are Literate Programming systems for a wide range of programming languages and documentation systems. Specialized Literate Programming tools have been written for Ada, Awk, C, C++, Fortran, Modula-2, Modula-3, Pascal and Scheme, and generic tools exist that can generate almost any programming language (including Perl and sh). Documentation systems supported include TeX, Troff, and Word for Windows. "BOUNCED" ACKNOWLEDGEMENTS: none -- Dave Cornejo There is nothing so subtle Dogwood Media as the obvious Fremont, California From [email protected] Thu Sep 16 14:00:27 1993 Path: uunet!not-for-mail From: [email protected] Newsgroups: news.announce.newgroups,news.groups,comp.programming,comp.text.tex,comp.lang.misc,comp.software-eng,comp.lang.c,comp.lang.c++,comp.lang.pascal,comp.lang.fortran Subject: RESULT: comp.programming.literate passes 354:31 Supersedes: <[email protected]> Followup-To: poster Date: 16 Sep 1993 10:15:59 -0400 Organization: Usenet Volunteer Votetakers Lines: 447 Sender: [email protected] Approved: [email protected] Message-ID: <[email protected]> References: <[email protected]> NNTP-Posting-Host: rodan.uu.net Xref: uunet news.announce.newgroups:4056 news.groups:82042 comp.programming:6443 comp.text.tex:36780 comp.lang.misc:14117 comp.software-eng:16668 comp.lang.c:77752 comp.lang.c++:53579 comp.lang.pascal:24314 comp.lang.fortran:15770 comp.programming.literate group vote results - 385 votes Yes No : 2/3? >100? : Pass? : Group ---- ---- : ---- ----- : ----- : ------------------------------------------- 354 31 : Yes Yes : Yes : comp.programming.literate CHARTER Charter: A forum for the discussion of issues related to literate programming. (1) To share ideas, questions, experiences, and knowledge about the reading and writing of literate programs. (2) To discuss the merits of the currently existing literate programming tools. (3) To discuss the design of new literate programming tools. If a newsgroup is created, it will be mirrored to the existing mailing list [email protected] For reference purposes, the newsgroup will be fully archived by the host sponsoring the mailing list. Background: What is Literate Programming? Literate programming is a programming technique invented by Donald. E. Knuth. A literate programming system can be characterized by the following properties: - The compilable program and the publishable documentation should be generated *automatically* from a *single* document. - The program can be presented in the order that is best for human understanding, regardless of any requirements of the programming language. - The program should be automatically indexed and cross-referenced. Knuth's original system, called WEB, generated Pascal code and a TeX documentation. Most tools relating to the TeX system have been written using WEB, and the TeX and Metafont programs have been published in book form. Today, there are Literate Programming systems for a wide range of programming languages and documentation systems. Specialized Literate Programming tools have been written for Ada, Awk, C, C++, Fortran, Modula-2, Modula-3, Pascal and Scheme, and generic tools exist that can generate almost any programming language (including Perl and sh). Documentation systems supported include TeX, Troff, and Word for Windows. comp.programming.literate group vote Final Vote Ack Yes Votes ------------------------------------------------------------------------------ [email protected] (Ramesh Fernando) [email protected] (Aaron) [email protected] (Osman F Buyukisik) [email protected] (Joey Gibson) [email protected] [email protected] (Allan Klassen) [email protected] (Andre Lehovich) [email protected] (Alan Coopersmith) [email protected] (Anders Hallberg) [email protected] (Anders Lindstrom) [email protected] (Andreas Savva) [email protected] (Donald Arseneau) [email protected] (Andreas Schott) [email protected] (Bart Childs) [email protected] (George D. Greenwade) [email protected] [email protected] (Bo Frese Rasmussen) [email protected] (Bruce Holder) [email protected] (B.J. Herbison) [email protected] (Bill Jones) [email protected] (Alan Bleier) [email protected] (Peter G. Bouillon) [email protected] (Brad Clark) [email protected] (Brian Raven) [email protected] (Brent Benson) [email protected] (Brooks David Smith) [email protected] (Robert Blumen) [email protected] [email protected] (Beth Walker) [email protected] (Cameron Smith) [email protected] (Mark C. Carroll) [email protected] (Gary Casterline) [email protected] (Chuck D'Antonio) [email protected] (Chris Flatters) [email protected] (Roger Chaplin) [email protected] (Darrah Chavey) [email protected] (Po Shan Cheah) [email protected] (Chua Hak Lien) [email protected] [email protected] (Jon B. Weygandt) [email protected] (INFUHRER) [email protected] (Cory L. Scott) [email protected] (Ben Combee) [email protected] (Conrado) [email protected] (Craig Groeschel) [email protected] [email protected] (Curtis Johnson 619-597-3808) [email protected] (Douglas Nunn) [email protected] (Dave Love) [email protected] [email protected] (David Middleton) [email protected] [email protected] [email protected] (Dan Haugland) [email protected] [email protected] (Dave Searle) [email protected] [email protected] (David Matos) [email protected] (David Pascoe) [email protected] (Bill Davidsen) [email protected] (Bill Davies) [email protected] [email protected] (Donald Baker) [email protected] (Dave Barton (visitor)) [email protected] [email protected] (Daniel F Dickinson) [email protected] (Dominique de Waleffe) [email protected] (Dean Edwards) [email protected] (Christine Detig) [email protected] (Dipankar Gupta) [email protected] (David Gould) [email protected] (David G Freudenstein) [email protected] (Richard Wood) [email protected]c.dk (Soeren L. Dittmer) [email protected] (Dmitry S. Kohmanyuk) [email protected] (Stephan Bechtolsheim) [email protected] (David M. Jones) [email protected] (Duncan Murdoch) [email protected] (Dorai Sitaram) [email protected] [email protected] (David Sims) DVERRIER%[email protected] (D. Verrier) [email protected] (David Vincent) [email protected] (Mickey Williams 66753) [email protected] [email protected] (Edward Reid) [email protected] (R.S. Wail) [email protected] (Erik Ernst) [email protected] (Gunnar Ekolin) [email protected] (Ed McGuire) [email protected] (Eamonn McManus) [email protected] (Eric S Johansson) [email protected] (E. Troelsen og N.E. Oestergaard (930201#HHL)) [email protected] [email protected] (Francisco Figueirido) [email protected] (Frank Jensen) [email protected] (Frank Copeland) [email protected] (Mike Frame) [email protected] (Frank Dabelstein) [email protected] (Wolfgang Franke) [email protected] [email protected] [email protected] (Martin Gebhardt) [email protected] (Markus Geltz) [email protected] (Gene Ouye) [email protected] (john hoebing) [email protected] (charles fiterman) [email protected] (phil leone) [email protected] (Geoffrey Leach) [email protected] [email protected] [email protected] (Gil Hauer - OpCom Consultant) [email protected] (Glenn Pittenger) [email protected] (Glenn L Vanderburg -- Personal Account) [email protected] [email protected] (Achim Gratz) [email protected] (Greenfie) [email protected] (Klaus Guntermann) [email protected] (Soh Kam Hung) [email protected] [email protected] (Paul Hardwick) [email protected] [email protected] (Stephan Heilmayr) [email protected] (Henri Faber) [email protected] (Jim Hetrick) [email protected] (Hans-Hermann Bode) [email protected] (Drs. H.J. Kooy Jr.) [email protected] (Jerry C. Hudgins) [email protected] (Larry Hughes) [email protected] (Humberto Ortiz Zuazaga) [email protected] [email protected] (hzhu) [email protected] (Ian Cargill) [email protected] (Ilan Cohen) [email protected] (Ingo T. Storm) [email protected] (Ian Foster) [email protected] [email protected] (Jan Sandquist) [email protected] (Joan Boorstein) [email protected] [email protected] (Boris Jeremic) [email protected] (Jerry Wilcox) [email protected] (J. Eric Townsend) [email protected] [email protected] (Jon Krom) [email protected] [email protected] [email protected] (John Kim) [email protected] (John Hughes) [email protected] (Joshua D. Juran) [email protected] (John K Nicoll) [email protected] (Johannes MULLER p73413) [email protected] (Joe "AmigaMan" Gonzalez) [email protected] (J. Theuerkauf) [email protected] (John D. Mitchell) [email protected] (John Marshall) [email protected] (Joseph Reynolds) [email protected] (Joseph Hall) [email protected] (Jost Krieger) jq%[email protected] (Jim Quick) [email protected] (Jim Van Zandt) [email protected] (Joseph Romanovsky) [email protected] (Jack Sharer) [email protected] (Kaelin Colclasure) [email protected] (Wolfram Kahl) [email protected] (Dietrich Kappe) [email protected] (Charles Karney) [email protected] (Kayvan Sylvan) [email protected] [email protected] (Klaus Didrich) [email protected] (Klaus Dahlenburg) [email protected] (Ken Holmberg) [email protected] (Brian M Kennedy) [email protected] (Maurice van Keulen) [email protected] (Kevin Mitchell) [email protected] (Kjeld H|yer Mortensen) [email protected] (Evan Kirshenbaum) kmb%[email protected] (Kai M. Becker) [email protected] (Chad Knudson) [email protected] (mark anthony kolesar) [email protected] (Michael G. Koopman) [email protected] (Kell Orhoj) [email protected] (John Krommes) [email protected] (Kurt Jung) [email protected] (Martin Schr"oder) [email protected] (BARTHOLDI Laurent) [email protected] (Lee Crites) [email protected] (Silvio Levy) [email protected] (Klaus Lichtenwalder) [email protected] (Stephen W. Liddle) [email protected] (Anselm Lingnau) [email protected] (Linh Minh Hong Dang) [email protected] (Andrew Y Ng) [email protected] (Donald A. Lobo) [email protected] (Georg Lokowandt) [email protected] (Nathan Loofbourrow) [email protected] (Tuomas J Lukka) [email protected] (Christian Lynbech) [email protected] (Vincent Manis) [email protected] (Jun Hong) [email protected] (Marcus Speh) [email protected] (Mario Groleau) [email protected] (Mark R. Friedman) [email protected] (Mark Toleman) [email protected] (Martin Paul) [email protected] (Martin Kneissl) [email protected] (Chris Maxwell) [email protected] (Maya Biersack) [email protected] (Marcus Brown) [email protected] (Cesare Feroldi De Rosa) [email protected] (John D McCalpin) [email protected] (mckearney_s) [email protected] (Mark Meuer) [email protected] (Dr. Laurence Leff) [email protected] (Mike Yoder) [email protected] (Marc G. Frank) [email protected] [email protected] (Mike Vevea) [email protected] (Mike Bates) [email protected] (Michael Mueller) [email protected] (Mark-Jason Dominus) [email protected] (Mike McGary) [email protected] (Rick Morneau) [email protected] (Michel Olagnon) [email protected] (Mohan Sodhi) [email protected] [email protected] (David Muir Sharnoff) [email protected] (Brian Murray) [email protected] (Matthias Neeracher) [email protected] (Nancy Munoz) [email protected] (Norman Ramsey) [email protected] [email protected] (Thorsten Ohl) [email protected] (Ole Robert Hestvik) [email protected] (Mark Orton) [email protected] (Louis Glassy) [email protected] (Ozan S. Yigit) [email protected] (David L. Finley) [email protected] (Paul Palmer) [email protected] (Torsten Klein) [email protected] (Patrick Mann) [email protected] [email protected] [email protected] [email protected] [email protected] (Paul Lyon) [email protected] (Andrew Peed) [email protected] (Ron Peierls) [email protected] (Petri M Riihikallio) [email protected] (Lewis Perin) [email protected] (Donald N. Petcher) [email protected] [email protected] (Peter Johnson) [email protected] (James Petts) [email protected] (Paul E. Hoffman) [email protected] [email protected] [email protected] (Preston Briggs) [email protected] [email protected] (Michael J. Quinn) [email protected] (Rafael Laboissiere) [email protected] (Ralph Santos) [email protected] (Ralph Betschko) [email protected] (Thorbjoern Ravn Andersen) [email protected] [email protected] (Richard Walker) [email protected] (Richard Jennings) [email protected] (Richard H. Miller) [email protected] [email protected] [email protected] (Bob Dowling) [email protected] (Richard Lewis Jones) [email protected] (Rowan Limb) [email protected] (Randall Raemon (Contractor)) [email protected] (Rob Duncan) [email protected] (Robert Klaffl) [email protected] (Edward M. Robinson) [email protected] (Robert Shillingsburg) [email protected] (Roger Browne) [email protected] (Ronald Koster) [email protected] (TARDIS Console) [email protected] (Neil Rowe) [email protected] [email protected] (Robert T. Raschke) [email protected] (Ryan Bayne) [email protected] [email protected] [email protected] (Alon Ziv) [email protected] (Sanjeev Y. Dharap) [email protected] (Bruce Tindall) [email protected] (Sean Boyle x1542) [email protected] (Steven M Casburn) [email protected] (Dirk Schroetter) [email protected] (Jonas Schlein (CMSC/MATH)) [email protected] (Joachim Schrod) [email protected] (Edmund Schweppe) [email protected] (Steve Rogers) [email protected] (Christophe Debou) [email protected] (Norbert Fuchs) [email protected] (Helga Haug) [email protected] (Michael Haux) [email protected] (Franz Hofer) [email protected] (Stefan Jungmayr) [email protected] (Jaroslav Liptak) [email protected] (Marco Mulazzani) [email protected] (Karl-Heinz Weidmann) [email protected] (Sharon Peleg) [email protected] (Gary Shea) [email protected] [email protected] (Simon Kershaw) [email protected] [email protected] (Rich Skrenta) [email protected] (Wojtek Skulski, LBL phone: (510) 486 7791) [email protected] (Soumyabrata Bhattacharya) [email protected] (Frank Sperry) [email protected] (Stan Rifkin) [email protected] (Steve Roy) [email protected] [email protected] (Stephan Eggermont) [email protected] (Steve Coltrin) [email protected] (Steven Huggins) [email protected] (Christopher A. Stone) [email protected] (Stu Labovitz) [email protected] (Dan Sullivan) [email protected] (Sven Utcke) [email protected] (David Reeve Sward) [email protected] (Sascha Wildner) [email protected] (synergy) [email protected] (The Doctor) [email protected] (Tom Zych) [email protected] (Taylor Hutt) [email protected] [email protected] [email protected] (Terry "Tebster" O'Neill) [email protected] [email protected] (Thomas Treml) [email protected] (Detlef Lannert) U35395%[email protected] (C. M. Sperberg-McQueen) [email protected] (Timothy Connal Delaney) [email protected] (Brent D. Beach) [email protected] (Ulrich Hoffmann) [email protected] (Uwe Kloss) [email protected] (Venu Dasigi) [email protected] [email protected] (Ulrik Vieth) [email protected] (Vince Mehringer) [email protected] (Eelco Visser) [email protected] [email protected] (Contr Karl Vogel) [email protected] [email protected] (homo obsolescensis) [email protected] (Gerard Zwaan) [email protected] (J. D. Yeager) [email protected] (Joachim Ziegler) No Votes ------------------------------------------------------------------------------ [email protected] (Andrew Dobrowolski) [email protected] (Rob Beezer) [email protected] (Mary Bos) [email protected] (Les) [email protected] (Chris Marble) [email protected] (THOMAS COLLINS) [email protected] (Christopher Ward) [email protected] (Eric Scharff) [email protected] (Eric J. Olson) [email protected] (Hardcore Alaskan) [email protected] (Basalat Ali Raja) [email protected] (Herb M. Petro) [email protected] [email protected] (Jonathan Wilson) [email protected] (Julian Macassey) [email protected] (Phil Julian) [email protected] (M Afzal) [email protected] (Manuel Carriba) [email protected] (MCCOLLUM DAVID SCOTT) [email protected] (Bert Medley) [email protected] (Martin Nisshagen) [email protected] [email protected] (Pete Su) [email protected] (\"Sendhil \"Mr. Bubbles\" Revuluri\") [email protected] (Roman Symank) [email protected] (Smarasderagd Draco) [email protected] (Steve Rogers) [email protected] [email protected] (Timothy Murphy) [email protected] [email protected] (John MacWilliamson) -- Dave Cornejo There is nothing so subtle Dogwood Media as the obvious Fremont, California From [email protected] Fri Dec 20 18:28:41 1996 Path: uunet!bounce-back From: Norman Ramsey <[email protected]> Newsgroups: news.announce.newgroups,news.groups,comp.programming.literate,comp.programming Subject: RFD: moderate comp.programming.literate Followup-To: news.groups Date: 20 Dec 1996 23:28:30 -0000 Organization: . Lines: 168 Sender: [email protected] Approved: [email protected] Message-ID: <[email protected]> NNTP-Posting-Host: rodan.uu.net Archive-Name: comp.programming.literate Xref: uunet news.announce.newgroups:9455 news.groups:244389 comp.programming.literate:3863 comp.programming:38171 REQUEST FOR DISCUSSION (RFD) moderated group comp.programming.literate (moderates existing group) This is a formal Request For Discussion (RFD) to moderate the world-wide unmoderated Usenet newsgroup comp.programming.literate. This is not a Call for Votes (CFV); you cannot vote at this time. Procedural details are below. Newsgroup lines: comp.programming.literate Literate programming and LP tools. (Moderated) RATIONALE: comp.programming.literate The newsgroup comp.programming.literate was voted into existence in September 1993, with charter substantially identical to that given below. The title of the newsgroup has led many people to assume that the newsgroup exists to provide general ``programming literacy.'' As a result, traffic on the newsgroup is of two separate types that clearly don't belong together: - discussions of literate programming - requests for help and other questions for people who are presumably ``programming literate'' Some people estimate that three-quarters of posts to comp.programming.literate are for general programming help. According to the charter of the group, these posts are off topic. On 12 Dec 1996 at the University of Virginia news server, 13 threads were off-topic, 7 were discussing literate programming, and 2 were discussing how to reduce the number of off-topic posts. The proposal is to moderate comp.programming.literate, so it can be reserved for discussions of literate programming. General programming questions will revert to comp.programming or to the many other newsgroups to which they are often cross-posted. CHARTER: comp.programming.literate A forum for the discussion of literate programming. (1) To share ideas, questions, experiences, and knowledge about the reading and writing of literate programs or more generally the presentation of code for human readers (e.g., prettyprinting). (2) To discuss the merits of the currently existing literate- programming and related tools. (3) To discuss the design of new literate-programming and related tools. Moderation Policies: Any posting that bears a plausible relationship to literate programming is welcome. For example, discussion may include techniques for prettyprinting code or other techniques for documenting design or code. Advertising of tools or services related to literate programming (e.g., offers to review programs for pay) is considered acceptable. Other advertising is unacceptable. Background: The rest of this section presents some background information to help people identify what topics are related to literate programming. In an article published in _The Computer Journal_ 27 (1984), 97-111, Donald E. Knuth proposed a "literate" programming style: I believe that the time is ripe for significantly better documentation of programs, and that we can best achieve this by considering programs to be works of literature. Hence, my title: "Literate Programming." Let us change our traditional attitude to the construction of programs: Instead of imagining that our main task is to instruct a *computer* what to do, let us concentrate rather on explaining to *human beings* what we want a computer to do. The practitioner of literate programming can be regarded as an essayist, whose main concern is with exposition and excellence of style. Such an author, with thesaurus in hand, chooses the names of variables carefully and explains what each variable means. He or she strives for a program that is comprehensible because its concepts have been introduced in an order that is best for human understanding, using a mixture of formal and informal methods that reinforce each other. There is reasonable (but not unanimous) consensus that a literate-programming system can be characterized by the following properties: - The compilable program and the publishable documentation should be generated *automatically* from a *single* source. - The program can be presented in the order that is best for human understanding, regardless of any requirements of the programming language. - The program should be automatically indexed and cross-referenced. - The program may be formatted or prettyprinted in a way that makes it especially readable. Existing literate-programming systems support a wide range of programming languages and documentation systems. Specialized tools have been written for Ada, Awk, C, C++, Fortran, Modula-2, Modula-3, Pascal and Scheme, and there are language-independent tools exist that support almost any programming language (including Perl, sh, and make). Documentation systems supported include HTML, TeX, Troff, and Word for Windows. END CHARTER. MODERATOR INFO: comp.programming.literate Moderator: David Fox <[email protected]> Moderator: Marc van Leeuwen <[email protected]> Moderator: Mary Bos <[email protected]> Moderator: Matthias Neeracher <[email protected]> Moderator: Michael Norrish <[email protected]> Moderator: Norman Ramsey <[email protected]> Moderator: Patrick TJ McPhee <[email protected]> These moderators were chosen more or less at random from a pool of 14 volunteers. Many are long-time participants in comp.programming.literate, and some have made major contributions to the literate-programming community. All are easily capable of identifying off-topic posts. The group intends to use the robo-moderation software described at http://www.algebra.com/~ichudov/usenet/scrm/robomod/robomod.html It is anticipated that volunteers will rotate into and out of the group approximately every six months. END MODERATOR INFO. PROCEDURE: This is a request for discussion, not a call for votes. In this phase of the process, any potential problems with the proposed newsgroups should be raised and resolved. The discussion period will continue for a minimum of 21 days (starting from when the first RFD for this proposal is posted to news.announce.newgroups), after which a Call For Votes (CFV) may be posted by a neutral vote taker if the discussion warrants it. Please do not attempt to vote until this happens. All discussion of this proposal should be posted to news.groups. This RFD attempts to comply fully with the Usenet newsgroup creation guidelines outlined in "How to Create a New Usenet Newsgroup" and "How to Format and Submit a New Group Proposal". Please refer to these documents (available in news.announce.newgroups) if you have any questions about the process. DISTRIBUTION: news.announce.newgroups news.groups comp.programming.literate comp.programming [email protected] (subscription requests to [email protected]) Proponent: Norman Ramsey <[email protected]> -- Norman Ramsey http://www.cs.virginia.edu/~nr From [email protected] Tue Feb 18 14:28:03 1997 Path: news.isc.org!bounce-back From: [email protected] (Jim Davis) Newsgroups: news.announce.newgroups,news.groups,comp.programming,comp.programming.literate Subject: CFV: moderate comp.programming.literate Followup-To: poster Message-ID: <[email protected]> Organization: Usenet Volunteer Votetakers, Ska Revival branch. Approved: [email protected] Expires: 12 Mar 1997 00:00:00 GMT Archive-Name: comp.programming.literate Date: Tue, 18 Feb 1997 22:21:31 GMT Lines: 200 Xref: news.isc.org news.announce.newgroups:52 FIRST CALL FOR VOTES (of 2) moderated group comp.programming.literate (moderates existing group) Newsgroup line: comp.programming.literate Literate programming and LP tools. (Moderated) Votes must be received by 23:59:59 UTC, 11 Mar 1997. This vote is being conducted by a neutral third party. Direct questions about the proposed group to the proponent. Proponent: Norman Ramsey <[email protected]> Mentor: Jonathan Grobe <[email protected]> Votetaker: Jim Davis <[email protected]> RATIONALE: comp.programming.literate The newsgroup comp.programming.literate was voted into existence in September 1993, with charter substantially identical to that given below. The title of the newsgroup has led many people to assume that the newsgroup exists to provide general ``programming literacy.'' As a result, traffic on the newsgroup is of two separate types that clearly don't belong together: - discussions of literate programming - requests for help and other questions for people who are presumably ``programming literate'' Some people estimate that three-quarters of posts to comp.programming.literate are for general programming help. According to the charter of the group, these posts are off topic. On 12 Dec 1996 at the University of Virginia news server, 13 threads were off-topic, 7 were discussing literate programming, and 2 were discussing how to reduce the number of off-topic posts. The proposal is to moderate comp.programming.literate, so it can be reserved for discussions of literate programming. General programming questions will revert to comp..programming or to the many other newsgroups to which they are often cross-posted. CHARTER: comp.programming.literate A forum for the discussion of literate programming. (1) To share ideas, questions, experiences, and knowledge about the reading and writing of literate programs or more generally the presentation of code for human readers (e.g., prettyprinting). (2) To discuss the merits of the currently existing literate- programming and related tools. (3) To discuss the design of new literate-programming and related tools. Moderation Policies: Any posting that bears a plausible relationship to literate programming is welcome. For example, discussion may include techniques for prettyprinting code or other techniques for documenting design or code. Advertising of tools or services related to literate programming (e.g., offers to review programs for pay) is considered acceptable. Other advertising is unacceptable. Moderation will primarily be automatic, by robo-moderator. Submissions from regular contributors will be accepted immediately, without human intervention. The human moderators will examine other submissions; any submission that conforms to the newsgroup charter will be accepted, and the person making the submission will be added to the list of regular contributors (whose posts are automatically accepted). In the unlikely event that a regular contributor sends a number of off-topic posts, that person will be notified by a moderator and removed from the list of regular contributors. The exact number of such posts required to trigger this action is left to the good judgement of the moderators. The moderators will continue to accept on-topic posts from such persons; no person is ever to be prohibited from posting articles deemed acceptable under this charter. Background: The rest of this section presents some background information to help people identify what topics are related to literate programming. In an article published in _The Computer Journal_ 27 (1984), 97-111, Donald E. Knuth proposed a "literate" programming style: I believe that the time is ripe for significantly better documentation of programs, and that we can best achieve this by considering programs to be works of literature. Hence, my title: "Literate Programming." Let us change our traditional attitude to the construction of programs: Instead of imagining that our main task is to instruct a *computer* what to do, let us concentrate rather on explaining to *human beings* what we want a computer to do. The practitioner of literate programming can be regarded as an essayist, whose main concern is with exposition and excellence of style. Such an author, with thesaurus in hand, chooses the names of variables carefully and explains what each variable means. He or she strives for a program that is comprehensible because its concepts have been introduced in an order that is best for human understanding, using a mixture of formal and informal methods that reinforce each other. There is reasonable (but not unanimous) consensus that a literate-programming system can be characterized by the following properties: - The compilable program and the publishable documentation should be generated *automatically* from a *single* source. - The program can be presented in the order that is best for human understanding, regardless of any requirements of the programming language. - The program should be automatically indexed and cross-referenced. - The program may be formatted or prettyprinted in a way that makes it especially readable. Existing literate-programming systems support a wide range of programming languages and documentation systems. Specialized tools have been written for Ada, Awk, C, C++, Fortran, Modula-2, Modula-3, Pascal and Scheme, and there are language-independent tools exist that support almost any programming language (including Perl, sh, and make). Documentation systems supported include HTML, TeX, Troff, and Word for Windows. END CHARTER. MODERATOR INFO: comp.programming.literate Moderator: David Fox <[email protected]> Moderator: Marc van Leeuwen <[email protected]> Moderator: Mary Bos <[email protected]> Moderator: Matthias Neeracher <[email protected]> Moderator: Michael Norrish <[email protected]> Moderator: Norman Ramsey <[email protected]> Moderator: Patrick TJ McPhee <[email protected]> Administrative contact address: [email protected] Article submission address: [email protected] These moderators were chosen more or less at random from a pool of 14 volunteers. Many are long-time participants in comp.programming.literate, and some have made major contributions to the literate-programming community. All are easily capable of identifying off-topic posts. The group intends to use the robo-moderation software described at http://www.algebra.com/~ichudov/usenet/scrm/robomod/robomod.html It is anticipated that volunteers will rotate into and out of the group approximately every six months. END MODERATOR INFO. HOW TO VOTE: Send email to: [email protected] Your email message should contain one and only one of the following statements: I vote YES on comp.programming.literate I vote NO on comp.programming.literate You may also vote ABSTAIN or CANCEL. ABSTAIN does not affect the final vote count in any way but is listed in the final voting results. CANCEL removes any earlier vote and is not listed in the final voting results. VOTING PROCEDURE NOTES: Standard Guidelines for voting apply. One account per person and one vote per person. Votes must be mailed directly from the voter to the votetaker. Anonymous, forwarded or proxy votes are not valid; this includes votes generated by WWW/HTML/CGI forms. Vote counting is automated: If you don't follow these directions then your vote may not get counted. If you do not receive an acknowledgment of your vote within several days, contact the votetaker about the problem. It's your responsibility to make sure that your vote is registered correctly. Duplicate votes are resolved in favor of the most recent valid vote. Addresses and votes of all voters will be published in the final voting results post. The purpose of a Usenet vote is to determine the genuine interest in people who would read a proposed newsgroup. Soliciting votes from disinterested people defeats this purpose. Please do not redistribute this CFV. If you must, direct people to the official CFV as posted to news.announce.newgroups. Distributing pre-marked or otherwise edited copies of this CFV will result in those votes being cancelled. When in doubt, ask the votetaker. DISTRIBUTION: This CFV has been crossposted to comp.programming comp.programming.literate From [email protected] Sat Mar 1 12:04:39 1997 Path: news.isc.org!bounce-back From: [email protected] (Jim Davis) Newsgroups: news.announce.newgroups,news.groups,comp.programming,comp.programming.literate Subject: 2nd CFV: moderate comp.programming.literate Followup-To: poster Message-ID: <[email protected]> Supersedes: <[email protected]> Organization: Usenet Volunteer Votetakers, Ska Revival branch. Approved: [email protected] Expires: 12 Mar 1997 00:00:00 GMT Archive-Name: comp.programming.literate Date: Sat, 01 Mar 1997 19:46:00 GMT Lines: 205 Xref: news.isc.org news.announce.newgroups:126 LAST CALL FOR VOTES (of 2) moderated group comp.programming.literate (moderates existing group) Newsgroup line: comp.programming.literate Literate programming and LP tools. (Moderated) Votes must be received by 23:59:59 UTC, 11 Mar 1997. This vote is being conducted by a neutral third party. Direct questions about the proposed group to the proponent. Proponent: Norman Ramsey <[email protected]> Mentor: Jonathan Grobe <[email protected]> Votetaker: Jim Davis <[email protected]> RATIONALE: comp.programming.literate The newsgroup comp.programming.literate was voted into existence in September 1993, with charter substantially identical to that given below. The title of the newsgroup has led many people to assume that the newsgroup exists to provide general ``programming literacy.'' As a result, traffic on the newsgroup is of two separate types that clearly don't belong together: - discussions of literate programming - requests for help and other questions for people who are presumably ``programming literate'' Some people estimate that three-quarters of posts to comp.programming.literate are for general programming help. According to the charter of the group, these posts are off topic. On 12 Dec 1996 at the University of Virginia news server, 13 threads were off-topic, 7 were discussing literate programming, and 2 were discussing how to reduce the number of off-topic posts. The proposal is to moderate comp.programming.literate, so it can be reserved for discussions of literate programming. General programming questions will revert to comp..programming or to the many other newsgroups to which they are often cross-posted. CHARTER: comp.programming.literate A forum for the discussion of literate programming. (1) To share ideas, questions, experiences, and knowledge about the reading and writing of literate programs or more generally the presentation of code for human readers (e.g., prettyprinting). (2) To discuss the merits of the currently existing literate- programming and related tools. (3) To discuss the design of new literate-programming and related tools. Moderation Policies: Any posting that bears a plausible relationship to literate programming is welcome. For example, discussion may include techniques for prettyprinting code or other techniques for documenting design or code. Advertising of tools or services related to literate programming (e.g., offers to review programs for pay) is considered acceptable. Other advertising is unacceptable. Moderation will primarily be automatic, by robo-moderator. Submissions from regular contributors will be accepted immediately, without human intervention. The human moderators will examine other submissions; any submission that conforms to the newsgroup charter will be accepted, and the person making the submission will be added to the list of regular contributors (whose posts are automatically accepted). In the unlikely event that a regular contributor sends a number of off-topic posts, that person will be notified by a moderator and removed from the list of regular contributors. The exact number of such posts required to trigger this action is left to the good judgement of the moderators. The moderators will continue to accept on-topic posts from such persons; no person is ever to be prohibited from posting articles deemed acceptable under this charter. Background: The rest of this section presents some background information to help people identify what topics are related to literate programming. In an article published in _The Computer Journal_ 27 (1984), 97-111, Donald E. Knuth proposed a "literate" programming style: I believe that the time is ripe for significantly better documentation of programs, and that we can best achieve this by considering programs to be works of literature. Hence, my title: "Literate Programming." Let us change our traditional attitude to the construction of programs: Instead of imagining that our main task is to instruct a *computer* what to do, let us concentrate rather on explaining to *human beings* what we want a computer to do. The practitioner of literate programming can be regarded as an essayist, whose main concern is with exposition and excellence of style. Such an author, with thesaurus in hand, chooses the names of variables carefully and explains what each variable means. He or she strives for a program that is comprehensible because its concepts have been introduced in an order that is best for human understanding, using a mixture of formal and informal methods that reinforce each other. There is reasonable (but not unanimous) consensus that a literate-programming system can be characterized by the following properties: - The compilable program and the publishable documentation should be generated *automatically* from a *single* source. - The program can be presented in the order that is best for human understanding, regardless of any requirements of the programming language. - The program should be automatically indexed and cross-referenced. - The program may be formatted or prettyprinted in a way that makes it especially readable. Existing literate-programming systems support a wide range of programming languages and documentation systems. Specialized tools have been written for Ada, Awk, C, C++, Fortran, Modula-2, Modula-3, Pascal and Scheme, and there are language-independent tools exist that support almost any programming language (including Perl, sh, and make). Documentation systems supported include HTML, TeX, Troff, and Word for Windows. END CHARTER. MODERATOR INFO: comp.programming.literate Moderator: David Fox <[email protected]> Moderator: Marc van Leeuwen <[email protected]> Moderator: Mary Bos <[email protected]> Moderator: Matthias Neeracher <[email protected]> Moderator: Michael Norrish <[email protected]> Moderator: Norman Ramsey <[email protected]> Moderator: Patrick TJ McPhee <[email protected]> Administrative contact address: [email protected] Article submission address: [email protected] These moderators were chosen more or less at random from a pool of 14 volunteers. Many are long-time participants in comp.programming.literate, and some have made major contributions to the literate-programming community. All are easily capable of identifying off-topic posts. The group intends to use the robo-moderation software described at http://www.algebra.com/~ichudov/usenet/scrm/robomod/robomod.html It is anticipated that volunteers will rotate into and out of the group approximately every six months. END MODERATOR INFO. HOW TO VOTE: Send email to: [email protected] Your email message should contain one and only one of the following statements: I vote YES on comp.programming.literate I vote NO on comp.programming.literate You may also vote ABSTAIN or CANCEL. ABSTAIN does not affect the final vote count in any way but is listed in the final voting results. CANCEL removes any earlier vote and is not listed in the final voting results. VOTING PROCEDURE NOTES: Standard Guidelines for voting apply. One account per person and one vote per person. Votes must be mailed directly from the voter to the votetaker. Anonymous, forwarded or proxy votes are not valid; this includes votes generated by WWW/HTML/CGI forms. Vote counting is automated: If you don't follow these directions then your vote may not get counted. If you do not receive an acknowledgment of your vote within several days, contact the votetaker about the problem. It's your responsibility to make sure that your vote is registered correctly. Duplicate votes are resolved in favor of the most recent valid vote. Addresses and votes of all voters will be published in the final voting results post. The purpose of a Usenet vote is to determine the genuine interest in people who would read a proposed newsgroup. Soliciting votes from disinterested people defeats this purpose. Please do not redistribute this CFV. If you must, direct people to the official CFV as posted to news.announce.newgroups. Distributing pre-marked or otherwise edited copies of this CFV will result in those votes being cancelled. When in doubt, ask the votetaker. DISTRIBUTION: This CFV has been crossposted to comp.programming comp.programming.literate comp.programming.literate Bounce List - No need to revote ------------------------------------------------------------------------------ [email protected] Beirne Konarski [email protected] add "rabbit" to Subject: line to override spamgard{tm} From [email protected] Tue Mar 11 17:30:14 1997 Path: news.isc.org!bounce-back From: [email protected] (Jim Davis) Newsgroups: news.announce.newgroups,news.groups,comp.programming,comp.programming.literate Subject: RESULT: comp.programming.literate passes 227:14 Followup-To: news.groups Message-ID: <[email protected]> Supersedes: <[email protected]> Organization: Usenet Volunteer Votetakers, Ska Revival branch. Approved: [email protected] Archive-Name: comp.programming.literate Date: Wed, 12 Mar 1997 01:29:14 GMT Lines: 419 Xref: news.isc.org news.announce.newgroups:164 RESULT moderated group comp.programming.literate passes 227:14 There were 227 YES votes and 14 NO votes, for a total of 241 valid votes. There was 1 abstain. For group passage, YES votes must be at least 2/3 of all valid (YES and NO) votes. There also must be at least 100 more YES votes than NO votes. There is a five day discussion period after these results are posted. If no serious allegations of voting irregularities are raised, the moderator of news.announce.newgroups will create the group shortly thereafter. comp.programming.literate passed on Thu Feb 20 05:58:12 1997. Newsgroup line: comp.programming.literate Literate programming and LP tools. (Moderated) This vote was conducted by a neutral third party. Direct questions about the proposed group to the proponent. Proponent: Norman Ramsey <[email protected]> Mentor: Jonathan Grobe <[email protected]> Votetaker: Jim Davis <[email protected]> RATIONALE: comp.programming.literate The newsgroup comp.programming.literate was voted into existence in September 1993, with charter substantially identical to that given below. The title of the newsgroup has led many people to assume that the newsgroup exists to provide general ``programming literacy.'' As a result, traffic on the newsgroup is of two separate types that clearly don't belong together: - discussions of literate programming - requests for help and other questions for people who are presumably ``programming literate'' Some people estimate that three-quarters of posts to comp.programming.literate are for general programming help. According to the charter of the group, these posts are off topic. On 12 Dec 1996 at the University of Virginia news server, 13 threads were off-topic, 7 were discussing literate programming, and 2 were discussing how to reduce the number of off-topic posts. The proposal is to moderate comp.programming.literate, so it can be reserved for discussions of literate programming. General programming questions will revert to comp..programming or to the many other newsgroups to which they are often cross-posted. CHARTER: comp.programming.literate A forum for the discussion of literate programming. (1) To share ideas, questions, experiences, and knowledge about the reading and writing of literate programs or more generally the presentation of code for human readers (e.g., prettyprinting). (2) To discuss the merits of the currently existing literate- programming and related tools. (3) To discuss the design of new literate-programming and related tools. Moderation Policies: Any posting that bears a plausible relationship to literate programming is welcome. For example, discussion may include techniques for prettyprinting code or other techniques for documenting design or code. Advertising of tools or services related to literate programming (e.g., offers to review programs for pay) is considered acceptable. Other advertising is unacceptable. Moderation will primarily be automatic, by robo-moderator. Submissions from regular contributors will be accepted immediately, without human intervention. The human moderators will examine other submissions; any submission that conforms to the newsgroup charter will be accepted, and the person making the submission will be added to the list of regular contributors (whose posts are automatically accepted). In the unlikely event that a regular contributor sends a number of off-topic posts, that person will be notified by a moderator and removed from the list of regular contributors. The exact number of such posts required to trigger this action is left to the good judgement of the moderators. The moderators will continue to accept on-topic posts from such persons; no person is ever to be prohibited from posting articles deemed acceptable under this charter. Background: The rest of this section presents some background information to help people identify what topics are related to literate programming. In an article published in _The Computer Journal_ 27 (1984), 97-111, Donald E. Knuth proposed a "literate" programming style: I believe that the time is ripe for significantly better documentation of programs, and that we can best achieve this by considering programs to be works of literature. Hence, my title: "Literate Programming." Let us change our traditional attitude to the construction of programs: Instead of imagining that our main task is to instruct a *computer* what to do, let us concentrate rather on explaining to *human beings* what we want a computer to do. The practitioner of literate programming can be regarded as an essayist, whose main concern is with exposition and excellence of style. Such an author, with thesaurus in hand, chooses the names of variables carefully and explains what each variable means. He or she strives for a program that is comprehensible because its concepts have been introduced in an order that is best for human understanding, using a mixture of formal and informal methods that reinforce each other. There is reasonable (but not unanimous) consensus that a literate-programming system can be characterized by the following properties: - The compilable program and the publishable documentation should be generated *automatically* from a *single* source. - The program can be presented in the order that is best for human understanding, regardless of any requirements of the programming language. - The program should be automatically indexed and cross-referenced. - The program may be formatted or prettyprinted in a way that makes it especially readable. Existing literate-programming systems support a wide range of programming languages and documentation systems. Specialized tools have been written for Ada, Awk, C, C++, Fortran, Modula-2, Modula-3, Pascal and Scheme, and there are language-independent tools exist that support almost any programming language (including Perl, sh, and make). Documentation systems supported include HTML, TeX, Troff, and Word for Windows. END CHARTER. MODERATOR INFO: comp.programming.literate Moderator: David Fox <[email protected]> Moderator: Marc van Leeuwen <[email protected]> Moderator: Mary Bos <[email protected]> Moderator: Matthias Neeracher <[email protected]> Moderator: Michael Norrish <[email protected]> Moderator: Norman Ramsey <[email protected]> Moderator: Patrick TJ McPhee <[email protected]> Administrative contact address: [email protected] Article submission address: [email protected] These moderators were chosen more or less at random from a pool of 14 volunteers. Many are long-time participants in comp.programming.literate, and some have made major contributions to the literate-programming community. All are easily capable of identifying off-topic posts. The group intends to use the robo-moderation software described at http://www.algebra.com/~ichudov/usenet/scrm/robomod/robomod.html It is anticipated that volunteers will rotate into and out of the group approximately every six months. END MODERATOR INFO. comp.programming.literate Final Vote Ack Voted Yes ------------------------------------------------------------------------------ [email protected] Robert M. Muench [email protected] Tony Zimmer [email protected] Arthur Gold [email protected] Anthony Towns [email protected] John Hurst [email protected] Andrew Johnson [email protected] Alain Deckers [email protected] Alan Ralph [email protected] [email protected] Paolo Amoroso [email protected] Andy Latto [email protected] Apostolos Syropoulos [email protected] Stephanie da Silva [email protected] Arne Schirmacher [email protected] Arnim Herbig [email protected] Alexandre Valente Sousa [email protected] [email protected] Bill Robertson [email protected] Anthony Bailey [email protected] Barry Gaunt [email protected] Basile STARYNKEVITCH [email protected] Beirne Konarski [email protected] Benedikt Stockebrand [email protected] Aurelio Bignoli [email protected] Beauford Jones [email protected] Michael Brennan [email protected] Louis Bronne [email protected] David Bushnell [email protected] Chris P. Jobling [email protected] Brian Casiello [email protected] Cesar BALLARDINI [email protected] Charles Carroll [email protected] Dmitry I. Cherkasov [email protected] [email protected] Chun Yin Hsu [email protected] Chris Hendrie [email protected] Christopher Booth [email protected] Clark L. Coleman [email protected] C M Sperberg-McQueen [email protected] Michele Coleman [email protected] Craig Earls [email protected] Don Croyle [email protected] Andreas CART [email protected] Dave Love [email protected] David Kastrup [email protected] Daniel Rybowski [email protected] Daniel A. Shiel [email protected] David Carrington [email protected] David W. Crawford [email protected] David Dibben [email protected] Dominique de Waleffe [email protected] Jurgen Defurne [email protected] Daniele Degiorgi [email protected] Sven de Vries [email protected] Dan Schmidt [email protected] David Bruce [email protected] [email protected] [email protected] [email protected] David Wright [email protected] Bob Bechtel [email protected] Eric Prestemon [email protected] Ed Blachman [email protected] Ed Vandergriff [email protected] Paul Eggert [email protected] erik hilsdale [email protected] Tommy Ekola [email protected] Mike Elliott [email protected] Eric S. Johansson [email protected] Ekkehard Uthke [email protected] Frans F.J. Faase [email protected] Freddy Potargent [email protected] F Fiquet FUTSYS [email protected] Fred Oberhauser [email protected] Florian Weimer [email protected] Gavan Schneider [email protected] Gerardo Cisneros [email protected] Gerd Moellmann [email protected] Glenn Strong [email protected] Gerhard Gonter [email protected] Jacob Grydholt Jensen [email protected] Klaus Guntermann [email protected] Bjoern Labitzke [email protected] Michael and MJ Houghton [email protected] Jim Baranovich [email protected] Hans-Martin Mosner [email protected] Cord Hockemeyer [email protected] Samuel A Horwitz [email protected] Peter S. Housel [email protected] Hugh S. Myers [email protected] Irina Rempt [email protected] John Hamer [email protected] Kenneth Snyder [email protected] Joao Canas Ferreira [email protected] Cortis, John [email protected] [email protected] John David Galt [email protected] Jennifer Schwartz [email protected] Jesus Eugenio Sanchez [email protected] John Dallman [email protected] john meisell [email protected] J. Otto Tennant [email protected] Justin Cormack [email protected] J. Porter Clark [email protected] [email protected] Joseph S. D. Yao [email protected] Andy Finkenstadt [email protected] Kamilo [email protected] Kannan Varadhan [email protected] Stephen Dunhom [email protected] Kenneth S. Brittain [email protected] Roland Kaufmann [email protected] Kim DeVaughn [email protected] Axel Koehler [email protected] Bill Kossmann [email protected] Rafal Kowalski [email protected] Kragen Sittler [email protected] Lee Choquette [email protected] Lee Wittenberg [email protected] Arthur Lemmens [email protected] Jens Lippmann [email protected] Martin Schr"oder [email protected] Long Nguyen-Duc [email protected] Loris Bennett [email protected] Alexandre Lymberopoulos [email protected] Marc van Leeuwen [email protected] Michael Malak [email protected] Mark T. Gray [email protected] Martyn Williams [email protected] Mary Bos [email protected] Alex Matulich 03T1 [email protected] Andrew Mauer-Oats [email protected] Michael McHenry [email protected] Robert T. McLay [email protected] matt craig [email protected] Meyers Chuck [email protected] Mike Hatz [email protected] Michael Norrish [email protected] Michael T Decerbo [email protected] Corey Minyard [email protected] [email protected] Michael Cook [email protected] Matthew Hannigan [email protected] Markus Oellinger [email protected] Christian Weisgerber [email protected] Balasubramanian Narasimhan [email protected] Matthias Neeracher [email protected] Fco. J. Ballesteros [email protected] Ernesto Rico-Schmidt [email protected] Nick Waterman [email protected] Norman Ramsey [email protected] osman buyukisik [email protected] Trevor [email protected] Phil Bewig [email protected] Per I. Mathisen [email protected] Perry E. Metzger [email protected] [email protected] Peter Horan [email protected] Phil Boswell [email protected] Phil Hunt [email protected] Pierre Uszynski [email protected] [email protected] Michel [email protected] Scott Prahl [email protected] Patrick TJ McPhee [email protected] Philip W. Miller [email protected] Raphael Quinet [email protected] Rene Berber [email protected] Rogerio Brito [email protected] Dusty Reichwein [email protected] Remo Dentato [email protected] Richard Hutchinson [email protected] Richard H. Miller [email protected] Robert Raschke [email protected] Ollivier Robert [email protected] Steve Romanow [email protected] Ronnie Grant [email protected] Rich Salz [email protected] Gerardo Rubino [email protected] Ronald Hale-Evans [email protected] Sean Tregeagle [email protected] [email protected] [email protected] Reiner Schlotte [email protected] David & Kathleen Seidel [email protected] Sergei D. Petrov [email protected] Serge G. Kruk [email protected] Silvio Ranise [email protected] Simon Grant [email protected] Simon Williams [email protected] Simon Wright [email protected] Sudish Joseph [email protected] [email protected] David Harmon [email protected] Jason Sperber [email protected] Steve Furlong [email protected] Chris Stamper [email protected] stephen [email protected] Steve Peterson [email protected] A.R. & F.L. Scott-Thoennes [email protected] Stuart Yeates [email protected] Steven Garman [email protected] Thomas Preymesser [email protected] Ryan [email protected] [email protected] Daniel Victor Tausk [email protected] taweil [email protected] Matthias Hoelzl (tc) [email protected] F. Gaertner [email protected] Thetrekguy [email protected] G A Vignaux [email protected] Brian Danilko [email protected] Dr. Thomas Tensi [email protected] [email protected] Thomas Heft [email protected] Lars Jesper Riemer [email protected] Emil Volcheck [email protected] David Wald [email protected] Walter C. Pelissero [email protected] William Hesse [email protected] add "rabbit" to Subject: line to override spamgard{tm} [email protected] werner lemberg [email protected] Gary Young [email protected] Yuval Peduel [email protected] Ole D. M. Lennert [email protected] Ned Fleming [email protected] Mark Atwood Voted No ------------------------------------------------------------------------------ [email protected] Andrew Fabbro [email protected] Martin H. Booda [email protected] Mark Kramer [email protected] Derek Clarke 01705 227138 [email protected] G.P. Ryan [email protected] James Broughton [email protected] John Lowther [email protected] Fred Cherry [email protected] Aaron Marquez [email protected] Patrick J. LoPresti [email protected] Richard Songhurst [email protected] Dwight Brown [email protected] STella [email protected] Todd C. Lawson Abstained ------------------------------------------------------------------------------ [email protected] Timothy D. Prime
USENET FACT: Flaming
Flaming is the hostile interaction between multiple Usenet users.