Click on FTP to download from the FTP archives.
![[FTP]](http://www2.encompassus.org/hidedecus/graphics/i_ftp.gif)
Copyright © 1990--1994 by MadGoat Software. This code may be freely
distributed and modified for non-commercial purposes as long as this
copyright notice is retained.
========================================================================
FLIST v2.2-1 is a file and directory manager written in VAX TPU and
VAX C (DEC C). The program was originally written in 1987 by Hunter
Goatley. FLIST v2.0 includes many new features, added by Hunter
Goatley and Peter Galbraith. (Generic EVE and DCL code by Peter
Galbraith is provided to support a "kept" EVE subprocess. This code is
compatible with the code used by EVEplus.)
Please forgive me for the bad code---I wrote it quickly and have never
had the time to go back and really do much with it. It isn't as
pretty as I'd like, but it works.
To build, simply execute BUILD_FLIST.COM. This version of FLIST has
been tested on VMS V5.3-1 through v5.5-1 and on OpenVMS AXP (Alpha)
v1.0. Earlier versions will report errors during startup because
FLIST uses new (since 5.2) TPU features to change default directories
and provide support for DECwindows.
To use, you must define a logical and a symbol:
$ define FLIST_TPU_SECTION device:[dir]FLIST.TPU$SECTION
$ flist :== $device:[dir]flist.exe
You can then type
$ FLIST [file-spec]
The optional file-spec can contain wildcards. Once inside of FLIST, you
can type H for a one-line description of some of the commands. Pressing
PF2 will show you a list of all key definitions.
All of the FLIST commands consist of either single-key presses or
GOLD-key combinations; be careful which characters you type once inside
FLIST. (If you use a DECwindows mouse for cut and paste between
DECterms, be careful that you don't paste into a DECterm running FLIST,
because each pasted character will be treated as an FLIST command.)
If you don't want to define the logical, simply change the following
line in FLIST.MAR to point to the section file FLIST.TPU$SECTION:
SECTION: .ASCII /FLIST_TPU_SECTION/
Simply replace FLIST_TPU_SECTION with the full file specification.
If you find bugs, drop me a line and I'll see what I can do. If you fix
it, send me the fix and I'll incorporate it in my version.
Known limitations:
o Long file names get truncated and can't be viewed; it's one of
those little bugs I just haven't gotten to yet.
A mailing list has been established for FLIST discussions and
announcements. To subscribe, send the following line in the body of a mail
message to LISTSERV@WKUVX1.BITNET
SUBSCRIBE FLIST-L "Your real name"
I welcome any comments.
Hunter
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Hunter Goatley, VAX Systems Programmer E-mail: GOATHUNTER@WKU.EDU
ACRS, Western Kentucky University Voice: 502-745-5251
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
FLIST v2.1 Description
Authors: Hunter Goatley, goathunter@wkuvx1.bitnet
Peter Galbraith, galbrth@ac.dal.ca
A mostly-complete list of changes can be found at the beginning of the
FLIST.TPU source file. A number of bugs were fixed. The following
list presents the biggest changes/enhancements to FLIST v2.1:
o The RETURN key has been redefined so that it will VIEW a file in
the main buffer and return to the directory if viewing a file.
This change should be much more natural than the previous methods
for viewing and returning.
o The wildcard spec for the search is displayed on the status line.
o If only one file matches the wildcard spec, you are automatically
placed in the view buffer. I frequently use FLIST just to browse
through a file; since I usually know the file name, I just
specify enough to make it unique and FLIST views it....
o Modified purge so it can rename the version of the remaining file
to ;1 (resets it to ;1). This is controlled by the variable
flist$reset_on_purge (see FLIST.INIT for more information). This
is enabled by default.
o Modified "flist_find" to accept RETURN as "yes."
o Added support for configuration variable flist$default_editor,
which can be used to change the default editor from spawned EVE
to callable EDT. See FLIST.INIT for more information.
o Fixed tagged-file bug that was causing files to be untagged even
if an error occurred.
o Fixed copy-file bug.
o Modified the check for directories so that only files with the
directory header bit set are displayed as directories.
o GOLD-R has been defined to re-scan the directory, using the current
wildcard specification. Useful when editing multiple files that
don't get displayed when new versions are created. Same as "W",
except there is no prompt for the wildcarded file spec.
o Various tree bugs fixed.
o Added ability to sort files based on the file type instead of the
name. Controlled by flist$sort_by_types in FLIST.INIT.
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
FLIST v2.0 Description
Authors: Hunter Goatley, goathunter@wkuvx1.bitnet
Peter Galbraith, galbrth@ac.dal.ca
FLIST v2.0 contains an almost-completely-new interface. There are now
two windows created when FLIST is started: a window of subdirectories
and a window of all non-.DIR files in the specified directory. In
addition, a "graphical" directory tree interface has been added, as well
as support for a DECwindows mouse.
Numerous bugs have been fixed, ranging from errors trying to copy files
to purely-visual enhancements.
Some of the features include:
o Separate subdirectory and file windows (can be resized)
o Graphical tree interface (GOLD/T)
o CD directory changer which uses abbreviations
o Ability to connect to a "kept" editor in a subprocess
o Separate key map lists for the various buffers, including
user key maps
o Support for DECwindows mouse ("M" and GOLD/S)
o Support for an initialization file containing user
customizations (see the file FLIST.INIT)
o Option to repaint screens instead of scroll
o Ability to copy, rename, and purge tagged files
o Ability to view a full-screen MESSAGES buffer
o Ability to shift the windows left and right
o Ability to show all key definitions for a given buffer (PF2)
The number of keys defined are too numerous to list here. The
documentation for FLIST is sparse, but the product is (hopefully)
intuitive enough that you should be able to understand what it does by
simply playing with it.
In addition to the documentation below, the sample initialization file
FLIST.INIT contains extensive documentation about user-settable
parameters.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Kept Editor: (see also KEPT_EDIT.README)
~~~~~~~~~~~~
FLIST allows the use of a kept editor (spawned in a sub-process)
although none is provided. It should work with EVEPLUS without
modification.
Your kept editor should:
o Have defined the logical name KEPT_EDIT in the JOB table to hold
the the process name of the editor. FLIST will translate it and
attach to this process. This is usually defined by the COM file
which you call to spawn and create the editor.
o When you attach to the kept editor process, it should translate
the logical name EDIT_NEW_FILE to get the filename of the new
file to edit. FLIST will define this logical in the JOB table.
Note that a simple TPU `file_parse' or `file_search' statement
can translate the logical for you.
o Optionally, it may translate the logical name EDIT_NEW_DEFAULT
which FLIST sets as the current default directory.
Note that a TPU `file_parse' statement can translate the logical.
The following keys are defined in FLIST for the kept editor:
K - Attaches to kept editor.
GOLD\K - Attaches to Kept editor to edit the file under cursor.
M3 - (mouse button 3 when mouse is activated using "M")
Pressing M3 down highlights the file under the mouse.
Move the mouse off of the selected line and release to cancel
or release with the mouse still on the selected line to attach
to the kept editor with the selected file.
Tree
~~~~
A directory tree is displayed by pressing GOLD\T while in the
directory/file list. Pressing GOLD\T will display the Tree and
position the cursor on the current default directory. The movement
keys are then defined to let you move around as well as:
<RETURN> exits back to the directory/file list
V or M2 select directory under cursor and redo directory/file list
(The mouse works again as describe above, move and release
to cancel the selection)
L position cursor on current default directory
GOLD\T redo the TREE (if newer directories were created)
The Tree is only built the first time you invoke it. Pressing GOLD\T
in the directory/file list afterwards simply put you back into the
existing Tree with the cursor on the current default directory.
Pressing GOLD\T again once in the Tree re-builds it.
CD
~~
CD replaces the DCL "SET DEFAULT" command with a shorthand that
permits the use of abbreviations for each directory name. It also
allows the use of UNIX style directory separators (/).
It automatically pops-up the directory tree if it cannot not find
the search list below the current default (see examples).
Normal_Use
CD F.SE ==> SET DEF [F*.SE*] where F and SE are abbreviations
to directory names.
If the directory is not found below, then the search
starts above. All directories are validated.
CD F/SE ==> UNIX style directory separators can be used.
Features - supported prefixed tokens:
CD \ ==> Goes to SYS$LOGIN.
CD ~ ==> Goes to SYS$LOGIN (UNIX style)
CD \SUBDIR ==> Goes to SYS$LOGIN and then searches for SUBDIR*.DIR
CD .. ==> Pops-up one level (equivalent to SET DEF [-]).
CD $DISK: ==> Forces "SET DEF DISK:" without validation.
The use of logical names can be made preceded by "$".
Examples
o You may put any number of prefix token before the abbreviated
search list:
CD .... will pop twice.
CD \.. will go to SYS$LOGIN and then pop.
CD \..A.B will go to SYS$LOGIN, pop and search for [.A*.B*]
o SYS$LOGIN Asuming the default directory is
\ [.FORTRAN.PROJECT]
FORTRAN
/ \ $ CD T will go to TEST below.
CODE PROJECT $ CD C will go to CODE because
\ nothing that starts with
TEST C is found below PROJECT
so that it will move up
to FORTRAN and look again
and find CODE.
$ CD \F.C will again go to CODE
o Current default is:
DISK4:[GALBRTH.UTILITY.COM_FILES.EVE.BETA.POSITION]
CD T.K.C will search for:
(*) DISK4:[GALBRTH.UTILITY.COM_FILES.EVE.BETA.POSITION.T*.K*.C*]
will not find a directory, will search for:
DISK4:[GALBRTH.UTILITY.COM_FILES.EVE.BETA.T*.K*.C*]
will not find a directory, will search for:
DISK4:[GALBRTH.UTILITY.COM_FILES.EVE.T*.K*.C*]
will not find a directory, will search for:
DISK4:[GALBRTH.UTILITY.COM_FILES.T*.K*.C*]
will not find a directory, will search for:
DISK4:[GALBRTH.UTILITY.T*.K*.C*]
and will find:
DISK4:[GALBRTH.UTILITY.TEX.KATIA.CV]
(*) Note that CD will actually skip this level and pop because
it knows the directory can only be 8 levels deep.
Click on FTP to download from the FTP archives.