From mike_maxwell@sil.org  Fri Jul 23 15:25:02 1999
Received: from barlaeus.ic.uva.nl (barlaeus.ic.uva.nl [145.18.68.50])
	by swi.swi.psy.uva.nl (8.9.3/8.9.3) with ESMTP id PAA22160
	for <prolog@swi.psy.uva.nl>; Fri, 23 Jul 1999 15:25:02 +0200 (MET DST)
From: mike_maxwell@sil.org
Received: from email1.camnet.com (root@email1.camnet.com [208.145.81.9])
	by barlaeus.ic.uva.nl (8.8.7/8.8.8) with ESMTP id PAA26237
	for <prolog@swi.psy.uva.nl>; Fri, 23 Jul 1999 15:25:51 +0200 (MET DST)
Received: from router-8.camnet.com (router-8.camnet.com [208.145.81.78])
	by email1.camnet.com (8.9.3/8.8.7) with SMTP id MAA10714
	for <prolog@swi.psy.uva.nl>; Fri, 23 Jul 1999 12:55:43 -0400
Received: from ccMail by router-8.camnet.com (ccMail Link to SMTP R8.31.00.5)
    id AA932736448; Fri, 23 Jul 1999 09:27:30 -0400
Message-Id: <9907239327.AA932736448@router-8.camnet.com>
X-Mailer: ccMail Link to SMTP R8.31.00.5
Date: Fri, 23 Jul 1999 09:21:43 -0400
To: <prolog@swi.psy.uva.nl>
Subject: using Index.html as Help file
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Content-Description: "cc:Mail Note Part"

We certainly can't fault Jan for not replying quickly to our questions!  I only
wish commercial support was that fast to respond...

Awhile back I said that the INDEX.HTML file in the Swi-Prolog manual was empty. 
Jan suggested that there might be a case conflict (on Windows systems).  He was
right; a Windows program I have shows both an index.html and an Index.html, and
since Windows has case-insensitive filenames, the one had clobbered the other.

In order to make the Index.html file function as a help file, I munged it in an
editor by adding a name=<pred name> to all the <A...> tags that contained Prolog
predicates or C function calls to Prolog.  Then an HTML browser can be called
with the predicate's name at the end of the URL, e.g.
    file:///c:\foobar\Index.html#recorda
(Note the lack of the arity indication.)  I did the same for the PL_<name>
function calls.  I wonder if this "name=<pred name>" structure couldn't be
automatically generated in the HTML file?

I then set up the VSlick editor so that typing @H with the cursor in a Prolog
built-in pred name automatically calls up the index file and scrolls it to show
the first index entry for that name.  (Since there may be several preds with the
same name but different arities, I didn't try to go directly to the appropriate
sxn of the manual.  I'm not quite up to determining the arity of the pred in
VSlick.  For that matter, I don't know how to make my browser automagically jump
the additional link.)

If anyone else is using the VSlick editor, I'll be glad to provide them with
this index file and several other things I did to make VSlick work better with
Swi-Prolog (the chief of which was making VSlick jump to the appropriate line in
a file, based on the compiler's error msgs).

                            Mike Maxwell
                            Mike_Maxwell@sil.org
                            Summer Institute of Linguistics

