Path: utzoo!utgpu!news-server.csri.toronto.edu!cs.utexas.edu!samsung!uakari.primate.wisc.edu!sdd.hp.com!decwrl!bacchus.pa.dec.com!granite.pa.dec.com!mwm
From: mwm@raven.pa.dec.com (Mike (Real Amigas have keyboard garages) Meyer)
Newsgroups: comp.sys.amiga.tech
Subject: Re: autodoc reader
Message-ID: <MWM.90Aug14134103@raven.pa.dec.com>
Date: 14 Aug 90 18:41:03 GMT
References: <6265@milton.u.washington.edu> <13794@cbmvax.commodore.com>
Sender: news@wrl.dec.com (News)
Organization: Missionaria Phonibalonica
Lines: 48
In-Reply-To: peter@cbmvax.commodore.com's message of 14 Aug 90 14:45:00 GMT

In article <13794@cbmvax.commodore.com> peter@cbmvax.commodore.com (Peter Cherna) writes:

   Path: bacchus.pa.dec.com!decwrl!uunet!cs.utexas.edu!rutgers!cbmvax!peter
   From: peter@cbmvax.commodore.com (Peter Cherna)
   Newsgroups: comp.sys.amiga.tech
   Date: 14 Aug 90 14:45:00 GMT
   References: <6265@milton.u.washington.edu>
   Reply-To: peter@cbmvax (Peter Cherna)
   Organization: Commodore, West Chester, PA
   Lines: 27

   In article <6265@milton.u.washington.edu> dlarson@blake.u.washington.edu (Dale Larson) writes:
   ><eat me>
   >
   >Does anyone know where I can get a good autodoc reader?
   >(better than "more" or "less" :-)

   Fish disk 297 includes the DevKit, which is a collection of ARexx macros
   and C-programs for integrating CygnusEd into the autodocs and includes, etc.
   There is a stand-alone program called GetAutoDoc that is part of it.

I've got (had? - depends on many other things) a version of the 2.0
AutoDocs loaded into the hypertext system "Thinker". When CBM gets
more 3000's so they can ship me one, I'm going to try it with the
read-only demo version.

The results look more like the infominder version than getautodoc, but
it's got one advantage over both: given an autodoc that references
another function, you can click on the names of functions, and get the
docs for the referenced function. Your choice of doing it in the
current window, another window, or any open thinker window.

Unfortunately, building those thinker documents was a lot of work, and
it's not liable to be repeated. Nor am I sure about how I can
distribute them - after all, they're covered by some funny agreement I
had to sign to get them.

It'd help a lot of the autodocs had a consistent format, instead of
whatever whoever wrote them thought would work best. Then again, that
would probably help _everybody_ who wanted to load the autodocs into
some form of "intelligent reader".

	<mike
--
When logic and proportion have fallen softly dead,	Mike Meyer
And the white knight is talking backwards,		mwm@relay.pa.dec.com
And the red queen's off her head,			decwrl!mwm
Remember what the dormouse said.