[Date Prev] [Date Next] [Thread Prev] [Thread Next] Date Index Thread Index Search archive:
Date:Mon Dec 29 03:31:03 2001 
Subject:Reading the documentation with a web browser 
From:Pete Goodeve 
Volume-ID:1011229.01 

In article <9vtlda$103a$1@agate.berkeley.edu> ("Thirty Years..."), I wrote:
>   I've hammered together a PHP script that lets me access the doc
>files from my browser.  [.....]
>                                                 If anyone wants it,
>I'll be happy to make it available.  Actually you can try it at:
>
>	http://jwgibbs.cchem.berkeley.edu/pop11
>

The script has been through several iterations since then, and now
handles *most* of the cross-reference variants that VED uses.  The
latest version is in place at the URL above.

It now understands mutiple references on a line where only the first has
a prefixed section.  If the '*' is the first non-whitespace it assumes
'HELP'.  It even looks up topics in 'ref/doc_index' if it can't find
them in the current section.  [THAT mechanism was hard to find...!(-))]

It doesn't handle quite *all* asterisk forms -- I didn't want it to
tag "X * Y" for instance -- and it ignores the few lower-case tags
that occur.  It doesn't try to follow 'subreferences' that follow
a slash.

I don't think I'll do much more work on it, so as promised the script is
now available (as plain text) at the URL:

       http://jwgibbs.cchem.berkeley.edu/pop11/getscript.php

I think it should install easily on any server that has PHP available
[and the docs themselves, of course!].  You'll have to change the
"$usepop=..." line in the script appropriately, but I believe that's all.
I have it as 'index.php' in its own 'pop11' server directory, but you
may want to do it some other way.

Hope it's useful.
					-- Pete --