CXrL SHADOW binary distribution (pre-2.3.1 BETA release) ======================================================== MANIFEST: README .................................... This file. INSTALL.w95 ............................... Win32 specific instructions. NEWS ...................................... NEWS file from distribution shadow-docs.tar.gz ........................ SHADOW docs (Primer) shadow-docs.zip ........................... in ZIP format for Win32 shadow-2.3.1-win32.zip .................... Windows'95/NT shadow-2.3.1-i386-linux.tar.gz ............ Linux (RedHat, Debian) shadow-2.3.1-hppa1.1-hp-hpux9.07.tar.gz ... HP-PA RISC HP-UX 9.07 shadow-2.3.1-sparc-sun-sunos4.1.3.tar.gz .. Sun SPARC SunOS 4.1.3 (1) shadow-2.3.1-sparc-sun-solaris2.4.tar.gz .. Sun SPARC Solaris 2.4 shadow-2.3.1-alpha-dec-osf3.2.tar.gz ...... DEC Alpha DU/OSF 3.2 shadow-2.3.1-rs6000-ibm-aix4.2.tar.gz ..... IBM RS/6k AIX 4.2 split/ .................................... Split binaries for some NOTE: Some of these files are missing still. I'll create these as time permits. These distributions include core SHADOW v2.3.1 and the GUI version 1.1.0, but NOT the documentation. You need to get shadow-docs as well. There is a simple-minded tutorial to get you started with the GUI at http://shadow.xraylith.wisc.edu/shadow/GUI. Please see the README file included in the distribution for further instructions on how to install SHADOW on your system. All the UNIX files are compressed with GNU zip utility, hence the .gz extension. If you do not have gunzip, then either get the source from a GNU/FSF ftp site (eg., prep.ai.mit.edu:/pub/gnu) or use the precompiled one in ../unsupported directory. Ditto for the "patch" program. The Windows distribution is a self-extracting ZIP file, so nothing extra is needed. ======================= CXrL version SHADOW 2.3.1 ====================== >> WHAT YOU SHOULD GET: For Unix (Substitute $platform for whatever platform you need): - README (this file + some more info) - shadow-2.3.1-${platform}.tar.gz - shadow-docs.tar.gz And if your system does not have GNU unzip (gunzip) to unpack: - ../unsupported/gunzip-$platform.Z IF NEEDED If you have trouble getting the whole *.tar.gz file for a given platform due to network delays and timeouts, you can also see if I have already created "split" binaries that you can get and put them back together with the "cat" command. See the split subdirectory for what is available. For Windows'95/NT: - README (this file + some more info) - INSTALL.w95 - shadow-2.3.1-win32.zip - shadow-docs.zip If you have trouble getting the whole ZIP file for Windows '95/NT due to network delays and timeouts, I have already created "split" binaries that you can get and put them back together with the "copy" command. Get the sh_w32_zip.* files, and recombine as noted below to re-create the original shadow-2.3.1-win32.zip file. ========================================================================== >> UNPACKING AND CONFIGURATION: >>>> Unix: All the binaries are tar'd and GNU zip'd (hence the .tar.gz extension). If you do not have "gunzip", then you can get the pre-built binaries from our FTP site (../unsupported directory) or build it yourself from the source code available at any fine GNU mirror (eg., PREP at MIT ftp://prep.ai.mit.edu/pub/gnu). Unpacking instructions: % mkdir /usr/local % cd /usr/local % gunzip -c /tmp/shadow-2.3.1-i386-linux.tar.gz | tar xvf - % gunzip -c /tmp/shadow-docs.tar.gz | tar xvf - You should now see a directory tree that looks like the following: shadow-2.3.1/ ./.shadowrc ................ Startup file for CSH users ./.shadowrc.sh ............. Startup file for sh/bash/ksh users ./NEWS ..................... What's new ./README ................... This file ./SHADOW_VERSION ........... SHADOW version information ./SHADOW_GUI_VERSION ....... SHADOW GUI version information ./bin/ ..................... All SHADOW binaries ./data/ .................... SHADOW data files (mostly binary) ./doc/ ..................... Documentation (precious little) ./lib/ ..................... Mostly shared libraries you might not have ./tcl/ ................. GUI (tcl/tk etc) scripts ./libexec/ ................. GUI library executables If you cannot or do not want to install in /usr/local/shadow-2.3.1, then you will have to edit the two SHADOW startup files located at the top of the tree (.shadowrc for csh/tcsh users and .shadowrc.sh for Bourne or Korn shell users) and edit the SHADOW_ROOT variable. >>>> Windows'95/NT: All the binaries are zipped with PkZip and you must unpack with a compatible unzipper that understands long file names (or else you lose!). WinZip 6.2 (http://www.winzip.com) is such a compatible and a very competent program. See INSTALL.w95 for more detailed instructions on how to install SHADOW under Win32. SHADOW now uses InstallShield to install, so the installation should be quite painless (famous last words ;-). The only gotcha is that if you already have SHADOW v2.3.0, the first public release, installed, you *have* to remove the various definitions (PATH and DOS variables) defined for SHADOW v2.3.0. Otherwise, 2.3.1 will die with mysterious error messages. ========================================================================== >> GETTING STARTED >>>> Unix: - To run SHADOW, users MUST include $SHADOW_ROOT/bin in their $PATH variable, and set a few, one of which is essential, environment variables. The file $SHADOW_ROOT/.shadowrc does this for you (see $SHADOW_ROOT/.shadowrc.sh for ksh/bash/sh users). Do make sure that the SHADOW_ROOT variable in both of these startup files is pointing to the correct SHADOW installation directory. - initialize the environment. For CSH users, % source /usr/local/shadow/.shadowrc does the job. BOURNE shell users use % . /usr/local/shadow/.shadowrc.sh - users may wish to read $SHADOW_ROOT/doc/Startup.doc before getting started. - To run the GUI, % shadow And load the demos using HELP | DEMOS from the toplevel menu bar. >>>> Windows'95/NT: - The SHADOW installer should have created a SHADOW program group that you can access via the Start menu. Simply run "SHADOW GUI" from there. - If you want to run one of the text mode utilities (eg., intens, translate, etc) that has yet to be integrated into the GUI, you can run it from the Tools menu, or you can open a DOS Shell Window with "Tools | New Shell Window" menu; this DOS window has the SHADOW binary directory already in PATH. If you get "Out of environment errors" when running text mode programs with DOS Window, then you need to add the following line in your CONFIG.SYS and reboot: SHELL=C:\WINDOWS\COMMAND\COMMAND.COM /E:1500 /P ========================================================================== >> TROUBLE SHOOTING: Troubles, contact CXrL at shadow@xraylith.wisc.edu or phone (608) 877-2400 or fax (608) 877-2401 Please see SHADOW Web page at http://shadow.xraylith.wisc.edu/shadow on what information you should supply when filing a bug report. >>>> Unix: Please double check that the SHADOW_ROOT variable is pointing to the actual installation directory before looking further. >>>> Windows'95/NT: Please double check that the SHADOW_ROOT variable is pointing to the actual installation directory before looking further. For more detailed info, see the file PLATFORMS in the source distribution. ========================================================================== >> CONTACT: For more information on SHADOW, please contact Mumit Khan at +1 608 265 6075 or Franco Cerrina at +1 608 263 4955 . Center for X-ray Lithography University of Wisconsin - Madison 1415 Engineering Drive Madison WI 53706 ========================================================================== >> MAILING LIST: There is also a mailing list for SHADOW users. To join, send a mail to majordomo@xraylith.wisc.edu with "subscribe shadow-users" in the body of the message. More info at the SHADOW Web site: http://shadow.xraylith.wisc.edu/shadow ############# Last Updated Fri Apr 11 22:24:13 1997 Mumit Khan ############ ------- x --------