Garbo/Garbo.cdr/pc/arcutil/arjop110.zoo/ARJOPT.DOC

Text File | 1991-10-07 | 11.3 KB | 261 lines

ARJOPT.DOC                                               October, 1991

:for ARJOPT.EXE, version 1.10


ARJOPT is a simple and fast menu/directory display for Robert Jung's
ARJ.EXE. It features:

1.  Display of the first 100+ files in a directory that match your
    wildcard entries. (100 in 25-line mode, 190 in 40-line mode, 225 in
    50-line mode.)
2.  Multiple wildcard entries permitted. (i.e. *.COM  *.EXE  A*.B?)
3.  Rapid movement throughout the displayed files with multi-directional
    "rollover" and first letter searching.
4.  Support of International character set - all European and American
    character sets supported.
5.  Support of VGA (50 line) and EGA (43 line) extended screens.
6.  On screen instructions for usage.
7.  Bar menus for rapid command selection.
8.  Support for ARJ "a", "m", "e", "x", and "l" commands.
9.  Same environment usable for DOS copy, move, and delete.
10. Equally usable with mono-color monitors as with color monitors.
11. Works with ALL versions of ARJ.EXE!
12. Inexpensive - and quite possibly FREE! (See below)


LEGAL MATTERS:

                           COPYRIGHT NOTICE


ARJOPT is Copyright (c) 1991 by Michael D McCombs

This document is Copyright (c) 1991 by Michael D McCombs

No parts of ARJOPT or this document may be copied in whole or in part,
except as provide in the license on the next page.


                              DISCLAIMER

Michael D McCombs, hereinafter referred to as the author, makes no warranty
of any kind, express or implied, including, but not limited to warranties
of merchantability or fitness for any particular purpose with respect to
this software and its associated documentation.

IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DAMAGES (INCLUDING DAMAGES
FOR LOSS OF PROFITS, INTERRUPTION OF BUSINESS, LOSS OF INFORMATION OR DATA,
OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THIS
PROGRAM, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.


                       Trademarks and Copyrights

ARJ is Copyright (c) 1990, 1991 by Robert K Jung

BORLAND is a trademark of Borland International, Inc.

DOS is Copyright (c) by Microsoft, Inc.


                            LICENSE

ARJOPT is not, nor has it ever been, public domain software.

ARJOPT is distributed under the Shareware (User Supported Software)
concept. ARJOPT is free for the use of non-commercial, non-institutional
and non-governmental users. A limited license is granted to commercial,
institutional and governmental users to use ARJOPT for a trial period not
to exceed four weeks in order to determine if ARJOPT meets their needs.
Any use by a commercial, institutional or governmental user beyond this
period is expressly forbidden. Exception is made for any person or
commercial/institutional concern possessing a valid license for the
use of ARJ from Robert K Jung. This program is FREE for their usage.

All users are granted a limited license to copy ARJOPT for the sole
purpose of allowing others to try it, subject to the above restrictions
and:

     ARJOPT must be distributed in unmodified form, including ALL files
     present in the original.

     ARJOPT may not be included with any other product for any reason
     without a special license from the author.

     No price or fee may be charged for ARJOPT, excepting that a
     subscription fee to a BBS or similar distribution system shall not be
     considered such a fee.

Distributors of Shareware (User Supported) and Public Domain software MUST
obtain written permission from the author before distributing ARJOPT and
MUST follow the above conditions.

Special license is obtainable for religious institutions, excepting
schools, colleges or universities owned by religious institutions that
offer courses other than those taught toward ordination or investment as
minister, priest, rabbi, imam or other cleric.

_______________________________________

Author's note: The above simply means you can use ARJOPT for free at home,
but not at work. It can be distributed on BBS's as normal. The special
license for religious institutions excludes all educational affiliates
except seminaries or non-christian equivalents. The author reserves the
right to judge what is a valid religious institution. Any user with a
valid ARJ license may use ARJOPT without any fee.

                          REGISTRATION

As noted above, registration is not required for use of ARJOPT in a
private home by a private user. Registration IS required by all other
users (except licensed ARJ users) after the original four week trial
period.

A donation of $5.00 (US) is suggested for all non-registering users. Such
donations are what make it possible for authors like myself to continue to
create and improve Shareware. You are also strongly urged to support ARJ,
REARJ, ARJSORT, and UNARJ, without which this program would not exist.

To register, simply mail me $10 per computer upon which you plan to run
ARJOPT concurrently. Substantial discounts are available in the form of
site licenses for large numbers of computers - write for details.

My address is:
                          Mike McCombs
                          517 Ninth Ave.  #310
                          Seattle, WA    98104

Enough of that!
_____________________________________________________________________________

QUICK START

For those of you who don't like to spend a lot of time reading, simply
copy ARJOPT.EXE to any directory on your DOS PATH (if unfamiliar with the
DOS PATH command, see your DOS reference), insure that ARJ.EXE is also,
and type ARJOPT. A short usage display will provide you with more than
enough information to start using ARJOPT immediately.

NON-ENGLISH KEYBOARDS

ARJOPT will display any file in a directory, but it is in "directory
order" rather than sorted. The "first-letter search" feature works with
any character set as long as the proper COUNTRY.SYS and KEYBOARD.SYS
are properly loaded. All text is currently in English. With adequate
support, other language versions will become available.

STARTING ARJOPT

Simply type "ARJOPT" at the DOS command prompt. This will provide a short
instruction screen. ARJOPT accepts standard DOS wildcards as arguments.
(If you are unfamiliar with DOS wildcard usage, see your DOS reference
manual.) For instance, "ARJOPT *.*" will present a list of all (or, at
least, the first 100 in 25-line mode) files in the current directory.
"ARJOPT *.EXE *.C" will do the same for all files with the .EXE or .C
extensions. ARJOPT will automatically adopt VGA 50-line, EGA 43-line,
or default 25-line text mode if that was the mode in which your screen
is operating at the time ARJOPT is loaded.

SCREEN "WINDOWS"

The ARJOPT screen is divided into four "windows". The top two lines are
simply the credit line and a divider with the current directory printed
out. The large center section of the screen is devoted to the file names
for the wildcards entered. The lower left contains the command bar menu,
the lower right contains a short list of available keys. The program
starts with the cursor in the "file select" window.

SELECT WINDOW

Files are selected (or subsequently unselected) with the SPACE or ENTER
key. Movement within the window is made with the cursor arrows or a
"first letter" search - typing a letter will move to the next file name
beginning with that letter. Movement to the right from the right-most
column will place the cursor in the left-most column and vice-versa.
Movement up from the top of the column will place the cusor at the bottom
of the previous column and vice-versa. Movement down from the last file
name will place the cursor at the first filename and vice-versa. Marking
a file will advance the cursor by one file. This combination makes
moving around amongst the displayed files very rapid. TAB and ESCAPE
will quit the Select Window and move the cursor to the Command Window.

COMMAND WINDOW

The Command Window offers command selection via a menu bar. Left and
right cursor keys move the highlighted command. Typing the first letter
of a command also moves to that command. ENTER selects the command. This
will provide either a sub-menu or execute the command (for List, Del,
and Return/Quit). Executing a command may require the entry of a file
name or directory name, and a line will be presented with the
appropriate prompt when required. When entering these names, the left
and right cursor keys, HOME, END, DEL, and BACKSPACE will have their
usual editing functions. INSERT will toggle between insert and
overwrite mode. ESCAPE will always exit the current task - which is Quit
from the main menu.

OTHER MATTERS

That's about it - I told you it was simple. If you are working with
directories with larger numbers of files, chances are excellent you can
display all the files you want with intelligent usage of the wildcards
entered on the command line. (I stongly urge you NOT to keep directories
this large, anyway. It drastically slows down all DOS operations in
that directory.) The number of wildcard entries you make is limited only
by the length of the DOS command line.

In order for ARJ to be properly accessed by ARJOPT, ARJ.EXE must be on
the DOS PATH.

With ARJ, various switches can be accessed through the use of the ARJ_SW
environment variable. With ARJ 2.10 and higher this has become even more
powerful. See the ARJ user's manual for your version to use this to your
best advantage.

IF ARJOPT IS NOT ENOUGH....

ARJOPT is fast and simple, but accesses only a small subset of the power
available with ARJ. If you like a menu environment, you may wish to
consider trying ARJMENU - available through many BBS's as ARJMxxx.EXE.
ARJMENU is a pop-up menu/directory utility that makes the full power of
ARJ available to those for whom the DOS command line is inconvenient or
unpleasant. ARJMENU offers full mouse support. ARJMxxx.EXE is also
available from the author - see my address in the Legal Matters section,
above.

________________________

ARJOPT is not designed to make a profit, though donations will help
defray expenses. ARJOPT *is* written for the support of Robert K Jung
and his tremendous ARJ, ARJSORT, UNARJ and related-product family. I
strongly urge you to support ARJ with your registrations and donations;
ARJOPT is then FREE for your use!

If you have comments or suggestions for ARJOPT, or are interested in
ARJMENU, I am also available via e-mail (Internet/ARPAnet) as:

                    [e-mail]
             or     [e-mail]

If in the Netherlands and you are without Internet/ARPAnet access, you
may leave messages for me with Ensing-BBS, 31-5904-1913, SysOp Gert
Ensing. Ensing-BBS is an official distribution center for ARJOPT and
ARJMENU (thanks, Gert!).

My special thanks to Robert Jung for his advice, encouragement and assistance
with ARJOPT and ARJMENU. Thanks to Gert Ensing in the Netherlands for
his support and Zbig Tyrlik (BBS Akademia Pana Kleksa - [phone]),
for his always helpful suggestions. Thanks also to my patient wife, Melina.
But mostly, thanks to the good Lord for His mercy and salvific grace.

I hope you enjoy ARJOPT,

Mike McCombs                                         October 6, 1991




End of ARJOPT.DOC