Also as promised at IPROF SIGMPE, here is my Perl script that converts the
CICAT.PUB.SYS :HELP text into separate HTML files:

        http://www.cccd.edu/ftp/pub/mpe/cicat2html.pl
        or
        ftp://ftp.cccd.edu/pub/mpe/cicat2html.pl

You can see the results of running this script at:

        http://mbloaner.dis.cccd.edu/~MARK.BIXBY/cicat/

The script attempts to find headings which it will encapsulate in <Hn>...</Hn>.

References to what the script thinks are :COMMANDS, HPVARNAME variables,
funcname() functions, etc, all get encapsulated in a <A HREF=>...</A> hyperlink
which points to their own CICAT page.

While writing this script, I quickly discovered that there are considerable
format variations within CICAT.  It was a challenge to make the script pattern
matching broad enough to match everything I needed, but narrow enough to not
match plain text paragraphs that should be left alone.

As Jeff Vance mentioned at the SIGMPE meeting, it would be handy if all of the
multiple references to filename syntax in CICAT could be replaced with a
hyperlink that points to the one true page of unduplicated info, but having
my script attempt major automatic reformatting like that was beyond the scope
of my free time.
--
Mark Bixby                      E-mail: [log in to unmask]
Coast Community College Dist.   Web: http://www.cccd.edu/~markb/
District Information Services   1370 Adams Ave, Costa Mesa, CA, USA 92626-5429
Technical Support               Voice: +1 714 438-4647
"You can tune a file system, but you can't tune a fish." - tunefs(1M)