home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #1
/
monster.zip
/
monster
/
UTIL_ARC
/
LUP102.ZIP
/
LUP.DOC
< prev
next >
Wrap
Text File
|
1994-02-09
|
58KB
|
1,465 lines
Lodji Utility Program (LUP), Version 1.02
by David W. Roscoe
USER MANUAL
CONTENTS
INTRODUCTION .................. 2
QUICK START ................... 3
ACKNOWLEDGEMENTS .............. 3
SHAREWARE AND REGISTRATION .... 3
REQUIREMENTS .................. 4
INSTALLATION .................. 4
CONFIGURATION ................. 5
NOTATIONS ..................... 5
STARTING THE PROGRAM .......... 6
USING THE PROGRAM ............. 6
EXITING THE PROGRAM ........... 7
MENUS ......................... 7
HELP .......................... 8
VIEWING DIRECTORIES ........... 8
INCREMENTAL SEARCHING ......... 9
VIEWING MULTIPLE DIRECTORIES .. 9
VIEWING ARCHIVES .............. 10
VIEWING FILES ................. 11
COPYING FILES ................. 12
DELETING FILES ................ 12
RENAMING FILES ................ 13
EXTRACTING FILES .............. 13
DEMONSTRATION ................. 13
PERFORMANCE ................... 13
FILES USED BY LUP ............. 14
TECHNICAL SUPPORT ............. 16
FREE REGISTRATION UPGRADES .... 18
REVISION HISTORY ............. 19
KNOWN PROBLEMS ................ 19
1
INTRODUCTION
LUP (pronounced "loop") is a directory and archive viewer and
file extractor, and a simple file manager. It was designed to
be useful to anyone who receives, compares, or maintains large
collections of files. This includes CD-ROM publishers, BBS
operators, shareware venders, or anyone who receives their
products or services. LUP's commands are available through
command keys, context sensitive menus on demand, and help,
making LUP easy to learn and use.
LUP can display the contents of both DOS directories and
archive files. With LUP you can view the contents of files,
whether they are in DOS directories, archive files, or
subdirectories inside of archive files. LUP also supports
archive files inside archive files, in other words, nested or
embedded archive files.
Viewing the contents of archive files with LUP is just like
viewing regular DOS directories. In fact, the directory of an
archive file looks just like an extension of the DOS
subdirectory tree. This virtual extension also applies to
subdirectories in the archive file if the archive format
supports this, and to other archive files in the archive file.
LUP has a built in viewer for examining text files. This
includes files inside of archive files. You need not extract
the files first. LUP extracts them to temporary files
automatically when needed and deletes them when you exit LUP.
LUP can extract files from archives. It does this
automatically as part of the regular file copy command if the
files you are trying to copy are inside of one or more
archives.
Besides copying, LUP has other simple file management functions
such as file deletion and renaming. These commands work on
both regular files or directory files.
Also LUP can display more than one directory or archive at the
same time. Unlike many other programs, which display each
directory in a separate screen window, LUP displays them in a
single window. If two files have the same name and appear
identical then their display occupies a single line, allowing
more files to be fit on a screen. Files which appear different
are displayed on more than one line in a way which emphasizes
their differences such as length and time stamp. This makes it
easy for you to detect new, changed, or deleted files. This
feature is especially useful when comparing related groups of
files, such as a directory and its backup copy, or two versions
of the same software package or data set. When you move from
one subdirectory to another LUP attempts to do similar moves
for each subdirectory being displayed so that related files are
automatically displayed together.
2
LUP presently supports [.ARC], [.LZH], [.ZIP], and [.ZOO]
archives. Support for other archive file types is being added.
QUICK START
This section is for those who want to get LUP running quickly.
If you are an experienced user but are not sure whether LUP
will work on your computer then skip to the REQUIREMENTS
section, then the INSTALLATION section.
If you are an experienced user and have a fairly powerful
computer you can probably skip directly to the INSTALLATION
section.
ACKNOWLEDGEMENTS
I must thank several people for helping me to produce this
program.
First, I thank Robert Schenot for writing "The ShareWare Book".
His book is full of useful information on the software
business, with special emphasis on Shareware as a distribution
channel. It has saved me many hours of work.
I thank my Beta testers, most of whom are members of the Boston
area SMUDGE computer user group. Special thanks to Jim Van
Zandt and Irv Bosinoff for their valuable feedback.
I give my greatest thanks to Brad Hare for putting LUP through
grueling stress tests. He used LUP to view and extract files
from [.ZIP] archives from CD-ROMs and computer systems all over
the country. If LUP is mostly bug free then it is partially
because Brad found most of the bugs for me.
SHAREWARE AND REGISTRATION
This product is distributed as Shareware, a Try-Before-You-Buy
approach to software distribution. Please feel free to use LUP
free for up to 30 days to ensure that it meets your needs. If
you decide to continue using LUP you must register with the
author.
Your registered copy of LUP will include: the latest release of
the software, a printed user manual, a registration key to
disable the production of registration reminder messages from
the program, 90 days of support, upgrade notices, and maybe
some other miscellaneous software.
To obtain a registered copy of LUP use the <Alt-R> (Register)
command in the LUP File Lists Viewer. The File Lists Viewer is
3
active when LUP first starts. The Register command will
produce a registration form which will make your registration
easier for both you and me.
See the section LICENSE AGREEMENT for more information.
REQUIREMENTS
LUP will run on your computer if your computer is an IBM PC
compatible running MS-DOS or PC-DOS version 3.0 or later, has
400K of disk space, and has 640K of Random Access Memory (RAM).
If you plan to use LUP to examine archives then you must also
have the appropriate archive program in a directory in your DOS
PATH. The archive programs are available from most electronic
bulletin board systems. The presently supported archive file
types, the archive programs needed to access them, are listed
below:
[.ARC]: PKUNPAK.EXE v3.61, packaged in PK361.EXE, a self
extracting [.ARC] file, along with its companion
program PKPAK. This may be the last version of an
archive program produced by PKWARE which supported the
[.ARC] format. Earlier versions of these programs were
called PKXARC and PKARC. PKWARE abandoned the [.ARC]
format and developed the now much more popular [.ZIP]
format after settlement in 1988 of a lawsuit by System
Enhancement Associates against PKWARE. Note, [.ARC]
format does not support subdirectories.
[.LZH]: LHA.EXE v2.13. packaged in LHA213.EXE, a self
extracting archive file.
[.ZIP]: PKUNZIP.EXE v2.04g. packaged in PKZ204G.EXE, a self
extracting [.ZIP] file, along with its companion
program PKZIP. They can also be obtained from: PKWARE,
INC.; 9025 N. Deerwood Dr.; Brown Deer, WI 53223; USA
[.ZOO]: ZOO.EXE v2.1. packaged in ZOO210.EXE, a self
extracting archive file.
LUP was tested with these particular versions. It will
probably run with other versions. However, if you have newer
versions of these archive programs with which LUP does not work
then please notify me.
If you plan to run the DEMO.BAT demonstration script then you
will need both PKUNZIP.EXE and its companion program PKZIP.EXE.
INSTALLATION
To install LUP, copy all of the distribution files to an empty
subdirectory. I suggest the subdirectory name "\LUPnnn" where
4
"nnn" are the digits of the version number. If you set your
default directory to this subdirectory then you will be able to
run LUP.
If you want to be able to start LUP from any default directory
without using LUP's directory in the command then you must
follow some additional steps. The files LUP.EXE and LUP.DOC
must be in a directory which appears in your DOS PATH. You can
do this either by adding LUP's subdirectory to your DOS PATH,
or by copying LUP.EXE and LUP.DOC to a directory which is
already in your DOS PATH. LUP.DOC should be in the same
directory as LUP.EXE because this is needed by the Help
command.
If you plan use LUP to access archive files then you must also
have archive programs installed in your DOS PATH for each type
of archive. See REQUIREMENTS for more information on these
archive programs.
If your copy of LUP is a registered copy then you have one more
step to perform. See the section called DISABLING REGISTRATION
REMINDERS.
CONFIGURATION
This version of LUP has no configuration options. LUP tries to
adapt to the type of computer and the video mode you are using
when you run it. LUP will adapt to monochrome or color display
adapters. It will adapt to different screen dimensions, for
example, 25 lines, 43 lines, or 50 lines.
See the documentation on the DOS MODE command, or whatever
command you use to control your video display, for more
information.
NOTATIONS
The notation <KEY_NAME> represents the pressing of a key.
KEY_NAME represents the name of key. Usually this is the text
printed on the top of the key. For example <Esc> represents
the Escape key. On most computers the text "Esc" is printed on
the top of this key. Some keys have no text printed on them.
For example the down arrow key usually has a picture of an
arrow pointing down, but no text. In this documentation these
picture keys are represented by angle brackets enclosing text
which approximately describes this picture. For example, the
down arrow key is referenced by <Arrow-Down>
The notation [FILE_TYPE] represents a file type. The file type
implies a way of interpreting the file. FILE_TYPE is the name
of the type. For example, [.ZIP] represents a file created by
PKZIP or similar program. FILE_TYPE may or may not be the same
as the file name extension. For more information see VIEWING
5
ARCHIVES.
The notation {SPECIAL} represents a special list item where
SPECIAL is the name of that item. You may see this in the File
List Viewer or the Path Picker. The program takes special
action when you press the Enter key while the cursor is on one
of these items. The action is suggested by the value of
SPECIAL. For example, pressing <Enter> when the cursor is on
{Parent} in the File List Viewer causes the parent directory
or directories to be displayed.
STARTING THE PROGRAM
The simplest method of starting LUP is simply to type "LUP"
from the DOS prompt. Type:
LUP<Enter>
The "<Enter>" stands for the Enter key. LUP will execute and
display the File List of the current working directory in the
File Lists Viewer. From there you may change the File Lists
being displayed, move elsewhere in the directory tree, or
perform other file operations.
To make LUP begin by displaying one or more File Lists other
than the current working directory, simply add their names to
the DOS command line. For example, suppose C:\PROJECT1
contains your files of a particular project, and a floppy
diskette contains previously saved versions of those files, and
you want to see which files have changed since you saved them.
To do this, place the diskette in drive A: and at the DOS
prompt type:
LUP C:\PROJECT1 A:<Enter>
This will cause LUP to start and to display both directories
simultaneously. Note, only File List specifications can appear
on the command line. You can not view a text file directly
from the command line, however you can do this after LUP is
started.
You may also specify archive files on the command line. In
general you may type an archive file path name anywhere you
could type a directory file path name. See VIEWING ARCHIVES
for more information.
USING THE PROGRAM
LUP was designed to be both easy to learn and easy to use.
Almost all program commands are available through context
sensitive menus AND single key shortcuts.
Using the menus is easy. You can begin using the program
6
immediately with the menus. If you want you can learn the
shortcut keys. All shortcut keys are displayed in the menus of
their associated commands, which makes them easy to learn.
There is also a simple Help command which allows you to view
this user manual from inside of LUP.
EXITING THE PROGRAM
You can quit, or exit, any part of the program using <Esc>
(Escape key). If you do this in the File Lists Viewer then you
are asking to quit the program and return to DOS. In this case
the program will ask for confirmation before exiting. The
default directory will be the one active when you started the
program.
You can also exit the program using the <Alt-X> (Exit to
directory) from the File Lists Viewer. This command allows you
to exit with the default directory set to one of the ones being
displayed by the File Lists Viewer, which may not be the one
active when you started the program.
MENUS
Menus are available from nearly everywhere in the program. You
can display a menu by pressing the F10.
Menus are context sensitive. This means that the commands
listed in a menu vary according to the commands available at
that point of the program. These commands can depend on
everything from the type of dialogue box active to the position
of the cursors. If you are ever not sure about what to do
next, pressing F10 will produce a menu of all the things you
can do at that point. For example, if the File Lists Viewer is
active and you press the F10 key then a menu labeled "File
Lists Viewer Menu" will be displayed which lists all the
commands available from the File Lists Viewer. You will even
see the F10 key listed.
You can use a menu in two ways. The first way is to select one
of the commands in the menu and press the Enter key to execute
it. For example, in the menu of the File Lists Viewer is the
menu item "<Alt-A> About this program". If you move the menu
cursor to that menu item and press the Enter key then a
dialogue box will be displayed which gives a brief description
of the program.
The other way to use a menu is as a command summary. When you
see in a menu the command you want to execute, you can press
the <Esc> key to exit the menu and then press the associated
command key to trigger that command.
Note, sometimes a menu item represents a group of commands, not
7
a single command. Group menu items end in "...". If you press
<Enter> when the menu cursor is on a group menu item then
another nested menu will appear. This nested menu represents
the group. For example, when a list scroller is active there
are several command keys available for moving the scroller's
cursor. These appear as a single group menu item under the
name "Line Cursor Movement...". If you press the Enter key
while the menu cursor is on the "Line Cursor Movement..." item
then another menu will appear which lists the actual cursor
movement commands with their command keys, such as "<Arrow-
Down> Forward", etc.
To abandon a menu without executing one of its commands, press
the Esc key. The menu will disappear.
HELP
If you still can't figure out how to do what you want after
using the menus then you can get help by pressing the <F1> key.
This will open a dialogue for viewing the user manual file,
i.e., the file you are reading now. Help is available from
everywhere the menus are available.
VIEWING DIRECTORIES
You view directories with the File Lists Viewer, which is the
dialogue which fills the entire screen when you start the
program. It displays one or more directories. It is divided
into two major parts.
The top part contains a summary of the directories displayed.
Each line in the summary includes the number of the directory,
the total number of bytes in all the files in that directory,
the number of files including subdirectories in that directory,
and the path name of the directory. It also includes the file
mask, however this should probably be displayed elsewhere
because all file masks must be the same.
The bottom contains a list of the file entries in the
directories summarized in the top part. Each entry includes
the file name, the file size or if the entry is a subdirectory
a notation to indicate that, the file date, file time, and the
file attributes. Note, together the file date and file time
make up what is called the file time stamp. This is the time
the file was created or last written to.
The file entry list may be scrolled using the cursor movement
commands. Cursor movement commands include incremental
searches. This allows you to move the cursor directly to a
particular file entry by pressing the first few characters of
the file name. See INCREMENTAL SEARCHING for details.
8
To display a subdirectory of the directory you are displaying,
simply move the scroller cursor to the subdirectory you wish to
display and press the <Enter> key. If you wish to display the
parent of the directory being displayed then move the cursor
the entry labeled "{Parent}" and press the <Enter> key.
Using these two basic operations you can easily examine all
directories on a disk.
If you would like to examine the directories on a different
disk drive, or would like to jump immediately to a distant
directory then use the Alt-S (Substitute Path) command.
If you would like to limit the display to a subset of all the
files in the directory you can use the Alt-F (File Mask)
command. For example to display only the files ending in
".TXT", change the New File Mask to "*.TXT".
The previous commands are part of a group of commands to
control the file lists displayed by the File Lists Viewer.
This group is visible as the "Lists Displayed..." item in the
File Lists Viewer menu. For information on the commands in
this group see VIEWING MULTIPLE DIRECTORIES.
INCREMENTAL SEARCHING
If you are in the File Lists Viewer or the Path Picker and you
know the first few characters of a file in which you are
interested you can quickly move the cursor to its file entry by
typing those characters on the keyboard. This is called
incremental searching. Each time you press a key LUP adds that
key to the search string and moves the cursor to the first file
which matches that string. If the search string does not match
any file entry then LUP displays a message and allows you to
correct or remove that last character.
The position of the character cursor within the file entry
shows how many search characters have been pressed. You can
remove the last character in the search string by pressing the
<Backspace> key. LUP repositions the cursor appropriately.
If you use one of the other cursor movement keys the
incremental search string will be adjusted appropriately.
Characters are removed from the tail of the search string until
the search string matches the file name in the new file entry.
An empty search string matches every file entry. The
incremental search can usually be completely reset by pressing
the <Home> key.
VIEWING MULTIPLE DIRECTORIES
Viewing multiple directories at the same time is similar to
viewing single directories. It is also done with the File
Lists Viewer however there are a few differences in the
display. Each file entry may occupy more than one line,
9
between one and the number of directories displayed. If LUP
finds that two files with the same name in two different
directories have the same size, date, time, and attributes then
it displays then on the same line. Otherwise it puts them on
two different lines. The numbers in the column headed with
"**..." indicate which directories a given version of a file is
in. The different file versions are ordered by date and time
with the newest files first.
Any line which does not have numbers in every position of the
"**..." column indicates some type of difference, either a new
file, a deleted file, a changed file, a file with different
attribute bits, etc. This is the column which makes finding
differences between directories easy.
The directories being displayed are summarized in the top of
the two rectangular display areas on the screen. The
directories are ordered alphabetically by name.
The set of directories being displayed can be changed by using
the File Lists Viewer, Lists Displayed... commands. With them
you can add a directory, remove a directory, or substitute a
directory in the set of directory or archive files being
displayed. If you want to add a directory to the File Lists
Viewer use the <Alt-I> (Include Path) command. If you want to
remove one from the File Lists Viewer use the <Alt-E> (Exclude
Path) command. Note, in earlier versions this was called
Eliminate Path. The name was changed because the old name
suggested that it may delete files, however it merely removes
them from the display. If you want to change one then use the
<Alt-S> (Substitute Path) command.
VIEWING ARCHIVES
Viewing archive files is very similar to viewing directory
files. To view an archive file, move the cursor of the File
Lists Viewer to the file entry of the file and press the
<Enter> key. The File Lists Viewer will display the contents
of the archive file as a list of the files it contains. The
archive file must be one of the archive types supported.
You may move between the subdirectories of an archive file just
like DOS subdirectories. You may even move into archive files
inside of archive files, in other words, nested archive files.
You may also display regular DOS directory listings and archive
listings at the same time to compare them as described in the
section on VIEWING MULTIPLE DIRECTORIES.
Normally LUP decides how to view a file by examining the file
name extension. For example, the names of most [.ZIP] files
end in ".ZIP". However not all archive files end in their
standard name extensions.
There are two ways to view an archive file which does not have
10
the file name extension normally associated with it. One way
is to use the File Lists Viewer <Alt-V> (View with selectable
method) command. This command displays a list of ways to view
the file. You may move the cursor to the appropriate archive
type and press <Enter>. This will cause LUP to try to display
the file as that type of archive file. For example, a self
extracting [.ZIP] file whose name is FILE.EXE may be examined
as a [.ZIP] archive by using the <Alt-V> command and selecting
the [.ZIP] view option.
The other way to view an archive file with a nonstandard name
extension is to use the [FILE_TYPE] notation to specify an
archive type. Any place where LUP accepts the path name of an
archive file, for example on the command line or in the
"Substitute Path" command, you may use an optional archive file
type specifier. For example, you may specify a self extracting
[.ZIP] file whose name is FILE.EXE by "FILE.EXE[.ZIP]".
There is a class of archive files which get special treatment.
Often an archive file which contains files in subdirectories
also contains their subdirectories. For example, if a [.ZIP]
file contains an entry for a file "SUB\FILE.TXT" then it
probably also contains an entry for the subdirectory "SUB\".
LUP will display the entry for this subdirectory in the usual
manner. However if the entry for subdirectory "SUB\" is
missing then LUP must simulate its presence. A listing of the
contents of such a [.ZIP] file will contain a simulated entry
for the subdirectory. You can recognize these fake
subdirectories by the impossible date and time stamp value of
"1980-00-00 00:00:00".
Note, some archive files created on Unix systems contain files
whose names have lower case characters. LUP will convert these
names to upper case when it displays them because DOS does not
support lower case in its file names.
VIEWING FILES
To view a file, use the File Lists Viewer to display the
directory or archive containing the file you would like to
examine. Move the cursor to the entry for the file and press
the <Enter> key. LUP displays the file.
If the file has a file name extension normally associated with
one of the archive file types, then LUP will display the file
in a File Viewer text window which may be scrolled. If the
file you want to view has an archive file type extension but
you know that the file is actually a text file, or if you want
to view an archive file as text, use the "View with selectable
method) <Alt-V> command. This command allows you to override
the normal viewing method.
By default the File Viewer shows only printable ASCII
11
characters. However you may display all characters except the
line-feed <LF>, which is treated as a line terminator, by using
the <Alt-J> (toggle Junk filter) command. This will display
all characters, whether they are printable ASCII or not. In
either case LUP also does some rudimentary formatting of tab
characters.
If a file line will not fit on a single screen line then it
will be continued to as many following screen lines as
necessary. Use the <Alt-M> (toggle Multicolor lists) command
to display alternate file lines in different colors and make
this continuation easier to see.
COPYING FILES
To copy regular or directory files, use the File Lists Viewer
to display the directory or archive containing the files you
want copy. If you are interested in a particular one then move
the cursor to it. Press the <Alt-C> (Copy regular or directory
files) key.
LUP will display a dialogue box with its best guesses for
source path, destination path, and file mask filled in or
selected. Complete filling in these values. Use the Tab key
to move between value gadgets.
When you have defined all values press the Enter key. LUP will
begin copying files. When it is finished the destination path
will be added to the File Lists Viewer if that path was not
already being displayed.
You may not copy into an archive file. However you may copy
files out of an archive file into a DOS directory. In this
case LUP will automatically extract the files.
DELETING FILES
To delete regular or directory files, use the File Lists
Viewer to display the directory or archive containing the files
you want delete. If you are interested in a particular one
then move the cursor to it. Press the <Alt-D> (Delete regular
or directory files) key.
LUP will display a dialogue box with its best guesses for path
and file mask filled in or selected. Complete filling in these
values. Use the Tab key to move between value gadgets.
When you have defined all values press the Enter key. If you
have specified more than one file to be deleted then LUP will
ask for confirmation. If you answer Yes then it will begin
deleting files.
You may not delete files from an archive file.
12
RENAMING FILES
To rename a regular or directory file, use the File Lists
Viewer to display the directory or archive containing the file
you want rename. If you are interested in a particular one
then move the cursor to it. Press the <Alt-N> (reName a file)
key to activate the "reName a file" command.
LUP will display a dialogue box with its best guesses for
directory, and old name filled in or selected. Complete
filling in these values and provide a new name. Use the Tab
key to move between value gadgets.
When you have defined all values press the Enter key and LUP
will rename the file. You may not rename a file inside an
archive file.
EXTRACTING FILES
LUP can extract files from archive files. Extracting is done
automatically. There are no separate commands for extracting
files. When you copy files from one location to another and
the source location is inside an archive, or nested inside
several archives, LUP extracts the files automatically.
Whenever you view a file which is inside of an archive LUP
extracts it to a temporary file first. See COPYING FILES and
VIEWING FILES for more information.
DEMONSTRATION
The file DEMO.BAT is a batch file which demonstrates some of
the unusual features of LUP, namely the ability to view archive
files, and the ability to view multiple directory trees in a
merged format. The demo creates some files and subdirectories
in the default directory and displays instructions for you to
follow to explore various features. The demonstration is not
fully automated. It depends on your ability to follow
instructions.
To run the demonstration, set the default directory to the
directory containing the LUP files, and type:
DEMO<Enter>
PERFORMANCE
You may be able to make LUP run a bit faster if you want to.
Besides running LUP on a faster computer, there are several
things you can do.
13
LUP caches various calculations. This means that it saves the
results of calculations in a cache in Random Access Memory
(RAM). If LUP needs the result of a calculation again it may
find it in the cache and not need to spend the time to
calculate it again. If you can increase the amount of memory
for LUP to use then it can cache more calculations and run
faster. Recent versions of DOS allow you to load DOS, device
drivers, and TSRs (Terminate and Stay Resident programs) into
high memory, making more memory available for programs like
LUP. If you can do this but have not already done so then try
it. This may make some of your other programs run faster also.
Since LUP accesses disk a lot, using a disk cache can make it
run faster also. If you are not running a disk cache you may
want to do so. This may make some of your other programs run
faster also.
LUP runs an archive program to read the contents of an archive
file. With luck the archive program will be in your disk cache
when needed. However it may be purged from the disk cache by
later disk accesses, especially if your disk cache is small.
If this happens then you may want to use a RAM drive instead
of, or in addition to, a disk cache; and put your archive
programs in a directory on the RAM drive. If you do this then
you also need to have that directory in your DOS PATH,
otherwise LUP will be unable to find the RAM drive copy of the
archive program.
FILES USED BY LUP
The following files are parts of, or are created by, the LUP
package:
LUP.DOC: This is the file you are reading now. It is the user
manual for LUP. It is also used by the Help command.
LUP.EXE: This is the LUP executable.
LUP.CFG: This file is created by LUP. It contains
configuration information, which in this version of LUP
consists of only the registration status of the program. It
is always created in the directory from which the program
(LUP.EXE) is run.
C:\LUPTMP.$$$: This subdirectory and the files created in it
are temporary files. They are deleted when LUP terminates.
LUP creates temporary files when it examines the contents of
archive files.
DEMO.BAT: This batch file script creates some directories and
files which are used to demonstrate LUP's unusual features.
When executed it displays instructions for its use.
REGISTER.DOC: This contains information on how to register the
program.
VENDOR.DOC: This contains information for disk vendors on how
to distribute this software.
14
TITLE49.TXT: suggested title line of software when uploaded to
electronic bulletin board systems, in 49 characters or less.
KEYWORDS.TXT: suggested keywords for software when uploaded to
electronic bulletin board systems.
DESC549.TXT: suggested description of software when uploaded to
electronic bulletin board systems, in 549 characters or less.
FILE_ID.DIZ: This contains a description of the software
suitable for use with certain automatic catalog and BBS file
list production software.
{SDA.ID}: This contains a description of the software to be
used in its distribution by The SDN Project.
15
LICENSE AGREEMENT
You may use LUP free for up to 30 days to ensure that it meets
your needs.
If you decide to continue using LUP you must receive a
registered copy of the software by registering with the author.
You may make any number of copies of this software, including
the registration key and printed manual which come with a
registered copy, with the following conditions:
1. The number of days you have been using the software does
not exceed 30 days, or
2. The total number of people using any of the copies of the
software at any one time does not exceed the number of
registered copies owned by you.
You may give (or sell) copies of the software to others, in
fact you are encouraged to do so, with the following
conditions:
1. The software is not modified in any way.
2. You do not mislead the person receiving the software about
what that person is getting.
3. If you give (or sell) a package which includes a copy of a
registration key then you must destroy or include in the
same package all other copies of that key, and you must
destroy or include in the same package all copies of the
software associated with that key.
Note, if you are a shareware disk vendor then see file
VENDOR.DOC for more information.
LODJI disclaims all warranties relating to this software,
whether express or implied, including without limitation any
implied warranties of merchantability or fitness for a
particular purpose. Neither LODJI, nor anyone else who has been
involved in the creation, production, or delivery of this
software shall be liable for any special, incidental,
consequential, indirect or similar damages due to loss of data
or any other reason, even if LODJI or an agent of LODJI has
been advised of the possibility of such damages. In no event
shall LODJI's liability for any damages ever exceed the price
paid for the license to use software, regardless of the form of
the claim. The person using the software bears all risk as to
the quality and performance of the software.
TECHNICAL SUPPORT
Registered users are entitled to free technical support for
16
three months after registration. This support is for
correcting errors in the program.
If time permits support may also be provided to non-registered
users and registered users beyond their free support period.
You should provide all the information needed to reproduce the
error. At minimum you should provide your name, the version of
the software, and a description of what you did to trigger
the error and a description of the error. If you are a
registered user entitled to technical support you should also
provide the serial number and registration key of your
software. You may be asked to provide other information, such
as details on your computer system, your CONFIG.SYS and
AUTOEXEC.BAT files, and copies of data files associated with
the problem.
HOW TO CONTACT LODJI
You can reach LODJI at any of the following addresses:
USPS: LODJI, PO BOX 915, NORTH CHELMSFORD MA 01863-0915
CompuServe: 76360,1610
Internet: 76360.1610@compuserve.com
DISABLING REGISTRATION REMINDERS
To encourage you to obtain a registered copy of LUP from the
author, LUP occasionally displays messages to remind you of the
obligation to register. These reminders conform to the
guidelines of the Association of Shareware Professionals.
When you get a registered copy of LUP it includes a
registration key with which you can disable registration
reminder messages. The disabling of these messages is called
"silencing". If you do not silence LUP then it will
occasionally display these messages.
The registration key is printed on the invoice which comes with
your registered copy of LUP. Each key will silence only the
copy of LUP with a particular serial number. The serial number
of your copy of LUP is printed on both your diskette and your
invoice. If you purchased multiple registered copies of LUP
then make sure that you use the correct key for each copy.
To silence your registered copy of LUP, first find the key on
your invoice. It should be labeled "REGISTRATION KEY" and will
have the associated serial number printed nearby. Next, at the
DOS command prompt type:
LUP -s kkkkkkkkkk<Enter>
17
The "-s" is the silence option. The 's' must be in lower case.
The "kkkkkkkkkk" is the string of digits of the REGISTRATION
KEY you found on your invoice. "<Enter>" represents the Enter
key. Be sure to include spaces between the parts of the
command. If LUP displays the message "Silenced" and returns to
the DOS prompt then the silencing operation is successful. If
it does not do this then the silencing operation failed. This
probably means that you mistyped the registration key or some
other part of the command.
If you silence LUP but then copy it to another disk or
subdirectory, or you delete the file LUP.CFG, then the new copy
automatically changes so that it is no longer silenced. This
allows you to easily make and give unsilenced copies of LUP to
others. However it also means that if you copy LUP to another
directory as part of reorganizing your hard disk then you need
to perform the silencing procedure on the new copy.
Please do not give your registration key to anyone else. This
is a violation of your LICENSE AGREEMENT. Save a copy of your
key and serial number in a safe place. I suggest writing them
both here in the printed copy of this user manual.
Serial number:
Registration key:
FREE REGISTRATION UPGRADES
Once you own a registered copy of LUP you may repeatedly
upgrade free to new versions for up to one year after the date
of your registration. An upgraded copy is not as complete as
the original registered copy because it does not include a new
copy of the printed documentation or a new diskette, but it is
a fully functional and silenced copy of the program.
The upgrade procedure is as follows. When you learn of a new
release which you want to have, get a copy from a BBS, or a
friend, etc. Install it in the normal way.
Then, to silence your upgrade, at the DOS command prompt type:
LUP -s kkkkkkkkkk nnnnnnnnnn<Enter>
As before, the "kkkkkkkkkk" is the string of digits of the
REGISTRATION KEY from the invoice which came with your
registered copy. The "nnnnnnnnnn" is the SERIAL NUMBER of that
copy. The serial number MUST be typed in this case because it
is DIFFERENT from the serial number of the upgrade. This
procedure should work for any version released within one year
after the shipping date of your registered copy.
Note, the one year free upgrade period applies to release
18
dates, not to actual dates. The passage of time has no affect
on the operation of a registered original or upgrade, and has
no affect on the ability to silence it if you need to reinstall
it for some reason.
REVISION HISTORY
1.02 Public release, February 9, 1994.
* Added support for [.ARC], [.LZH] and [.ZOO] files.
* Added support for archive files which contain files in
subdirectories but not the subdirectories themselves by
simulating the subdirectories.
* Added free registration upgrade capability.
* Changed text representation of paths so [.ext] notation is
used in output and needed in input only if the file type is
different from the file name extension.
* Added <Alt-V> (View with selectable method) command.
* Add <Alt-J> command to display or hide (default)
unprintable graphic characters in File Browser.
* Add <Alt-M> command to display lists and files in two
colors or one color (default).
* Fixed readability problem with [.ZIP] files which contain
certain comments.
* Improved documentation, and added index and table of
contents.
* Increased speed slightly by: making memory management
faster; reducing memory fragmentation which reduced cache
purging which improved cache effectiveness.
* Made several minor bug fixes and some cosmetic changes,
including changing some command names and the keys to
activate them.
* Changed "File Lists Viewer" to never display unreadable
paths.
1.00 Public release (first).
KNOWN PROBLEMS
After using LUP to view directories and files LUP may run a bit
slower. On very rare occasions LUP may terminate with a
message which says that it is unable to allocate a block of
memory from its heap. If LUP terminates in this way, or if you
notice a slow down and would like to restore LUP's original
speed, simply restart LUP and then resume your task.
This problem does not have a severe impact on the usability of
LUP, so I will probably spend most of my time doing other
enhancements. However this problem will eventually be solved.
The slowing is caused by the LUP's memory manager purging the
internal cache in an attempt to recover memory blocks. The
termination happens when, after purging the entire cache, the
program is still unable to find a block of memory large enough
19
to satisfy an allocation request. Usually there is enough
total memory, but it is distributed in many separate blocks,
and no single block is large enough to satisfy the request.
This condition is called fragmented memory.
20
INDEX
ACKNOWLEDGEMENTS, 3
ARC, 4
Archive type, 11
Archives
viewing, 10
ASCII characters, 11
Browsing
see Viewing
Caches, 14
Color
see display
see toggle Multicolor lists
CONFIGURATION, 5
Copies of this software, 16
Copy regular or directory files, 12
COPYING FILES, 12
Date
see file time stamp
Default directory, 5, 7
Delete regular or directory files, 12
DELETING FILES, 12
DEMONSTRATION, 13
DEMO.BAT, 4, 13
Differences between directories, 10
Directories
viewing, 8
viewing multiple, 9
Directories displayed, 8
Disk cache, 14
Disk drive, 9
Display adapter
color, 5
monochrome, 5
DOS command line, 6
DOS MODE, 5
DOS PATH, 5
DOS prompt, 6
Eliminate Path
see Exclude Path
Embedded archive files
see nested
Escape, 7
Exclude Path, 10
Exit
see quit
Exit to directory, 7
EXITING THE PROGRAM, 7
EXTRACTING FILES, 13
Extraction
automatic, 12, 13
21
F1
help key, 8
F10
menu key, 7
File
changed, 10
deleted, 10
new, 10
File attributes, 8
File date, 8
File entries, 8
File Lists, 6, 10
File Lists
see Lists Displayed
File Lists Viewer, 3, 6, 8, 9
File Mask, 9
File name, 8
File size, 8
File time, 8
File time stamp, 8
File time stamp
impossible value, 11
File Viewer, 11
Files
directory, 12, 13
LUP, 14
regular, 12, 13
viewing, 11
FILES USED BY LUP, 14
Group menu items, 7
Help, 5, 8
Include Path, 10
Incremental searching, 8, 9
INSTALLATION, 4
INTRODUCTION, 2
LHA, 4
LICENSE AGREEMENT, 16
Line terminator, 11
Lists Displayed..., 10
LODJI, 17
Lower case characters, 11
LUP, 2
LUPTMP.$$$, 14
LUP.CFG, 18
LUP.DOC, 5
LUP.EXE, 5
LZH, 4
Memory, 19
MENUS, 7
22
MS-DOS
see DOS
Nested archive files, 10
New File Mask, 9
NOTATIONS, 5
Parent of the directory, 9
PATH
see DOS PATH
PC-DOS
see DOS
PERFORMANCE, 13
PKPAK, 4
PKUNPAK, 4
PKUNZIP, 4
PKWARE, 4
PKZIP, 4
QUICK START, 3
Quit, 7
RAM, 14
RAM drive, 14
Random Access Memory, 14
Register, 3
Registered copy, 16
Registering, 16
REGISTRATION KEY, 17, 18
REGISTRATION REMINDERS, 17
REGISTRATION UPGRADES, 18
ReName a file, 13
RENAMING FILES, 13
REQUIREMENTS, 4
REVISION HISTORY, 19
Screen
see display
Searching
see INCREMENTAL SEARCHING, 9
Self extracting archive
examining, 10
Serial number, 18
SHAREWARE AND REGISTRATION, 3
STARTING THE PROGRAM, 6
Subdirectories
displaying, 9
Subdirectories in archives, 10
Subdirectories in archives
simulated, 11
Subdirectory, 8
Substitute Path, 9
Support
see TECHNICAL SUPPORT
23
Tab characters, 11
TECHNICAL SUPPORT, 16
Time
see file time stamp
Toggle Junk filter, 11
Toggle Multicolor lists, 12
Unix systems, 11
Upgrades
see REGISTRATION UPGRADES, 18
Upper case, 11
USING THE PROGRAM, 6
Video
see display
Video mode, 5
View with selectable method <Alt-V>, 10, 11
VIEWING ARCHIVES, 10
VIEWING DIRECTORIES, 8
VIEWING FILES, 11
VIEWING MULTIPLE DIRECTORIES, 9
Warranties, 16
ZIP, 4
ZOO, 4
**, 10
<KEY_NAME>, 5
[FILE_TYPE], 5, 11
{ Parent }, 9
{SPECIAL}, 6
24
