From:	CSBVAX::MRGATE!vtcf@ncsc.ARPA@SMTP 13-APR-1988 02:55
To:	ARISIA::EVERHART
Subj:	SWING 3 OF 13


Received: from ncsc.ARPA by KL.SRI.COM with TCP; Mon 11 Apr 88 08:15:27-PDT
Received: by ncsc.ARPA id AA02728; Mon, 11 Apr 88 10:11:50 CST
Date: Mon, 11 Apr 88 10:11:50 CST
From: vtcf@ncsc.ARPA (Williams)
Message-Id: <8804111611.AA02728@ncsc.ARPA>
To: info-vax@kl.sri.com
Subject: SWING 3 OF 13

$Part03:
$ File_is="SWING.HLP"
$ Check_Sum_is=889654053
$ Copy SYS$Input VMS_SHAR_DUMMY.DUMMY
X!=======================================================================
X! THIS IS THE HELP LIBRARY FOR SWING
X!=======================================================================
X!
X!   This is the help file for the program SWING
X!   To add this to the standard help library on the VAX type:
X!   $ LIBRARY/HELP  SYS$HELP:HELPLIB  SWING.HLP
X!        
X!   Note that the processed version of this file (.HLB)
X!   is used by the SWING executable and must be located in SYS$HELP
X!
X1 SWING
X SWING is a VAX/VMS utility for displaying the graphical representation
X of directory trees on a VT100 or VT200 type terminal.  It can be used to
X move to a directory or subdirectory, as is done with the SET DEFAULT
X command, and it can rename, move and delete subdirectories.  SWING can
X also create hardcopy listings of a directory structure. 
X
V SWING takes one optional qualifier - START.  This sets the root of the { dire
Xctory tree to any directory that the user desires.  The directory
X is entered with the square brackets as with the SET DEFAULT command.
X START may also be set to CURRENT in which case the default directory
X is the root directory.
X
X Simply type SWING[/START=directory] at the VMS prompt.
X
X Limitations:  SWING cannot handle directory trees with more than 3500 
X directories, more than 8 levels deep, or that require more than 500
X lines to display.
X2 Moving_around
X Once SWING has drawn a picture of the default directory structure the
X cursor will be positioned at the current directory and it will be
X highlighted.  The arrow keys can be used to move from one subdirectory
X to another.  As you travel around you are "setting default" to that
X directory.  To exit simply type X, E, CONTROL-Z or ENTER and you will
X return to VMS in the new directory location. 
X 
X As you move around with the arrow keys notice that the RIGHT, UP and 
X DOWN arrows take you to the first directory available in that direction 
X and that the LEFT arrow takes you to the parent of the current directory.
X Typing B will take you to the bottom of the tree and typing T will take
X you to the top (root directory).
X
X Other commands can be entered to create, rename and move subdirectories,
X as well as delete entire directory trees and get a hardcopy listing of
X the current directory structure.  To get help on these various commands
X enter the section of help called COMMANDS. 
X2 Save_file
X Every time SWING displays a directory tree it gets its information from
X either searching the disk or from a save file called SWING.SAV located
X in the main directory.  If SWING is going to be used on a regular basis
X it is advisable that the structure be saved in such a file.  The SAVE
X command will create a SWING.SAV file and from that point on SWING will
X attempt to keep that file up-to-date.  Having the save file will speed
X up initialization so much that it might be tempting to use SWING for
X "setting default" all of the time. 
X 
X If the directory structure is changed in any way by SWING the save file
X will be updated automatically, but if a change has occurred without the
X use of SWING it will be necessary to do a manual SAVE on the new
X directory tree.
X 
X NOTE: SWING does purge the save files located in the main directory,
X       provided the current process has enough privilege.
X2 Commands
X Commands can be entered by either hitting the first letter of the
X commands located on the menu at the top of the screen or by hitting the
X CONTROL-P or DO keys and using the menu bar like a pulldown menu.  The
X pulldown menu is operated by using the arrow keys to go to a selection
X and then hitting the ENTER key to choose that item.  CONTROL-Z will exit
X the pulldown menu without making a choice. Although the pulldown menu is
X cute, hitting the first letter of the commands is by far a faster
X method. 
X3 Create
X CREATE prompts the user for the name of a new subdirectory to be created.
X The display will be updated and an actual directory is created. 
X3 Rename
X RENAME prompts for a new name to be given to the current directory.  The 
X display may change since the directories are in alphabetical order.
X3 Move
X MOVE initiates the move operation by blinking the current subdirectory
X and then the user is asked to move to the a new parent directory.  When
X either RETURN or ENTER is hit the move takes place.  Both the new parent
X and the directory being moved can have other subdirectories attached to
X them as well.  While moving to the new parent directory the operation
X can be canceled by hitting any key besides the arrow keys, ENTER and
X RETURN. 
X3 Delete
X DELETE causes the current directory and all subdirectories below it to 
X be deleted automatically.  The user is asked to enter YES before any 
X delete operation takes place and the word YES must be spelled out 
X completely.  The deletion starts at the lowest subdirectory in the tree 
X and works its way back to the current directory.  As files are being 
X deleted from a subdirectory that node will blink on the screen.  If the
X subdirectory is successfully deleted the node name will blank out, so you
X can watch the directory tree being deleted graphically. 
X
X IMPORTANT: IF A FILE DOES NOT HAVE DELETE ACCESS FOR THE USER, SWING 
X            WILL ATTEMPT TO CHANGE THE PROTECTION ON IT SO THAT IT CAN
X            DELETE THE FILE (GIVEN THE PRIVILEGE OF THE USER ONLY)
X
X If a particular subdirectory or file still can't be deleted then the
X deletion process will continue anyway, leaving the protected files. 
X A message will be given stating the problem.
X3 Print
X PRINT creates a file for printing that contains a hardcopy version of 
X the directory structure.  One of two file types can be created.  The 
X normal output is for any printer and the LQP input file is for running 
X through the LQP utility on a laser printer for a clean line drawn 
X representation of the directory tree.  The file is called SWING.LIS and 
X it will be placed in the current directory.
X3 Save
X SAVE causes a new save file to be created in the main directory.  The 
X save file is for speeding up the initialization of SWING.  See the 
X section called SAVE_FILE on the level of help above this level.
X3 FILER
X This is the file-management portion of the SWING utility.  It can be 
X used to delete, edit, move, print, or rename files in the current 
X directory.
X
X Limitations: The filer can only handle 500 files.  If a directory
X contains more than 500 files, the first 500 are displayed and the
X rest are not available.
X3 Option
X OPTION lists addition facilities available in SWING.  The desired option
X is selected by using the up- and down-arrows to position the cursor over
X the option then pressing RETURN.
X4 DCL Command
X This option allows the user to execute any DCL at the prompt.  SWING
X WILL NOT reflect changes made to the directory structure by these
X commands.  This option is non-interactive and should not be used for
X commands that do not return to the DCL prompt after completion.  The
X output is printed in the DCL Command window and reverse scrolling is 
X not possible.
X
X WARNING: THIS OPTION IS PRONE TO RANDOM BUGS.  THE OUTPUT MAY NOT
X MATCH THE OUTPUT SEEN AT COMMAND LEVEL.  THIS OPTION MAY ALSO CAUSE
X SWING TO HANG.  THIS CAN BE OVERCOME WITH A CTRL-Y BUT THE SUBPRO-
X CESS 'SWING_DCL_PROC' MUST BE STOPPED FOR FURTHER USE OF SWING.
X4 Display Directory
X DISPLAY DIRECTORY causes an optional full directory specification to be 
X displayed at the top of the screen.  The directory name will be modified
X each time the user moves to a new directory location.
X4 FILER
X This is the file-management portion of the SWING utility.  It can be 
X used to delete, edit, move, print, or rename files in the current 
X directory.
X
X Limitations: The filer can only handle 500 files.  If a directory
X contains more than 500 files, the first 500 are displayed and the
X rest are not available.
X5 Commands
X Commands can be entered by either hitting the first letter of the
X commands located on the menu at the top of the screen or by hitting
X the control-P or DO keys and using the menu bar like a pulldown menu.
X The pulldown menu is operated by using the arrow keys to go to a
X selection and then hitting the ENTER key to choose that item. 
X Control-Z will exit the pulldown menu without making a choice. 
X Although the pulldown menu is cute, hitting the first letter of the
X commands is by far a faster method.
X6 Delete
X DELETE causes the current file to be deleted.  The user is asked to
X enter YES before any delete operation takes place and the word YES
X must be spelled out completely.
X6 Edit
X EDIT invokes an editor with the current file as input.  The editor
X invoked is that specified in the logical name, SWING$EDIT.  SWING
X looks for translations in the following tables, in the following
X order: LNM$PROCESS, LNM$JOB and LNM$SYSTEM.  If this logical name
X is not defined, the default is TPU.  When the user exits the editor,
X control returns to the filer.  Any new files created by the editor
X will be displayed in the filer window.
X6 Move
X MOVE allows the user to move the current file to another directory. 
X The user is asked to move the cursor to the new host directory
X using the arrow keys.  When either RETURN or ENTER is hit the file
X is moved.  The operation may be aborted at any time by hitting any
X key besides the arrow keys, RETURN, or ENTER.
X6 Print
X PRINT causes the current file to be sent to the printer defined by
X SWING$PRINT.  SWING looks for translations in the following tables,
X in the following order: LNM$PROCESS, LNM$JOB, and LNM$SYSTEM.  If
X this logical name is not defined, the default is $PRINT.
X6 Rename
X RENAME prompts the user for a new name to be given to the current
X file.  The display will reflect the change and keep the files
X listed in alphabetical order.
X6 Option
X This command allows for expansion of the filer.  Available options
X are listed in the pulldown menu and a selection is made by using
X the arrow keys to highlight the desired option then hitting RETURN.
X7 DCL Command
X This option allows the user to execute any DCL at the prompt.
X SWING WILL NOT reflect changes made to the directory struc-
X ture by these commands.  This option is non-interactive and
X should not be used for commands that do not return to the DCL
X prompt after completion.  The output is printed in the DCL
X Command window and reverse scrolling is not possible.
X
X WARNING: THIS OPTION IS PRONE TO RANDOM BUGS.  THE OUTPUT MAY
X NOT MATCH THE OUTPUT SEEN AT COMMAND LEVEL.  THIS OPTION MAY
X ALSO CAUSE SWING TO HANG.  THIS CAN BE OVERCOME WITH A CTRL-Y
X BUT THE SUBPROCESS 'SWING_DCL_PROC' MUST BE STOPPED FOR
X FURTHER USE OF SWING.
X6 Quit
X QUIT causes the filer to be stored and returns control to SWING.  The keys
X Q, control-Z and ENTER quit the filer.
X3 Exit
X EXIT causes the SWING to exit to the currently selected subdirectory or 
X directory.  The keys E, X, CONTROL-Z and ENTER exit SWING.
$ GoSub Convert_File
$ Goto Part04
