CXrL SHADOW source distribution =============================== MANIFEST: README ............................. This file INSTALL ............................ INSTALL notes PLATFORMS .......................... Supported platforms for this release README.patch ....................... Info on how to apply patches shadow-2.3.2.tar.gz ................ Version 2.3.2 source shadow-2.3.0.tar.gz ................ Version 2.3.0 source shadow-2.3.1b1.tar.gz .............. Version 2.3.1 beta 1 source shadow-gui-1.1.2.tar.gz ............ GUI v1.1.2 source shadow-gui-1.1.0.tar.gz ............ GUI v1.1.0 source shadow-gui-1.1.0.tar.gz ............ GUI v1.1.0 source shadow-gui-1.1.1b1.tar.gz .......... GUI v1.1.1 beta 1 source shadow-docs.tar.gz ................. Docs, demos, etc. configure .......................... configuration script (1) All 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. Even though the source code for SHADOW and GUI are distributed separately, the prebuilt binary distributions come as one piece. There is a tutorial on the GUI available at http://shadow.xraylith.wisc.edu/shadow/GUI. What to get? - README, INSTALL, PLATFORMS, shadow-2.3.0.tar.gz : MUST GET - shadow-gui-1.1.0.tar.gz : If you want the SHADOW GUI. If you want just the character mode interface, you don't need this. (1) I had forgotten to include the configure script in the source distribution before April 18, 1997. If you picked up the source code before 10am CDT April 18 1997, please pick up the configure file, put it in SHADOW source directory and make it executable. The source distribution has since been updated, so if you're picking up the source code now, you don't need it. ============================ NEWS ==================================== CXrL SHADOW version 2.3.0 (Released 14-Apr-1997) Please see INSTALL file for instructions on how to build SHADOW from source code on your Unix/Windows'95/NT platform, and INSTALL.w95 on how to install on your Windows'95/NT. See README on how to install the binary distributions. Changes sinces 2.2.0: - Same source code for Unix and Windows'95. - Binary distributions are built with 25000 rays instead of 5000. You can still read your old files however, so no incompatibility. - Integrated GUI distributed with SHADOW now. * Workspace handling much improved since beta releases. o Workspace annotation (title, comments, etc) that is saved o Workspace info manager that peeks into saved workspaces * New Interactive Plotting program for GUI. Still an infant, but usable. * Win32 specific improvements o 200% speedup in startup time under Windows'95/NT. o Uses native file browsers and controls on Windows'95/NT. - X Windows works on Windows'95/NT. You do need a X Windows server of course. I have used eXceed and eXcursion with reasonable success. If you don't have a X server, can still use Postscript. See INSTALL.w95 for info on where to get a free X11 server. - Lots of enhancements and bug fixes: * PRESURFACE now accepts upto 201 points instead of 101. * SPLINE error bugs fixed. Now errant rays are tagged correctly as lost. * MENU works better under various curses emulation, eg., on linux. * Better auto-configuration on many systems when building from source. * EXCON<-->SHADOW interaction bugs have been fixed. * fixes in mlayer, plotspace, ffresnel, focnew, sourcinfo, histo3, presurface, epath, undul_cdf. * PRIMVS scripts (eg., when you run PLOTXY) now have .prm extension instead of .com/.cmd to avoid problems where .com is special (win32). * Only environment variable that is needed is SHADOW_ROOT. Rest are inferred if not explicitly specified. * Lots of fixes for 64-bit OS (eg., DEC Alpha/OSF). * Numeric precison fixes. Numbers with > 6 digits after decimal point were getting truncated in some places during translation. Now handle upto E20.13 format consistently. This mostly affected GUI users. * PLOTXY and friends will now run PRIMVS correctly under Win32. * TRANSLATE will now output CSV format so you can use spreadsheets. * Win32 version comes with SHVARS.BAT which you can CALL from AUTOEXEC. - New utilities: * nml-compare: Compare two START.xx files (of the same type of course) * nml-to-g, g-to-nml: GFILE<-->FORTRAN namelist Conversion programs - What's gone (binary distributions): * IBM RS6000 running AIX 3.2.5. Distribution only supported AIX 4.2+. * Sun SPARC running Solaris version <= 2.4. Please upgrade to >= 2.5. * Say no to VMS or OpenVMS. Nothing personal, just lack of resources. Other than VMS/OpenVMS, you can always grab the source code and build it on machines we have no access to (eg., rs6000-ibm-aix3.2.5). We will be glad to help with the build process. - Open bugs/misfeatures: * Polarization calculation for Undulators is not strictly correct. * There are problems on some platforms when compiled with options what causes the compiler to allocate local variables on the stack (eg., -automatic on alpha-dec-osf3.2). * Some programs misbehave (crashes outright, so at least you'll know) when compiled with optimization levels > 2, or -O2. This happens on alpha-dec-osf3.2. * The entire set of utilities and programs are not yet integrated in the GUI. * Lots of Win32 specific bugs: ^C makes a program haywire instead of just killing it as it should; excon can't run effectively unless you also install the Unix like utilities (grep, sed, awk, etc); Win32 GUI cannot print directly using The Win32 API, rather creates a Postscript file that you can print with GhostView; primvs takes forever to run under the GUI. ======================================================================