home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.update.uu.se
/
ftp.update.uu.se.2014.03.zip
/
ftp.update.uu.se
/
pub
/
rainbow
/
msdos
/
misc
/
sweep.lzh
/
SWEEP214.DOC
< prev
Wrap
Text File
|
1985-06-26
|
17KB
|
421 lines
CWEEP - A SWEEP-like program for MS-DOS
By Gary M. Berg
5850 Duncraig Drive
Apartment 806
Dayton, Ohio 45426
C.I.S. # 70106,1624
Copyright (C) 1984, 1985 by Gary M. Berg/Chemineer Inc.
Disclaimer
This software has been released to the public domain by the author.
All commercial rights are retained by the author. It may be freely
passed on to others as long as no charge is made except for possibly a
small copying charge. Although this software is thought to work as
described, no warranty of fitness is made for this software.
CWEEP is a program to provide the same capabilities for the MS-DOS
user as the program SWEEP does for the CP/M user. It provides the
ability to take a sorted list of the files on a disk and move forward
and backward in the list. Files can be viewed, copied, deleted
individually and in groups.
CWEEP is invoked at the MS-DOS command line by:
CWEEP {d:}{path}{afn} {-sw} {-sw}
{d:} an optional drive letter, the default being the
currently logged drive
{path} an optional path. Valid only for the 2.x version.
{afn} an optional ambiguous filename of what files to look
at, the default begin "*.*" (in the currently logged
directory under DOS 2.x).
{-sw} an optional switch or switches. Switches begin with a
'-' character.
CWEEP will then look up all files matching the specified files, and
prompt with the first file name. At this point, commands can be
entered to move around in the list, tag files, copy files, etc. The
display on the next page was generated by starting CWEEP with no
filename specified:
Page 1
CWEEP - A SWEEP-like program for MS-DOS
CWEEP (Display for version 1.x)
CWEEP version 1.37
Copyright (C) 1985 by: Gary M. Berg/Chemineer Inc.
sp/cr Advance to next file [M] Mass copy tagged files
[A] Re-tag '#' marked files [N] Calculate CRC
[B] Back up one file [P] Protected mass copy
[C] Copy file to drive [R] Rename a file
[D] Delete a file [S] Sort directory
[E] Erase (un)tagged files [T] Tag a file
[F] Free space on a drive [U] Untag a file
[H] Hexidecimal display [V] View file
[I] Print size/time for file [W] Wildcard file tag
[J] Jump to a named entry [X] Exit program
[L] Log new drive/filename [Z] Change subdirectory
[?],[/]Print this message [=] Goto settings menu
[-?], [+?] List other help messages, [@] for printer
47 files, using 226089 bytes (245K) -- 19968 bytes free (20K)
1. I:CW-COPY .C 08-Feb-1985 7K :[X] eXit
or
CWEEP (Display for 2.x version)
CWEEP version 2.14
Copyright (C) 1985 by: Gary M. Berg/Chemineer Inc.
sp/cr Advance to next file [M] Mass copy tagged files
[A] Re-tag '#' marked files [N] Calculate CRC
[B] Back up one file [P] Protected mass copy
[C] Copy file to drive [R] Rename a file
[D] Delete a file [S] Sort directory
[E] Erase (un)tagged files [T] Tag a file
[F] Free space on a drive [U] Untag a file
[H] Hexidecimal display [V] View file
[I] Print size/time for file [W] Wildcard file tag
[J] Jump to a named entry [X] Exit program
[L] Log new drive/filename [Z] Change subdirectory
[?],[/]Print this message [=] Goto settings menu
[-?], [+?] List other help messages, [@] for printer
48 files, using 227027 bytes (246K) -- 18944 bytes free (19K)
1. I:CW-COPY .C 08-Feb-1985 7K :[X] eXit
Page 2
CWEEP - A SWEEP-like program for MS-DOS
The files matching what was specified (in this case *.*) are sorted
in alphabetic order, and the first file in the list is listed on the
screen with the date and the size rounded up to the nearest 1K. In
addition, the amount of space free and the amount of space used in the
selected files is displayed.
The following is a list of commands with a short explanation:
[@] This character may be prefixed to a command to cause
the output of the command to also go to the printer.
This works with the [?] help, [H]ex, [N] CRC, [Q]uery,
and [V]iew commands. If the command is a "paged"
display, form-feeds will automatically be added to the
printer output every 60 lines.
<sp>
<cr> Advance to the next file on the list. Go to the first
file on the list if you are at the last file on the
list.
[A] Re-tag all files which are marked with a "#" in the
list.
<bs>
[B] Back up to the previous file in the list. Go to the
last file in the list if B is entered when you are
waiting at the first file on the list.
[C] Copy this file to another drive. Prompt for the drive
to copy to. Destination drive can be entered in the
form "d[:[v]]". The if the "v" is specified, then the
copy will be verified. If the file already exists, the
user will be queried about whether to delete it or not.
In version 2.x, the destination may be given as a
subdirectory. The default drive will be the current
one.
"A" - Copy to drive A
"A:" - Copy to drive A
"B:V" - Copy to drive B, and verify copy
"B:\GARY:V" - Copy to subdirectory "\GARY" on
drive B. Verify the copy.
"OTHER\SOME:V" - Copy to subdirectory "OTHER\SOME"
on the logged drive. Note that
this is a relative subdirectory,
relative to the current sub-
directory on the logged drive.
Page 3
CWEEP - A SWEEP-like program for MS-DOS
[-C] Copy file to another file name. Need to specify what
the new drive and file name are. Append a ":V" to the
end of the new name if you want the copy verified.
Specify the destination subdirectory if required with
version 2.x.
[D] Delete file. You are asked to verify deletion.
[E] Erase all tagged or untagged files. User is prompted
for which type of files to erase, and whether the user
should be prompted about each file or not. At most
options an "A" will abort the operation.
[F] Check free space on any drive.
[H] Dump the file in hex format. The escape and return
keys abort the dump, any other key pauses it.
[-H] Dump the file in hex one 'page' at a time.
[I] Display the file size in bytes and the creation time.
[J] Jump to the file in the list. Specify name and
extension, it will jump to the closest point in the
list.
[L] Log in a new drive (directory on V2.x) and ambiguous
filename. Will replace the list currently being used
by one matching what was entered. If no period (".")
is in the string, a "*.*" will be appended to the
string for the ambiguous filename.
[M] Copy all files which have been tagged to a specified
drive. The syntax is the same as for the Copy option.
This option WILL delete (without warning) any files
existing on the destination if they match a file which
is being copied.
[N] Calculate a CRC for this file. This is the same CRC as
the CP/M program CRCK returns.
[-N] Calculate CRC's for all tagged files.
[+N] Calculate CRC's for all untagged files.
[-O] Output a list of all tagged files to a disk file.
[+O] Output a list of all untagged files to a disk file.
[P] Protected mass copy option. Same as "M" option except
that the user will be queried before existing files are
deleted.
Page 4
CWEEP - A SWEEP-like program for MS-DOS
[-Q] Display a list of tagged files.
[+Q] Display a list of untagged files.
[R] Rename the file to something else. A wildcard new name
is allowed. If just "*" is entered, a wild card may be
entered for the old and new names.
[S] Sort the directory in order by name, extension, date,
or size. Preceed the sort field by "-" to invert the
normal order.
[T] Tag a file. It will appear in the listing marked with
a "*", and will be used in any operations which work on
tagged files.
[U] Untag a file. Clears the "*" marker.
[V] Display the file. It ignores line feeds, and converts
returns and vertical tabs to return/linefeed. This
allows listing files created by programs which only put
returns in the file, such as Spellbinder. The listing
can be controlled by using return or escape to
terminate, and any other key to pause.
[-V] Display file one 'page' at a time.
[W] Tag all files matching a wildcard.
[-W] Tag all files not matching a wildcard.
[Z] Enter a CHDIR command. Only valid for MS-DOS versions
2.0 and higher.
[?]
[/] Print help text for all commands with no "+" or "-"
prefix.
[-?]
[-/] Print help text for all commands with a "-" prefix.
[+?]
[+/] Print help text for all commands with a "+" prefix.
Page 5
CWEEP - A SWEEP-like program for MS-DOS
[=] This will take you to a settings menu controlling
several program flags. These are:
[M] Turn the menu printing on/off. Turning it off
will suppress printing the menu when logging a new
file specification. Same as the command line
option "-?" or "-/".
[P] Turn the path display on/off (V2.x only).
[Z] Turn ctrl/Z processing on/off. When on, viewing a
file will stop on ctrl/Z. When off, ctrl/Z is not
considered an end of file.
[=]
[Q]
[X] Exit the settings menu and return to normal
operations.
[?]
[/] Print a help message.
COMMAND LINE SWITCHES
The following is a list of valid command line switches for CWEEP.
They may follow or preceed the file specification to be logged in.
[-?]
[-/] Toggle the main help menus off. If present, the main
help menus will only be displayed when requested. This
setting may be altered from the mini-menu.
[-p] Toggle the display of the logged path off.
[-z] Toggle control/Z processing. If present on the command
line, control/Z will be ignored when encountered in a
file being viewed. This setting may be altered from
the mini-menu.
[-d]
[-e]
[-n]
[-s] Set the initial sort order to ascending whatever. The
options are the same as in the [S] command. If the
switch is entered as [--x] then the order will be
descending (i.e., [--d] will sort by descending date,
or most recent first).
Page 6
CWEEP - A SWEEP-like program for MS-DOS
For the user who does not like the default settings of some of the
command-line switches in CWEEP (not for the faint of heart), it is
possible to patch the values with DEBUG. If you unassemble the
beginning of the code, you will find several move word and move byte
instructions. By changing the value moved to 1 (true) or 0 (false)
the default may be changed (note that sort-order is an ascii
character). The move commands are (in order):
1)
Console on (Please don't change this!!)
2)
Printer off (Please don't change this!!)
3)
Menu on (The "M" in the settings menu)
4)
Initial sort order (Lower case is ascending)
(Upper case is descending)
5)
Ctrl/Z on (The "Z" in the settings menu)
6)
Path display on (The "P" in the settings menu)
CWEEP is written in the C language, and compiled with the C-ware
DeSmet C compiler. A Zenith Z-100 was used to develop it. It has
been tested by myself or others on a Z-150, IBM PC, and a Wang PC. It
uses some custom routines for reading and writing files and handling
all I/O to the keyboard and printer.
Since CWEEP uses the MS-DOS bdos calls to read/write the keyboard,
commands such as Ctrl/P and Ctrl/N work for directing output to the
printer. This allows the user to obtain a hardcopy listing of a
session with CWEEP. I/O redirection in MS-DOS version 2.0 and higher
allows putting a copy of a session in a file. However, the output
would not be displayed on the screen, making it difficult to use. In
addition, input redirection may be used if you can figure out exactly
what the input should be.
Page 7