home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-385-Vol-1of3.iso
/
f
/
flaka101.zip
/
FLAK.HLP
< prev
next >
Wrap
Text File
|
1992-10-04
|
101KB
|
2,462 lines
%@tit FLAK 1.01 - File List & Access by Keyboard
%@toc 0003966 Title
%@toc 0004665 Technical Support
%@toc 0005357 Introduction
%@toc 0006092 Copyright Notice
%@toc 0006802 DISCLAIMER NOTICE
%@toc 0007671 Shareware License/Registration/Distribution Notice
%@toc 0011400 Registration Form
%@toc 0013342 Description
%@toc 0014804 Requirements
%@toc 0015346 Installation & Setup
%@toc 0015963 Documentation Syntax Conventions and Notations
%@toc 0018234 Display Screen
%@toc 0021921 Startup: General
%@toc 0022461 Startup: [listi]
%@toc 0026540 Startup: [options]
%@toc 0032852 Startup: Configuration File - General
%@toc 0033128 Startup: Configuration File - Parameter Record
%@toc 0033673 Startup: Configuration File - Function Key Record
%@toc 0034748 Startup: Configuration File - Extension Record
%@toc 0035969 Startup: Configuration File - Alias Record
%@toc 0036871 Keys: Brief Description (Also available via F1)
%@toc 0038172 Keys: ENTER (execute command areas)
%@toc 0038295 Keys: CTL-ENTER (display command areas)
%@toc 0038693 Keys: ESC (clear commands, exit)
%@toc 0039133 Keys: F1 (HelpPrompt)
%@toc 0039869 Keys: F2 (HelpBar, HelpFile)
%@toc 0040227 Keys: Others (Detailed Descriptions)
%@toc 0042133 Command Area: General
%@toc 0042877 Command Area: Automatic Fileid Appending
%@toc 0043716 Command Area: Automatic Fileid Appending Cancellation
%@toc 0044158 Command Area: Automatic Directory Navigation
%@toc 0044750 Command Area: :EXT (Extension) Processing
%@toc 0045615 Command Area: :ALIAS (Alias) Processing
%@toc 0046544 Command Area: Substitution Strings and Flags
%@toc 0049426 Command Area: Application/Command Execution ('Launching')
%@toc 0050723 Command Area: CD (Change Directory)
%@toc 0051250 Command Area: D: (Drive)
%@toc 0051777 Command Area: RENAME (Move)
%@toc 0052562 Command Area: ERASE/DELETE **WARNING**
%@toc 0054157 FLAK Command: General
%@toc 0054767 FLAK Command: = (Repeat Previous Command)
%@toc 0055642 FLAK Command: ? (Reset Previous Command)
%@toc 0057594 FLAK Command: / (Make first line in display)
%@toc 0059870 FLAK Command: /A (Search specific file Attributes)
%@toc 0060844 FLAK Command: /B (Bell is audible or not)
%@toc 0061628 FLAK Command: /CD (Change Drive/Directory)
%@toc 0063250 FLAK Command: /CL (Change Drive/Directory and List)
%@toc 0066647 FLAK Command: /D (Display 'nn' or maximum fileids)
%@toc 0067437 FLAK Command: /DI (Display <fileid> or specified file)
%@toc 0068380 FLAK Command: /E (Execute .BAT, .COM, .EXE files)
%@toc 0069169 FLAK Command: /F (Find fileid with(out) chars)
%@toc 0071854 FLAK Command: /G (Get Project disk file data)
%@toc 0073047 FLAK Command: /H (HelpBar visible or not)
%@toc 0073784 FLAK Command: /K (Display/reset Function Keys)
%@toc 0074303 FLAK Command: /L (Reset [listi] data and list)
%@toc 0077178 FLAK Command: /L+ (Append [listi] data and list)
%@toc 0079285 FLAK Command: /M (Mark/Move fileids in the list)
%@toc 0081645 FLAK Command: /O (Order files by field value)
%@toc 0083166 FLAK Command: /P (Put fileid|[listi] to disk file)
%@toc 0084881 FLAK Command: /R (Refresh display after DOS)
%@toc 0085801 FLAK Command: /S (Maximum RAM Storage required)
%@toc 0086710 FLAK Command: /T (Search Tree for all occurrences)
%@toc 0088071 FLAK Command: /V (Set Video characteristics)
%@toc 0088865 FLAK Command: /XI (Exit FLAK)
%@toc 0089776 FLAK Command: /Y (Set Substitution Symbol)
%@toc 0090804 Project Files
%@toc 0093753 Resource Utilization & Optimization
%@toc 0095754 Network Execution
%@toc 0096085 Windows Installation
%@toc 0096880 Hints
%@toc 0099136 Version History
%@toc 0099538 HELP Utilization
%@sec Title
%@ign variable text = FLAKA101 1.01 170KB 10/04/92
%@ign condxtrc: bbs = Bulletin Board Service distribution
%@ign condxtrc: dsk = Disk distribution
%@ign file: flakread.me2 start
FLAK
File List & Access by Keyboard
Version 1.01
(BBS)
10/04/92
Copyright 1992 Paul J. Dickler, all rights reserved:
Users, sysops, and vendors are responsible for compliance with the
Copyright, DISCLAIMER, and Shareware License/Registration/Distribution
notices in this document.
%@ign
%@sec Technical Support
Technical support for installation is via the command:
FLAKINST
which offers Authenticity Verification information, demonstration
displays (tutorial), video color/attribute selection, registration,
production promotion, and more.
Technical support for 'Requests For Modification' and 'Problem Reports'
is available to registered users via:
Compuserv: 71763,3277
Mail: Paul J. Dickler
P.O. Box 732
Denville, NJ 07834
When requesting such support, be sure to specify the FLAK version you
are executing, your system configuration, and where you obtained your
copy of FLAK (BBS, vendor, etc.).
%@ign
%@sec Introduction
FLAK is a full-screen file listing program which provides a convenient
method of accessing and manipulating files from multiple drives and/or
directories simultaneously. It is intended for PC users executing DOS
commands, batch files, user programs, and utilities, and creates a very
productive working environment.
FLAK commands allow sorting, appending, rebuilding, saving, and
restoring the interactive onscreen file list, and more. A Configuration
File allows the user to specify command abbreviations and aliases,
default commands for specific file extensions, and function-key
definitions for frequently-issued commands.
Requires: DOS 3.00, 170KB, hard disk. Registration: US $25/35.
%@ign
%@sec Copyright Notice
"FLAK" (the FLAK program, support programs and files - the "Software")
is copyrighted material, and remains the property of the author.
All users are automatically granted a limited license to distribute and
evaluate the Software in accordance with the terms and conditions in the
"DISCLAIMER NOTICE" and "Shareware License/Registration/Distribution
Notice", which follow.
┌──────────────────────────────────────────────────────────────────────┐
│ Continued use of the Software requires registration and payment, as │
│ described below. │
└──────────────────────────────────────────────────────────────────────┘
%@ign
%@sec DISCLAIMER NOTICE
"FLAK" IS LICENSED ON AN "AS IS" BASIS, WITH NO WARRANTIES, EITHER
EXPRESS OR IMPLIED, WITH RESPECT TO ITS MERCHANTABILITY OR FITNESS FOR
ANY PARTICULAR PURPOSE.
ALTHOUGH GREAT EFFORT HAS GONE INTO THE DESIGN, CREATION, AND TESTING OF
THE SOFTWARE, THE VARIABILITY OF COMPUTING ENVIRONMENTS INTO WHICH IT
MAY BE LOADED AND EXECUTED REQUIRES THAT THE USER ACCEPT THE ENTIRE RISK
OF ANY AND ALL DAMAGES WHICH MAY BE SUFFERED.
ANY LIABILITY OF THE AUTHOR IS LIMITED EXCLUSIVELY TO PRODUCT
REPLACEMENT OR REFUND OF REGISTRATION FEE.
THESE TERMS AND CONDITIONS WILL BE CONSTRUED AND ENFORCED IN ACCORDANCE
WITH THE LAWS OF THE STATE OF NEW JERSEY, COUNTY OF MORRIS, USA, AS
APPLIED TO CONTRACTS ENTERED INTO AND PERFORMED WITHIN THAT
JURISDICTION.
SEE "SHAREWARE LICENSE/REGISTRATION/DISTRIBUTION NOTICE" WHICH FOLLOWS.
%@ign
%@sec Shareware License/Registration/Distribution Notice
FLAK is distributed as "shareware".
That is, the author, while retaining all rights, makes the Software
freely available to users, sysops (system operators), and vendors for
distributing, testing, and using under the following terms and
conditions:
License
────────────────────────────────────────────────────────────────────────
FLAK is licensed in 2 phases:
1. Testing
License is automatically granted to all users to test FLAK for a
reasonable period of time.
2. Using
If, after the above test period, the user decides to use FLAK on a
continuing basis, the user must 'register' such usage as follows:
(See 'Registration Form' below for associated fees.)
Registration
────────────────────────────────────────────────────────────────────────
User Type:
──────────
Single User
───────────
For each possible simultaneous individual user, 1 registration is
required. A single user may place a copy of the Software on any
number of computers, as long as only 1 copy is being executed at any
given time. However, multiple executions by a single user in a
multi-tasking environment (i.e., multiple windows) are considered an
individual use.
Multiple User
─────────────
For each possible simultaneous individual user, 1 registration is
required. Multiple users executing a single copy of FLAK in a
network environment require multiple registrations. However,
multiple executions by each user in a multi-tasking environment are
considered an individual use.
Version Type:
─────────────
In-use Version
──────────────
Upon registration, user receives instructions on removing the
Shareware 'reminder' prompt from the FLAK program already in use.
Upgrade Version
───────────────
Upon registration, user receives instructions on removing the
Shareware 'reminder' prompt from the FLAK program already in use.
Also, when available, user receives the next upgrade version of FLAK
and instructions for removing its reminder prompt.
Distribution:
───────────────────────────────────────────────────────────────────────
FLAK may ONLY be distributed by transmitting or copying the file:
FLAKA101.ZIP
a compressed, virus-proof, Archive (requires PKUNZIP (PKWARE, Inc)).
Modification of the above, or distribution of any expanded FLAKA101
Archive files is STRICTLY FORBIDDEN, except as follows:
┌──────────────────────────────────────────────────────────────────────┐
│ Sysops and vendors may add files to the FLAKA101 Archive via the │
│ PKZIP (PKWARE, Inc) program. However, the ORIGINAL FLAKA101 Archive │
│ MUST BE PRESERVED, because it contains Authenticity Verification │
│ data, which is cited in the Installation and Setup procedures. │
└──────────────────────────────────────────────────────────────────────┘
Note:
Since the FLAKA101 Archive contains data encryption technology, it may
not be exported outside the United States or Canada. Please contact the
author if an export version of the Software is required.
Additionally:
Users
─────
Users are encouraged to distribute FLAK to friends and other users,
as above.
Sysops
──────
Sysops may charge at most the standard rate for the Sysops' services
for connect time, file transmission, file copying, etc., for the
above.
Vendors
───────
Vendors may charge at most US $5 for the above.
Additionally, vendors must notify the author, in writing, of any
distribution mechanism in use.
%@ign
%@sec Registration Form
%@ign file: flakreg.frm start
FLAK 1.01 (BBS) - File List & Access by Keyboard - Registration Form
Date: ___________________
Send (and make check/money order payable) to:
Paul J. Dickler
P.O. Box 732
Denville, NJ 07834
From:
Name: __________________________________
(Company:) __________________________________
Street: __________________________________
__________________________________
City: __________________________________
State/Zip: __________________________________
In-use Version:
---------------
Version Number: _________________________
Vendor/Distributor: _________________________
Single user US $25
2 - 10 users US $23 each Count: ______
11 - 20 users US $21 each
21 & up users US $19 each Sub total: _____________
Upgrade Version:
----------------
Single user US $35
2 - 10 users US $33 each Count: ______
11 - 20 users US $31 each
21 & up users US $29 each Sub total: _____________
Diskette format (circle/check one):
5.25" ______ 3.5" ______
Distribution is by single diskette - Count: ______
Extra copies: US $5 each Sub total: _____________
Distribution outside of United States
and Canada: US $5 Sub total: _____________
New Jersey residents -
Add state tax: %6.0 Sub total: _____________
Enclosed Grand total: _____________
%@ign file: flakread.me2 stop
%@ign file: flakreg.frm stop
%@ign
%@sec Description
FLAK is a full-screen file listing program which provides a convenient
method of accessing and manipulating files from multiple drives and/or
directories simultaneously. It is intended for PC users executing DOS
commands, batch files, user programs, and utilities, and creates a very
productive working environment.
A list of files from any combination of drives and directories is
created and displayed. DOS commands may then be entered on the screen
which automatically include all (or specified) parts of the displayed
fileids (a file's drive, path, file-name, file-extension) as required,
or desired.
Batch files and applications may be 'launched' in the same manner.
'Project Files' containing file/path information may be created and
subsequently read to display specific collections of files.
FLAK Commands may also be entered to sort, rebuild, append, modify, and
manipulate the onscreen file list and display, and cause special actions
during DOS command processing.
As further aids to productive file manipulation, Configuration Files may
be utilized which can contain:
* abbreviations and aliases for commands
* default commands for specific file extensions
* function-key definitions for frequently-issued commands
Different Configuration Files may be utilized for various combinations
of the above, allowing highly customized working environments for
different projects.
%@ign
%@sec Requirements
FLAK executes on any IBM PC or compatible running DOS 3.xx or higher.
FLAK utilizes approximately 170KB (kilobytes) of RAM, providing a
minimum file list of 200 entries. Approximately 25 more bytes are
obtained for each additional entry above the 200, up to the current
implementation limit of 2,000.
A hard disk is strongly recommended because FLAK can be instructed to
'swap' itself from RAM to disk during DOS command execution to maximize
available RAM. See 'Resource Utilization & Optimization'.
%@ign
%@sec Installation & Setup
%@ign file: flakread.me start
FLAK 1.01 (BBS) Installation and Setup (hard disk):
1. Create a new directory ('c' drive assumed here). Enter:
C:
MKDIR \FLAK
2. Make the new directory current. Enter:
CD \FLAK
3. Download/copy the 'FLAKA101.ZIP' Archive from your Bulletin
Board Service (BBS) into the new directory.
4. Expand the Archive. Enter:
PKUNZIP FLAKA101
Important: Note all "-AV", warning, and final messages.
5. Continue FLAK Installation and Setup. Enter:
FLAKINST
%@ign file: flakread.me stop
%@ign
%@sec Documentation Syntax Conventions and Notations
Syntax Conventions:
───────────────────
Upper-case is generally used to indicate characters or commands which
are to be entered as they appear, although when actually entered,
lower-case may be utilized.
Lower-case is generally used to indicate characters or commands which
are to be replaced by a user-specified parameter.
A REQUIRED parameter, or choice of required parameters, is indicated by
enclosing it within vertical bars. That is, the following indicate that
'name0', and EITHER 'parm1' OR 'parm2' MUST be specified. The vertical
bars, however, are not coded:
|NAME0| |PARM1|PARM2| |PARM1|
|PARM2|
An OPTIONAL parameter, or a choice of optional parameters, is indicated
by enclosing them within brackets, separated by a vertical bar, or
enclosed within vertical bars. That is, the following indicate that
EITHER 'name0', 'name1', 'name2', OR NOTHING may be specified. The
brackets and bars are not coded:
[name0] [name1|name2] [|name1|]
|name2|
If a parameter may be REPEATED, it will be followed by elipses:
[...]
Notations:
─────────-
The following notation:
[pathi]
is used to indicate a path specification consisting of all or some
of the following:
[d:][\path\][fileid]
where:
[d:]
Is a drive letter (A-Z), followed by a colon, as shown.
[\path\]
Is a complete path specification to a sub-directory, with
the backslashes as shown.
[fileid]
Is a fileid specification which may contain the '?' and
'*' characters (as in the DOS DIR command) to represent a
single character or any number of characters,
respectively.
The following notation:
[listi]
is a list of one or more drives, paths, fileids, 'special' file
descriptors, or file attribute specifications, and is discussed
fully in following sections.
The following notation:
<ENTER>
<ESC>
etc...
indicates that the named key is pressed.
%@ign
%@sec Display Screen
FLAK displays the following screen:
┌─────────────────────────────────────────────────────────────────────┐
│ FLAK v/as <<<<<<<<< current drive/directory >>>>>>>>> calendar/clock│
│ fs/fmax <<<<<<<< [listi] specification >>>>>>>>> (error message)│
│ <fileid> <size> <date> <time> <path> │
│ <fileid> <size> <date> <time> <path> │
│ <fileid> <DIR> ------ ------ <path> │
│ ...etc... │
│ ~~ bytes~~ nnnnnn ------ ------ <path> │
│ ...etc... │
│(<<<<<<<<<<<<<<<<<<<<<<<<<< HelpBar >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>)│
└─────────────────────────────────────────────────────────────────────┘
Where:
Field Video
Description Characteristics
--------------------------------------------------------------------
FLAK (Normal)
Indicates the FLAK program.
|v/ | (Normal)
| /as| (Intense)
Indicates the program Version number.
Or, if the '/A...' Attribute Specification has been issued,
this field will indicate the file attributes currently included
in any subsequent search, with the following characters:
D - Directory files.
S - System files.
H - Hidden files.
A - Archive flag set.
R - Ready/only flag set.
current drive/directory (Hilight)
Is the DOS Current Drive and Current Directory.
calendar/clock (Normal)
Shows the current day, date, and time.
The clock is updated only when the display is refreshed, not
dynamically.
fs/fmax (Intense)
Shows the number (within the file list) of the first entry on
the screen, followed by the total number of entries in the
list.
[listi] specification (Intense)
Is the list information specification which created the file
list.
error message (Intense)
If present, indicates what error occurred.
|<fileid>| |<size>| <date> <time> <path> (Normal)
|<attr>| (Intense)
Indicate the fileid, size (in bytes), date and time of last
modification, and path information for each file in the list.
<fileid> is Intense when Automatic Fileid Appending is in
effect.
<size> field is replaced by <DIR> for parent- and sub-
directories.
<size> field is replaced by <attr> '/A...' file Attribute
characters when F3 key is pressed.
~~ bytes~~ nnnnnn ------ ------ <path> (Normal)
Indicates the total byte count for all files satisfying the
last [listi] search in the <path> directory.
(<< HelpBar >>) (Highlight)
If turned on (by the <F2> key or '/HY' command), the last
display line will show the labels for each defined Function
Key.
%@ign
%@sec Startup: General
FLAK is started by the command:
FLAK [listi] [options]
where:
[listi]
[options]
are described in the following sections.
If no [listi] is specified, all files in the Current Directory are
listed.
If no [options] are specified, the default Configuration File
'FLAK.CFG' is read for pre-coded [listi], [options], Function Key
definitions, command aliases, and abbreviations, and file-extension
default actions. See 'Startup: Configuration File' section for full
details.
%@ign
%@sec Startup: [listi]
[listi] is a list of one or more drives, paths, fileids (possibly
containing 'wild' characters), 'special' file descriptors, or file
attribute specifications, separated by semicolons, as follows (note that
no blanks are allowed):
|[pathi] | [;[pathi]] [;[/A[x...]]] [;[/G[fileid]]]
|T'[pathi] | [;[/G@[fileid]]]
|D'[pathi] |
|A'[fileid]|
|P'[fileid]|
where:
[pathi]
Causes the files in the specified drive and path to be listed.
If [d:] is not specified, the Current Drive is searched.
If [\path\] is not specified, the Current Directory is searched.
If [fileid] is not specified, all files are listed.
[fileid] may contain the '?' and '*' characters as in the DOS DIR
command to represent a single character, and any number of
characters, respectively.
Example: c:\dir1\*.wrk;a:
Lists all .WRK files in the c: drive DIR1 directory and
all files in the a: drive root (\) directory.
T'[pathi]
Causes all directories in the directory TREE to be searched.
That is, all files in the specified (or defaulted) drive and
directory, and all sub-directories are searched.
If [d:] is not specified, the Current Drive is used.
If [\path\] is not specified, the root (\) is used, thus causing a
search of all directories on the drive.
[fileid] (with wild characters) may be specified to filter the list.
Example: t'*.bak
Lists all .BAK files on the Current Drive.
D'[pathi]
Causes a search for sub-Directories only, as with T', above.
That is, all sub-directories in the specified drive and directory,
and all sub-directories are listed.
If [d:] is not specified, the Current Drive is used.
If [\path\] is not specified, the root (\) is used, thus causing a
search of all directories on the drive.
[fileid] may NOT be specified, as only sub-Directories are listed.
Example: d'\test\
Lists all directories in the \TEST directory, and all
subdirectories.
A'[fileid]
Causes the Current Directory and each directory in the APPEND
specification list, if active, to be searched.
[fileid] (with wild characters) may be specified to filter the list.
Example: a'*.exe
Lists all .EXE files in the APPEND directories.
P'[fileid]
Causes the Current Directory and each directory in the PATH
specification list, if active, to be searched.
[fileid] (with wild characters) may be specified to filter the list.
Example: p'*.bat
Lists all .BAT files in the PATH directories.
/A|N|x[x..]|
Specifies the file Attributes for subsequent file searches, where
'x' is as follows:
N - Normal (all files and directory entries)
D - Directories
S - System
H - Hidden
A - Archive flag set on
R - Read/only
Except for 'N', attributes are exclusive, and additive.
For example:
'/AA' lists only files with the Archive flag set.
'/AAR' lists files with the Archive OR Read/only flags set.
This operand takes effect immediately, and must be reset manually.
Thus, the following:
flak \work\;/aa;\prod\
would list all the files in the \WORK directory, but only files with
the Archive flag in the \PROD directory.
Subsequent lists will only include files with the Archive flag on,
until '/AN' (or another Attribute) is specified.
/G[fileid]
Causes FLAK to Get file/path records from the [fileid] disk file,
and list them.
If [fileid] is not specified, 'WRK.FLK' is used.
See 'Project Files' for full details.
/G@[fileid]
Causes FLAK to Get the [listi] specification from the [fileid] disk
file, and list the files described.
If [fileid] is not specified, 'WRK.FLK' is used.
See 'Project Files' for full details.
%@ign
%@sec Startup: [options]
FLAK [options] available are as follows:
/B|Y|N|
Specifies whether the console bell is to be sounded for warnings.
The bell is always sounded for severe errors.
If not specified, the default is 'Y'.
/C[fileid]
Specifies the Configuration File to be read during initialization.
If not specified, defaults to 'FLAK.CFG', which must reside in the
current directory or any PATH specification directory.
If no Configuration File is desired, specify '/CNUL'.
See 'Startup: Configuration File' for full details.
/D|nn|*|
Specifies the number of fileids to display on the physical screen.
Cannot exceed the number of lines in the physical screen.
'/D*' causes all the lines in the physical screen to be utilized.
If not specified, all lines in the physical screen are utilized.
/E|Y|N|
Specifies how Executables (.BAT, .COM, and .EXE files) are to be
handled:
Y - A leading blank Command Area causes Execution.
That is, the Executable <fileid> is pre-pended to any
Command Area input and passed to DOS.
N - An all-blank Command Area causes use of the Configuration
File :EXT definition, if coded, for the above file types.
See 'Startup: Configuration File' for details.
If not specified, the default is 'N'.
/H|Y|N|
Specifies whether the HelpBar is visible or not.
Y - HelpBar is visible.
N - HelpBar is not visible.
If not specified, the default is 'N'.
The HelpBar is also made visible by the first <F2> keypress.
/O[x[ss,ee]]
Specifies the file list sort Order, where 'x' is as follows:
A = Attributes, name, type.
N = Name, type, path.
E = Extension, name, path-order.
T = Type, name, path-order (same as, above).
S = Size, name, type.
D = Date, time, name, type.
P = Path, name, type.
Css,ee
= specific Columns of fileid, where 'ss,ee' specify the
start and end columns, each within the range 1-12.
The comma (,) must be specified, and the columns in
ascending order.
O = sort turned Off.
If not specified, default is '/ON'.
/R|Y|N|
Specifies whether to Refresh the FLAK display immediately after
executing any DOS commands, or wait for a keypress.
Y - The screen is refreshed with the FLAK display immediately
after completion of the last DOS command.
N - The output from DOS commands may be viewed until a keypress
restores the FLAK display.
Whenever '/D[nn]' is issued specifying less than the
maximum number of lines on the physical display, 'Refresh'
is automatically enabled (/RY). This leaves any DOS
command output on the bottom of the display.
Similarly, when '/D*' or '/D[nn]' specifies the maximum
number of lines, 'Refresh' is automatically disabled. This
causes FLAK to wait for a keypress before restoring the
file list display.
/S|Y|N|
Specifies whether maximum RAM Storage is to be allocated for all DOS
commands or not.
Y - Causes the maximum RAM Storage to be allocated by
'swapping' FLAK to a disk file.
This causes increased processing overhead for each DOS
command executed.
N - Causes DOS commands to utilize whatever RAM Storage is
available while FLAK is resident in RAM.
If not specified, the default is 'N'.
See 'Resource Utilization & Optimization' for full details.
/V[c[f,b]]
Specifies the Video characteristics of various display fields,
where:
c - Specifies which field type is to be set, as follows:
N - Is coded as shown, and represents 'Normal'.
H - Is coded as shown, and represents 'Highlighted'.
I - Is coded as shown, and represents 'Intense'.
See 'Display Screen' for which field types are used in
the various display areas.
f,b - Represent the foreground/background color/attribute
specifications, as listed below.
Monochrome attribute specifications:
1,0 - highlighted 1,8 - underline/blinking
7,0 - normal 7,8 - blinking
9,0 - high intensity/underline 9,8 - high intens/underl./blink.
14,0 - high intensity 15,8 - high intens/blink.
7,0 - reverse video 0,15 - reverse video/blink.
Color Foreground attribute specifications:
0 - black 6 - brown 11 - light cyan
1 - blue 7 - white 12 - light red
2 - green 8 - gray 13 - light magenta
3 - cyan 9 - light blue 14 - yellow
4 - red 10 - light green 15 - bright white
5 - magenta
Color Background attribute specifications:
0 - black 6 - brown 11 - cyan/blink.
1 - blue 7 - white 12 - red/blink.
2 - green 8 - black/blink. 13 - magenta/blink.
3 - cyan 9 - blue/blink. 14 - yellow/blink.
4 - red 10 - green/blink. 15 - white/blink.
5 - magenta
For example, to set 'Normal' fields on a color video screen to cyan
characters on a black background, enter:
/VN3,0
During FLAK Installation and Setup, the FLAKINST program has a
utility screen which makes this task an easy one.
/Y|c|
Specifies the Substitution Symbol to cause insertion of fileid
portions in commands, or special Flags to be set during DOS command
execution.
If not specified, defaults to '[' (left bracket).
Note:
Any Substitution Strings coded in a Configuration File must agree
with the defaulted or specified Symbol.
See 'Command Area: Substitution Strings and Flags'.
%@ign
%@sec Startup: Configuration File - General
The Configuration File is read during FLAK initialization, and may
contain the following types of records (all are optional):
Parameter
Function Key definition
Extension default command
Alias command
%@ign
%@sec Startup: Configuration File - Parameter Record
The 'Parameter' record may contain any valid FLAK command-line
specification: [listi], and/or [option].
parameter record
where:
See 'Startup: [options]' and 'Startup: [listi]' for allowed
operands.
Example:
*.exe;*.com;*.bat /bn /ey /od
This parameter record would list all executable files in the Current
Directory, turn the bell off for warnings, run executables with a
blank Command Area, and order the fileids by date.
%@ign
%@sec Startup: Configuration File - Function Key Record
The 'Function Key' record defines a Function Key.
:Kn |label| |[_]command-string|
where:
:K Is coded as shown.
n Is the Function Key number, in the range 4-12.
label Specifies the characters to appear in the HelpBar.
May be 1-8 characters in length, with no blanks.
[_]command-string
Is any number of words, separated by blanks, up to a total
of 66 characters.
May contain any FLAK command, DOS command, Substitution
Symbol, or Flag.
If a leading blank is desired, code the underbar character
('_').
Example:
:k4 Refresh /L=
This labels the F4 key 'Refresh', which issues the FLAK '/L='
command.
Example:
:k5 C-Comp cc [n [s
This labels the F5 key 'C-Comp', which causes execution of the 'cc'
executable. The filename is passed as a parameter, and maximum DOS
storage is allocated.
%@ign
%@sec Startup: Configuration File - Extension Record
The 'Extension' record defines the default command for a particular file
extension to be executed when a blank Command Area is detected. This
allows associating files with appropriate file viewers, editors, etc.
:EXT |ext| |[_]command-string...|
|* | |* |
where:
:EXT Is coded as shown.
ext Is a valid file extension, with NO period ('.').
If '*' is coded, every file extension matches.
[_]command-string...
Is any number of words, separated by blanks, up to a total
of 66 characters.
May contain any FLAK command, DOS command, Substitution
Symbol, or Flag.
If a leading blank is desired, code the underbar character
('_').
If '*' is coded, no action is performed.
Example:
:ext doc browse [r
Here, a blank Command Area for a '.DOC' file causes the 'browse'
executable to be run. After execution, the FLAK display is
refreshed without a pause. Note that, by default, the full <fileid>
will be appended to the command.
%@ign
%@sec Startup: Configuration File - Alias Record
The 'Alias' record defines a command alias/abbreviation.
:ALIAS |keyword| |minlen| |[_]command-string...|
where:
:ALIAS Is coded as shown.
keyword Is the 1-to-8 character command which is to be
replaced.
minlen Is the minimum length of 'keyword' which must be
specified in the Command Area.
[_]command-string
Is any number of words, separated by blanks, up to a total
of 66 characters.
May contain any FLAK command, DOS command, Substitution
Symbol, or Flag.
If a leading blank is desired, code the underbar character
('_').
Example:
:alias purge 4 erase
This defines the following commands to be identical to 'erase':
purge
purg
%@ign
%@sec Keys: Brief Description (Also available via F1)
Once the file list is created and displayed, the following keys are
available (full details below):
Esc - Clear cmnd; Clear all cmnds; Exit Bksp - Backspace char
F1 - HelpPrompt Ins - Toggle Insert mode
F2 - HelpBar, HelpFile Del - Delete character
F3 - Show Alternate Information Fields Home - First screen input
F4 - } End - Input start/end
F5 - } Ctl-Home - Toggle last screen
F6 - } Ctl-Del - Delete to line end
F7 - } PgUp - Next screen
F8 - } User-defined: See HelpBar PgDn - Previous screen
F9 - } Ctl-PgUp - First screen
F10 - } Ctl-PgDn - Last screen
F11 - } Tabf - Next Command Area
F12 - } Tabb - Prev Command Area
Enter - Process Commands
Ctl-Enter - Show DOS commands
but don't execute
%@ign
%@sec Keys: ENTER (execute command areas)
Enter
Causes all Command Areas onscreen to be processed.
%@ign
%@sec Keys: CTL-ENTER (display command areas)
Ctl-Enter
Shows DOS commands but doesn't execute them.
Process all Command Areas, but display resulting DOS commands
only: Do not pass them to DOS for execution. An asterisk
('*') is placed before the command when displayed.
This provides a way of testing a command prior to utilization.
%@ign
%@sec Keys: ESC (clear commands, exit)
Esc Clear cmnd; Clear all cmnds; Exit menu
1st press causes current Command Area to be reset to <fileid>
information.
2nd press causes all Command Areas onscreen to be reset.
3rd press causes Exit Menu display.
Select desired Option with UP/DOWN ARROWs, then
<ENTER>, or cancel with <ESC>.
%@ign
%@sec Keys: F1 (HelpPrompt)
F1 HelpPrompt
Causes a display of available FLAK Commands, Substitution
Symbols, and Flags with select/insert capability.
To use:
* Position the cursor where the Command, Symbol, or Flag is
required.
* Press <F1>.
* Use the ARROW and PAGE keys to select the desired operand.
* Press <ENTER> to insert the operand at the cursor.
Or, Press <F2> for HelpFile information on selection.
* Edit/replace inserted Prompt to complete command input.
* Press <ENTER> to issue command.
Also contains a display of keyboard usage (but with no prompt
capability).
%@ign
%@sec Keys: F2 (HelpBar, HelpFile)
F2 HelpBar, HelpFile
1st press causes HelpBar to replace last utilized screen line.
2nd press causes HelpFile display.
Once entered, press <F1> for Help on HelpFile.
HelpBar is also made visible by the '/HY' command, described
elsewhere.
%@ign
%@sec Keys: Others (Detailed Descriptions)
F3 AltInfo
Toggles between left and right portions of pathi fields, and
HelpBar (if displayed), and Size or Attributes of files.
F4 -
F12 User-definable Function Keys
These Function Keys may be defined in the Configuration File.
Bksp Backspace char
Causes cursor to move left 1 space, the character above it to
be erased, and all characters to the right to be moved left.
Ins Toggle Insert mode
Causes Insert Mode to be turned On, then Off.
Del Delete character
Causes character above cursor to be deleted, and all characters
to the right to move left.
Home First screen input
Causes cursor to be placed at the beginning of the first
Command Area on the current screen.
End Input start/end
1st press moves cursor to end of current Command Area input.
2nd press moves cursor to beginning of current Command Area.
Ctl-Home Toggle last screen
Whenever a FLAK command causes a 'second' display by appending
files to the current file list, this keypress will toggle
between the current and last display positions.
Ctl-Del Delete to line end
Deletes all characters from the current cursor position to the
end of the current line.
PgUp Next screen
Display next full screen of file list.
PgDn Previous screen
Display previous full screen of file list.
Ctl-PgUp First screen
Display first screenful of file list.
Ctl-PgDn Last screen
Display last screenful of file list.
Tabf Next Command Area
Move cursor to beginning of next Command Area on screen.
Tabb Prev Command Area
Move cursor to beginning of previous Command Area on screen.
%@ign
%@sec Command Area: General
Once the file list is displayed, DOS commands may be entered on any line
accessible by the cursor. Use the Tab, Arrow, and Page keys to position
the display and cursor and select the desired fileid(s).
When any input is entered, the <size>, <date>, <time>, and <path> fields
are cleared, thus expanding the Command Area.
DOS commands may be entered for any number of the files on a single
screen, but they are not executed until the <ENTER> key is pressed.
After a command is executed, it is 'commented-out' by an asterisk being
placed in column 1 of the Command Area. If a system error occurs, an
exclamation mark ('!') is placed in column 1 of the Command Area, and
the bell is sounded.
%@ign
%@sec Command Area: Automatic Fileid Appending
If a DOS command begins in column 1 of a Command Area, FLAK auto-
matically adds a blank and the fileid before executing the command.
For example, by simply entering the following (in column 1):
edit
and pressing <ENTER>, FLAK will pass the command:
EDIT fileid
to DOS for execution (where 'fileid' is from the <fileid> field).
If the fileid's path is the Current Directory, only the filename and
extension are inserted.
If the fileid's path is not the Current Directory, then the path is also
inserted.
If the fileid's drive is not the Current Drive, then the drive is also
inserted.
As a reminder of Automatic Fileid Appending, FLAK highlights the fileid
whenever the cursor is in column 1 of the Command Area, or if column 1
is not blank.
%@ign
%@sec Command Area: Automatic Fileid Appending Cancellation
If a Command Area begins with 1 or more leading blanks, FLAK cancels
Automatic Fileid Appending.
Therefore, to execute a DOS command with no fileid, simply enter at
least 1 leading blank, then the desired command.
DOS commands, program- and batch-file names may also be entered with
only portions of the fileid. See 'Substitution Symbols and Flags' for
details.
%@ign
%@sec Command Area: Automatic Directory Navigation
Fileids marked '<DIR>' in the <size> field represent sub-directories.
Fileids '..' represent the parent of the sub-directory in the <path>
field.
By entering a blank on a <DIR> display line and pressing <ENTER>, FLAK
will reset the '<< [listi] specification >>' field from the target
directory, and rebuild the file list.
Note:
The Current Directory is NOT changed.
Note:
When changing to a parent ('..') directory, the new file list is
positioned to the previous sub-directory entry in the list, not at the
top.
%@ign
%@sec Command Area: :EXT (Extension) Processing
If a Command Area is blank (that is, it begins with 1 or more leading
blanks, and has no other characters), a check is performed against
Configuration File :EXT records for a match. If the <fileid> extension
is found, then the Command Area is set to the associated :EXT
'command-string'.
Thus, for example, if the following Configuration File record was
specified:
:ext txt edit
And, at least 1 blank (and nothing else) was entered on the following
FLAK display line:
MYFILE TXT _ 200 06/02/92 10:00 c:\curdir
Then, the following DOS command would be executed:
edit MYFILE.TXT
Note:
:EXT processing utilizes Automatic Fileid Appending, even though the
Command Area begins with a blank.
See 'Startup: Configuration File - Extension Record' for details.
%@ign
%@sec Command Area: :ALIAS (Alias) Processing
After the :EXT check is performed, the first word in the Command Area is
compared against Configuration File :ALIAS records for a match.
If a match is found, the first word in the Command Area is replaced by
the associated :ALIAS 'command-string'.
Example:
If the following Configuration File record was specified:
:alias display 1 viewfile [r
And, the single-character command 'd' was entered on the following FLAK
display line:
MYFILE TXT d 200 06/02/92 10:00 c:\curdir
Then, the following DOS command would be executed:
viewfile MYFILE.TXT
Additionally, the '[R' flag causes FLAK to refresh the screen
immediately after command execution. That is, upon exiting the VIEWFILE
program, FLAK will restore the file list display, without user
intervention.
Obviously, you may create abbreviations in addition to aliases.
%@ign
%@sec Command Area: Substitution Strings and Flags
In either the Command Area, :EXT-, or :ALIAS- 'command-string', special
'Substitution Strings' and/or 'Flags' may be specified to cause
insertion of the <fileid> (or parts of it) into the command, or cause
special processing during the DOS command execution.
If the Substitution String contains any part of the fileid, Automatic
Fileid Appending is cancelled.
Note:
The left bracket is the default Substitution Symbol, and thus is
ENTERED AS SHOWN. This may be changed by the '/Yc' command, described
elsewhere.
String Action ('*' = Automatic Fileid Appending NOT cancelled)
───────── ──────────────────────────────────────────────────────────
[b Insert fileid with following blank ('b' = blank)
[C Insert fileid with Complete drive and path
[F Insert fileid with no following blank
[G Insert fileid without path
[D Insert file's drive and colon (:)
[N Insert file name
[T Insert file type (extension)
[E Insert file type (extension)
[P Insert file's path (with drive and colon)
[Q Insert file's path (without drive)
[+[++..] Insert next (1st, 2nd, 3rd, ...) fileid in list
[-[--..] Insert previous (1st, 2nd, 3rd, ...) fileid in list
[[ Insert Substitution Symbol
[R *Display can be Refreshed after this DOS command
[S *Maximum Storage is required for this DOS command
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA 100 06/21/92 10:00 c:\mydir\ │
│FNBBBB FTB erase [n.*<ENTER> │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the following command to be issued:
ERASE FNBBBB.*
Note:
Pay careful attention to the Current Drive/Current Directory when
issuing global commands (those with '*' or '?' -- effecting more than
just the <fileid> file).
See 'Command Area: ERASE/DELETE **WARNING**' for details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA 100 06/21/92 10:00 c:\mydir\ │
│FNBBBB FTB compare [ [+<ENTER> │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the following command to be issued:
COMPARE FNBBBB.FTB FNCCCC.FTC
%@ign
%@sec Command Area: Application/Command Execution ('Launching')
To run an executable (file extension of .BAT, .COM, or .EXE) enter:
[c<ENTER>
This will cause the Complete <path>/<fileid> to be passed to DOS.
If parameters are desired, they may be entered as follows:
[c parm1 parm2 ...<ENTER>
Additionally, if the '/EY' command has been issued, Executables can be
run simply by specifying a leading blank in the Command Area.
Note:
This facility allows you to bypass the normal DOS PATH directory search
order, and run a specific executable. This is convenient for testing
new versions of programs that are not in the PATH definition.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│MYAPPLIC BAT [c [+ <ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
This would cause the following command to be passed to DOS:
c:\mydir\MYAPPLIC.BAT FNBBBB.FTB
%@ign
%@sec Command Area: CD (Change Directory)
A DOS 'cd' (Change Directory) command is intercepted anywhere in a
Command Area, and even if entered in column 1, is NOT automatically
appended.
The specified directory is made the new Current Directory, the bell is
sounded, and the '<< current directory >>' field is updated.
Note:
The [listi] specification (and thus the current file list) is NOT
changed.
To Change Directory and reset the file list simultaneously, see
'FLAK Command: /CL (Change and List)'.
%@ign
%@sec Command Area: D: (Drive)
The DOS 'd:' (Drive) command is intercepted anywhere in a Command Area,
and even if entered in column 1, is NOT automatically appended.
After a 'd:' command completes, the '<<<< current drive/directory >>>>'
display area is updated with the new Current Drive, and the bell is
sounded.
The [listi] specification (and thus the current file list) is NOT
changed.
To change the current Drive and reset the file list simultaneously, see
'FLAK Command: /CL (Change and List)'.
%@ign
%@sec Command Area: RENAME (Move)
The 'RENAME' command is intercepted anywhere in a Command Area, and may
be used to rename files and sub-directories.
Additionally, if you specify a different path in the new name of a file,
it will be removed from the old directory, and placed in the new
directory, thus 'moving' the file.
After a successful rename, the file list and display are updated with
the new fileid and/or path information.
If 'd:' is included in the old fileid, it must be the same in the new
fileid: You cannot move a file to a new drive.
If the file is not in the Current Directory, and no directory is
specified in the new fileid, the original (old) directory is assumed.
No 'wild' characters are allowed in either the old or new fileids.
%@ign
%@sec Command Area: ERASE/DELETE **WARNING**
Although no special processing is performed for the DOS 'ERASE' and
'DELETE' commands, they are mentioned here to describe the processing
that FLAK performs for each <fileid> with a DOS command in its Command
Area.
After a DOS command completes, FLAK checks for the existence of <fileid>
in its displayed <path>. If the file still exists, all the fields in
the display line are updated. If the file has been erased, the file
statistics fields are replaced with:
-- not found --
However, if you execute commands or batch files which affect files other
than the one in the <fileid> field, FLAK will not update those fileid's
fields, as it has no way of knowing which files have been affected.
In fact, if a command creates new files, they will not even appear in
the file list until the list is manually re-built.
This facet of FLAK may be overlooked in many cases:
For example, assume you execute a program which updates a <fileid>
already in the file list. Although the statistics may be incorrect, you
may still access the file, and issue DOS commands against it, so long as
the <fileid> and <path> information remain correct.
However, assume you execute a program which creates a file only
sometimes (for example, a compiler creating an error-message file, only
when errors occur): Unless the fileid is in the display list prior to
the file's creation, or the list is re-built, the file's existence may
go unnoticed!
See the FLAK Command '/L=' for a quick method of rebuilding the file
list.
%@ign
%@sec FLAK Command: General
In addition to DOS commands, FLAK supports 'FLAK Commands' which
modify the file list, DOS environment, or perform other functions.
FLAK Commands begin in column 1 of the Command Area, and start with
the '/' (slash) character.
Normally they should be executed one-at-a-time, and followed immediately
by <ENTER>.
However, those noted by '##' may be entered multiple times on a screen
prior to <ENTER>.
A concise list of all FLAK Commands with HelpPrompt capability is
available via the <F1> key.
Each FLAK Command is discussed in the following sections.
%@ign
%@sec FLAK Command: = (Repeat Previous Command)
= ## Reset Command Area with last command, and execute.
=? Reset with Selected previous command, and execute.
A menu is presented for the selection.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA erase │
│FNBBBB FTB = │
│FNCCCC FTC =<ENTER> │
└───────────────────────────────────────────────────────────────────┘
Results in the following commands:
ERASE FNAAAA.FTA
ERASE FNBBBB.FTB
ERASE FNCCCC.FTC
%@ign
%@sec FLAK Command: ? (Reset Previous Command)
? ## Reset Command Area with last command, but don't execute.
?? Reset with Selected previous command, but don't execute.
A menu is presented for the selection.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA erase<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Followed by:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA -- not found -- c:\mydir\ │
│FNBBBB FTB ? │
│FNCCCC FTC ?<ENTER> │
└───────────────────────────────────────────────────────────────────┘
would result in the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA -- not found -- c:\mydir\ │
│FNBBBB FTB erase │
│FNCCCC FTC erase │
└───────────────────────────────────────────────────────────────────┘
At this point, you can hit <ENTER> to execute the commands, or <ESC> 2
times, to clear all Command Areas.
%@ign
%@sec FLAK Command: / (Make first line in display)
/ Make this line first in display.
/[nnn] Make line number 'nnn' first in display.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA 100 06/21/92 10:00 c:\mydir\ │
│FNBBBB FTB /<ENTER> │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Results in the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 2/3 *.fta │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
│ │
└───────────────────────────────────────────────────────────────────┘
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /3 │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Results in the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 3/3 *.fta │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
│ │
│ │
└───────────────────────────────────────────────────────────────────┘
%@ign
%@sec FLAK Command: /A (Search specific file Attributes)
/A|N|x[x..]| Search Normal, System, Dir, Hidden, Archive, Read-only
files in subsequent searches.
See 'Startup: [listi]' for details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /anr<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the next files search to include only Read/only files. The 'n'
sets 'Normal', and the 'r' sets Read/only.
The 'v/as' display field is set to the characters representing the file
attributes specified.
%@ign
%@sec FLAK Command: /B (Bell is audible or not)
/B|Y|N| Bell is audible or not for warnings
The bell is always sounded for severe errors.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /bn │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the Bell to be silenced for warning messages.
No change in the display occurs.
%@ign
%@sec FLAK Command: /CD (Change Drive/Directory)
/CD[pathi] Make specified [drive:][\path\] the Current Drive and
Current Directory.
If no [pathi] is supplied, no action is taken.
If [drive:] is not specified, the Current Drive is used.
If [\path\] is not specified, the Current Directory on the
current (or specified) drive is used.
Note:
The file list is not changed.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /cdb:\backup\ │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
This will cause the Current Drive and Directory to be changed, but not
the file list, as follows:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 b:\backup\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA 100 06/21/92 10:00 c:\mydir\ │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
%@ign
%@sec FLAK Command: /CL (Change Drive/Directory and List)
/CL= Rebuild file List from Current Directory.
/CL? Make Current/List from Selected previous specification.
A menu box is presented with previous [listi]
specifications, allowing selection.
/CL[pathi] Make specified [drive:][\path\] the Current Drive and
Current Directory and List the files therein.
If no [pathi] is supplied, the Current Directory is used.
If [drive:] is not specified, the Current Drive is used.
If [\path\] is not specified, the Current Directory is
used, unless [drive:] is new, in which case, '\' (the
root) is used.
[fileid] may also be specified to filter the list.
Note:
[\path\], if coded, must always include the ending '\'
to indicate [\path\], rather than [fileid].
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /cl=<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
This will cause all files in the c:\mydir\ directory to be listed.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /clb:\prod\*.bat<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
This will cause the b:\prod\ directory to become the Current Directory,
and all the .BAT files in it to be listed. Note the change in drive.
Example:
Assume the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│SUBDIR <DIR> -------- ----- c:\mydir\ │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Then, the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│SUBDIR /cl[c\<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
would make the SUBDIR directory the Current Directory, and list all
the files within it.
%@ign
%@sec FLAK Command: /D (Display 'nn' or maximum fileids)
/D|nn|*| Display 'nn' or maximum number of fileid's.
See 'Startup: [options]' for full details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /d*<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
would result in the maximum number of fileids to be displayed on each
screen.
%@ign
%@sec FLAK Command: /DI (Display <fileid> or specified file)
/DI[fileid] Display <fileid> or specified file.
The file is displayed by an internal FLAK routine which
provides convenient scroll capability.
Once entered, press <F1> for Help on its use.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /di │
│FNBBBB FTB = │
│FNCCCC FTC /diabc.def<ENTER> │
└───────────────────────────────────────────────────────────────────┘
This would cause first the file 'FNAAAA.FTA' to be displayed, then file
'FNBBBB.FTB', then file 'ABC.DEF'
%@ign
%@sec FLAK Command: /E (Execute .BAT, .COM, .EXE files)
/E|Y|N| Execute .BAT, .COM, .EXE files, or use Config File :EXT.
See 'Startup: [options]' for full details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /ey<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
This causes a leading blank Command Area to run executable files.
%@ign
%@sec FLAK Command: /F (Find fileid with(out) chars)
/F[!][cc.cc] Find (not) specific fileid in list.
/F[!][ccc] Find (not) filename with specified characters (in list).
/F[!].[ccc] Find (not) filetype with specified characters (in list).
/F[!]\ Find (not) same path as this fileid's (in list).
Characters specified may be 1-8 for filename searches, and
1-3 for filetype searches.
When successful, the <fileid> which satisifes the search
is made the first <fileid> on the screen.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /fnb<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Results in the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 2/3 *.fta │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
│ │
└───────────────────────────────────────────────────────────────────┘
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /f.tc<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Results in the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 3/3 *.fta │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
│ │
│ │
└───────────────────────────────────────────────────────────────────┘
%@ign
%@sec FLAK Command: /G (Get Project disk file data)
/G[fileid] Get Project disk file and list files therein.
If [fileid] is not specified, 'WRK.FLK' is used.
See 'Project files' for full details.
/G@[fileid] Get Project disk file [listi] specification and list.
Specifies a file to be read which contains a [listi]
specification as the first record.
If [fileid] is not specified, 'WRK.FLK' is used.
See 'Project files' for full details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /glist1.flk<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Results in the file 'LIST1.FLK' being read, and the display being
rebuilt from the <fileid> and <path> records within.
%@ign
%@sec FLAK Command: /H (HelpBar visible or not)
/H|Y|N| Specifies whether the HelpBar is visible or not.
See 'FLAK [options]' for full details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /hy<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
This makes the HelpBar visible.
%@ign
%@sec FLAK Command: /K (Display/reset Function Keys)
/K[nn] Display/reset Function Key labels/definitions.
If 'nn' (which must be in the range 4-12) is entered, the
specific Function Key label/definition is displayed, and
the user allowed to reset them.
The new Function Key definition is valid until reset
again, or until FLAK is exited. The new definition is not
saved in the Configuration File.
%@ign
%@sec FLAK Command: /L (Reset [listi] data and list)
/L= Rebuild List with current [listi] specification.
The Current Directory is not changed.
/L? Set [listi] with Selected previous specification.
A menu box is presented with previous [listi]
specifications, allowing selection.
The Current Directory is not changed.
/L Set [listi] with (modified) current specification.
An input box is presented with the current [listi]
specification, which may be modified.
The Current Directory is not changed.
/L[listi] Set [listi] specification and create new file list.
All valid [listi] specifications may be entered.
See 'Startup [listi]' for full details.
The Current Directory is not changed.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /L=<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the file list to be rebuilt using '*.fta'. This simply causes
the list to be 'refreshed', and is a good candidate for a Function Key
definition in the Configuration File.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /L\dir2\a*.bat<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the [listi] specification to be reset to '\dir2\a*.bat', and any
files meeting that specification to be listed.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /L[p<ENTER> (c:\mydir\) │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the [listi] specification to be reset to 'c:\mydir\', and all
files in that directory to be listed.
%@ign
%@sec FLAK Command: /L+ (Append [listi] data and list)
/L+[listi] Append current [listi] with new specification, and append
file list with resulting <fileid>'s.
'/L+' is specified as shown.
All valid [listi] specifications may be entered.
See 'Startup [listi]' for full details.
If any files are found, they are appended to the current
file list, and the display is positioned to the new files.
Toggle current/last display with <CTL-HOME> keypress.
Execute '/O...' (Order) or '/M...' (Move) commands to
merge both lists.
The Current Directory is not changed.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /L+\dir2\a*.bat<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the listi specification to be appended with '\dir2\a*.bat', and
any files meeting that specification to be added to the list.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /L+/aa;\*.bat<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the [listi] specification to be appended and those files to be
appended to the list. The specification includes all .BAT files in the
root (\) directory with the Archive flag set on.
%@ign
%@sec FLAK Command: /M (Mark/Move fileids in the list)
/M ## Mark <fileid> for subsequent '/MH' to Move it in list.
Mark any number of <fileid>'s on any screens in the
current file list.
The files will be moved in the order they are marked.
All files marked on a screen via a single <ENTER>, are
ordered top to bottom as they appear. To change the
order, issue <ENTER> after each '/M'.
/MM Start/end block of <fileids> to Move.
Enter 2 times anywhere in file list to mark all included
<fileids> for subsequent '/MH'.
/MH Move Marked <fileid>'s Here in list.
Enter after all '/M' or both '/MM' commands.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA 100 06/21/92 10:00 c:\mydir\ │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC /m<ENTER> │
└───────────────────────────────────────────────────────────────────┘
Followed by:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /mh<ENTER> │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
│FNCCCC FTC *m │
└───────────────────────────────────────────────────────────────────┘
Results in the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNCCCC FTC 100 06/21/92 10:00 c:\mydir\ │
│FNAAAA FTA 100 06/21/92 10:00 c:\mydir\ │
│FNBBBB FTB 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
%@ign
%@sec FLAK Command: /O (Order files by field value)
/O[x[ss,ee]] Order file list by Attrib, Name, Ext. (Type), Size,
Date, Path, Cols ss-ee, Off
If no Order character is specified, the list is ordered
according to the current character.
See 'FLAK [options]' for full details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /od<ENTER> │
│FNBBBB FTB 200 06/22/92 10:00 c:\mydir\ │
│FNCCCC FTC 300 06/23/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Results in the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
│FNBBBB FTB 200 06/22/92 11:00 c:\mydir\ │
│FNAAAA FTA 100 06/21/92 10:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Where the file list has been ordered by the <date> and <time> fields, in
descending order.
%@ign
%@sec FLAK Command: /P (Put fileid|[listi] to disk file)
/P ## Put <fileid> and <path> fields to output file.
The '/P' command writes records to 'Project Files' which
can subsequently be read by the '/G' (Get) command so that
specific file lists of <fileid>/<path> information may be
created, saved, and used.
See 'Project Files' for full details.
/PO[fileid] Open file for subsequent Put output.
If [fileid] not specified, 'WRK.FLK' is used.
/PL Put current [listi] string to output file.
/PP Start/Put block of <fileids> to output file.
Enter 2 times anywhere in file list to Put all
included <fileids>/<paths>.
/PC Close current Put file.
Note:
For any Put operation, if no output file is open, the default file
'WRK.FLK' is automatically opened.
All Put operations cause appending to the output file, no existing
records are ever lost.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /pp │
│FNBBBB FTB 200 06/22/92 11:00 c:\mydir\ │
│FNCCCC FTC /pp │
└───────────────────────────────────────────────────────────────────┘
Would cause the following records to be written to file 'WRK.FLK':
FNAAAA.FTA C:\MYDIR
FNBBBB.FTB C:\MYDIR
FNCCCC.FTC C:\MYDIR
%@ign
%@sec FLAK Command: /R (Refresh display after DOS)
/R|Y|N| Specifies whether to Refresh the screen after executing
any DOS commands, or clear it and restore the FLAK display
automatically.
See 'Startup: [options]' for full details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /rn │
│FNBBBB FTB 200 06/22/92 11:00 c:\mydir\ │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the last screenful of DOS command output to remain visible until
the user hits any key.
%@ign
%@sec FLAK Command: /S (Maximum RAM Storage required)
/S|Y|N| Specifies whether maximum RAM Storage is to be allocated
for all DOS commands or not.
See 'FLAK [options]' and 'Resource Utilization &
Optimization' for full details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /sy │
│FNBBBB FTB 200 06/22/92 11:00 c:\mydir\ │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the maximum amount of RAM storage to be made available during
every DOS command.
%@ign
%@sec FLAK Command: /T (Search Tree for all occurrences)
/T[pathi] Search Tree for all occurrences of fileid.
If [pathi] is specified, the search begins at
[drive:][\path\] and includes all sub-directories.
If [drive:] not specified, the Current Drive is used.
If [\path\] not specified, the root (\) is used, causing
entire drive to be searched.
If [fileid] is not specified, the <fileid> field is used.
If any files are found, they are appended to the current
file list, and the display is positioned to the new files.
Toggle current/last display with Ctl-Home keypress.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /ta: │
│FNBBBB FTB 200 06/22/92 11:00 c:\mydir\ │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes a search of all directories on the 'a:' drive for file
'FNAAAA.FTA' to be added to the file list.
%@ign
%@sec FLAK Command: /V (Set Video characteristics)
/V|c|f,b|| Set Video (Normal|Highlited|Intense), fore/background.
See 'Startup [options]' for details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA 100 06/21/92 10:00 c:\mydir\ │
│FNBBBB FTB /vn3,0 │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
This sets the 'Normal' fields of the FLAK display to cyan on a black
background.
%@ign
%@sec FLAK Command: /XI (Exit FLAK)
/XI Exit FLAK and return to DOS.
Note:
The rest of Command Area is ignored, and may contain
any characters.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA erase │
│FNBBBB FTB /xise │
│FNCCCC FTC erase │
└───────────────────────────────────────────────────────────────────┘
Would cause the following command to be issued:
ERASE FNAAAA.FTA
Then, FLAK would stop processing, and return to DOS. The last 'erase'
command would NOT be issued.
%@ign
%@sec FLAK Command: /Y (Set Substitution Symbol)
/Y|c| Specifies the Substitution Symbol to be character 'c'.
See 'Startup [options]' for details.
Example:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /y> │
│FNBBBB FTB 200 06/22/92 11:00 c:\mydir\ │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
Causes the '>' character to become the Substitution Symbol. Thereafter,
for example, to cause the filename to be included in a DOS command, the
user would specify:
>n
in the Command Area.
Remember that previously coded Configuration File 'command-strings' must
utilize the active Substitution Symbol.
%@ign
%@sec Project Files
FLAK 'Project Files' are disk files containing a [listi] specification
and/or <fileid>/<path> records.
Such a file can be read by the '/G@' (Get [listi]) or '/G' (Get)
commands, to create a file list from the pre-coded information.
When a Project File is processed by '/G@[fileid]', only the first record
is read, and it must be a valid [listi] specification.
When a Project File is read by '/G[fileid]', any record not containing a
<fileid>/<path> specification is simply ignored. Each file/path
specification is checked, and the file listed, if present. If the file
is not found, the file statistics fields are replaced with:
-- not found --
Valid Project File record types are:
[listi] record
<fileid>/<path> records
The [listi] record is any valid [listi] specification, except '/G' or
'/G@':
[listi]
where:
[listi]
Is a [listi] specification, which may be read via the
'/G@[fileid]' command.
No blanks are allowed.
This record is optional, but must be first, if coded.
The <fileid>/<path> record(s) describe a file and its location,
which may or may not actually exist:
|fileid| |path|
where:
|fileid|
Is a file-name/file-extension specification, with the
separating period ('.').
|pathi|
Is the drive/path location of the above file, and is separated
from the |fileid| by at least 1 blank.
Project File records may be created by an editor, or the '/P...'
FLAK Command, described elsewhere.
Example:
A program source file and supporting subroutine file are kept in
different directories because of their differing roles. However, during
development, it is more convenient to have both files 'visible' and
easily accessible at the same time. So, assume the following file, named
'MYPROJ.FLK':
mypgmain.c c:\source
mypgmsub.c c:\suptlib
Then,
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA /gmyproj.flk │
│FNBBBB FTB 200 06/22/92 11:00 c:\mydir\ │
│FNCCCC FTC 300 06/23/92 12:00 c:\mydir\ │
└───────────────────────────────────────────────────────────────────┘
would produce the following:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/2 /gmyproj.flk │
│MYPGMAIN C 100 06/21/92 10:00 c:\source\ │
│MYPGMSUB C 200 06/22/92 11:00 c:\suptlib\ │
└───────────────────────────────────────────────────────────────────┘
%@ign
%@sec Resource Utilization & Optimization
At startup, FLAK Version 1.01 requires approximately 170KB RAM,
providing a minimum file list of 200 fileids. More RAM is obtained as
the file list gets larger.
When FLAK runs an executable, it allocates whatever RAM is still
available in the system.
When the executable completes, the RAM is deallocated. Therefore,
DO NOT execute TSR's (Terminate and Stay Resident programs) from FLAK.
Swapping:
─────────
If more memory is needed for a particular executable -- you may see
either of the following error messages:
Cannot execute [pathi][fileid]
or,
Out of memory
specify the '[S' (maximum Storage required) Flag in the Command Area (or
'command-string' in a Configuration File definition). FLAK will 'swap'
(write) itself out of RAM into a temporary disk file during the
specified executable, and then read itself back into RAM afterwards.
This will make all but approximately 3KB of RAM available for the
executable, but will also add the processing necessary to perform the
swap operation.
If maximum storage is required for ALL executables, issue the '/SY'
command, or code it on a Configuration File parameter record.
Swap File Allocation:
─────────────────────
When FLAK starts, it allocates the temporary swap disk file according to
the path definition found in the following environment variables, in the
order shown:
FLAKTMP
TEMP
TMP
If none of the above have been specified, the swap file is allocated in
the Current Directory.
Therefore, if you want to allocate the swap file to a particular device
or area (a RAM disk is the best candidate), issue the following DOS
command, prior to FLAK startup:
set flakmp=d:\path\
Where:
d:\path\
Is a drive and path designation, which MUST EXIST.
Swap Fileid:
────────────
The swap fileid is 'FLAKnnnn.TMP', where 'nnnn' is automatically
replaced with a unique sequential identifier.
%@ign
%@sec Network Execution
Each invocation of FLAK creates a unique swap file, and thus is
compatible with multi-user network execution.
However, FLAK takes no other action for network execution: The
appropriate networking environment must be setup for any executables run
('SHARE.EXE' CONFIG.SYS entry, for example).
%@ign
%@sec Windows Installation
FLAK may be installed under Microsoft WINDOWS as follows:
1. Start Windows.
2. Select icon for Program Manager.
3. Select icon for the Program Group in which you want FLAK to appear.
4. Select File.
5. Select New...
6. Select Program Item * OK.
7. Enter in the Description field: FLAK
8. Enter in the Command Line field: [pathi]flak.exe [parms]
where:
[pathi]
Is the path describing where FLAK.EXE is located.
[parms]
Are any desired FLAK command-line parameters.
Alternatively, you may leave out the [parms], and enter
any desired options in the FLAK.CFG Configuration File.
9. Select OK.
Now, to run FLAK, just select the "FLAK" icon.
%@ign
%@sec Hints
Hint:
─────
A convenient working environment for typical compiling/debugging is the
combination of files ordered by date ('/OD') which places most-recently
created/modified fileids at the top of the list, and a function-key
definition which rebuilds the file list from the Current Directory
('/CL=').
By simply hitting the function-key, the files most likely to require
attention (modified source file, compiler error listing, etc) will
remain in view, at the top of the screen.
Hint:
─────
By combining command repetition and symbolic substitution, the user is
afforded a powerful capability to handle groups of files:
┌───────────────────────────────────────────────────────────────────┐
│flak 1.01 c:\mydir\ Mon 01/02/92, 13:45│
│ 1/3 *.fta │
│FNAAAA FTA ren [ [n.old │
│FNBBBB FTB = │
│FNCCCC FTC =<ENTER> │
└───────────────────────────────────────────────────────────────────┘
Results in the following commands:
RENAME FNAAAA.FTA FNAAAA.OLD
RENAME FNBBBB.FTB FNBBBB.OLD
RENAME FNCCCC.FTC FNCCCC.OLD
Hint:
─────
A Configuration File can be designed for Application Launching by
combining the '/G' command naming a Project File of applications, and
the '/EY' command allowing 1-blank Command Area executions. For
instance, assume the Configuration File 'MYAPPLS.CFG', as follows:
/gmyappls.lst /ey /sy
And assume the 'MYAPPLS.LST' Project File:
editor.exe c:\prdctn\
wordproc.exe c:\prdctn\
sprdshet.exe c:\prdctn\
calcultr.com c:\testlib\
Then, the command:
flak /cmyappls.cfg
would present the above fileids, and enable execution via a single blank
followed by <ENTER>.
Similarly, you may assign the '/Gmyappls.lst' command to a Function Key,
to 'pop-up' a list of applications during a FLAK session.
You would probably have issued the '/SY' and possibly the '/EY' commands
beforehand, to ensure maximum RAM for the applications, and single-blank
execution capability.
%@ign
%@sec Version History
FLAK Version 1.00 08/04/92
────────────────────────────
This version is the initial public offering of the program.
FLAK Version 1.01 10/04/92
────────────────────────────
Modification to the system call routine provides access to the primary
environment area variables, allowing executables to successfully access,
modify, and delete environment variables.
%@ign
%@sec HELP Utilization
%@ign (This section is for HELP <F2> processing and must be LAST)
HELP allows reading a file with a Table Of Contents (TOC). By high-
lighting a particular TOC entry with the Up/Down Arrow keys and pressing
the <ENTER> key, that section is displayed. HELP also uses the
following keys, as indicated:
Key Action, while displaying...
─────────────────────────────────────────────────────
Key ..Table of Contents (TOC) ..Selected Section
─────────── ───────────────────────── ───────────────────────
F1 Display this HELP Display this HELP
Esc Exit HELP Return to TOC
Down Arrow Next TOC entry Next screen/section
Tab Forward Next TOC entry Next screen/section
Page Down Next TOC screenful Next screen/section
Enter Display highlited section Next screen/section
Space Display highlited section Next screen/section
Up Arrow Previous TOC entry Previous screen
Tab Backward Previous TOC entry Previous screen
Page Up Previous TOC screenful Previous screen
Home Top of screen Top of section
End Bottom of screen ...
Right Arrow Next TOC entry Next section
Left Arrow Previous TOC entry Previous section
b Toggle Bell ON/OFF Toggle Bell ON/OFF
Whenever the displayed Section changes, the bell is sounded (if ON).
%@ign <<<<<=====-----.... end-of-file ....-----=====>>>>>