=================================
ARRAY VARIABLE naming:
- some of the namelist variables in the TOTOE are members of arrays, such
  as SCR_NUMBER(1) ... SCR_NUMBER(10). The original way was to name each
  individual array member as ``SCR_NUMBER(i)'', where i = 1 ... N.

  I'm not that fond of this naming scheme with PARENS, so changed it to
  SCR_NUMBER_i, where i = 1 ... N. Much easier to parse without any 
  ambiguity. Also, I'd like to reserve the PARENS for future extension to
  EXCON EXP language to include pseudo-function calls.

=================================
OE numbering:
- since TRACE very much depends on the OE numbering scheme, ie., it needs
  the OE number of the last element, I use the ``OE_NUMBER'' namelist
  variable that is NOT used by any of the SHADOW programs to supply this
  argument to EXCON-TRACE wrapper program.


- When using ``system-to-excon'', the scripts does the following:

    - create the SOURCE gfile (start.00 --> start.00.G)
    - for each of the OE's in SYSTEMFILE
      BEGIN
	- create the OE(i) gfile (start.0i -> start.0i.G)
	- replace the OE_NUMBER value in the gfile:
	    OE_NUMBER	=	oe_number_of_this_element
      END
    - create the template experiment file

=================================
GEN_SOURCE: (BEGIN.DAT)
- gen_source forces the output file name to be ``begin.dat'' and DOES NOT
  look at the namelist variable FILE_SOURCE.

TRACE: (FILE_SOURCE)
- TRACE uses the variable FILE_SOURCE to load the last image file from the
  namelist, so we can use this as a EXCON ``link'' variable to propagate
  the files. 
  
  Caveats:
    - both STAR and MIRR are hard-coded in the program, and the output is
      ALWAYS going to be STAR.%% and MIRR.%%, where %% == OE number.
    
  HACK solution:
    -
=================================
EXCON-SEED:

- since the FORTRAN SEED program mucks with other control files, such as
  SOURCE's start and end files, I decided to simply rewrite it (hell, it
  took all of 15 minutes) using NAWK.

- the current algorithm:
    
    - get statefile from g-file
    - get iteration counter from g-file (supplied by EXCON)
    - if ($iteration == 1)
	get ``istar1'' from g-file
	set newseed = $istar1
      else
	get ``istar1'' (ie., previous seed) from $statefile
	newseed = `get new seed from NAWK program`
      end
    - write $newseed to $statefile for next iteration
    - conditionally echo $newseed to standard output.

- as easy as that!
=================================
