• Your Trusted Usenet Provider
  • Secure, Private, Unlimited

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] (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].unm.edu                                                     
[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: Kill File
A set of filters setup to determine which user's posts will be read/downloaded or ignored.