Shareware 1 2 the Maxx/sw_1.zip/sw_1/UTILS/ARJOP141.ZIP/ARJOPT.DOC

Text File | 1992-05-20 | 13KB | 295 lines

ARJOPT.DOC                                               May, 1992

:for ARJOPT.EXE, version 1.41A


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 43-line mode, 225 in
    50-line mode.)
2.  Multiple UNIX-style wildcard entries permitted. (i.e. *.COM  *.EXE
    A*.B? *T[DG-IL]?)
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.  Support for self-extracting archives
10. Same environment usable for DOS copy, move, and delete.
11. Equally usable with mono-color monitors as with color monitors.
12. Works with ALL versions of ARJ.EXE!
13. FREE! (See below)
14. Comes with source code for easy user modification.


LEGAL MATTERS:

                           COPYRIGHT NOTICE


ARJOPT is Copyright (c) 1991, 1992 by Michael D McCombs

This document is Copyright (c) 1991, 1992 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 below.


                              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, 1992 by Robert K Jung

BORLAND is a trademark of Borland International, Inc.

DOS is Copyright (c) by Microsoft, Inc.

UNIX is a trademark of AT & T.


                            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 all ARJ users. The author
maintains copyright for the purpose of preventing others from selling
or otherwise making a profit from this program.

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

     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 support 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,
work or anywhere. It can be distributed on BBS's as normal. The special
support 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.


                          REGISTRATION

As noted above, registration is not required for use of ARJOPT in any
environment.

A donation of $5.00 (US) is suggested for all 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.


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. The text is currently in English. Versions also
exist in Dutch and Danish. If you would like a version in your native
language, write me! It can be arranged....

STARTING ARJOPT

Simply type "ARJOPT -h" at the DOS command prompt. This will provide a
short instruction screen. ARJOPT accepts standard UNIX/sh wildcards as
arguments. (if you are unfamiliar with UNIX sh-style regular expressions,
see the section so titled, below.) 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.

UNIX SH-STYLE WILDCARD USAGE

The *IX command SH is a working shell similar in feel to the MSDOS
shell COMMAND.COM.  In actuality, much of what we see in our
familiar DOS PROMPT was purloined from the early UNIX shells.

GLOBBER.C is a SH pattern matcher.  This allows such specifications
as *240.arj or * (same as *.* in DOS-speak). Expressions such as
[a-e]*t would fit the name "apple.crt" or "catspaw.bat" or "elegant".
This is considerably more powerful than the DOS usage with which you
are probably familiar.

In the specified pattern string:
     `*' matches any sequence of characters (zero or more)
     `?' matches any single character
     `\' suppresses significance of a special character (see below)
     [SET] matches any single character in the specified set,
     [!SET] or [^SET] matches any single character not in the specified set.

A set is composed of characters or ranges; a range looks like
'character hyphen character' (as in 0-9 or A-Z).  [0-9a-zA-Z_] is the
minimal set of characters allowed in the [..] pattern construct.
Other characters are allowed (ie. 8 bit characters) if your system
will support them (and it, in all probability, will).

To suppress the special significance of any of `[]*?!^-\', and match
the character exactly, precede it with a `\' (backslash).

(Much of the above section is from WILDF113.[archive] by John Kercheval.)

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 FREE for your use!

The source code is now included (version 1.40 and higher). Feel free to
use any or all of it in anything but an ARJ menu program.

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!).

Thanks also to John Kercheval, the author of WILDF113, without which the
file globber of GLOBBER.C would be only half as powerful. His example is
what inspired me to add the source code to the standard distribution file
for ARJOPT.

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                                               May 20, 1992




End of ARJOPT.DOC