File README.PC     ========= DIRDIF PC =========          11 July 1999

========    How to read DIRDIF from diskettes     or:   ==============
========    How to get  DIRDIF executables via ftp  !   ==============
========    And how to install DIRDIF  on MSDOS PC !!   ==============


The DIRDIF system for PC  (MS-DOS: 486, Pentium, etc.)  is distributed
as executables, either via diskettes or via ftp.  The Salford compiler
has been used,  and the corresponding DBOS extender is included in the
distributed package.

1.  Make a directory DDROOT  
    which can be referred to in the AUTOEXEC.BAT PATH definition  
    -  [or alternatively, later, you may copy the dirdif.bat file
       and all DBOS files (see below) into accessible directories ].
    -  [Note: the name 'DDROOT' is not relevant: in this write-up
       we use this name for the DIRDIF root directory, but this name
       is not used in the actual implementation procedure: in fact
       you may choose any name for this directory. ]
    -  [If there is an 'old' directory DDROOT with old files, you
       should clean this directory (or, at stops, enter: "YES").]

2.  Make DDROOT your working (default) directory, then make a sub-
    directory DDFTP and make DDFTP your working directory, i.e.:

    ====>   cd  xxxx\xxxx\DDROOT
    enter:  mkdir DDFTP
    enter:  cd  DDFTP

3.  Get the DIRDIF files either from diskette (3A) or via ftp (3B);

   3A. From two diskettes (1st with 'README.PC', 2nd with 'DBOS'):
    -  Place one diskette in the A: diskette reader and
       enter:  copy A:\*.* .
    -  Repeat for second diskette.

   3B. Alternatively, use ftp as follows:
    -  enter:  ftp ftp.sci.kun.nl
       user:   anonymous
    -  enter:  cd  pub/dirdif/pc 
    -  enter:  prompt
    -  enter:  bin
    -  enter:  mget *
    -  enter:  quit

4   Continue the installation (still being in directory DDFTP ):

    -  enter:  install
 
    If INSTALL is finished you are back in the DDROOT directory.
    The contents of subdirectory DDFTP may be saved for updates.

5.  You must now edit the file dirdif.bat
    (a.) to tell your PC the path to the DDROOT directory,  and
    (b.) to define a scratch disk ( see comments in DIRDIF.BAT )
    So: edit DIRDIF.BAT and:
    -  (a.) adapt setting for: %DIRSYSTEM%
    -  (b.) adapt setting for: %DIRTDISK%

6.  Make sure that the RAM-drive is implemented or that the
    directory 'DIRT' exist ( as defined by %DIRTDISK% , re 5b.;
    for instance:  mkdir xxxx\xxxx\DIRT  as defined in DIRDIF.BAT ).

7.  Be sure that your PATH definitions include the DDROOT directory:
    -  edit the AUTOEXE.BAT and include DDROOT in the PATH (re 5a.)
    -  switch off and restart the PC .

8.  Test the performance of DIRDIF with the MONOS test data, i.e.
    do run all tests described in the PRIMER 
    (this file is stored in the present directory DDROOT). 
    The MONOS data are stored in a subdirectory; do change to it:
    ====>  cd monos
    and try the following runs (replies as descibed in the primer):
    ====>  dirdif h
    ====>  dirdif monos patty
    ====>  dirdif monos orbase
    ====>  dirdif monos orient
    and check the results as described in the PRIMER !

9.  About twenty test structures are available via diskette or ftp;
    if you wish to try and experiment with those, proceede as follows.
    Make a directory for storage of all data, and make it your working
    directory, for instance
    -  mkdir xxxx\xxxx\CCALL
    -  cd    xxxx\xxxx\CCALL
    and get the appropriate files from diskette (A) or via ftp (B):

  9A. From  diskette ( diskette #3, denoted 'CC' ):
    -  Place the diskette in A:   and enter:  copy A:\*.* .
  9B. Alternatively, use ftp as follows:
    -  as 3B, but change to directory: pub/dirdif/ccall
    -  enter:  prompt ;  bin ;  mget * ;  quit

    Then follow instructions given in file README.CC .

10. For more details, see the PRIMER and the DIRDIF USER'S GUIDE.
    Read the PRIMER to learn about our nomenclature.
    See file DIRDIF.README (= DDROOT\README ) for registration.

The DIRDIF USER's GUIDE is needed for optimal use of DIRDIF:
please ask for it !  =================> e-mail:  ptb@sci.kun.nl
And thanks for letting me know your good and bad experiences.

Thank you !

====================================================================
Prof. Paul T. Beurskens                       e-mail: ptb@sci.kun.nl
LABORATORIUM    VOOR    KRISTALLOGRAFIE       ======================
University of Nijmegen,  Toernooiveld 1       Phone:  +31-24-3652188
6525 ED NIJMEGEN        The Netherlands       Home:   +31-24-3580219
                                              Telefax:+31-24-3653177
====================================================================
DIRDIF ftp site: ftp ftp.sci.kun.nl ; anonymous ; cd pub/dirdif  
DIRDIF WWW home page :   http://www-xtal.sci.kun.nl/xtal/dirdif/
====================== end of implementation =========================