Newsgroups: comp.programming.literate,comp.lang.lisp,comp.lang.scheme
Path: cantaloupe.srv.cs.cmu.edu!das-news2.harvard.edu!news2.near.net!noc.near.net!paperboy.wellfleet.com!news-feed-1.peachnet.edu!gatech!howland.reston.ans.net!EU.net!uunet!olivea!charnel.ecst.csuchico.edu!csusac!csus.edu!netcom.com!thinman
From: thinman@netcom.com (Technically Sweet)
Subject: Re: liprog tool with plain comment output?
Message-ID: <thinmanCxMJEB.Mr3@netcom.com>
Organization: International Foundation for Internal Freedom
References: <37eld6$n0a@disunms.epfl.ch>
Date: Thu, 13 Oct 1994 18:30:11 GMT
Lines: 30
Xref: glinda.oz.cs.cmu.edu comp.programming.literate:1640 comp.lang.lisp:15076 comp.lang.scheme:10361

matomira@di.epfl.ch (Fernando Mato Mira) writes:

>  Is there any litprog tool that will give me a nice lisp file
>with comments but no LaTeX commands? SchemeWEB either strips off
>all comments, or leaves all the mess in.
>  It's OK if it doesn't pretty print, provided it doesn't
>tangle the code, either.

I just added a set of functions which document various functions,
variables, classes, methods, and modules: 
	(doc-module module-name short-description . text )
	(doc-class class-name parent . text )
	(doc-method method-name class-name arguments . text )
	(doc-function function-name arguments . text )
	(doc-variable variable-name . text )
	(doc-text . text)

Where 'text' is one or more strings.  I have an program which
finds these all and spits out a troff document.  I'll probably
do an HTML version soon when I have mosaic.  Cross-referencing
the classes would be very cool.

The code is straight Scheme, and (doc-*) are dummy functions
which the above arguments for syntax-checking.

-- 

Lance Norskog
thinman@netcom.com
Artisputtingtogether. Art  s th ow n  aw y.
