home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / DOS / UTILITY / SCHIJF / V1V098K / V1.DOC < prev    next >
Text File  |  1994-11-22  |  39KB  |  1,024 lines
  1. ************************************************************************
  2. V1 Directory Browser and File Viewer
  3. (C) Copyright Neil Faulks 1994. All Rights Reserved.
  4. ************************************************************************
  5.  
  6. V1 is a superb tool for exploring directories on a hard or floppy disk,
  7. or CD-ROM and viewing or processing files. Several unique features make
  8. V1 indispensible, particularly when you are searching your hard disk
  9. trying to work out where all the space has gone.
  10.  
  11. This version is shareware and you must read the section on registration
  12. and payment at the end of this file.
  13.  
  14. ************************************************************************
  15. ********************** IMPORTANT - READ THIS! **************************
  16. ************************************************************************
  17. This version of V1 is still being developed and tested. It has not been
  18. debugged to the same high standard as the E4 Editor. V1 is being
  19. released early, because it is a useful product and I would like to get
  20. feedback as soon as possible. To avoid putting early users at a
  21. disadvantage registration of this version carries the added benefit of a
  22. free upgrade to Version 1.00, PLUS a second free upgrade on request (via
  23. email where possible). Registered users of E4 get a free software
  24. upgrade to the latest E4 version when they register V1.
  25. ************************************************************************
  26.  
  27. Features
  28.  
  29.         o       Full screen display of filenames with adjustable level
  30.                 of detail, sorted by name, size, time, or extension.
  31.  
  32.         o       Single keypress to change directory up or down, or to
  33.                 change drive.
  34.  
  35.         o       Filename completion in dialog boxes, with directories
  36.                 presented first.
  37.  
  38.         o       Background scanning of the hard disk to compute
  39.                 directory sizes, while you use V1 normally.
  40.  
  41.         o       Transparent treatment of archive files (.ZIP, .ARJ etc)
  42.                 as if they were directories, allowing you to enter and
  43.                 view the contents of a archive file with a single
  44.                 keypress.
  45.  
  46.         o       Copy and Move whole directory trees, as if they were
  47.                 single files!
  48.  
  49.         o       User definable colours for files, depending on filename
  50.                 and/or attributes.
  51.  
  52.         o       Full support for 4DOS style file descriptions in display
  53.                 and when moving and copying files.
  54.  
  55.         o       Support for 28/43/50 lines modes and all SVGA text modes
  56.                 up to 255 rows and columns. Special feature to increase
  57.                 number of text modes available.
  58.  
  59.         o       Transparent support for text files from UNIX or Mac
  60.                 systems.
  61.  
  62.         o       Comments can easily be added to files from within V1.
  63.  
  64.         o       Rename files or directories by editing their name.
  65.  
  66.         o       Delete directories and their contents.
  67.  
  68.         o       Universal "Process" feature to automate tasks such as
  69.                 the extraction of ZIP files into directories.
  70.  
  71.         o       Programmable function keys.
  72.  
  73.         o       XMS Swapping when executing DOS commands.
  74.  
  75.         o       Network aware. Handles extra attributes, like Novell's
  76.                 Shareable flag.
  77.  
  78.         o       Split windows.
  79.  
  80.         o       Compare files in two directories to find identical,
  81.                 older or newer files.
  82.  
  83.         o       Small and neat.
  84.  
  85.         o       Single simple configuration file controls all aspects of
  86.                 V1's behaviour.
  87.  
  88. Introduction to Using V1
  89.  
  90.         The most important keys in V1 are Return and Backspace.
  91.  
  92.         Return enters directories or archives, invokes applications to
  93.         view files, runs executables.
  94.  
  95.         Backspace leaves directories and archives.
  96.  
  97.         Most of your navigation can be done using just these two keys.
  98.  
  99.         To alter the level of detail in the display (such as whether the
  100.         size, date and time are shown) press one of the number keys,
  101.         from 1 to 6. 1 shows just the filename, 6 shows the maximum
  102.         level of detail.
  103.  
  104.         To change drive use Ctrl and the letter of the drive. For
  105.         example
  106.  
  107.                 Ctrl-A to change to drive A:
  108.                 Ctrl-C to change to drive C:
  109.  
  110.         V for View will always view the contents of a file using V1's
  111.         built-in file viewer. Return will also view files for which no
  112.         associated application has been defined (based on the file's
  113.         extension).
  114.  
  115.         Inside the file viewer many normal commands are still available
  116.         such as the Delete key to delete the file being viewed, or K to
  117.         and a file comment. The + or = key is used to step to the next
  118.         file in sequence, - to the previous.
  119.  
  120.         The Move or Copy commands work on the current file unless one or
  121.         more other files are marked (the current file is shown by a
  122.         reverse video "selector bar"). Having pressed M for Move or C
  123.         for copy you are prompted for the destination file or directory.
  124.         To move or copy several files first mark them by pressing the
  125.         space bar over each file in turn. Once files are marked Move or
  126.         Copy will work on those files. The current file will not be
  127.         included unless it is also marked.
  128.  
  129.         You can limited the list of displayed files by using the List
  130.         command.
  131.  
  132.         For more detailed information on all aspects of V1 please read
  133.         through the alphabetically list of commands.
  134.  
  135. Usage
  136.  
  137.         V1 [<options> ...] [<directory>] [<filespec> ...]
  138.  
  139.         A directory name may be given to cause V1 to change to that
  140.         directory before starting. Only one directory name may be given,
  141.         but it can include a filespec. For example: V1 C:\DOS\*.COM
  142.  
  143.         Normally V1 displays all files in the current directory. One or
  144.         more filespecs may be used to limit the display of files to
  145.         those that match them.
  146.  
  147.         A filespec preceded by a minus sign causes V1 to ignore those
  148.         files that match the specification.
  149.  
  150.         Specifications given on the command line may be modified by the
  151.         List command. Directories are not affected by the file
  152.         specifications command and are always displayed. For examples
  153.         see the List command in the "Keys and Commands" section below.
  154.  
  155. Command Line Switches (Options)
  156.  
  157.         /1-/6   Level of detail (same as commands below)
  158.  
  159.         /0      Toggle display of 4DOS style descriptions
  160.  
  161.         /B      Force black & white only
  162.  
  163.         /E      Expert mode. Supresses hints from V1 about how
  164.                 to do things more quickly
  165.  
  166.         /H      Toggle display of Hidden/System files
  167.  
  168.         /Q      Quiet mode. Supresses background reading of the
  169.                 disk
  170.  
  171.         /OU     Set sort order to "unsorted"
  172.         /ON     Set sort order to "by name"
  173.         /OT     Set sort order to "by time"
  174.         /OS     Set sort order to "by size"
  175.         /OE /OX Set sort order to "by ext"
  176.  
  177.         /V##    Video mode. For example V1 /V2a will set video mode 2a
  178.                 on those video cards that support it. The video mode
  179.                 number must be given in hexadecimal, as that is how it
  180.                 is printed in most video card manuals.
  181.  
  182.                 WARNING: Make sure that your monitor can handle the
  183.                 video modes available on your display card.
  184.  
  185.                 Try 2a for 100x40 on Tseng ET4000 cards. 56 for 132x60
  186.                 on Trident 8900 cards.
  187.  
  188.         /V##:## A decimal number given after a colon sets the number of
  189.                 rows for the given video mode. If the mode is omitted
  190.                 the current mode is used. Examples:
  191.  
  192.                 /V3:50  50 lines in Mode 3
  193.                 /V:28   28 lines in the current mode
  194.                 /V2a:75 special 100x75 mode for ET4000 cards
  195.  
  196.         /X      Toggle use of XMS memory for swapping (normally on).
  197.                 When V1 executes a DOS command or shell it tries to
  198.                 reduce its use of DOS memory by swapping itself to XMS,
  199.                 if enough XMS memory is available. This switch is
  200.                 provided in case you do not wish V1 to consume XMS
  201.                 memory.
  202.  
  203.         Default switches may be set using the environment variable V1.
  204.         E.g. SET V1=/V2a /30 /OX for video mode 2a and medium detail
  205.         with 4DOS descriptions, sorted by extension.
  206.  
  207. General Topics
  208.  
  209.         V1TEMP and TEMP Environment Variables
  210.  
  211.                 V1 uses the V1TEMP or TEMP environment variable to
  212.                 indicate where it should extract .ZIP and other archive
  213.                 files when using the "Enter Archive" feature. Preference
  214.                 is given to V1TEMP: TEMP is only used if V1TEMP is not
  215.                 set. If either of these variables are not set the root
  216.                 of the current drive is used.
  217.  
  218.         Filename Completion
  219.  
  220.                 When in a dialog, such as that presented by a Move or
  221.                 Copy command you can press Tab for filename completion.
  222.                 V1 looks at the characters that you have typed into the
  223.                 dialog and attempts to complete the rest of the
  224.                 filename. If you haven't typed anything V1 presents the
  225.                 first item it finds.
  226.  
  227.                 Directories are presented before files as these are most
  228.                 likely to be required within V1. So pressing Tab
  229.                 repeatedly in an empty dialog will step though each of
  230.                 the sub-directories in the current directory, followed
  231.                 by each of the files. At theend of the list V1 beeps.
  232.                 Another press of Tab will start te cycle again.
  233.  
  234.                 If you have just pressed Tab for filename completion and
  235.                 the next character you type is a backslash (\) V1 will
  236.                 jump to the end of the line before adding the backslash.
  237.  
  238.         Background Activity
  239.  
  240.                 While V1 is idle on the directory screen it scans the
  241.                 disk to compute the size of directories. Only the drive
  242.                 associated with the current window is scanned.
  243.  
  244.                 Once a drive has been fully scanned it is not scanned
  245.                 again until the Tab (refresh) key is pressed.
  246.  
  247.                 The size of directories appears as a ? until that
  248.                 particular directory has been scanned, although the
  249.                 display is not updated unless you press a key, or the
  250.                 whole drive has been checked.
  251.  
  252. Keys and Commands
  253.  
  254.         RETURN
  255.  
  256.                 Depending on the type of the file under the selector bar
  257.                 (the current file) RETURN will change into a directory,
  258.                 run an executable, enter an archive (.ZIP, etc.) or view
  259.                 any other file.
  260.  
  261.                 V1 asks before executing a program, unless the ALT key
  262.                 is held down when pressing RETURN.
  263.  
  264.                 If the current file is an archive file, of a type listed
  265.                 in V1.INI, then V1 will unarchive the contents into a
  266.                 temporary directory (set by the V1TEMP or TEMP
  267.                 environment variable) and switch to that drive and
  268.                 directory. Changing up from that directory will return
  269.                 you to the starting directory (the one containing the
  270.                 archive file).
  271.  
  272.         BKSP (Backspace)
  273.  
  274.                 Changes to the parent directory (goes up one level), as
  275.                 if you had typed CD .. at the DOS prompt.
  276.  
  277.         Ctrl-A to Ctrl-Z
  278.  
  279.                 Selects a drive letter: Ctrl-A selects A: and so on.
  280.  
  281.         ESC
  282.  
  283.                 Leaves V1, but only if the current directory is the one
  284.                 from which V1 was started. Otherwise you are asked to
  285.                 use either the Quit or Jump commands.
  286.  
  287.         SPACE
  288.  
  289.                 Marks or unmarks the current file (indicated by a
  290.                 reverse video bar). Marked files may be processed by
  291.                 many other commands. The Select command (S) may also be
  292.                 used to mark files.
  293.  
  294.         ALT
  295.  
  296.                 Holding the ALT key when using several of the commands
  297.                 described here causes most normal confirmation prompts
  298.                 to be suppressed.
  299.  
  300.         DELETE
  301.  
  302.                 Deletes the file or directory under the selector bar, or
  303.                 multiple files if they have been marked. You are
  304.                 prompted before the deletion unless you hold the ALT key
  305.                 down when pressing Delete. You warned twice before
  306.                 deleting non-empty directories.
  307.  
  308.         1 to 6
  309.  
  310.                 Sets the level of detail in the directory display. 1
  311.                 displays just the name, whereas 6 provides full size,
  312.                 time, date, and attribute information.
  313.  
  314.         0
  315.  
  316.                 Toggles files descriptions (used by 4DOS and other
  317.                 programs). When file descriptions are on the directory
  318.                 display is always a single column: the level of detail
  319.                 affects the space remaining for the description, which
  320.                 is truncated as necessary to fit the screen.
  321.  
  322.         TAB
  323.  
  324.                 Refreshes the directory display and other information by
  325.                 re-reading the disk.
  326.  
  327.                 All windows are refreshed by this command and the
  328.                 directory map used to compute sizes of directories is
  329.                 discard and the rebuilding process begun again.
  330.  
  331.         Ctrl-Right
  332.         Ctrl-Left
  333.  
  334.                 Switch to the next or previous window. See the window
  335.                 (W) command.
  336.  
  337.         ?
  338.  
  339.                 Display extra information about the current directory on
  340.                 the status line.
  341.  
  342.         \
  343.         .
  344.                 Both these keys work like the Goto command, except that
  345.                 the character typed is entered into the Goto dialog box.
  346.                 So for example typing
  347.  
  348.                         \FRED [RETURN]
  349.  
  350.                 Would change to the directory FRED in the root of the
  351.                 current drive.
  352.  
  353.                         .. [RETURN]
  354.  
  355.                 Will change directory to the parent directory (although
  356.                 pressing Backspace is simpler!).
  357.  
  358.         F2 .. F12
  359.  
  360.                 The function keys are available for user-defined
  361.                 functions. The section on "Programming V1" explains how
  362.                 to do this.
  363.  
  364.         +
  365.         -
  366.                 The plus (actually the equals sign key) and minus keys
  367.                 move the selector bar to the next and previous files.
  368.                 Unlike down and up arrow these keys will not move onto
  369.                 directories.
  370.  
  371.                 If any files are marked then these keys will switch to
  372.                 the next or previous marked file.
  373.  
  374.                 If you have used the Window Match command then
  375.                 then + & - take you between files that where
  376.                 annotated as part of the Match.
  377.  
  378.         A - Attrib
  379.  
  380.                 Changes the attributes of the current file (it is not
  381.                 possible to change the attributes of several files at
  382.                 the same instant). You change the attribute flags by
  383.                 pressing the initial letter of the attribute(s) as
  384.                 desired, then press RETURN to commit to the change, or
  385.                 ESC to leave the file as it was.
  386.  
  387.         C - Copy
  388.  
  389.                 If no files are selected this command copies the current
  390.                 file to another file or directory. If files are selected
  391.                 then they may be copied to another directory. V1 warns
  392.                 beforehand if it is going to overwrite a file.
  393.  
  394.         D - Dos Shell
  395.  
  396.                 Spawns a Dos Shell. The normal DOS prompt is changed to
  397.                 indicated that you are shelled out from V1. Type EXIT to
  398.                 return to V1. XMS swapping is used to which dramatically
  399.                 increases the amount of memory available to the shell.
  400.  
  401.         E - Edit
  402.  
  403.                 Invokes an editor on the current file. The editor name
  404.                 may be set by the EDITOR environment variable, otherwise
  405.                 E4 is used (if present in the path).
  406.  
  407.         G - Goto Directory
  408.  
  409.                 Prompts you for a directory (and optionally a drive
  410.                 name), to which V1 then changes. The Backslash key may
  411.                 be used as a synonym to the Goto command except that it
  412.                 enters a Backslash as the first character of the new
  413.                 directory name.
  414.  
  415.         H - Hidden File Display
  416.  
  417.                 Toggles the display of Hidden and System files. Normally
  418.                 such files are not shown in the display.
  419.  
  420.         I - Info
  421.  
  422.                 Changes the bottom line of the screen to display either
  423.                 a menu of commands, or information about the current
  424.                 file.
  425.  
  426.         J - Jump
  427.  
  428.                 Leaves V1, taking you to the currently selected
  429.                 directory. Compare with the Quit command.
  430.  
  431.         K - Comment
  432.  
  433.                 Comments a file by adding a 4DOS style description to
  434.                 the file DESCRIPT.ION (creating it if necessary).
  435.                 Comments are copied with the file when using the V1 Move
  436.                 Copy, or Rename commands.
  437.  
  438.                 When a file is deleted the description is deleted as
  439.                 well.
  440.  
  441.                 See also: Rename
  442.  
  443.         L - List
  444.  
  445.                 Controls which files are listed in the display. You can
  446.                 enter a series of file specifications and only files
  447.                 that match at least one of those specifications are
  448.                 displayed. A file specification may also be preceded by
  449.                 a minus sign, which causes files that match that
  450.                 specification not to be listed. For example:
  451.  
  452.                         *.ASM *.C -PROJECT.*
  453.  
  454.                 Would list only C and ASM files, but not PROJECT.C or
  455.                 PROJECT.ASM
  456.  
  457.                 All directories are always displayed.
  458.  
  459.                 If files exist in the directory that do not match the
  460.                 given criteria they are show on the display as the
  461.                 single special file
  462.  
  463.                         <other>
  464.  
  465.                 Pressing RETURN over this file will remove the criteria,
  466.                 causing all files to be displayed.
  467.  
  468.         M - Move
  469.  
  470.                 Works like the Copy command except that the files are
  471.                 moved rather than copied. This is almost instant when
  472.                 moving a file between directories, but moving a file
  473.                 between drives involves a combination of copy and
  474.                 delete, which is slower. Directories cannot be moved or
  475.                 copied.
  476.  
  477.         N - New
  478.  
  479.                 Creates a new directory; not necessarily inside the
  480.                 current one. The directory name entered will become the
  481.                 default for subsequent Move or Copy commands.
  482.  
  483.         O - Order
  484.  
  485.                 Controls the ordering of files in the display.
  486.                 Directories are normally separated from files (they
  487.                 appear first) but are affected by the option chosen. The
  488.                 options are:
  489.  
  490.                         N       Name
  491.                         E or X  Extension
  492.                         S       Size
  493.                         T       Date/Time
  494.                         U       Unsorted
  495.  
  496.                 When the order is "By Extension" the file name display
  497.                 is changed to separate the extension from the file base
  498.                 name.
  499.  
  500.                 When the order is "Unsorted" directories are mixed with
  501.                 files.
  502.  
  503.                 When the order is "By Size" directories are still sorted
  504.                 by name, unless the size is known.
  505.  
  506.                 G - Group
  507.  
  508.                 Order by Group is a very special mode, where files with
  509.                 similar extensions are grouped together as a single
  510.                 entry on the display. For example *.bat would indicate
  511.                 all.BAT files in the current directory. The size shown
  512.                 next to such an entry is the combined size on disk of
  513.                 all the files matching the pattern.
  514.  
  515.                 Pressing Return over one of these entries causes it to
  516.                 explode into the list of files that it represents. Othe
  517.                 files are left grouped. You can regroup the files by
  518.                 pressing Escape. or by selecting another group.
  519.  
  520.         P - Process
  521.  
  522.                 This command "processes" the current file. Processes can
  523.                 be set for each extension, in the V1.INI file. If the
  524.                 current file is an archive and a process is not defined,
  525.                 but V1 knows how to decompress the archive, then the
  526.                 archive is decompressed into a sub-directory with the
  527.                 same name as the archive (but without the extemsion).
  528.  
  529.                 The sample V1.INI file includes a process entry that
  530.                 processes self-extracting archives stored as .EXE files
  531.                 by decompressing them into a sub-directory.
  532.  
  533.         Q - Quit
  534.  
  535.                 This leaves V1 and returns you to the directory from
  536.                 which V1 was started. Compare with the Jump command.
  537.  
  538.         R - Rename
  539.  
  540.                 Allows you to rename the current file or directory by
  541.                 editing the name. Note that the renamed file is not
  542.                 resorted in the display, until the display is refreshed
  543.                 by pressing TAB.
  544.  
  545.                 Any description attached to a file will remain with the
  546.                 file.
  547.  
  548.                 See: Comment (K)
  549.  
  550.         S - Select
  551.  
  552.                 Normally you mark (or select) files one at a time by
  553.                 pressing the space bar. This command allows you to
  554.                 select all the displayed files; clear all the marks; or
  555.                 to invert the marks: so that marked files become
  556.                 unmarked and unmarked files become marked.
  557.  
  558.                 If you have used the Window Match command you
  559.                 can also use the Select command to mark files
  560.                 resulting from the comparison. For example
  561.                 pressing = will mark all files in the current
  562.                 window that are identical to those in the other
  563.                 window.
  564.  
  565.         U - Use
  566.  
  567.                 Uses a command or program on the current file, or marked
  568.                 files. You are prompted for command to be run and the
  569.                 name of the current file is automatically added to the
  570.                 command line. For example if the current file is
  571.  
  572.                         TEST.DOC
  573.  
  574.                 and you enter
  575.  
  576.                         WORD
  577.  
  578.                 then the command would be run as
  579.  
  580.                         WORD TEST.DOC
  581.  
  582.                 If several files are marked then the given command is
  583.                 applied to each in turn.
  584.  
  585.                 You can control where in the command the filename
  586.                 appears by using the special marker <> in the command to
  587.                 be run. For example:
  588.  
  589.                         ECHO "<>" >> DIR.LST
  590.  
  591.                 Would echo the quoted name of each file to the file
  592.                 DIR.LST. If the string <> does not appear in the command
  593.                 then the filename is added to the end of the command
  594.                 preceded by a space.
  595.  
  596.         V - View
  597.  
  598.                 Invokes the built-in file viewer on the current file.
  599.                 You can normally view a file by pressing RETURN, but
  600.                 this command must be used if the file is an executable
  601.                 as RETURN will try to execute rather than view such a
  602.                 file.
  603.  
  604.         W - Window
  605.  
  606.                 V - Vertical
  607.                 H - Horizontal
  608.  
  609.                 Creates a new directory window, by splitting the
  610.                 current window in half, Vertically or
  611.                 Horizontally. Initially the second window is a
  612.                 copy of the first but changing directory affects
  613.                 only to the current window. You can switch
  614.                 windows by using Ctrl-Right and Ctrl-Left.
  615.  
  616.                 O - One
  617.  
  618.                 Closes the other window, leaving the current
  619.                 window as the only one.
  620.  
  621.                 M - Match
  622.  
  623.                 Compares the date/time and sizes of the files in
  624.                 two windows. Files in both windows are marked to
  625.                 show whether they are older, newer, same
  626.                 date/time or same date/time & size, as
  627.                 corresponding files in the other window.
  628.  
  629.         X - eXecute
  630.  
  631.                 Runs the current file, if the extension is .EXE .COM or
  632.                 .BAT You can use the Zip command to view the output of
  633.                 the program once it has finished running.
  634.  
  635.         Z - Zip to DOS Screen
  636.  
  637.                 "Zip back and take a look at the DOS Screen". Pressing
  638.                 this key displays the state of the DOS screen, either
  639.                 what was on the screen when V1 was entered, or the
  640.                 output produced by running a program from within V1.
  641.  
  642. Viewing Files
  643.  
  644.         When viewing files the following commands are available:
  645.  
  646.         PageUp, PageDown, Up, Down
  647.  
  648.                 Are used to scroll the file vertically.
  649.  
  650.         Left, Right, Ctrl-Left, Ctrl-Right
  651.  
  652.                 Scroll the file horizontally.
  653.  
  654.         Ctrl-PageUp
  655.  
  656.                 Goes to the start of the file.
  657.  
  658.         Ctrl-PageDown
  659.  
  660.                 Goes to the end of the file.
  661.  
  662.         Esc, Backspace, V, Return
  663.  
  664.                 All leave the file viewing mode and return to the
  665.                 directory viewing screen.
  666.  
  667.         + or =
  668.         -
  669.  
  670.                 Switch to the next or previous file. If any files are
  671.                 marked then these keys switch to the next or previous
  672.                 marked file.
  673.  
  674.         E - Edit
  675.  
  676.                 Invokes an editor on the file. Set by the EDITOR
  677.                 environment variable, or E4 if the environment variable
  678.                 is not set.
  679.  
  680.         F - Find
  681.  
  682.                 Allows you to search for a string. The search is not
  683.                 case sensitive. The search may be repeated by pressing N
  684.                 (next) or the Grey +/- keys on the numeric keypad, or
  685.                 Alt-PageUp/Alt-PageDown. These latter keys also control
  686.                 the direction of search +/PageDown for forwards,
  687.                 -/PageUp for backwards.
  688.  
  689.         H - Hex
  690.  
  691.                 Toggles the display between text and a hexadecimal dump.
  692.  
  693.         7 - 7 Bit mode
  694.  
  695.                 Strips the top (parity) bit from the characters before
  696.                 they are displayed. This only affects the display, not
  697.                 the original file.
  698.  
  699.         8 - 8 Bit mode
  700.  
  701.                 Shows the full IBM character set.
  702.  
  703.         Delete
  704.  
  705.                 Deletes the file, as if you had pressed Delete from the
  706.                 directory viewing screen.
  707.  
  708.         Q - Quit
  709.         J - Jump
  710.  
  711.                 Behave as they do on the directory viewing screen.
  712.  
  713. Setting the COLOURS environment variable
  714.  
  715.         The colours environment variable or the colours .INI file entry
  716.         control the displayed colour of a file based on its filename
  717.         and/or it attribute flags. The variable is set to a string of
  718.         items seperated by spaces, where each item may be either
  719.  
  720.                 <filespec>:<colour>
  721.  
  722.         or
  723.  
  724.                 <attributes>:<colour>
  725.  
  726.         <filespec> may be any normal wildcard specification or specific
  727.         filename e.g. *.bat or autoexec.bat, but it must be given in
  728.         lowercase.
  729.  
  730.         <attributes> may be any of the letters RHSVDAYX which must be in
  731.         uppercase to distingish them from a file specification.
  732.  
  733.         Colours are given as
  734.  
  735.                 <foreground><background> or just <foreground>
  736.  
  737.         Colour letters are
  738.  
  739.                 k       black
  740.                 b       blue
  741.                 g       green
  742.                 r       red
  743.                 m       magenta
  744.                 y       yellow/brown
  745.                 w       white
  746.  
  747.         Capitalising the letter makes foreground colours bright and
  748.         background colours flash.
  749.  
  750.         Example
  751.  
  752.                 SET COLOURS=D:W HS:g H:K e4*.exe:Gb *.c:G *.h:G *.asm:R
  753.                 *.exe:M *.bat:M *.com:M *.bak:b readme*.*:YK *.doc:C
  754.                 *.txt:C *.obj:B
  755.  
  756.         For each filename the list is search from left to right and the
  757.         first set of attributes or filespec to match decides the colour
  758.         for the file.
  759.  
  760.         In the above example directories will be bright white, hidden
  761.         system files will be green, and other hidden files will be
  762.         bright black (grey). For other files the colour will depend
  763.         primarily on the extension: executables will be bright magenta
  764.         except for any .EXE files that begin E4. Any README files will
  765.         be flashing yellow.
  766.  
  767. The V1 Initialisation File
  768.  
  769.         The file V1.INI is used to customise V1, and it must be placed
  770.         in the same directory as V1.EXE.
  771.  
  772.         The file consists of a series of entries, each of which controls
  773.         some aspect of V1's behaviour. A small V1.INI is provided
  774.         containing a few essential entries.
  775.  
  776.         Entries in V1.INI take the form
  777.  
  778.                 <name>=<text>
  779.  
  780.         Setting Default Command Line Switches
  781.  
  782.                 The V1 entry may be used to set any default
  783.                 command line switches, as an alternative to
  784.                 using the V1 environment variable. For example:
  785.  
  786.                         V1=/H
  787.  
  788.                 Would turn on the display of hidden files.
  789.  
  790.         Setting File Colours
  791.  
  792.                 As an alternative to using the COLOURS environment
  793.                 variable the COLOURS entry in V1.INI may be used to set
  794.                 default file colours. The entry may continue over
  795.                 several lines as long as the second and subsequent lines
  796.                 are indented by at least one tab stop. For example:
  797.  
  798.                         COLOURS=*.txt:Bw
  799.                                 *.exe:BW
  800.  
  801.         Associating a File Type with an Application
  802.  
  803.                 When the RETURN key is pressed (in the directory
  804.                 display) V1 looks to see if it knows what kind of
  805.                 application should be used on the current file.
  806.                 Applications are associated with different extensions by
  807.                 using entries of the form
  808.  
  809.                         <extension>=<program>
  810.  
  811.                 For example:
  812.  
  813.                         .doc=word
  814.                         .gif=view
  815.  
  816.                 V1 will invoke the given application with the name of a
  817.                 file as an argument, just like the Use command.
  818.  
  819.                 Like the Use command it is possible for the filename to
  820.                 be inserted in the middle of the command by using the <>
  821.                 placeholder. For example:
  822.  
  823.                         .ext=prog <> /option
  824.  
  825.                 All other placeholders are also available, but note that
  826.                 the entry cannot extend over more that one line.
  827.  
  828.         Archive Files (.ZIP, .ARJ, etc)
  829.  
  830.                 V1 can automatically uncompress archives file into
  831.                 temporary directories, when RETURN is pressed over an
  832.                 archive name.
  833.  
  834.                 You tell V1 how to uncompress different kinds of archive
  835.                 by using entries like:
  836.  
  837.                         unarc.zip=pkunzip -d
  838.                         unarc.arj=arj x
  839.  
  840.                 The command given should be one that uncompresses the
  841.                 archive into the current directory, extracting any
  842.                 sub-directory information as well.
  843.  
  844.                 The name of the archive to be uncompressed is
  845.                 automatically added to the end of the command. If you
  846.                 want it to appear elsewhere in the command use the <>
  847.                 placeholder at the that point. UNARC entries cannot
  848.                 extend over more than one line.
  849.  
  850.                 It is the presence of an UNARC entry that causes V1 to
  851.                 recognise a file as being an archive: without an entry a
  852.                 .ZIP file is treated just like any other.
  853.  
  854.         Example
  855.  
  856.                 A comprehensive V1.INI file might look like this:
  857.  
  858.                 V1=/4 /H /OX
  859.  
  860.                 COLOURS=        D:W HS:g H:K e4*.exe:Gb *.c:G *.h:G
  861.                                 *.asm:R *.exe:M *.bat:M *.com:M *.bak:b
  862.                                 readme*.*:YK *.doc:C *.sty:c *.txt:C
  863.                                 *.obj:B *.zip:y *.arj:Y
  864.  
  865.                 .doc=word
  866.                 .gif=vpic
  867.  
  868.  
  869.                 unarc.zip=pkunzip -d
  870.                 unarc.arj=arj x
  871.  
  872. Programming V1
  873.  
  874.         V1 allows you to assign short batch programs to function keys
  875.         (except for F1, which is used for help), or to the P key
  876.         (Process command). Such assignments are placed in the V1.INI
  877.         file as entries of the form:
  878.  
  879.                 <key>=<program>
  880.  
  881.         For example
  882.  
  883.                 F2=echo F2 key pressed
  884.  
  885.         For the Process command the word "process" is used instead of a
  886.         keyname:
  887.  
  888.                 process=echo Process Command
  889.  
  890.         Often the script assigned to the key will extend over more than
  891.         one line, in this case the second and subsequent lines must be
  892.         indented by a tab character:
  893.  
  894.                 F2=echo first line
  895.                         echo second line
  896.                         echo third line
  897.  
  898.         More than one program can be assigned to a key, and selected
  899.         depending on the extension of the current file. For example you
  900.         can use F2 to view archive files with entries like:
  901.  
  902.                 F2.zip=pkunzip -v <> | more
  903.                 F2.arj=arj v <> | more
  904.  
  905.         Note the use of the <> placeholder for the name of the file.
  906.         Unlike the Use command or UNARC entries in V1.INI the name of
  907.         the current file is not appended automatically to the command,
  908.         unless the <> placeholder is used.
  909.  
  910.         Other Placeholders
  911.  
  912.         The <> placeholder varies in meaning according to the command,
  913.         it is normally the relative pathname of the file, but may be the
  914.         full pathname in certain circumstances.
  915.  
  916.         For example in an UNARC entry <> will be ..\ARCHIVE.ZIP when
  917.         uncompressing an archive into a sub-directory, it but will be
  918.         the full pathname of the archive when uncompressing into the
  919.         TEMP directory, as this may be on another drive.
  920.  
  921.         Several placeholders are available in addition to the normal <>.
  922.         Assuming a full pathname of C:\WORK\PROGRAMS\TEST.BAT the
  923.         placeholders and their example values are listed below:
  924.  
  925.         <name>          TEST.BAT
  926.  
  927.                 The filename only, often a synonym for <>
  928.  
  929.         <fullname>      C:\WORK\PROGRAMS\TEST.BAT
  930.  
  931.                 The full pathname of the file
  932.  
  933.         <path>          C:\WORK\PROGRAMS
  934.  
  935.                 Just the path, without the filename part, or a trailing
  936.                 slash (unless the file is in the root directory of a
  937.                 drive, in which case the slash is present).
  938.  
  939.         <dir>           WORK\PROGRAMS
  940.  
  941.                 The absolute path without the drive or leading slash
  942.  
  943.         <drive>         C:
  944.  
  945.                 The drive letter followed by a colon.
  946.  
  947.         <basename>      TEST
  948.  
  949.                 The name of the file without an extension
  950.  
  951.         <ext>           .BAT
  952.  
  953.                 The extension with leading dot.
  954.  
  955.         <label>
  956.  
  957.                 The volume label of the current drive.
  958.  
  959.         <exedir>
  960.  
  961.                 The directory containing the V1 Executable (V1.EXE)
  962.  
  963.         The above placeholders may be used to write powerful batch
  964.         programs such as this one, which will uncompress a
  965.         self-extracting .EXE file into a sub-directory:
  966.  
  967.                 process.exe=
  968.                         mkdir <basename>
  969.                         cd <basename>
  970.                         ..\<name>
  971.  
  972.         The process command is capable of automatically uncompressing
  973.         other types of archive into sub-directories, if V1.INI contains
  974.         and UNARC entry for that kind of archive.
  975.  
  976. Registration and Payment
  977.  
  978.         Registration and Payment is required if you continue to use V1
  979.         after an initial trial period of 30 days, from the date of first
  980.         use. You must pay for this software if you wish to continue to
  981.         use it legally.
  982.  
  983.         The registration fee helps to pay for the further development of
  984.         this and other software.
  985.  
  986.         V1 costs just £19 or $29 world-wide, for which you will receive
  987.         a vesion of V1 registered to you personally and without the
  988.         registration reminders. The price include postage and packing,
  989.         and technical support.
  990.  
  991.         Technical support is available before purchase, to help you
  992.         decide if V1 meets your needs.
  993.  
  994.         Cheques should be in UK Pounds Sterling, drawn on a UK bank,
  995.         and sent to the following address:
  996.  
  997.                 Neil Faulks
  998.                 96 Middle Lane
  999.                 Crouch End
  1000.                 London
  1001.                 England  N8 8NT
  1002.  
  1003.         Enquiries may be telephoned to +44 171 873 2007 (24Hr), Faxed to
  1004.         +44 171 258 0717, or Emailed to
  1005.  
  1006.                 neil@dcs.kcl.ac.uk
  1007.  
  1008.         or from CompuServe:
  1009.  
  1010.                 INTERNET:neil@dcs.kcl.ac.uk
  1011.  
  1012.         or
  1013.  
  1014.                 100417,1251     (A faster response may be had from the
  1015.                                 internet address)
  1016.  
  1017.         Orders are welcome from any country in the world.
  1018.  
  1019.         For more details and a printable order form refer to the file
  1020.         V1ORDER.TXT
  1021.  
  1022.  
  1023. End of File
  1024.