Applying the ESP Rev 1.19 Overlay for the July 2021 CAPS Training


	The CAPS Training will be using Revision 1.19 of ESP, which has been 
available since early June 2021. If not already the case, please ensure this 
version of ESP functions on your equipment (report any problems, preferably 
before the training itself). There is the training material itself and some 
minor updates that need to be added to the distribution, please follow the
instructions below to install these modifications:


I. PreBuilt Distributions:

* MAC & Linux

  1. Grab "ovrly119MAC.tgz" or "ovrly119Lin.tgz" (which ever is appropriate) 
     from acdl.mit.edu/ESP/Training using a web browser (note the OSX 
     warning below).
  2. Start a terminal with the proper ESP environment (double-click on the
     "ESP 1.19" icon if using a PreBuilt distribution).
  3. cd to $ESP_ROOT
  4. Move the downloaded "overlay" tgz file to $ESP_ROOT.
  5. Execute the command: tar -xvzf ovrly119MAC.tgz  --or--
                          tar -xvzf ovrly119Lin.tgz 
  6. Once complete you can delete the tgz file.

  OSX Catalina (and newer MACOS) warning:
     "ovrly119MAC.tgz" must be downloaded via
     "curl -O https://acdl.mit.edu/ESP/Training/ovrly119MAC.tgz -o ovrly119MAC.tgz"

* Windows

  1. Grab "ovrly119Win.exe" from acdl.mit.edu/ESP/Training using a web browser.
  2. Extract the overlay by double-clicking on the exe file.
  3. Specify the extracted location to that of the path associated with 
     %ESP_ROOT% (e.g., drive:\path\to\ESP119\EngSketchPad).
     a. You should get a pop-up window stating: 
        "Would you like to replace the existing file..."
        Answer "Yes to All"
     b. If not, you did not specify the appropriate full path to %ESP_ROOT%
  4. Once completed you can delete ovrly119Win.exe.


II. Built from Source:

* Follow the instructions above
* cd to the path associated with ESP_ROOT
* cd to src and type "make"