----- file created by makedoc on: Tue Apr  1 15:29:56 2008
----- Documentation for /scisoft/xop2.3/extensions/shadowvui/src/lib/xsh_run.pro -----

 NAME:
	XSH_RUN

 PURPOSE:
	Spawns a command to run shadow.

 CATEGORY:
	Shadow gui application.

 CALLING SEQUENCE:

	XSH_RUN,command

 INPUTS:
	command:	Command to be run

 OPTIONAL INPUTS:
	
 KEYWORD PARAMETERS:
	LOGFILE = file with log of running (not available under W95).
	LOGVIEW = When set, opend a window with the log file after the
		completition of the run. (not available under W95).
	BG = When set, performs the task in the background.
	NOINIT = when set, the initialization file (usually .shadowrc) is
		not executed before the spawned command. (always set under W95).

 OUTPUTS:
	None.

 OPTIONAL OUTPUTS:

 COMMON BLOCKS:
	shadow (includes the shadow_start (i.e. source .../.shadowrc))

 SIDE EFFECTS:
	initializes the spawn command with the result of
		xsh_defaults('INITIALIZE')

 RESTRICTIONS: 

 PROCEDURE:
	Straightforward.

 EXAMPLE:
	xsh_run,'epath < epath.inp'

 MODIFICATION HISTORY:
 	Written by:	M. Sanchez del Rio
	November, 1996
	97/11/04 srio@esrf.fr makes spawned processes under /bin/sh. 
	97/11/12 srio@esrf.fr adapts for W95.
	98/03/19 srio@esrf.fr adds common block with shadow_start and shell
	98/04/06 srio@esrf.fr removes shell from common block
	98/04/08 srio@esrf.fr bug fixed in Unix after PC changes
	00/07/17 srio@esrf.fr debugging messages when XOP_BINARIES_DEBUG
		environment variable is set.

