home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Hall of Fame
/
HallofFameCDROM.cdr
/
util2
/
withlist.lzh
/
MANUAL.DOC
< prev
next >
Wrap
Text File
|
1990-06-14
|
26KB
|
697 lines
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒ ┌──────────────────────────────────────────────┐ ▒▒
▒▒ │ │ ▒▒
▒▒ │ WithList │ ▒▒
▒▒ │ │ ▒▒
▒▒ │ Version 1.0 Release Date 4 June 90 │ ▒▒
▒▒ │ │ ▒▒
▒▒ │ │ ▒▒
▒▒ └──────────────────────────────────────────────┘ ▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
WithList is not dedicated to the Public Domain. WithList is:
Copyright 1990 by Richard Grubic and OurSoft, all rights reserved.
WithList is fully Copyrighted and protected under US Federal and
International Copyright laws.
See Copyright Notice and License Agreement in License.doc.
You may use WithList to evaluate it. You are encouraged to make
copies for others to evaluate, so long as you do not charge for them,
and so long as you copy unaltered, the entire packed file including
the documentation, copyright notice, and licenses.
While there is no dollar fee for use of WithList, if you use it
OurSoft asks you to comply with the following four (4) special
requests:
1) Review the Other Products from OurSoft section of this manual,
familiarizing yourself with OurSoft products.
2) If you can or do use software of the same nature as any of the
OurSoft products, obtain copies of the related OurSoft products and
try them out. Compare the features with any alternatives.
Please note that, if you are a DOS user you should obtain and try both
Blaiz and StarCOM as you will want both of those. If you use MSWord
you should obtain and try FWCONV. If you use either Brief, or any
Borland Turbo language you will be quite pleased with Turbo Brief.
3) Tell your friends about and/or write your experiences in your
favorite echo conference about the OurSoft products you try.
4) If you decide you like one or more of these OurSoft products,
Order or Register for them.
WithList.zip includes the following files:
WITHLIST.BAT executes a command repetitively with a file of inputs
SETENV .ZIP Richard Marks environment modifier package
SUMMARY .DOC overview of WithList
MANUAL .DOC on-line manual
INFO .DOC ordering information, policies, prices, terms, etc.
LICENSE .DOC license agreements
ORDER .DOC registration form
WithList requires Richard Marks SetEnv.exe. We have included a
packed file of his SetEnv as it circulates on local BBS's. Both Mike
Arst and Richard Grubic made special efforts to locate and contact the
author to obtain his permission to include his package. However,
neither of us was able to locate anyone who knew how to contact him.
There is no copyright nor contact information in SetEnv, so we
presumed it was Public Domain wherein the author allows any use.
For your convenience, approximate line numbers in MANUAL.DOC
INFO.DOC and LICENSE.DOC are shown in the Contents and Indexes for
easy quick screen access with line oriented editors or display
programs like LIST. There is no printed manual available for
WithList.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ C O N T E N T S █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
Subject MANUAL .DOC Line
Introduction..................................................149
About OurSoft.................................................179
Installation..................................................191
How to Use....................................................209
How it Works
by Mike Arst..............................................263
Other Products from OurSoft...................................407
Blaiz.....................................................407
StarCOM...................................................449
FWCONV....................................................485
Turbo Brief...............................................509
Support and Training......................................551
WithList Tutorial.............................................569
Index.........................................................623
Subject INFO .DOC Line
How to Contact OurSoft........................................ 32
How to Order..................................................116
How to Register...............................................116
Support Services..............................................194
General...................................................200
Unbundled Support.........................................227
Procedures................................................293
Training..................................................353
Policies......................................................371
Source Code...............................................374
Software Developers.......................................398
Original Software.........................................416
Printed Manuals...........................................428
Enhancements..............................................446
Definition of Users.......................................458
Home Use..................................................488
Volume Discounts..........................................506
Purchase Orders...........................................566
Terms.....................................................578
Price Schedule................................................596
Index.........................................................650
Subject LICENSE .DOC Line
Copyright Notice.............................................. 17
Agreements
LICENSE AGREEMENT......................................... 32
SUPPORT AND TRAINING SERVICES AGREEMENT...................182
Index.........................................................260
Subject ORDER.DOC Line
Registration Form...............................................4
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒ ┌──────────────────────────────────────────────┐ ▒▒
▒▒ │ │ ▒▒
▒▒ │ WithList │ ▒▒
▒▒ │ │ ▒▒
▒▒ └──────────────────────────────────────────────┘ ▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Introduction █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
Thank you for down-loading WithList
This software offering, WithList, was conceived as a Batch file
to enable Blaiz users to use a list contained in a file for multiple
inputs to Blaiz commands like COPY, MOVE and DEL. See Other Products
from OurSoft. It also works with any commands which follow the DOS
syntax for those commands.
OurSoft wishes to thank Mike Arst for writing the description of
WithList.Bat in the How it Works section, below. And also to thank
Richard Marks for writing SetEnv.
Neither Mike Arst nor Richard Marks are affiliated with OurSoft.
Mike Arst is currently the moderator of FidoNet's BatPower echo
conference.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ About OurSoft █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
OurSoft was founded in 1987 by Richard Grubic.
OurSoft's goal is to be your kind of software company. Your
feedback in helping us better serve your needs is most welcome.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Installation █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
Copy or unpack WithList.bat and SetEnv.Zip to a subdirectory on
the PATH you have set in your AUTOEXEC.BAT file.
Unzip SetEnv.Exe from SetEnv.Zip.
Delete SetEnv.Zip.
See your DOS manual for how to use paths and how to create an
AUTOEXEC.BAT file.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ How to Use █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
SYNTAX:
WithList FileList Your_Command [input1 [input2 [input3]]]
The first argument, FileList, should be the path and file name of a
text file containing your list of inputs for Your_Command. FileList
is a required input.
Your_Command is the second argument and should be the name of the
command which you would like to repeat with the inputs on each line
contained in FileList. Your_Command is a required input.
After Your_Command you may have up to three optional inputs. These
are provided in case you desire to add switches required for
Your_Command, which switches would be operative on every line in
FileList.
The FileList should contain a text list of the inputs you would like
for Your_Command. You may place more than one input per line, but a
full line will be passed to Your_Command on each execution. If you
have more than one input per line, put a space between each input.
WithList executes Your_Command on the input lines in FileList in the
following sequence. First it executes the first line in FileList.
Then excluding that first line, it executes the remaining lines in
reverse ASCII (alphabetical) order. This order goes like this:
z..a\Z..A@9..0/-'"!
For other characters, see an ASCII table.
Note that WithList is a batch file. As such, if you call it in
another batch file, it should be the last instruction in that batch
file. Otherwise, if you need it in the middle of your batch file, you
should call withlist with a secondary command processor, as follows.
command /c WithList FileList Your_Command [inputs]
Be sure the /c precedes WithList, because if you put it afterwards,
WithList will attempt to use it as a switch for Your_Command.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ How it Works █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
by Mike Arst
ECHO OFF
: The following batch file can be used as-is, including the comment
: lines.
: Just rename the existing file WITHLIST.BAT to save it and then
: write this section out as "WITHLIST.BAT".
: Comments here are done via a colon on the left margin, followed by
: a space, followed by the text of the comment. DOS will not process
: such lines as actual instructions to be executed by the batch file.
: The purpose of this batch file is to allow you to perform some
: operation on a series of files. The batch file reads from a list
: of files stored in an ASCII text file - the name of the text file is
: this sample batch file's %1 parameter.
: This is preferable to using FOR..IN..DO if you have a very long list
: of files to process - if you do, you run into problems with the DOS
: limitation on the length of a command line.
: "Wild card" filespecs may be used if the command you wish to use for
: processing the list allows them and so long as the first character
: is not asterisk "*". Substitute "?*.*" for "*.*" omitting the
: quotes "".
: If the ASCII list of files is the batch file's %1 parameter, the %2,
: %3 etc. parameters of the batch file are the commands you wish to
: use for processing files contained in the list. Example: suppose you
: wish to execute a program called EDIT and it allows a parameter on
: the command line in addition to the file name. Suppose the parameter
: you want to use is /X.
: Your command from DOS for a single file would be EDIT (some
: filename) /X.
: To use this batch file and do the same thing for a list of files to
: process contained within the text file FILELIST.TXT:
: WITHLIST FILELIST.TXT EDIT /X
: NOTE: the ASCII list of file names may contain blank lines between
: lines containing file names, but they will be ignored. And the
: last line in the list should be terminated with a SINGLE <cr>
: Also note: the SETENV program used by this batch file may not be
: compatible with any replacements you may have made for
: COMMAND.COM.
COPY %1 my.dat
: Copies your source file - the ASCII list - to a temporary file
: named MY.DAT. Otherwise, your source file would be altered by this
: batch file instead of MY.DAT.
ECHO.>> my.dat
: Adds a blank line to the END of MY.DAT to make sure last line with a
: filename ends with a <cr>. Otherwise next command would add the
: periods to the end of the last file.
ECHO ....>> my.dat
: Adds a line containing only four periods to the END of MY.DAT.
: Sort /r puts this line last but before any blank lines and before
: the title line created by Find which starts with hyphens. See below.
:LOOP
: The batch file's "LOOP" label (not a comment line!). Batch
: processing returns here after the first and each subsequent line.
SETENV F1 " " < my.dat
: Uses the SETENV.EXE program to create an environment variable named
: F1
: This instruction *requires* the " " shown above. This is a null
: prompt line needed by SETENV here, or else it won't work.
: This SETENV instruction causes the file name on the *first* line
: of the temporary file MY.DAT to be "pushed" into the environment
: variable F1. That is, the text on the first line of MY.DAT is
: redirected, via the angle-bracket character, to SETENV, which puts
: that file into the environment. If the first line were FILE1.TXT
: then this would be equivalent to SET F1=FILE1.TXT
IF "%F1%" == "" goto ENVERROR
: If the F1 variable contains NOTHING, it probably means you ran out
: of environment space; SETENV couldn't create the variable F1. This
: traps such an error and terminates the batch file. See below for
: label ENVERROR
IF "%F1%" == "...." goto :end
: If variable F1 turns out to contain four dots, then quit to the
: batch file's END label.
%2 %F1% %3 %4 %5
: This is the instruction you want the batch file to execute. The %2
: on the command line is the name of the program you want to call.
: %F1% contains the file name, from MY.DAT, pushed into the variable
: F1.
: %3, etc. are (optional) parameters for the program you want to run.
FIND /v "%F1%" my.dat > my2.dat
: Now use the DOS external utility FIND to locate the string in
: variable F1 - to locate it within the temporary file MY.DAT. Using
: the /V option of FIND causes all lines EXCEPT the string contained
: in F1, to be written out to a new temporary file called MY2.DAT.
SORT /r < my2.dat > my.dat
: Now run the DOS external utility SORT, using the new file MY2.DAT
: for input, and redirecting the output of this operation back to the
: temporary file MY.DAT, which is over-written now by the sorted list.
: The /r switch causes a reverse-order sort. The row of periods again
: ends up at the bottom of the MY.DAT file.
GOTO LOOP
: Now return to the LOOP label, at which point SETENV is again used to
: create an environment variable F1. This time the file name, read in
: from the text file MY.DAT, is something other than the one that was
: read the last time - since the FIND /V operation has caused the
: first file name to be removed from MY.DAT.
:ENVERROR
echo.
: That puts a blank line on the screen.
echo It looks as if SETENV couldn't write the environment variable.
echo Batch file terminated.
GOTO END_2
:END
echo.
echo No more files to process.
echo.
:END_2
erase my?.dat
: Get rid of any remaining temporary file (MY.DAT and/or MY2.DAT)
: end of the batch file.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Other Products from OurSoft █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
┌──────────────┐
│ Blaiz TM │
└──────────────┘
Blaiz has enhanced replacements for the DOS commands COPY and DEL
as well as a MOVE command and an fast editor optimized for small batch
files.
Blaiz feels intuitive and comfortable. It has no command line
switches. If Blaiz encounters a potential problem, it describes it
and asks your choice. It has rigorous DOS wildcard compliance so you
don't need to learn a new syntax.
Blaiz is the safest copy, move and del. It checks for potential
overwrites, duplicate targets, or disks too full, and gives you a
warning message and a choice for each. With each choice you are
presented the latest inputs for re-editing making the correction of
errors easy.
Blaiz makes you faster by saving you keystrokes.
Blaiz allows multiple sources.
The editor in Blaiz accepts all the ASCII characters 0-255,
including NULL and Esc making it ideal for small quick batch files.
For the small text files for which it was optimized, it is faster than
any editor I have tried.
One beta tester referring to the safety features and protections
built into Blaiz said Blaiz really saved my bacon. It'll save your
bacon too, and that alone will make it worth the $19.95 registration.
By itself the editor would be worth the registration fee. Together
Blaiz is a real value.
Blaiz registration is $19.95. As an Introductory Offer, if you
register both Blaiz and StarCOM before July 18, 1990 you get $10 off.
So, save $10 by ordering both right away. -- See Prices in INFO.DOC.
┌──────────────┐
│ StarCOM TM │
└──────────────┘
StarCOM gives you the same visibility and control over the
internal commands of DOS as you now have over a file directory. You
can change, delete, duplicate or view internal DOS commands.
There are two main reasons you should get StarCOM. First is the
ability to "Bypass DOS". This would be useful in conjunction with
Blaiz so that the improved Copy and Del commands can be used with
their familiar names. This can also be used with any third party
improvement to DOS. For example, if you have a favorite DIR program
called FastDIR you might really like changing the internal command DIR
to say CAT (for catalogue) so you could rename FastDir.exe to DIR.exe.
Then when you typed DIR, FastDIR would run!
The second main reason you should get StarCOM is for foreign
language localizing. For example, if you speak Japanese you could
change the internal commands to Japanese, eg. if you change DIR to HYO
when you type HYO you'll get the familiar file list. This works for
any language: French, Greek, Swedish, German, etc..
StarCOM is not a TSR, it rewrites command.com and so takes up no
additional memory. It does not hook nor intercept interrupts which
means universal program compatibility. It works equally from both
command line or from a batch file.
StarCOM registration is $59.95 and has a 60 day satisfaction or
money back guarantee. As an Introductory Offer, if you register both
Blaiz and StarCOM before July 18, 1990 you get $10 off. So, save $10
by ordering both right away. -- See Prices in INFO.DOC.
┌───────────┐
│ FWCONV │
└───────────┘
■ Convert ASCII files to MSWord.
■ Convert FinalWord files to ASCII.
■ Convert FinalWord files to MSWord.
The Conversion from ASCII to MSWord is a smart conversion that
recognizes paragraphs and tables. The left margin is stripped.
To convert from ANY word processor to MSWord, print your docs
from any word processor in ASCII (or redirect print output to a file),
and then convert with FWCONV.
If you use MSWord you'll want FWCONV for those times when you
save a file with 'Text-only-with-line-breaks' and then later desire to
edit that file with MSWord. FWCONV will put it back into a form
MSWord prefers, simplifying this greatly.
FWCONV registration is $9.95.
┌──────────────────┐
│ Turbo Brief TM │
└──────────────────┘
Turbo Brief is an enhancement for Brief and so requires Brief to
work. Turbo Brief doubles the number of functions of Brief making the
combination the most powerful editor today. Some highlights are:
■ A pulldown menuing system.
■ Integrated Make collects errors from mixed languages and gives you
point and shoot access. Skip directly to correct file and line
no matter the source language. No one else has this.
■ Full screen pick list display of history for each and every
command.
■ Full editing power for commands even brings Undo to the command
line. Commands visible up to 72 characters wide.
■ Integrated access to Turbo Debugger or Codeview with one hot-key.
■ Hot-key to patching language help or integrated debugger in
Borland's Turbo IDE.
■ Two key sets, one with original Brief keys and one that makes Brief
act just like Turbo IDE. If you use Borland Turbo languages
you'll love this.
The Beta testers of Turbo Brief said they'd rather fight than
switch back to Brief without Turbo Brief or back to Turbo IDE. Turbo
Brief is not shareware but has a 60 day money back guarantee, and is
sold directly for $199.50.
┌────────────────────────┐
│ Support and Training │
└────────────────────────┘
OurSoft Support and Training services are sold separately. See
Support and Training in INFO.DOC. OurSoft not only provides such
services for its own products but also in integrating many popular
shareware and commercial packages on DOS systems.
If your organisation uses outside third party support you will be
glad you compared with OurSoft Support. Support is $9.95 per 5 minute
unit, Training is on a per bid basis.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ WithList Tutorial █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
If you haven't already, install WithList. See Installation.
We will use erase as the first command to demonstrate.
Make a list of filespecs you wish to delete in a file called
Delete.Lst, for example assuming you had the following on your system
enter these in your Delete.Lst:
\word\*.bak
\word\mw*.tmp
\word\docs\*.bak
\word\docs\mw*.tmp
\word\notes\*.bak
\word\notes\mw*.tmp
If you don't have these directories then substitute a list of
filespecs you might like to delete.
then at the DOS prompt type:
withlist delete.lst erase
WithList should go through and delete each of the six file specs.
As a second example, if you have a set of files that recur regularly
and you want to keep a short history of them you might have a
history.bat to manage them as follows.
if exist sav4\*.* erase sav4\*.*
WithList savelist.txt move
Where move is a move command like that contained in Blaiz Move. See
Other Products from OurSoft.
And where savelist.txt contains the following.
sav3 sav4
sav2 sav3
sav1 sav2
z_in sav1
When History.bat is run it should rotate the files keeping the most
recent four (4) files while deleting the oldest.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ I N D E X █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
Blaiz.........................................................407
Contents...................................................... 77
FWCONV........................................................485
Installation..................................................191
Other Products from OurSoft...................................407
StarCOM.......................................................449
Support and Training..........................................551
Turbo Brief...................................................509
Tutorial,WithList.............................................569