================================================= C SWING version 3.7.4 (with MOST version 3.2.1FM) ================================================= Language: C, uses SMG$ for I/O's Compiler: VAX C 3.1 or greater with VAX/VMS 5.1 or greater, or DEC C 1.2 or greater with OpenVMS/AXP 1.0 or greater Introduction ============ SWING is a VAX/Alpha utility for the graphic representation and manipulation of VMS directory structures and files on any terminal that can support the SMG routines -- that is primarily the VTxxx series of terminals and terminal emulators. SWING is designed to make life easy for a user who frequently performs directory or file operations within his or her directories. SWING's Directory Manager displays the top eight levels of the user's directory structure. If there are more than eight levels a diamond is displayed in the right-most column indicating that there are non-displayed directories. It's File Manager is invoked via the F option while pointing to a directory. SWING has a two level help facility. Quick menus are available via the ? option. Standard VMS help is available via the H or HELP (LK201) option. The C language version of SWING was written by Simon Brown, and maintained by him through V3.2. It has been modified by many people, and is currently maintained primarily by Harry Flowers and Foteos Macrides. Most of the documentation has been rewitten by Chris Butler and Foteos Macrides. The re-write of SWING was necessary as Simon did not have a Fortran compiler, and felt that C was a more appropriate language. Also, colleagues required major enhancements, so the software was started from scratch. The result that you see here consumed something in the region of 400 to 500 hours of spare time. The software is copyrighted but freely distributable (to keep it free ;-). For more information on SWING look in the MANUAL subdirectory, where you will find SWING_MANUAL.MEM. It can be printed, or viewed with the MOST utility. -- It is the User Guide, with answers to beginning and advanced questions. READ IT!!!! MOST is a file paging utility invoked via the Y option in the File Manager. The version of MOST supplied with SWING is a modification by Foteos Macrides of John E. Davis' MOST v3.0 and v3.2. This version of MOST has a two level help facility. A summary of its commands is available via its ?, H, PF2, or HELP (LK201) option (synonyms for Quick Help). Its documentation file is displayed via its GOLD H or GOLD PF2 option (synonyms for Full Help), where GOLD is PF1 or CTRL-X. For more information about MOST read MOST.DOC_FM in the DOCUMENTATION subdirectory. Objects compiled under v5.5 of VMS using v3.1 of the VAX C compiler, or under OpenVMS Alpha AXP v1.5 using v1.3 of the DEC C compiler, can be obtained via anonymous FTP from narnia.memst.edu [141.225.1.24]. Directory Structure =================== SWING-----------SOURCE-------+-DOCUMENTATION-+-HELP_LIB | | +-EXE +-MANUAL | +-OBJ Tailoring SWING =============== There are a number of definitions near the top of the [.SOURCE]SWING.H file, which slightly modify the behaviour of SWING. They are: LOCALFIX MATS_HACK CR_RETURNS_FROM_FILE_TO_DIR_MGR Q_EXITS_TO_ORIGINAL_DIR ALWAYS_TRY_000000 SPECIFIC_EXITS_TO_SYSROOT COMMON_EXITS_TO_SYSROOT _PRINT_MENU For full information, see SWING.H, the release notes and documentation. To define them, simply move the '*/' from the line after the 'define' statement to the line before it. Build procedure (objects, executables, Help Library and Manual) =============================================================== A BUILD.COM is provided in the SOURCE subdirectory for compiling and linking the executables (CSWING.EXE, MOST.EXE), and for building the Help Library (CSWING.HLB) and Manual (SWING_MANUAL.MEM). $ @BUILD Depending on your system configuration, the BUILD procedure will use the descriptor files DESCRIP.MMS and SWING.MMS in the SOURCE subdirectory to create the objects and executables and the descriptor file DESCRIP.MMS in the DOCUMENTATION subdirectory to build the Help Library and Manual, or it will use the command procedures COMPILE.COM and LINK.COM in the SOURCE subdirectory, and RUNOFF.COM in the DOCUMENTATION subdirectory. If DEC C is installed, the BUILD procedure will use it as the compiler. Otherwise, it will use VAX C. System HELP Library =================== The files DCL_SWING.HLP and DCL_MOST.HLP in the DOCUMENTATION subdirectory have descriptions of SWING and MOST which can be inserted into the system HELP library. Execution ========= The executables are in the EXE subdirectory. To run, in the time-honored way, define these foreign commands in your SYS$SYLOGIN or LOGIN.COM: $ Sw*ing :== disk:[directory]cswing $ Mo*st :== disk:[directory]most Copy CSWING.HLB in the HELP_LIB subdirectory into the same directory as the executable, or define SWING$HLP to point to that directory, and you have on-line help for SWING. Also put SWING_MANUAL.MEM into that directory, and define the logical SWING_MANUAL to point to this file, so that users have easy access to it for printing or for viewing with MOST. Similarly copy MOST.DOC_FM in the DOCUMENTATION subdirectory to the same directory as the MOST executable, or define the logical MOST_HELP to point to that documentation file, for on-line access to it when using MOST. A SWING_STARTUP.COM is provided in the SOURCES subdirectory for installing CSWING.EXE and MOST.EXE as shared images, and for defining the SWING$HLP, SWING_MANUAL, and MOST_HELP logicals. Put it into SYS$COMMON:[SYS$STARTUP] and add this to SYS$MANAGER:SYSTARTUP_V5.COM (or SYS$MANAGER:SYSTARTUP.COM): $ @SYS$STARTUP:SWING_STARTUP Release Notes ============= Can be found for SWING in its Help Library and in Section 6 of its Manual, and for MOST in the header of its MAIN.C. MAINTAINERS =========== If you have any problems with CSWING, or even an enhancement that you think would be of general interest, then contact one of the current maintainers: Harry Flowers Memphis State University Memphis, TN USA email: FLOWERS@MSUVX2.MEMST.EDU (on INTERNET) FLOWERS@MEMSTVX1.BITNET (on BITNET) Foteos Macrides Worcester Foundation for Experimental Biology Shrewsbury, MA USA email: MACRIDES@SCI.WFEB.EDU (on INTERNET) MACRIDES@WFEB2.BITNET (on BITNET)