home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / fileutil / vcd / vcd.doc < prev    next >
Encoding:
Text File  |  1992-07-01  |  10.0 KB  |  248 lines
  1.  
  2.  
  3.                                  VCD.EXE
  4.        
  5.                   A Change Directory program for OS/2 and DOS.
  6.  
  7.         Copyright 1989-1992 Les J. Ventimiglia.  All rights reserved.
  8.  
  9.         _____________________________________________________________
  10.  
  11.  
  12.         VCD (Ventimiglia Change Directory) is an enhanced change 
  13.         directory utility featuring a full screen mode and a command
  14.         line pop-up window for similar name directory changes.  VCD
  15.         makes changing directories very easy.  Accessing directories
  16.         anywhere on your disk is greatly simplified.
  17.  
  18.  
  19.         Using VCD
  20.         _________
  21.  
  22.  
  23.         VCD [/rn] [d:][path]
  24.                 
  25.         Where : /r = Causes a complete rescan of the specified drive.  
  26.  
  27.                 /n = Do not write the VCD data file.
  28.  
  29.                 d: = Drive to scan.
  30.  
  31.                 path = partial path to change to. Only the portion 
  32.                     after the last \ is used.   
  33.  
  34.         An invalid option will display the usage.
  35.     
  36.         / options can be combined or be specified separately before or
  37.         after any of the filespecs.
  38.         
  39.                 /rn == /n/r == /r /n  
  40.  
  41.     ******************************************************************
  42.     *                                                                *
  43.     *   Note: Protected mode usage must use the command file VCD.CMD,*
  44.     *         using the executable in protected mode without the     *
  45.     *         command file will look like it is changing to the      *
  46.     *         directory but will not due to OS/2 restoring the       *
  47.     *         environment when the program is finished running.      *
  48.     *                                                                *
  49.     *         In case someone tampers with this zip file and deletes *
  50.     *         the vcd.cmd file from it, the cmd file should look     *
  51.     *         as follows:                                            *
  52.     *                                                                *
  53.     *           @echo off                                            *
  54.     *           vcdpgm %1 %2 > c:\vcdx.cmd                           *
  55.     *           if errorlevel 1 goto end                             * 
  56.     *           call c:\vcdx.cmd                                     * 
  57.     *           :end                                                 * 
  58.     *           del c:\vcdx.cmd                                      * 
  59.     *                                                                *
  60.     *                                                                *
  61.     *                                                                * 
  62.     ******************************************************************
  63.  
  64.         Operation
  65.         _________
  66.  
  67.  
  68.         VCD will rescan the specified or implied disk in the
  69.         following instances:
  70.  
  71.                 - The VCD database does not exist or
  72.                 - The /r (Rescan) option is specified or
  73.                 - The current directory of the specified disk is not
  74.                   in the VCD database.
  75.  
  76.         VCD will not save the database when used on drives A: or B:
  77.         or if the /n (nosave) option is used.
  78.  
  79.         The database file is written to the root directory of the
  80.         specified or implied drive using the name "VCD_data".  If the 
  81.         drive is write protected (as some network drives are), VCD
  82.         will attempt to save the database on drive C: using the name
  83.         "VCD_x.dat" where x is the drive letter.
  84.  
  85.         VCD is designed to keep the database for each drive on the
  86.         root directory of that drive.  Scanning never crosses drives. 
  87.         I chose to do this to support removable hard drives, such as
  88.         the Tandon Personal DataPacs.  If I were to scan all drives
  89.         and keep the database on drive c: (as someone's DOS imitation
  90.         does), it would not find a directory on a drive that has been 
  91.         ejected and replaced by another.  Keeping the database on each 
  92.         drive also allows for faster searches for the desired directory.
  93.  
  94.  
  95.         If [path] is specified on the command line, VCD will do the 
  96.         following:
  97.  
  98.                 - VCD scans the entire tree for a match to [path]. 
  99.                 - If there is only one match, 
  100.                   then VCD will change to that directory.
  101.                 - If there are no matches, 
  102.                   then VCD will remain in the current directory.
  103.                 - If there are multiple matches, VCD will first check
  104.                   for one exact match.  If there is one exact match,
  105.                   VCD change to that directory.  Otherwise, VCD will 
  106.                   popup a box containing the choices.  Move the 
  107.                   highlight to the one you want to reach and press 
  108.                   <enter> to select it, VCD will change to that
  109.                   directory.
  110.  
  111.  
  112.         Command line EXAMPLES:
  113.         
  114.         To change to your INCLUDE directory on the current drive and
  115.         rebuild the VCD data file:
  116.  
  117.                 VCD include /r           or   VCD /r include
  118.  
  119.         To change to the \bin directory on drive c:
  120.  
  121.                 VCD c:bin
  122.  
  123.  
  124.         If the [path] option is not specified, VCD will start up in
  125.         full screen mode.
  126.  
  127.         VCD will display a graphical tree display of the directory
  128.         structure.
  129.  
  130.         Once the display is up, you can use the following keys to move
  131.         around the display:
  132.  
  133.  
  134.         <up>   or <left>  - moves highlight up or scrolls screen down
  135.  
  136.         <down> or <right> - moves highlight down or scrolls screen up
  137.  
  138.         <pgup>  - - - - - - moves the screen up one page
  139.  
  140.         <pgdn>  - - - - - - moves the screen down one page
  141.  
  142.         <home>  - - - - - - moves to the root directory "\"
  143.         
  144.         <end> - - - - - - - moves to the end of the display
  145.  
  146.         <enter> - - - - - - ends the program and goes to the
  147.                                 highlighted directory.
  148.  
  149.         <ALPHA-NUMERIC> - - Speed searches for directory match.
  150.  
  151.         <esc> - - - - - - - ends the program without changing
  152.                                 directories.
  153.  
  154.         <ctrl><enter> - - - Speed search for next directory match.  
  155.  
  156.         <F2>  - - - - - - - ReScan the current drive.
  157.      
  158.         <F3>  - - - - - - - Change to a different drive.
  159.  
  160.         _____________________________________________________________
  161.  
  162.         REGISTRATION AND LICENSING
  163.         __________________________
  164.  
  165.         If you find VCD useful, your registration would be 
  166.         appreciated.  Registration costs $15.  Send registrations to
  167.         
  168.                         Les J. Ventimiglia
  169.                         15247 Monroe Ave.
  170.                         Moorpark, CA. 93021
  171.  
  172.                         Phone     : (805) 529-6370
  173.                         CompuServ : (CIS) 76307,1246
  174.  
  175.         _____________________________________________________________
  176.  
  177.         SHAREWARE LICENSE
  178.         _________________
  179.  
  180.         This program is distributed under the SHAREWARE concept.
  181.         You are encouraged to copy and share this program with other 
  182.         users.
  183.  
  184.         SUPPORT SHAREWARE WITH YOUR REGISTRATION FEES!!
  185.         
  186.         SHAREWARE is based on these three beliefs:
  187.  
  188.         1.  The value of software is best assessed by the
  189.             user on his own system.
  190.         2.  Creation of personal computer software can and
  191.             should be supported by computing community.
  192.         3.  That copying of programs should be encouraged,
  193.             rather than restricted.
  194.  
  195.         This document and the current version of this program
  196.         ("the software") are copyrighted by the author. The
  197.         copyright owner hereby licenses you to: use the software; make
  198.         as many copies of the program and documentation as you wish;
  199.         give such copies to anyone; and distribute the software and
  200.         documentation via electronic means.
  201.  
  202.         However, you are specifically prohibited from charging, or
  203.         requesting donations, for any such copies, however made. 
  204.  
  205.         No copy of the software may be distributed or given away without
  206.         this document; and this notice must not be removed.
  207.  
  208.         _____________________________________________________________
  209.  
  210.         DISCLAIMER OF WARRANTY
  211.         ______________________
  212.  
  213.  
  214.         LES J. VENTIMIGLIA hereby disclaims all warranties relating to
  215.         this software, whether express or implied, including without
  216.         limitation any implied warranties of merchantability or fitness
  217.         for a particular purpose.  LES J. VENTIMIGLIA will not be
  218.         liable for any special, incidental, consequential, indirect or
  219.         similar damages due to loss of data or any other reason.  In no
  220.         event shall LES J. VENTIMIGLIA's liability for any damages ever
  221.         exceed the price paid for the license to use the software,
  222.         regardless of the form of the claim.
  223.  
  224.         _____________________________________________________________
  225.  
  226.         VIO/Network/Windows Warnings
  227.         ____________________________
  228.  
  229.         Through out the testing of this program, I have found
  230.         that the VIO functions used to display output onto the
  231.         screen may not work as expected when run in real mode in a
  232.         Windows windowed DOS session or if your are running the 
  233.         Novell client software on top of real mode DOS.
  234.  
  235.         For Windows 3.0, I have found that if I run a VIO'ed program
  236.         in a windowed DOS session, I tend to get black characters on a
  237.         black background.  This problem goes away as soon as the
  238.         cursor reaches the bottom of the windowed box.
  239.  
  240.         For Novell, I have found that running VIO'ed programs tend to
  241.         crash the client software if the network card is set to I/O
  242.         port 2e0h.  The solution to this problem it to move the
  243.         port address of the network card to 300h.  This conflict is 
  244.         due to a bug in the VIO libraries supplied with the toolkit.
  245.  
  246.  
  247.  
  248.