home *** CD-ROM | disk | FTP | other *** search
/ Game Killer / Game_Killer.bin / 809.README.DOC < prev    next >
Text File  |  1992-03-09  |  6KB  |  171 lines
  1. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2. +  FLIGHT SIMULATOR SCENERY DIRECTORY MANAGEMENT UTILITIES  +
  3. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  4.  
  5. Freeware programs created by C.D. Trent, Stafford, UK.
  6.  
  7. Original version   1.0    - 1 December 1991
  8. Updated to version 1.1    - 9 March 1992
  9.  
  10. This package contains the following files:
  11.  
  12.         README.DOC      - this file
  13.         SCDEL.EXE       - scenery file delete utility
  14.         SCADD.BAT       - sample scenery file add utility
  15.         IDEL.EXE        - interactive delete utility
  16.  
  17. Changes from previous version:
  18.         1. SCDEL.EXE has been altered to allow the use of a 
  19.            drive letter in the environment variable SCENROOT
  20.         2. README.DOC has been updated and revised 
  21.  
  22.  
  23.  
  24.     _________________________________________________________
  25.  
  26.  
  27.  
  28.  
  29. I created these utilities for use under DOS to maintain some order in
  30. my own FS4 directories. I became tired of manually copying, moving,
  31. deleting fairly large numbers of .SC1, .DY1 and .MOD files in order to
  32. keep my working set to a reasonable size, and I also wanted to keep 
  33. some mutually incompatible groups of files out of the way of each other.
  34.  
  35. The file structure I use is typified by:
  36.  
  37.     FS4---
  38.          |--SCN--
  39.          |      |--AZ
  40.          |      |--CA
  41.          |      |--CARIB
  42.          |      |--NM
  43.          |      |--NY
  44.          |      |--NYCITY
  45.          |      |--UK
  46.          |
  47.          |--SEE
  48.          etc.
  49.  
  50. I keep all the groups of scenery files (.SC1, .DY1, .MOD files) in separate 
  51. subdirectories, grouped under a common parent directory, which in the 
  52. illustration above happens to be \FS4\SCN. I use the files in the various 
  53. subdirectories as, in effect, master copies of the scenery. I use the 
  54. utilities SCADD.EXE and SCDEL.EXE (as supplied here) to create and delete 
  55. working copies of these groups of master files in my basic FS4 directory. 
  56.  
  57. This allows me to keep a clean FS4 directory, with just those groups of 
  58. scenery files that I want in it at any one time, and I can add or remove 
  59. scenery with very simple commands (SCADD, SCDEL - see below).
  60.  
  61.  
  62.     _________________________________________________________
  63.  
  64.  
  65.  
  66.  
  67. The utilites included here require you to set up an environment variable 
  68. SCENROOT  before using them: SCENROOT should contain the pathname of the 
  69. parent directory of all the scenery subdirectories. 
  70.  
  71. In the example above the necessary DOS command line would be 
  72.  
  73.         set SCENROOT=\fs4\scn
  74.  
  75. You could either type this in or (more typically) insert it in your 
  76. AUTOEXEC.BAT file. The right-hand side of the assignment can 
  77. optionally contain a drive assignment, for example:
  78.  
  79.         set SCENROOT=c:\fs4\scn
  80.  
  81. This allows you to use SCADD and SCDEL if you keep master scenery files
  82. on a different physical or logical disk from your basic FS4 files.
  83.  
  84.     _________________________________________________________
  85.  
  86.  
  87. The program SCDEL.EXE is used to remove groups of files from the main
  88. FS4 directory. It uses the environment variable SCENROOT to provide a 
  89. pathname for the parent directory of all the scenery subdirectories.
  90. You must define SCENROOT beforehand: an example is given above.
  91.  
  92. SCDEL.EXE is run in the basic FS4 directory. It has the command line 
  93. syntax: 
  94.  
  95.         scdel [subdirectory list]
  96.  
  97.         (e.g: scdel ny az carib)
  98.  
  99. It deletes all copies in the basic FS4 directory of the various files 
  100. with .SC1 .DY1 .MOD extensions which exist in those scenery 
  101. subdirectories named as arguments in its command line. It does *not* 
  102. delete any files in the scenery subdirectories themselves.
  103.  
  104. Note: SCDEL.EXE can also be used without any arguments, when it responds 
  105. to input consisting of a single directory name per line. Just 
  106. hitting <return> or <ctrl-Z> will exit the program. This interactive mode  
  107. is intended to allow SCDEL.EXE to accept piped input in a batch program.
  108.  
  109.     _________________________________________________________
  110.  
  111.  
  112. Copying groups of scenery files into the main FS4 directory is 
  113. simple - the batch file SCADD.BAT in this package is a working example 
  114. that can be modified if necessary. 
  115.  
  116. SCADD.BAT is run in the basic FS4 directory. The command line syntax 
  117. for this batch file is:
  118.     
  119.         scadd [subdirectory list]
  120.  
  121.         (e.g: scadd az carib)
  122.  
  123. SCADD.BAT requires the environment variable SCENROOT to be set up - 
  124. an example of this is given above. 
  125.  
  126.     _________________________________________________________
  127.  
  128.  
  129. I also include a simple interactive file deletion program IDEL.EXE 
  130. with this package: this has the command line syntax
  131.  
  132.         idel [file list]
  133.  
  134. It deletes the named files.
  135.  
  136. Its main intended use is without command line arguments, when it
  137. deletes files whose names are piped from another program or typed 
  138. one per line from the keyboard - exit using <ctrl-Z>. The piping 
  139. facility is not available from the standard DELETE command in DOS. 
  140. Typical uses might be:
  141.  
  142.         type [listfile] | idel
  143.  
  144. or (in a batch file, and using the Unix-derived stream editor sed.exe, 
  145. not supplied here, to extract suitable filenames from a directory 
  146. listing):
  147.  
  148.         dir %1 | sed -f [sedscriptfile] | idel
  149.  
  150. IDEL.EXE does not use the SCENROOT environment variable: it deletes 
  151. only the files explicitly named in its input. Wild cards are *not* 
  152. allowed in the filenames supplied to it and file name extensions must 
  153. be specified. (The alternative seemed far too risky to me!) The use of 
  154. IDEL.EXE is not restricted to .SC1,.DY1,.DOC files.
  155.  
  156. This file may be of use to people who have directories organised very 
  157. differently from the pattern I have shown above, so that SCDEL.EXE and 
  158. SCADD.EXE are of no interest to them.
  159.  
  160. All the above programs are provided as is, with no guaranteees - they work 
  161. fine in my system - and have not been validated against all versions of DOS. 
  162. They are provided free of copyright and at no charge. Please contact me 
  163. via CIS  with any queries or comments. I will provide the C source code for 
  164. SCDEL.EXE on request.
  165.  
  166.  
  167.                         Chris Trent 
  168.                         100015,3647
  169.                         9 March 1992
  170.                         
  171.