Path: utzoo!utgpu!news-server.csri.toronto.edu!rpi!think.com!zaphod.mps.ohio-state.edu!unix.cis.pitt.edu!pitt!willett!ForthNet
From: ForthNet@willett.pgh.pa.us (ForthNet articles from GEnie)
Newsgroups: comp.lang.forth
Subject: Documenting
Message-ID: <2800.UUL1.3#5129@willett.pgh.pa.us>
Date: 22 May 91 02:36:52 GMT
Organization: (n.) to be organized.  But that's not important right now.
Lines: 26

Category 3,  Topic 3
Message 3         Tue May 21, 1991
D.RUFFER [Dennis]            at 00:53 EDT
 
Re: RAY DUNCAN

I sure can't argue with you Ray.  I've experienced everything you mentioned
with regard to shadow blocks.  Yet, there's something about the vertical
formatting that doesn't quite work for me either. I supposed with block or
text files or any other "linear" approach to source management, I'm not going
to be satisfied.  I haven't experimented with the hypertext type systems yet. 
Maybe they might hold some promise.

Has anyone done hypertext source code documentation?  I think the FPC might
have the facilities to do it.  Has anyone used them for program documentation
yet?

Ray, I know what you mean about the "modules as file" concept, but I haven't
been able to "sell" that idea yet.

Time will tell!   DaR
-----
This message came from GEnie via willett.  You *cannot* reply to the author
using e-mail.  Please post a follow-up article, or use any instructions
the author may have included (USMail addresses, telephone #, etc.).
Report problems to: dwp@willett.pgh.pa.us _or_ uunet!willett!dwp