home *** CD-ROM | disk | FTP | other *** search
/ CD-X 3 / cdx_03.iso / shutils / dos / vc400sw.arj / VCINFO.DOC < prev    next >
Encoding:
Text File  |  1995-09-01  |  17.1 KB  |  393 lines
  1.  
  2.                     VC  Version 4.00 shareware
  3.             Copyright (C) Vsevolod V. Volkov 1991-1995
  4.  
  5.  
  6.  
  7. Minimal requirements:
  8.      Computer. . . . . . . . IBM PC or BIOS-compatible
  9.      Operation system. . . . DOS 3.20 or higher
  10.      Free RAM. . . . . . . . about 155 Kb
  11.  
  12.  
  13. Implementation notes:
  14.      - all  file and memory management operations implemented on
  15.        DOS level via Int 21h
  16.      - keyboard polling implemented on BIOS level via Int 16h
  17.      - I/O  ports access: only for snow elimination on CGA, only
  18.        port 3DAh and only if this port is detected
  19.  
  20.  
  21. Some notes and recommendations:
  22.  
  23.  1. The Volkov Commander  allows  you  to select, copy, move and
  24.     delete  directories (including all contained subdirectories)
  25.     as well as ordinary files.
  26.  
  27.  2. You  can  split and merge files while copying. What you have
  28.     to  do  for  splitting - if you see  following message while
  29.     copying file to diskette:
  30.  
  31.                 ╔═════════════ Copy ══════════════╗
  32.                 ║ There isn't enough room to copy ║
  33.                 ║           filename to           ║
  34.                 ║           D:\filename           ║
  35.                 ║        Abort   Continue         ║
  36.                 ╚═════════════════════════════════╝
  37.  
  38.     change diskette and select "Continue". First part of splited
  39.     file  will have such date and time as had source file, other
  40.     parts will have current date and time.
  41.  
  42.     How  to  merge  two  files?  You have to copy second part of
  43.     splitted  file to directory  where  first  part resides. You
  44.     will see following message
  45.  
  46.             ╔═════════════════ Copy ══════════════════╗
  47.             ║        The following file exists        ║
  48.             ║               D:\filename               ║
  49.             ║ Do you wish to write over the old file? ║
  50.             ║     Overwrite   All   aPpend   Skip     ║
  51.             ╚═════════════════════════════════════════╝
  52.  
  53.     - choose "Append".
  54.  
  55.  3. Pressing  Alt-F10  after  F5 or F6 (Copy or Rename commands)
  56.     pops up panel with directory  tree  of  drive, specified  in
  57.     destination path - you  can  choose then right place to copy
  58.     to. Pressing  F10  invoke directory tree of current (source)
  59.     disk.
  60.  
  61.  4. Group  Selection (Grey +) and  Group Inversion (Grey *) acts
  62.     upon  files  only, while  Unselection  (Grey -) acts on both
  63.     files and directories.
  64.  
  65.  5. After  completion of operation upon  selected group of files
  66.     you  can  restore  selection  using  Restore  Selection (^M)
  67.     command.
  68.  
  69.  6. You  can  specify a name of DOS command, executable or batch
  70.     file  in command  line as a parameter for  VC  which will be
  71.     executed automatically when the Volkov Commander starts. For
  72.     example:
  73.  
  74.                         VC startup.bat
  75.  
  76.     VC  will start up and then run batch file startup.bat, which
  77.     may contain DOS commands and resident programs.
  78.  
  79.  7. There are two options of residing VC in RAM:
  80.  
  81.     1. "Small" mode - The Commander  deallocates  memory  before
  82.        execution  of  each  DOS  command  or  application.  When
  83.        program started from  VC  is terminated, file  VC.COM  is
  84.        reloaded  from path it was  originally  started. In  this
  85.        mode  only  about 12.5 Kbytes of The Commander resides in
  86.        memory when programs run.
  87.  
  88.     2. Full-resident mode - VC is totally  allocated in the  RAM
  89.        (about 76 Kb). While  in  full-resident  mode, executable
  90.        file  VC.COM is loaded only once and does not need later.
  91.        This mode is faster.
  92.  
  93.     Small mode is selected if 'Memory Allocation' option checked
  94.     in pull-down menu Options. It is possible while being in one
  95.     of this modes to launch applications in  opposite  execution
  96.     mode without using menu: you just have to press  Shift-Enter
  97.     instead  of  Enter. The status of Shift key is also examined
  98.     when  starting  programs  from  User Menu  (F2)  or  History
  99.     (Alt-F8).
  100.  
  101.     Mode choice recommendations:
  102.  
  103.     1. If  you  have  more  than 65 Kbytes of high  memory (UMB)
  104.        free - it would be preferable to load VC into  UMB  using
  105.        command LH VC under  MS-DOS 5.0, HILOAD VC  under  DR-DOS
  106.        6.0.  In such case it would be better to utilize "maximal
  107.        mode" for faster operating.
  108.  
  109.     2. If  you  have  no  UMBs  in  your  system  or UMB size is
  110.        insufficient - "small mode" will be optimal if you run VC
  111.        from  hard  disk. If  you  have  RAM-disk it will be even
  112.        better to copy  VC.COM to RAM-disk and start from it. For
  113.        example, it could be done in such a way:
  114.  
  115.                         COPY C:\VC\vc.com E:\
  116.                         SET VC=C:\VC
  117.                         E:\vc
  118.  
  119.        SET VC=... command  specifies  directory   where  VC.INI,
  120.        VC.HLP, main menu  VC.MNU, etc reside.  If VC environment
  121.        variable  is not specified, these files are looked for in
  122.        directory VC.COM was started from.
  123.  
  124.     3. If you run  VC  from floppy disk - "maximal mode" will be
  125.        the best choice. In spite of expense of RAM, this  choice
  126.        save  you from painful waiting for VC.COM reloading after
  127.        return from applications.
  128.  
  129.  8. You  can  compress  VC.COM  by almost any executable packing
  130.     program, such  as  DIET, LZEXE or PKLITE. Some  packers (for
  131.     example, LZEXE) support  only  EXE-files. Older  versions of
  132.     PKLITE or DIET  before v1.44 refusing to pack  COM-files  of
  133.     size near 64K. In such cases you'll have to transform VC.COM
  134.     to EXE-format using COM2EXE utility.
  135.  
  136.  9. Two methods of launching  DOS commands and applications from
  137.     VC is available.
  138.  
  139.     First - standard way: executing COMMAND.COM /C <command>. In
  140.     this  case  it  is  needed  that  COMSPEC  variable  in  DOS
  141.     environment  shall be installed  properly  and  presence  of
  142.     command  processor  on  mentioned path. This is no-risky way
  143.     (and used by default).
  144.  
  145.     Second method - using  DOS  interrupt int 2Eh - may not work
  146.     in some cases (for example 4DOS and NDOS support this method
  147.     optionally, OS/2  DOS box  does not support it at all). This
  148.     method  have  some  advantages over the standard method: you
  149.     are  able  to  modify  master  DOS  environment variables by
  150.     usual SET, PATH, PROMPT etc. commands, second  copy of shell
  151.     (COMMAND.COM or replacement) wouldn't be loaded into memory,
  152.     therefore  commands and applications are executed faster and
  153.     after loading of resident programs there is no "hole" in RAM
  154.     after  second  copy  of  COMMAND.COM. There  are  also  some
  155.     shortcomings inherited in DOS: BATCH-file  interruption with
  156.     Ctrl-Break  stops  execution but with trying to execute next
  157.     command, continued  execution of interrupted batch  file and
  158.     then  ordered  command;  DOS  has  no  possibility of nested
  159.     execution  through  int 2Eh, so if one program started  with
  160.     int 2Eh  and then started another one through  int 2Eh also,
  161.     the control will be given to the process which started first
  162.     program  and other program is allocated in RAM, though there
  163.     is no access to it. Shortly  speaking - the choice is yours.
  164.     You  can  select  second  method  by checking "Quick execute
  165.     commands" in Advanced options.
  166.  
  167. 10. "Memory Info" (Alt-F5) command  gives you useful information
  168.     about  programs  loaded into low (first 640 Kbyte) and upper
  169.     (UMB area)  memory: PSP  segment address, number and size of
  170.     memory blocks occupied by program, and intercepted interrupt
  171.     vectors.  You  can  also  remove from memory thouse resident
  172.     programs which were loaded after the Commander.
  173.  
  174.     You can select/unselect programs from the list using Insert,
  175.     Grey -, Grey + keys  and  then remove selected programs from
  176.     memory by pressing Enter.
  177.  
  178.     It is not possible to unload resident program if one or more
  179.     interrupt vectors  originally owned by this program rehooked
  180.     (intercepted)  by  another TSR. That's why the programs with
  181.     the    same    intercepted   vectors   could   be   unloaded
  182.     simultaneously  or  one  by  one   starting  with  the  last
  183.     intercepting program. 
  184.  
  185.     When  VC  exits to DOS it unloads all TSR programs installed
  186.     after VC was started.
  187.  
  188. 11. "File Attributes" command (item in Files menu) allows you to
  189.     change  the  attributes, date and time of selected files. If
  190.     you  apply  this  command to subdirectory, attributes of all
  191.     files in that subdirectory will be changed.
  192.  
  193. 12. You  can  calculate  the  sizes of all subdirectories in the
  194.     current  panel. The size of directory is the sum of sizes of
  195.     all  files and subdirectories inside of that directory. This
  196.     calculation  can  be  done automatically on every file panel
  197.     re-reading - check "Auto directory sizes" in  Options  menu,
  198.     or manually - using Alt-F6 combination.
  199.  
  200. 13. File  search  function  Alt-F7  allows  to  search  files by
  201.     standard  wildcards  template  or  filtered  by context.  If
  202.     "Containing"  field  is  empty, the template search is going
  203.     on, and if the "containing" field  is not  empty, the search
  204.     is running  according  to  the  specified string facing  the
  205.     template.  This  command  searches  the current or specified
  206.     directory  and  in  all enclosed directories. Apart from the
  207.     particular  directory you can specify the drive. You may use
  208.     *: instead of drive letter if you  want looking for files on
  209.     all  fixed  disks, i. e. on  all  hard  disk partitions, all
  210.     virtual and network disks excluding floppy drives and CD-ROM
  211.     drives. While search is in progress you can move the pointer
  212.     above  the found files, interrupt search or switch to chosen
  213.     file into the specified subdirectory of specified drive.
  214.  
  215. 14. There  is  current  drive  label in the Info panel. You  can
  216.     create, edit or remove it, with the command  Volume label in
  217.     menu Commands or press Ctrl-F4. To remove the label you have
  218.     simply  to  delete  all characters in the field of the label
  219.     name.
  220.  
  221. 15. You can create enclosed  User Menus. For this, you have only
  222.     to  enter  full  file name containing submenu instead of the
  223.     command. If path is not specified the search  will be in the
  224.     same directory from what file executing was loaded. It is an
  225.     obligation to specify extension .mnu as follows:
  226.  
  227.                    F1:  Formatting...
  228.                         format.mnu
  229.     or
  230.                         C:\VC\format.mnu
  231.  
  232. 16. It is possible to use macro !@  in extension files and menu,
  233.     which  creates  file (VC.LST) containing list of highlighted
  234.     files  and  directories, and  inserts  pathname of this file
  235.     into  the  command  instead  of  !@. If there is a string in
  236.     menu:
  237.  
  238.                         PKZIP -ex ! @!@
  239.  
  240.     the file VC.LST will be created and command
  241.  
  242.                 PKZIP -ex filename @C:\VC\vc.lst
  243.  
  244.     would be executed. File  VC.LST is created in home directory
  245.     of VC or in directry specified in TEMP environment variable.
  246.  
  247. 17. Internal viewer and editor work in both text and hexadecimal
  248.     modes (F4 switches modes).  While in hexadecimal mode Search
  249.     operation (F7) allows  to search  file  fragments  and bytes
  250.     sequences in hexadecimal. For example, if you specify:
  251.  
  252.                             EB,38,A5,6
  253.  
  254.     VC  will  try  to  find text "EB,38,A5,6" as well as 4 bytes
  255.     sequence: EB 38 A5 06. Mentioned  string  could be presented
  256.     in any convenient way:
  257.  
  258.                             EB, 38, A5, 6
  259.                             EB38A56
  260.                             EB38A506
  261.                             EB 38 A5 6
  262.  
  263. 18. VC  allows you to associate operation of  Enter, F3  and  F4
  264.     keys  with  file  extensions. Information  about  associated
  265.     commands  stored  in  so-called  "extension"  files: VC.EXT,
  266.     VCVIEW.EXT   and  VCEDIT.EXT  correspondingly.  These files'
  267.     format is following:
  268.  
  269.                 ┌───────────────────────────────┐
  270.                 │' Comment                      │
  271.                 │ext:   command1                │
  272.                 │       @ command2              │
  273.                 │       . . . . .               │
  274.                 └───────────────────────────────┘
  275.  
  276.     The  sign ' in  the  first  position  means  that  the  line
  277.     contains comments. If any other  sign apart from  Space, Tab
  278.     or ',  VC  tries  to  identify  extension  in such a string.
  279.     Command1, command2, ...- could be any DOS commands. If there
  280.     is a symbol @ before  the  command, both  prompt and command
  281.     are not echoed to  screen (as in BATCH-files). Using 4DOS or
  282.     NDOS, the following string has to be included into VC.EXT:
  283.  
  284.                               BTM:     !
  285.  
  286.     This string allows to run BTM-files simply with Enter press.
  287.  
  288.     Meanings  of  all sequences of the macro substitutions using
  289.     ! are in the lower  part of screen  while  editing extension
  290.     files.
  291.  
  292.     Viewers  could be run in two ways: either in mentioned above
  293.     way or with  passing on of the parameters, including 'Socha'
  294.     string,  information  about  colors,  mouse  etc.,  as  many
  295.     standard  viewers do. To  pass  on  the  parameters in files
  296.     VCVIEW.EXT  or  VCEDIT.EXT  the  string  has  to  look like:
  297.     the command  has  to  contain  only  full name of the viewer
  298.     including  extension and path; if the path is not specified,
  299.     the  viewer is being  searched in the  same  directory, from
  300.     what extension file was read; the command should not contain
  301.     substitution  symbols  !; only  one  command allowed for the
  302.     extension. For example, the following lines
  303.  
  304.                 txt:    wpview.exe
  305.                 txt:    C:\VIEWERS\wpview.exe
  306.  
  307.     will  invoke  viewer  in  proper way, with passing on of the
  308.     parameters, and the first line  will try to load  wpview.exe
  309.     from the same directory where are the  files  VCVIEW.EXT  or
  310.     VCEDIT.EXT  located.  And if the viewer has not found there,
  311.     internal viewer would be invked instead. But commands
  312.  
  313.                 txt:    wpview
  314.                 txt:    wpview.exe !.!
  315.                 txt:    wpview.exe
  316.                         cls
  317.  
  318.     will  be  executed  as  regular commands through the command
  319.     line.
  320.  
  321. 19. VC  supports  not  only  main (global) version  of extension
  322.     files  VC.EXT, VCVIEW.EXT, VCEDIT.EXT and menu file  VC.MNU,
  323.     but  also local ones. Local versions overrides main file for
  324.     current  directory. What does it mean? VC  looks for "local"
  325.     versions  of  this  files  in  current  directory of current
  326.     drive. Only if local  file  does  not exist, VC  looking for
  327.     main  extension or menu  file  in  directory,  specified  in
  328.     environment  variable  VC=...,  and  if  this  variable  not
  329.     specified - in directory VC was started from.
  330.  
  331. 20. Internal  editor  can  edit  quite  long  files,  using  all
  332.     available free memory.
  333.  
  334. 21. Internal  editor  can  undo  last  character, line  or  word
  335.     deletion (Ctrl-U).
  336.  
  337. 22. To  hide  the  panels  and  show DOS output screen, move the
  338.     mouse  into  the  upper  left  corner  and click any button.
  339.     Click mouse button one more to restore panels. This function
  340.     is the same as Ctrl-O press.
  341.  
  342. 23. Ctrl-Z displays the Tree-panel in the adjacent window.
  343.  
  344. 24. Ctrl-I  inserts  selected filenames into command line, space
  345.     delimited.  Ctrl-[ and Ctrl-] inserts path of left and right
  346.     panels.
  347.  
  348. 25. VC  fully  supports logical drives created by DRIVER.SYS and
  349.     phantom disk drive B: in systems with one floppy drive.
  350.  
  351. 26. VC is fully compatible with  multitasking  environments like
  352.     DesqView,  Windows,  OS/2  DOS  boxes  and  does  not  waste
  353.     processor time while waiting for keyboard input.
  354.  
  355. 27. Country  information  sets  the appearance of date, time and
  356.     determines  character  converting  from  lower to upper case
  357.     in   search  operation.  If  this  function  does  not  work
  358.     properly, be  sure  the  country  code and code page are set
  359.     correctly in the COUNTRY=... line of CONFIG.SYS file.
  360.  
  361. 28. The program  VCSETUP  allowes you to set a lot of parameters
  362.     of  screen,  mouse,  panels, view  country  information  and
  363.     change color palette.
  364.  
  365. 29. You can check for presence of VC in memory and get addresses
  366.     of VC internal data structures using this INT 21h call:
  367.  
  368.     INT 21h:
  369.     Set registers to:
  370.         CX = 'VC' (5643h)
  371.         DX = 'OM' (4F4Dh)
  372.         AH = 2Bh
  373.         AL - subfunction:
  374.              AL = 0 - get pointer to left panel data structure
  375.              AL = 1 - get pointer to right panel data structure
  376.              AL = 2 - get address or global data varables
  377.     Returns:
  378.         AL = 0FFh - if VC.COM is not loaded
  379.         AL = 0    - if VC.COM loaded
  380.         ES:BX     - pointer to requested data structure
  381.  
  382. ----------------------------------------------------------------
  383.  
  384. Vsevolod V. Volkov                                 Kiev, Ukraine
  385.  
  386. Fidonet:  2:463/18.16
  387. Internet: vvv@topaz.kiev.ua
  388. Phone:    +7(044) 484-2542                Monday through Friday,
  389.                                7pm-10pm Kiev time (+3 hours GMT)
  390.  
  391.  
  392.                        September-1-1995
  393.