Xmosaic restart protocol
========================

	xmosaic is started by genaid.exe. genaid stores the pid of xmosaic in a
file /tmp/xm-<display name>, where <display name> is derived from the
environment variable DISPLAY by substituting a dot for each colon.

	To access xmosaic from a parameter prompt in a Newstar program, PPDHELP
call genmosaic.cun. The latter routine reads the file created by genaid to
retrieve xmosaic's pid, <pid>. It then follows the protocol defined by xmosaic
to access the appropriate help information in mosaic form:


	1. Create a file /tmp/Mosaic.<pid>, containing the lines

		goto
		file://localhost/<directory>/file.html

	2. Sending a SIGUSR1 signal to process <pid>.

The latter signal causes xmosaic to opend the file /tmp/Mosaic.pid and act on
its contents.


Changes, early november 1994
============================

	Parameter .html files are now clustered in one .html file per .psc or
.pef file. Finding the right target for display by mosaic requires some
searching, which is done most easily in a .csh script:

	set target = \
	    `grep -l <Keyword> $n_hlp/intfc/<program>_private_intfc.psc`
	if ($#target != 0) then
	  set typ = 'private'
	else
	  set target = `grep -l <Keyword> $n_src/*/*.pef`
	  if ($#target != 0) then
	    set typ = 'public'
	  else
	    <emit error message>
	endif
	set label = `echo <keyword> sed -e 'y:A...Z_:a...z.:' `
	echo 'goto' >! /tmp/Mosaic.<pid>
	echo \
"file://localhost$n_hlp/<pgm>_${typ}_intfc/<pgm>_${typ}_intfc.html#$target" \
	  >> /tmp/Mosaic.<pid>
	ln -s /tmp/Mosaic.<pid> /tmp/xmosaic.<pid>
	kill -SIGUSR1 <pid>