home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR3 / LUP101.ZIP / LUP.DOC < prev    next >
Text File  |  1993-12-10  |  33KB  |  697 lines
  1.         Lodji-Utility-Program (LUP), Version 1.01.
  2.              by David W. Roscoe
  3.  
  4.  
  5.                              USER MANUAL 
  6.  
  7.  
  8.  
  9.  
  10. CONTENTS 
  11.  
  12.   INTRODUCTION 
  13.   ACKNOWLEDGEMENTS 
  14.   SHAREWARE AND REGISTRATION 
  15.   REQUIREMENTS 
  16.   INSTALLATION 
  17.   CONFIGURATION 
  18.   STARTING THE PROGRAM 
  19.   USING THE PROGRAM 
  20.   MENUS 
  21.   GETTING HELP 
  22.   BROWSING DIRECTORIES 
  23.   BROWSING MULTIPLE DIRECTORIES 
  24.   BROWSING ZIP ARCHIVES 
  25.   BROWSING FILES 
  26.   COPYING FILES 
  27.   DELETING FILES 
  28.   RENAMING FILES 
  29.   EXTRACTING FILES 
  30.   DEMONSTRATION 
  31.   PERFORMANCE 
  32.   SYSTEM FILES 
  33.   LICENSE AGREEMENT 
  34.   TECHNICAL SUPPORT 
  35.   HOW TO CONTACT LODJI 
  36.   DISABLING REGISTRATION REMINDERS 
  37.   REVISION HISTORY 
  38.   KNOWN BUGS 
  39.  
  40.  
  41.  
  42. INTRODUCTION 
  43.  
  44.   LUP (pronounced "loop") is a file utility program.  Its strength is in 
  45.   browsing and comparing disk directories and [.ZIP] archive files.  LUP 
  46.   presently supports only [.ZIP] archives however support for other archive 
  47.   file types can be added if there is sufficient demand.  
  48.  
  49.   Browsing the contents of [.ZIP] files with LUP is just like browsing 
  50.   regular DOS directories.  In fact, the directory of a [.ZIP] file looks 
  51.   just like an extension of the DOS subdirectory tree.  This extension also 
  52.   applies to subdirectories of the [.ZIP] file and to other [.ZIP] files in 
  53.   the [.ZIP] file, i.e.  nested [.ZIP] files!  
  54.  
  55.   In addition to browsing the file listings of DOS directories and [.ZIP] 
  56.   files, LUP also allows you to browse their text files.  This includes 
  57.   files inside of [.ZIP] files.  The user need not extract the files first.  
  58.   LUP's ability to display files inside of [.ZIP] archives without first 
  59.   extracting those files makes easy the browsing of large [.ZIP] file 
  60.   collections like those in CD-ROM libraries.  
  61.  
  62.   Also LUP can display more than one directory or [.ZIP] archive at the same 
  63.   time.  Unlike many other programs, which display each directory in a 
  64.   seperate screen window, LUP displays them in a single window.  If two 
  65.   files with the same name appear identical in two different directories 
  66.   then their display occupies a single line, allowing more files to be fit 
  67.   on a screen.  Files which do not appear identical are displayed on 
  68.   seperate lines in a way which emphasizes their differences such as length 
  69.   and time stamp.  This makes it easy to detect new, changed, or deleted 
  70.   files.  This feature is especially useful when comparing related groups of 
  71.   files, such as a directory and its backup copy, or two versions of the 
  72.   same software package.  When you move from one subdirectory to another LUP 
  73.   attempts to do similar moves for each subdirectory being displayed so that 
  74.   related files are automaticly displayed together.  
  75.  
  76.   LUP has other miscellaneous file management functions such as file 
  77.   deletion, copying, etc.  If you copy files from inside a [.ZIP] file then 
  78.   LUP will automaticly extract those files first.  
  79.  
  80.  
  81. ACKNOWLEDGEMENTS 
  82.  
  83.   I must thank several people for helping me to produce this program.  
  84.  
  85.   First, I thank Robert Schenot for writing "The ShareWare Book".  His book 
  86.   is full of useful information on the software business, with special 
  87.   emphasis on Shareware as a distribution channel.  It has saved me many 
  88.   hours of work.  
  89.  
  90.   I thank my Beta testers, most of whom are members of the Boston area 
  91.   SMUDGE computer user group.  Special thanks to Jim Van Zandt and Irv 
  92.   Bosinoff for their valuable feedback.  
  93.  
  94.   I give my greatest thanks to Brad Hare for putting LUP through grueling 
  95.   stress tests.  He used LUP to browse and extract files from [.ZIP] 
  96.   archives from CD-ROMs and computer systems all over the country.  If LUP 
  97.   is mostly bug free then it is partially because Brad found most of the 
  98.   bugs for me.  
  99.  
  100.  
  101. SHAREWARE AND REGISTRATION 
  102.  
  103.   This product is distributed as Shareware, a Try-Before-You-Buy approach to 
  104.   software distribution.  Please feel free to use LUP free for up to 30 days 
  105.   to ensure that it meets your needs.  If you decide to continue using LUP 
  106.   you must register with the author.  
  107.  
  108.   Your registered copy of LUP will include: the latest release of the 
  109.   software, a printed user manual, a registration key to disable the 
  110.   production of registration reminder messages from the program, 90 days of 
  111.   support, upgrade notices, and maybe some other miscellaneous software.  
  112.  
  113.   To obtain a registered copy of LUP use the "Register" command in the LUP 
  114.   File Lists Browser.  The File Lists Browser is active when LUP first 
  115.   starts.  The Register command will produce a registration form which will 
  116.   make your registration easier for both you and me.  
  117.  
  118.   The section LICENSE AGREEMENT for more information.  
  119.  
  120.  
  121. REQUIREMENTS 
  122.  
  123.   LUP will run on your computer if your computer is an IBM PC compatible 
  124.   running MS-DOS or PC-DOS version 3.0 or later, has 400Kb of disk space, 
  125.   and has 512Kb of Random Access Memory (RAM).  If you plan to use LUP to 
  126.   examine [.ZIP] archives then you must also have PKUNZIP.EXE in a directory 
  127.   in your DOS PATH.  If you plan to run the DEMO.BAT demonstration script 
  128.   then you will also need PKZIP.EXE.  PKZIP and PKUNZIP are available from: 
  129.  
  130.     PKWARE, INC.;  9025 N. Deerwood Dr.;  Brown Deer, WI 53223; USA
  131.  
  132.  
  133. INSTALLATION 
  134.  
  135.   To install LUP, copy all of the distribution files to an empty 
  136.   subdirectory.  I suggest the subdirectory name "\LUPnnn" where "nnn" are 
  137.   the digits of the version number.  If you set your default directory to 
  138.   this subdirectory then you will be able to run LUP.  
  139.  
  140.   If you want to be able to start LUP from any default directory without 
  141.   using LUP's directory in the command then you must follow some additional 
  142.   steps.  The files LUP.EXE and LUP.DOC must be in a directory which appears 
  143.   in your DOS PATH.  You can do this either by adding LUP's subdirectory to 
  144.   your DOS PATH, or by copying LUP.EXE and LUP.DOC to a directory which is 
  145.   already in your DOS PATH.  LUP.DOC should be in the same directory as 
  146.   LUP.EXE becaused this is needed by the Help command.  
  147.  
  148.   If your copy of LUP is a registered copy you have one more step to 
  149.   perform.  See the section called DISABLING REGISTRATION REMINDERS.  
  150.  
  151.  
  152. CONFIGURATION 
  153.  
  154.   This version of LUP has no configuration options.  LUP tries to adapt to 
  155.   the type of computer and the video mode you are using when you run it.  
  156.   LUP will adapt to monochrome or color display adapters.  It will adapt to 
  157.   different screen dimensions, for example, 25 lines, 43 lines, or 50 lines.  
  158.  
  159.   See the documentation on the DOS MODE command, or whatever command you use 
  160.   to control your video display, for more information.  
  161.   
  162.  
  163. STARTING THE PROGRAM 
  164.  
  165.   The simplest method of starting LUP is simply to type "LUP" from the DOS 
  166.   prompt.  Type: 
  167.  
  168.     LUP<Enter> 
  169.   
  170.   The "<Enter>" stands for the Enter key.  LUP will execute and display the 
  171.   File List of the current working directory.  From there you may change the 
  172.   File Lists being displayed, move elsewhere in the directory tree, or 
  173.   perform other file operations.  
  174.   
  175.   To make LUP begin by displaying one or more File Lists other than the 
  176.   current working directory, simply add their names to the command line.  
  177.   For example, suppose C:\PROJECT1 contains your files of a particular 
  178.   project, and a floppy diskette contains previously saved versions of those 
  179.   files, and you want to see which files have changed sinced you saved them.  
  180.   To do this, place the diskette in drive A: and at the DOS prompt type: 
  181.   
  182.     LUP C:\PROJECT1 A:<Enter> 
  183.  
  184.   This will cause LUP to start and to display both directories 
  185.   simultaneously.  Note, only File List specifications can appear on the 
  186.   command line.  You can not browse a text file directly from the command 
  187.   line, however you can do this after LUP is started.  
  188.  
  189.   You may also specify (.zip) archive files on the command line.  There is a 
  190.   notation [.ZIP] for doing this which is explained in the section named 
  191.   BROWSING ZIP ARCHIVES.  
  192.  
  193.  
  194. USING THE PROGRAM 
  195.  
  196.   LUP was designed to be both easy to learn and easy to use.  Almost all 
  197.   program commands are available through context sensitive menus AND single 
  198.   key shortcuts.  
  199.   
  200.   Using the menus is easy.  You can begin using the program immediately with 
  201.   the menus.  If you want you can learn the shortcut keys.  All shortcut 
  202.   keys are displayed in the menus of their associated commands, which makes 
  203.   them easy to learn.  
  204.   
  205.   There is also a simple Help command which allows you to browse this user 
  206.   manual from inside of LUP.  
  207.  
  208.  
  209. MENUS 
  210.  
  211.   Menus are available from nearly everywhere in the program.  You can 
  212.   display a menu by pressing the F10 key.  
  213.  
  214.   Menus are context sensitive.  This means that the commands listed in a 
  215.   menu vary according to the commands available at that point of the 
  216.   program.  These commands can depend on everything from the type of dialog 
  217.   box active to the position of the cursors.  If you are ever not sure about 
  218.   what to do next, pressing F10 will produce a menu of all the things you 
  219.   can do at that point.  For example, if the File Lists Browser is active 
  220.   and you press the F10 key then a menu labeled "File Lists Browser Menu" 
  221.   will be displayed which lists all the commands available from the File 
  222.   Lists Browser.  You will even see the F10 key listed.  
  223.   
  224.   You can use a menu in two ways.  The first way is to select one of the 
  225.   commands in the menu and press the Enter key to execute it.  For example, 
  226.   in the menu of the File Lists Browser is the menu item "<Alt-A> About this 
  227.   program".  If you move the menu cursor to that menu item and press the 
  228.   Enter key then a dialog box will be displayed which gives a brief 
  229.   description of the program.  
  230.  
  231.   The other way to use a menu is as a command summary.  When you see in a 
  232.   menu the command you want to execute, you can press the <Esc> key to exit 
  233.   the menu and then press the associated command key to trigger that 
  234.   command.  
  235.   
  236.   Note, sometimes a menu item represents a group of commands, not a single 
  237.   command.  Group menu items end in "...".  If you press <Enter> when the 
  238.   menu cursor is on a group menu item then another nested menu will appear.  
  239.   This nested menu represents the group.  For example, when a list scroller 
  240.   is active there are several command keys available for moving the 
  241.   scroller's cursor.  These appear as a single group menu item under the 
  242.   name "Line Cursor Movement...".  If you press the Enter key while the menu 
  243.   cursor is on the "Line Cursor Movement..." item then another menu will 
  244.   appear which lists the actual cursor movement commands with their command 
  245.   keys, such as "<Arrow-Down> Forward", etc.  
  246.   
  247.   To abandon a menu without executing one of its commands, press the Esc 
  248.   key.  The menu will dissappear.  
  249.  
  250.  
  251. GETTING HELP 
  252.  
  253.   If you still can't figure out how to do what you want after using the 
  254.   menus then you can get help by pressing the <F1> key.  This will open a 
  255.   dialog for browsing the user manual file, i.e., the file you are reading 
  256.   now.  Help is available from everywhere the menus are available.  
  257.   
  258.  
  259. BROWSING DIRECTORIES 
  260.  
  261.   You browse directories with the File Lists Browser, which is the dialog 
  262.   which fills the entire screen when you start the program.  It displays one 
  263.   or more directories.  It is divided into two major parts.  
  264.  
  265.   The top part contains a summary of the directories displayed.  Each line 
  266.   in the summary includes the number of the directory, the total number of 
  267.   bytes in all the files in that directory, the number of files including 
  268.   subdirectories in that directory, and the path name of the directory.  It 
  269.   also includes the file mask, however this should probably be displayed 
  270.   elsewhere because all file masks must be the same.  
  271.   
  272.   The bottom contains a list of the file entries in the directories 
  273.   summarized in the top part.  Each entry includes the file name, the file 
  274.   size or, if the entry is a subdirectory, a notation to indicate that, the 
  275.   date and time stamp of the file, and the attributes.  
  276.   
  277.   The file entry list is scrollable using the cursor movement commands.  
  278.   Cursor movement commands include INCREMENTAL SEARCHES.  This allows you to 
  279.   move the cursor directly to a particular file entry by pressing the first 
  280.   few characters of the file name.  
  281.   
  282.   To display a subdirectory of the directory you are displaying, simply move 
  283.   the scroller cursor to the subdirectory you wish to display and press the 
  284.   <Enter> key.  If you wish to display the parent of the directory being 
  285.   displayed then move the cursor the entry labeled "[ Parent ]" and press 
  286.   the <Enter> key.  
  287.   
  288.   Using these two basic operations you can easilly examine all directories 
  289.   on a disk.  If you would like to examine the directories on a different 
  290.   disk drive, or would like to jump immediately to a distant directory then 
  291.   use the Alt-S (File Lists Browser, Substitute Path) command.  
  292.   
  293.   If you would like to limit the display to a subset of all the files in the 
  294.   directory you can use the Alt-F (File Lists Browser, File Mask) command.  
  295.   For example to display only the files ending in ".TXT" then change the 
  296.   file mask to "*.TXT".  
  297.   
  298.  
  299. BROWSING MULTIPLE DIRECTORIES 
  300.  
  301.   Browsing multiple directories at the same time is similar to browsing 
  302.   single directories.  There are a few differences in the display.  Each 
  303.   file entry may occupy more than one line, between one and the number of 
  304.   directories displayed.  If LUP finds that two files with the same name in 
  305.   two different directories have the same size, date, time, and attributes 
  306.   then it displays then on the same line.  Otherwise it puts them on two 
  307.   different lines.  The numbers in the column headed with "**..." indicate 
  308.   which directories a given version of a file is in.  The different file 
  309.   versions are ordered by date and time with the newest files first.  
  310.   
  311.   Any line which does not have numbers in every position of the "**..." 
  312.   column indicates some type of difference, either a new file, a deleted 
  313.   file, a changed file, a file with different attribute bits, etc.  This is 
  314.   the column which makes finding differences between directories easy.  
  315.   
  316.   The directories being displayed are summarized in the top of the two 
  317.   rectangular display areas on the screen.  The directories are ordered 
  318.   alphabetically by name.  
  319.  
  320.   The set of directories being displayed can be changed by using the "File 
  321.   Lists..." commands.  With them you can add a directory, remove a 
  322.   directory, or substitute a directory in the set of directory or archive 
  323.   files being displayed.  
  324.     
  325.  
  326. BROWSING ZIP ARCHIVES 
  327.  
  328.   Browsing [.ZIP] archive files is very similar to browsing directories.  To 
  329.   examine a [.ZIP] file, move the cursor to the file entry of the file and 
  330.   press the <Enter> key.  The File Lists Browser will display the contents 
  331.   of the [.ZIP] file as a list of the files it contains.  
  332.  
  333.   The File Lists summary at the top of the screen will have the notation 
  334.   "[.ZIP]" after the name to indicate that a [.ZIP] file, rather than a 
  335.   regular directory, is being displayed.  This is the same notation which 
  336.   may be used for command line arguments when starting LUP from the command 
  337.   line.  
  338.   
  339.   The seperate "[.ZIP]" notation, rather than the file name extension, is 
  340.   needed to distinguish DOS directory files from DOS data files because: 
  341.  
  342.     1.  DOS directory names can have extensions, even ".ZIP".  
  343.     
  344.     2.  Not all [.ZIP] files have ".ZIP" extensions.  For example, it is 
  345.         common for a self extracting [.ZIP] file to end with ".EXE".  
  346.   
  347.   You may move between the subdirectories of a [.ZIP] file just like DOS 
  348.   subdirectories.  You may even move into [.ZIP] files inside of [.ZIP] 
  349.   files, in other words, nested [.ZIP] files.  You may display regular DOS 
  350.   directories and [.ZIP] file directories at the same time to compare them.  
  351.   
  352.   To display a [.ZIP] file which does not have a [.ZIP] extension, such as a 
  353.   self extracting [.ZIP] file, use the Include Path or Substitute Path 
  354.   commands.  Enter the name of the file with the characters "[.ZIP]" at the 
  355.   end.  For example, if you were browsing the directory C:\INBOX which 
  356.   contained a file NEWSTUFF.EXE which was a self extracting [.ZIP] file, use 
  357.   the Substitute Path command and replace "C:\INBOX" by 
  358.   C:\INBOX\NEWSTUFF.EXE[.ZIP]".  This will display the file as a [.ZIP] File 
  359.   List.  
  360.  
  361.   Note, some [.ZIP] files created on Unix systems contain files whose names 
  362.   have lower case characters.  LUP will convert these names to upper case 
  363.   when it displays them because DOS does not support lower case in its file 
  364.   names.  
  365.  
  366.   There is another type of [.ZIP] file which gets special treatment.  
  367.   Usually a [.ZIP] file which contains files in subdirectories also contains 
  368.   their subdirectories.  For example, if a [.ZIP] file contains an entry for 
  369.   a file "SUBDIR\FILE.TXT" then is also contains an entry for the 
  370.   subdirectory "SUBDIR\".  LUP will display the entry for this subdirectory 
  371.   in the usual manner.  However if the entry for subdirectory "SUBDIR" is 
  372.   missing then LUP must simulate its presence.  A listing of the contents of 
  373.   such a [.ZIP] file will contain a simulated entry for the subdirectory.  
  374.   You can recognize these fake subdirectories by the impossible date and 
  375.   time stamp value of "1980-00-00 00:00:00".  
  376.  
  377.  
  378. BROWSING FILES 
  379.  
  380.   To examine a file as text, use the File Lists Browser to display the 
  381.   directory or archive containing the file you would like to examine.  Move 
  382.   the cursor to the entry for the file and press the <Enter> key.  LUP 
  383.   displays the file in a scrollable text window.  
  384.   
  385.   By default the display shows only printable ASCII characters.  However you 
  386.   may display all characters except the line-feed <LF>, which is treated as 
  387.   a line terminator, by using the <Alt-J> (toggle Junk filter) command.  
  388.   This will display all characters, whether they are printable ASCII or not.  
  389.   In either case LUP also does some rudimentary formating of tab characters.  
  390.   
  391.   If a file line will not fit on a single screen line then it will be 
  392.   continued to as many following screen lines as necessary.  Use the <Alt-M> 
  393.   (toggle Multicolor lists) command to display alternate file lines in 
  394.   different colors and make this continuation easier to see.  
  395.  
  396.  
  397. COPYING FILES 
  398.  
  399.   To copy regular or directory files, use the File Lists Browser to display 
  400.   the directory or archive containing the files you want copy.  If you are 
  401.   interested in a particular one then move the cursor to it.  Press the 
  402.   <Alt-C> key.  
  403.   
  404.   LUP will display a dialog box with its best guesses for source path, 
  405.   destination path, and file mask filled in or selected.  Complete filling 
  406.   in these values.  Use the Tab key to move between value gadgets.  
  407.   
  408.   When you have defined all values press the Enter key.  LUP will begin 
  409.   copying files.  When it is finished the destination path will be added to 
  410.   the File Lists Browser if that path was not already being displayed.  
  411.  
  412.   You may not copy into a [.ZIP] archive file.  However you may copy files 
  413.   out of a [.ZIP] file in to a DOS directory.  In this case LUP will 
  414.   automaticly extract the files.  
  415.  
  416.  
  417. DELETING FILES 
  418.  
  419.   To delete regular or directory files, use the File Lists Browser to 
  420.   display the directory or archive containing the files you want delete.  If 
  421.   you are interested in a particular one then move the cursor to it.  Press 
  422.   the <Alt-D> key.  
  423.   
  424.   LUP will display a dialog box with its best guesses for path and file mask 
  425.   filled in or selected.  Complete filling in these values.  Use the Tab key 
  426.   to move between value gadgets.  
  427.   
  428.   When you have defined all values press the Enter key.  If you have 
  429.   specified more than one file to be deleted then LUP will ask for 
  430.   confirmation.  If you answer Yes then it will begin deleting files.  
  431.  
  432.   You may not delete files from a [.ZIP] archive file.  
  433.  
  434.  
  435. RENAMING FILES 
  436.  
  437.   To rename a regular or directory file, use the File Lists Browser to 
  438.   display the directory or archive containing the file you want rename.  If 
  439.   you are interested in a particular one then move the cursor to it.  Press 
  440.   the <Alt-N> key to activate the "reName a file" command.  
  441.  
  442.   LUP will display a dialog box with its best guesses for directory, and old 
  443.   name filled in or selected.  Complete filling in these values and provide 
  444.   a new name.  Use the Tab key to move between value gadgets.  
  445.   
  446.   When you have defined all values press the Enter key and LUP will rename 
  447.   the file.  You may not rename a file inside a [.ZIP] archive file.  
  448.  
  449.  
  450. EXTRACTING FILES 
  451.  
  452.   LUP can extract files from archive files.  Extracting from a [.ZIP] 
  453.   archive file is called "unzipping".  
  454.   
  455.   There is no seperate command for extracting files.  LUP extracts 
  456.   automaticly whenever you browse a file which inside of an archive, or copy 
  457.   files from inside of an archive.  See COPYING FILES and BROWSING FILES for 
  458.   more information.  
  459.  
  460.  
  461. DEMONSTRATION 
  462.  
  463.   The file DEMO.BAT is a batch file which demonstrates some of the unusual 
  464.   features of LUP, namely the ability to browse [.ZIP] archive files, and 
  465.   the ability to browse multiple directory trees in a merged format.  The 
  466.   demo creates some files and subdirectories in the default directory and 
  467.   displays instructions for you to follow to explore various features.  The 
  468.   demonstration is not fully automated.  It depends on your ability to 
  469.   follow instructions.  
  470.  
  471.   To run the demonstration, set the default directory to the directory 
  472.   containing the LUP files, and type: 
  473.  
  474.     DEMO<Enter> 
  475.  
  476.  
  477. PERFORMANCE 
  478.  
  479.   You may be able to make LUP run a bit faster if you want to.  Besides 
  480.   running LUP on a faster computer, there are several things you can do.  
  481.  
  482.   LUP caches various calculations.  This means that it saves the results of 
  483.   calculations in a cache in Random Access Memory (RAM).  If LUP needs the 
  484.   result of a calculation again it may find it in the cache and not need to 
  485.   spend the time to calculate it again.  If you can increase the amount of 
  486.   memory for LUP to use then it can cache more calculations and run faster.  
  487.   Recent versions of DOS allow you to load DOS, device drivers, and TSRs 
  488.   (Terminate and Stay Resident programs) into high memory, making more 
  489.   memory available for programs like LUP.  If you can do this but have not 
  490.   already done so then try it.  This may make some of your other programs 
  491.   run faster also.  
  492.  
  493.   Since LUP accesses disk a lot, using a disk cache can make it run faster 
  494.   also.  If you are not running a disk cache you may want to do so.  This 
  495.   may make some of your other programs run faster also.  
  496.  
  497.   LUP runs PKUNZIP to read the contents of [.ZIP] archive files.  With luck 
  498.   PKUNZIP.EXE will be in your disk cache when needed.  However PKUNZIP.EXE 
  499.   may be purged from the disk cache by later disk accesses, especially if 
  500.   your disk cache is small.  If this happens then you may want to use a RAM 
  501.   drive instead of, or in addition to, a disk cache; and put PKUNZIP in a 
  502.   directory on the RAM drive.  If you do this then you also need to have 
  503.   that directory in your DOS PATH, otherwise LUP will be unable to find the 
  504.   RAM drive copy of PKUNZIP.  
  505.  
  506.  
  507. SYSTEM FILES 
  508.  
  509.   The following files are parts of, or are created by, the LUP package: 
  510.  
  511.   LUP.DOC: This is the file you are reading now.  It is the user manual for 
  512.     LUP.  It is also used the the Help command.  
  513.   LUP.EXE: This is the LUP executable.  LUP.CFG: This file is created by 
  514.     LUP.  It contains configuration information, which in this version of
  515.     LUP consists of only the registration status of the program.  It is
  516.     always created in the directory from which the program (LUP.EXE) is run.
  517.   DEMO.BAT: This batch file script creates some directories and files which
  518.     are used to demonstrate LUP's unusual features.  When executed it
  519.     displays instructions for its use.
  520.   REGISTER.DOC: This contains information on how to register the program.
  521.   FILE_ID.DIZ: This contains a description of LUP suitable for use in
  522.     catalog and BBS directory listings.  The most significant information is
  523.     near the front of the file so that automated software distribution 
  524.     systems can use the most important information.  
  525.   VENDOR.DOC: This contains information for disk vendors on how to 
  526.     distribute this software.  
  527.   C:\LUPTMP.$$$: This subdirectory and the files created in it are temporary 
  528.     files.  They are deleted when LUP terminates.  LUP creates temporary 
  529.     files when it examines the contents of [.ZIP] archive files.  
  530.  
  531.  
  532.  
  533. LICENSE AGREEMENT 
  534.  
  535.   You may use LUP free for up to 30 days to ensure that it meets your needs.  
  536.   If you decide to continue using LUP you must receive a registered copy of 
  537.   the software by registering with the author.  
  538.  
  539.   You may make any number of copies of this software, including the 
  540.   registration key and printed manual which come with a registered copy, 
  541.   with the following conditions: 
  542.  
  543.     1. The number of days you have been using the software does not exceed 
  544.     30 days, or 
  545.  
  546.     2. The total number of people using any of the copies of the software at 
  547.     any one time does not exceed the number of registered copies owned by 
  548.     you.  
  549.  
  550.   You may give (or sell) copies of the software to others, in fact you are 
  551.   encouraged to do so, with the following conditions: 
  552.  
  553.     1.  The software is not modified in any way.  
  554.  
  555.     2.  You do not mislead the person receiving the software about what that 
  556.     person is getting.  
  557.  
  558.     3.  If you give (or sell) a package which includes a copy of a 
  559.     registration key then you must destroy or include in the same package 
  560.     all other copies of that key, and you must destroy or include in the 
  561.     same package all copies of the software associated with that key.  
  562.  
  563.     Note, if you are a shareware disk vendor then see file VENDOR.DOC for 
  564.     more information.  
  565.  
  566.   LODJI disclaims all warranties relating to this software, whether express 
  567.   or implied, including without limitation any implied warranties of 
  568.   merchantability or fitness for a particular purpose. Neither LODJI, nor 
  569.   anyone else who has been involved in the creation, production, or delivery 
  570.   of this software shall be liable for any special, incidental, 
  571.   consequential, indirect or similar damages due to loss of data or any 
  572.   other reason, even if LODJI or an agent of LODJI has been advised of the 
  573.   possibility of such damages.  In no event shall LODJI's liability for any 
  574.   damages ever exceed the price paid for the license to use software, 
  575.   regardless of the form of the claim.  The person using the software bears 
  576.   all risk as to the quality and performance of the software.  
  577.  
  578.  
  579. TECHNICAL SUPPORT 
  580.  
  581.   Registered users are entitled to free technical support for three months 
  582.   after registration.  This support is for correcting errors in the program.  
  583.  
  584.   If time permits support may also be provided to non-registered users and 
  585.   registered users beyond their free support period.  
  586.  
  587.   You should provide all the information needed to reproduce the error.  At 
  588.   minimum you should provide your name, the version of the software, and a 
  589.   description of what you did to trigger the error and a description of the 
  590.   error.  If you are a registered user entitled to technical support you 
  591.   should also provide the serial number and registration key of your 
  592.   software.  You may be asked to provide other information, such as details 
  593.   on your computer system, your CONFIG.SYS and AUTOEXEC.BAT files, and 
  594.   copies of data files associated with the problem.  
  595.  
  596.  
  597. HOW TO CONTACT LODJI 
  598.  
  599.   You can reach LODJI at any of the following addresses: 
  600.  
  601.     USPS: LODJI, PO BOX 915, NORTH CHELMSFORD MA 01863-0915 
  602.  
  603.     CompuServe: 76360,1610 
  604.  
  605.     Internet: 76360.1610@compuserve.com 
  606.  
  607.  
  608. DISABLING REGISTRATION REMINDERS 
  609.  
  610.   To encourage you to obtain a registered copy of LUP from the author, LUP 
  611.   occasionally displays messages to remind you of the obligation to 
  612.   register.  These reminders conform to the guidelines of the Association of 
  613.   Shareware Professionals.  
  614.  
  615.   When you get a registered copy of LUP it includes a registration key with 
  616.   which you can disable registration reminder messages.  The disabling of 
  617.   these messages is called "silencing".  If you do not silence LUP then it 
  618.   will eventually begin displaying the messages.  
  619.  
  620.   The registration key is printed on the invoice which comes with your 
  621.   registered copy of LUP.  Each key will silence only the copy of LUP with a 
  622.   particular serial number.  The serial number of your copy of LUP is 
  623.   printed on both your diskette and your invoice.  If you purchased multiple 
  624.   registered copies of LUP then make sure that you use the correct key for 
  625.   each copy.  
  626.  
  627.   To silence your registered copy of LUP, first find the key on your 
  628.   invoice.  It should be labelled "REGISTRATION KEY" and will have the 
  629.   associated serial number printed nearby.  Next, at the DOS command prompt 
  630.   type: 
  631.  
  632.     LUP -s kkkkkkkkkk<Enter> 
  633.  
  634.   The "-s" is the silence option.  The 's' must be in lower case.  The 
  635.   "kkkkkkkkkk" is the string of digits of the REGISTRATION KEY you found on 
  636.   your invoice.  "<Enter>" represents the Enter key.  Be sure to include 
  637.   spaces between the parts of the command.  If LUP displays the message 
  638.   "Silenced" and returns to the DOS prompt then the silencing operation is 
  639.   successful.  If it does not do this then the silencing operation failed.  
  640.   This probably means that you mistyped the registration key or some other 
  641.   part of the command.  
  642.  
  643.   If you silence LUP but then copy it to another disk or subdirectory, or 
  644.   you delete the file LUP.CFG, then the new copy automaticly unsilences 
  645.   itself.  This allows you to easilly make and give unsilenced copies of LUP 
  646.   to others.  However it also means that if you copy LUP to another 
  647.   directory as part of reorganizing your hard disk then you need to perform 
  648.   the silencing procedure on the new copy.  
  649.  
  650.   Please do not give your registration key to anyone else.  Save a copy of 
  651.   your key and serial number in a safe place.  I suggest writing them both 
  652.   here in the printed copy of this user manual.  
  653.  
  654.     Serial number:                 Registration key: 
  655.  
  656.  
  657. REVISION HISTORY 
  658.  
  659.   1.00 (first) public release.
  660.   1.01 public release.
  661.     Feature changes:
  662.       Support [.ZIP] files which contain files in subdirectories but not
  663.     the subdirectories themselves by simulating the subdirectories.
  664.       Add  <Alt-J> command to display or hide (default) nonprintable
  665.     graphic characters in File Browser.
  666.       Add <Alt-M> command to display lists and files in two colors or one
  667.     color (default).
  668.     Bug fixes:
  669.       Fix readability problem with [.ZIP] files which contain certain
  670.     comments.
  671.  
  672.  
  673. KNOWN BUGS 
  674.  
  675.   After using LUP to browse many directories or files LUP may run a bit 
  676.   slower.  On rare occasions LUP may terminate with a message which says 
  677.   that it is unable to allocate a block of memory from its heap.  The 
  678.   slowing is caused by the memory manager purging the internal cache in an 
  679.   attempt to recover memory blocks.  The termination happens when, after 
  680.   purging the entire cache, the program is still unable to find a block of 
  681.   memory large enough to satisfy an allocation request.  Usually there is 
  682.   enough total memory, but it is distributed in many seperate blocks, and no 
  683.   single block is large enough to satisfy the request.  This condition is 
  684.   called fragmented memory.  
  685.  
  686.   If LUP terminates in this way, restart LUP and retry your task.  Unless 
  687.   you enter exactly the same sequence of keys, you should be able to 
  688.   complete your work.  
  689.  
  690.   I plan to fix this problem, and I know of several ways to do it, however, 
  691.   none of them is easy.  If you are a programmer and have some good ideas 
  692.   about avoiding fragmented memory problems, please send them to me.  They 
  693.   may help me to fix this problem sooner.  Otherwise, because this is not a 
  694.   serious problem, I will probably spend most of my time doing other 
  695.   enhancements to LUP.  
  696.  
  697.