home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR36 / VF120.ZIP / VF.DOC < prev    next >
Text File  |  1993-08-28  |  15KB  |  516 lines
  1.  
  2.  
  3.  
  4.                      VF ver. 1.20
  5.               A Product of Chenango Shoreware
  6.                Copyright 1993 by G. Vrooman
  7.                    All rights reserved
  8.  
  9.  
  10.  
  11.     VF is a fast, powerful text file viewer that:
  12.  
  13.     Will recognize VI editor commands.
  14.  
  15.         Can handle files containing over 150,000 lines depending on available 
  16.     memory. 
  17.  
  18.     Will configure itself to use existing screen colors.  Colors can
  19.     also be configured from the environment.
  20.  
  21.     Will adapt itself to virtually any text mode including 132 column 
  22.     modes.  Video mode can be specified as an option.
  23.  
  24.     Can display lines either numbered or unumbered.    
  25.  
  26.     
  27.  
  28.     
  29.     SYSTEM REQUIREMENTS:  Hard disk, Any Monitor, 256k, IBM Compatible
  30.                   BIOS and DOS 3.0 or later.  
  31.  
  32.  
  33.     SUPPORT:  If you have any questions or comments about VF you
  34.           can write me at the address below:
  35.  
  36.                 Gerald M. Vrooman
  37.                 6400 NY RT 79
  38.                 Chenango Forks, NY
  39.                 13746
  40.  
  41.  
  42.                     INSTALLING VF
  43.  
  44.       Just copy the files to any convenient directory and make sure that
  45.     the directory is included in the PATH statement in your AUTOXEC.BAT
  46.     file.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.                     CONFIGURING VF
  55.  
  56.       Under ordinary circumstances, VF is self-configuring and will
  57.         adapt itself to existing screen colors and screen size.  To provide 
  58.     an additional degree of flexibility screen colors can be set from 
  59.     the environment.  This is done by setting the environment variable
  60.     VFCOLORS to the desired colors.  eg:
  61.  
  62.             SET VFCOLORS=6E6F7F
  63.  
  64.  
  65.     char 1-2    Normal screen colors for VF.  These are hex numbers 
  66.             and correspond to standard DOS color attributes.  
  67.             The first digit ranges from 0 to 7 and sets the 
  68.             background color.  The second digit ranges from 0 to 
  69.             F and sets the foreground color.
  70.  
  71.     char 3-4    Highlighted text search colors for VF. Same as above.
  72.  
  73.     char 5-6    Menu bar colors for VF.
  74.  
  75.  
  76.  
  77.                DOS SCREEN COLOR CODES
  78.  
  79.  
  80.                  NORMAL                BRIGHT / BLINK
  81.  
  82.     0    BLACK                8    BLACK
  83.  
  84.     1    BLUE                9    BLUE
  85.  
  86.     2    GREEN                A    GREEN
  87.  
  88.     3    CYAN                B    CYAN
  89.  
  90.     4    RED                C    RED
  91.  
  92.     5    MAGENTA                D    MAGENTA
  93.  
  94.     6    AMBER                E    YELLOW
  95.  
  96.     7    WHITE                F    WHITE
  97.  
  98.  
  99.     If a number between 8 and F is used for a foreground color you
  100.     will get bright text.  If it is used for background you will
  101.     get blinking text.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.     NAME:
  110.  
  111.     VF    View File 
  112.  
  113.  
  114.     SYNTAX:
  115.  
  116.  
  117.     vf                     Read from standard input.    
  118.  
  119.         vf [-##b][+##][+\string] file       Displays contents of file one 
  120.                        page at a time.
  121.  
  122.     vf dir                   Lists directory and allows you
  123.                        to choose file.
  124.  
  125.  
  126.     SWITCHES:
  127.  
  128.         +###            Begin displaying at line ###.
  129.  
  130.     +\string    Begin displaying at first occurrence of string.
  131.  
  132.     -##             Set display adaptor to mode ##.
  133.  
  134.     -b        Write to BIOS instead of video memory.
  135.  
  136.  
  137.  
  138.  
  139.     DESCRIPTION:
  140.  
  141.       VF is a text file viewer which can read files containing
  142.         up to 150,000 lines.  For the convenience of UNIX oriented users
  143.     VF will recognize most relevant VI editor commands.  VF also makes
  144.     full use of the cursor and function keys and is similar in feel
  145.     to other DOS file viewers.  To use VF merely type VF and the name
  146.     of the file that you would like to read.  For example:
  147.  
  148.             vf dosnix.doc
  149.  
  150.     Wild cards and multiple arguments can be used to view several files 
  151.     in sequence.  For example:
  152.  
  153.             vf *.doc
  154.  
  155.     can be used to page through all .DOC files, and
  156.  
  157.             vf whats.new quickref.doc
  158.  
  159.     will first read WHATS.NEW, then QUICKREF.DOC.
  160.  
  161.       
  162.  
  163.        When VF begins, it will display one page of text and then pause. 
  164.      You can then enter one of the following commands:
  165.  
  166.  
  167.     COMMAND            FUNCTION        VI/EX EQUIVALENT
  168.  
  169.     Home         Move to beginning of file.        1G, :1
  170.  
  171.         End             Move to end of file.            G, :$
  172.  
  173.      <PgDn>          Display next page.               ^F
  174.  
  175.         <PgUp>          Display previous page.            ^B
  176.  
  177. ^L
  178.  
  179.  
  180.  
  181.         Down Arrow      Display next line of text.        j
  182.  
  183.     Up Arrow        Move back one line.            k
  184.  
  185.     Right Arrow    Shift screen one tab stop right.
  186.  
  187.     Left Arrow    Shift screen one tab stop left.
  188.  
  189.     ]         Display next half page of text.        ^D
  190.  
  191.         [           Move back one half page.        ^U
  192.  
  193.         F1, h         Display help page.
  194.  
  195.     F2, \        Search text for string.  Ignore case.
  196.  
  197.     ShF2, |        Search backwards.  Ignore case.
  198.  
  199.     F3        Search for next occurrence of string.    n
  200.  
  201.     F4        Select new file from directory.
  202.  
  203.     F5            Change file mask.
  204.  
  205.     F6              Toggle line numbers.            :set nu
  206.                                 :set nonu
  207.  
  208.     F7        Shell to DOS.                :sh
  209.  
  210.     F8          Search text for string.  Match case.     /
  211.  
  212.     ShF8              Search backwards.  Match exact case.    ?
  213.  
  214.     F9        Reverse direction of search.        N
  215.  
  216.         F10, q         Terminate the program.            :q
  217.  
  218.         -###,           Move back ### lines.            :-###
  219.  
  220.         +###,         Move forward ### lines.            :+100
  221.  
  222.         ###             Move to line number ###.                ###G, :###
  223.  
  224.         ^L              Rewrite current page.            ^L
  225.  
  226.     :n        Read next file.               :n
  227.  
  228.     :p        Read previous file.
  229.  
  230.  
  231.       The escape key can be used to interrupt text searches and exit
  232.     the help screen.  It will also terminate the program from the main
  233.     menu.  F10 or Del can be used in place of Esc and  ^PgUp and ^PgDn
  234.     can be used in place of Home and End.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.       The number of the top line is displayed on the menu bar unless 
  242.     the end of file message is visible. Then the line number displayed 
  243.     will be the last line of the file.  Unless the file is very small, 
  244.     you can use Esc to realign the last page and get rid of the message. 
  245.  
  246.       If the number keys are used to go to a line already on the screen, 
  247.     the screen will scroll until the line is at the top.  Otherwise the 
  248.     screen will clear and a new page will be displayed.  
  249.  
  250.       The number of every line can be displayed by pressing F6.  Line
  251.     numbers will be displayed on the right hand side of the screen and
  252.     will overwrite the last few columns of text.  Pressing the Right
  253.     arrow key will shift the screen and allow you to read any text that
  254.     is covered.
  255.  
  256.       You can choose a new file from the directory by pressing F4.  The 
  257.     current directory will be displayed and you can use the arrow keys 
  258.     to choose either a new file or a new directory.  You can start the 
  259.     program in this mode by using a directory as an argument.  Pressing 
  260.     F5 while in this mode will allow you to change the file mask.
  261.  
  262.       You can also choose a new file by pressing F5 from the main
  263.     program.  You will then be given an opportunity to enter a new
  264.     file name.
  265.  
  266.       Text searches can be done by typing a "\" (F2) or a "/" (F8).  
  267.     You will then be prompted to enter a search string.  VF will begin 
  268.     displaying ten lines before the line containing the search string and 
  269.     the matching line will be highlighted.  The "\" command will ignore 
  270.     differences between upper and lower case.  The "/" command will find 
  271.     only strings having the exact case as the search string.  Using the 
  272.     shift key with with either of these commands (ie. "|" or "?") will 
  273.     search backwards through the file for any previous occurence of a 
  274.     string.  Typing a "n"  or F3 will continue searching in the same 
  275.     direction  while "N" or F9 will search in the opposite direction.
  276.  
  277.       VF also has several options which can be used from the command
  278.     line.  If the +\string switch is used, VF will search the first 
  279.     occurrence of "string" before displaying.  For example:
  280.  
  281.             vf +\ffind dosnix.doc
  282.  
  283.     will scan DOSNIX.DOC for the first occurrence of "ffind" and
  284.     begin displaying ten lines before the first matching line.
  285.  
  286.       Case sensitive searches can also be initiated from the command
  287.     line.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.       When +### is used as a switch, VF will begin displaying at 
  294.     whatever line number is given after the plus sign.  For example:
  295.  
  296.         vf +300 dosnix.doc
  297.  
  298.     will begin displaying at line 300.
  299.  
  300.  
  301.       Normally VF writes text directly to video memory.  If the -b
  302.     option is used VF will use the video BIOS to write text.  If
  303.     you have a CGA monitor and are having trouble with "snow" the
  304.     -b option will eliminate it.
  305.  
  306.       An option has been provided to change the mode of your display
  307.     adaptor.  To use this option type
  308.  
  309.                 vf -# filename
  310.  
  311.     where # is the number of the new mode in decimal.  # can be any 
  312.     valid text mode and you should check the manual for your graphics 
  313.     card to see what modes are supported. Common text modes are listed
  314.     below:
  315.  
  316.  
  317.                                Standard  Text  Modes
  318.  
  319.         Mode       Card            Format
  320.  
  321.         0      CGA        40 X 25     Black & White
  322.         1      CGA        40 X 25     Color
  323.         2      CGA        80 X 25     Black & White
  324.         3         CGA        80 X 25     Color
  325.         7      Monochrome    80 X 25     Black & White
  326.  
  327.     EGA and VGA cards support all of the above modes but VGA does not
  328.     distinguish beetween CGA Color and Black & White modes.
  329.  
  330.  
  331.                 Extended Text Modes
  332.  
  333.  
  334.                 Trident TVGA BIOS
  335.  
  336.          Mode                    Format
  337.  
  338.             80 (50h)                80 X 30
  339.         81 (51h)                80 X 43
  340.         82 (52h)                80 X 60
  341.         83 (53h)                132 X 25
  342.         84 (54h)                132 X 30
  343.         85 (55h)                132 X 43
  344.         86 (56h)                132 X 60
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.                 Tseng ET-4000    
  354.  
  355.          Mode                    Format
  356.  
  357.         34 (22h)                132 X 44
  358.         35 (23h)                132 X 25
  359.         36 (24h)                132 X 28
  360.         38 (26h)                80 X 60
  361.  
  362.  
  363.  
  364.     These are the only cards I have data for.  If I have omitted
  365.     your favorite display adaptor send me the mode numbers and I
  366.     will add them to the docs.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.                 ABOUT SHAREWARE
  374.  
  375.         Shareware distribution gives users a chance to try software
  376.     before buying it. If you try a Shareware program and continue
  377.     using it, you are expected to register. Individual programs
  378.     differ on details -- some request registration while others
  379.     require it, some specify a maximum trial period. With registration, 
  380.     you get anything from the simple right to continue using the software 
  381.     to an updated program with printed manual.
  382.  
  383.         Copyright laws apply to both Shareware and commercial software,
  384.     and the copyright holder retains all rights, with a few specific
  385.     exceptions as stated below. Shareware authors are accomplished
  386.     programmers, just like commercial authors, and the programs are
  387.     of comparable quality. (In both cases, there are good programs
  388.     and bad ones!) The main difference is in the method of distribution. 
  389.     The author specifically grants the right to copy and distribute the         software, either to all and sundry or to a specific group. For 
  390.     example, some authors require written permission before a commercial 
  391.     disk vendor may copy their Shareware.
  392.  
  393.         Shareware is a distribution method, not a type of software. 
  394.     You should find software that suits your needs and pocketbook,
  395.     whether it's commercial or Shareware. The Shareware system makes
  396.     fitting your needs easier, because you can try before you buy.
  397.     And because the overhead is low, prices are low also. Shareware
  398.     has the ultimate money-back guarantee -- if you don't use the
  399.     product, you don't pay for it.
  400.  
  401.             DISCLAIMER - AGREEMENT
  402.  
  403.         Users of VF must accept this disclaimer of warranty:
  404.     "VF is supplied as is.  The author disclaims all warranties, 
  405.     expressed or implied, including, without limitation, the 
  406.     warranties of merchantability and of fitness for any purpose.
  407.     The author assumes no liability for damages, direct or conse-
  408.     quential, which may result from the use of VF."
  409.  
  410.             VF is a "shareware program" and is provided at no charge to 
  411.     the user for evaluation.  Feel free to share it with your friends, 
  412.     but please do not give it away altered or as part of another system. 
  413.     The essence of "user-supported" software is to provide personal 
  414.     computer users with quality software without high prices, and yet to 
  415.     provide incentive for programmers to continue to develop new products. 
  416.     If you find this program useful and find that you are using VF and 
  417.     continue to use VF Utilities after a reasonable trial period, you 
  418.     must make a registration payment of $15.00 to the author.  The $15.00
  419.     registration fee will license one copy for use on any one computer 
  420.     at any one time.  You must treat this software just likea a book.
  421.  
  422.  
  423.  
  424.  
  425.  
  426.        An example is that this software may be used by any
  427.     number of people and may be freely moved from one computer
  428.     location to another, so long as there is no possibility of it
  429.     being used at one location while it's being used at another.
  430.     Just as a book cannot be read by two different persons at the
  431.     same time.
  432.  
  433.         Commercial users of VF must register and pay for their 
  434.     copies of VF within 30 days of first use or their license
  435.     is withdrawn.  Site-License arrangements may be made by 
  436.     contacting the author.
  437.  
  438.         Anyone distributing VF for any kind of remuneration must
  439.     first contact the author at the address below for authorization.
  440.     This authorization will be automatically granted to distributors
  441.     recognized by the Association of Shareware Professionals as adhering 
  442.     to its guidelines for shareware distributors, and such distributors 
  443.     may begin offering VF immediately (However the author must 
  444.     still be advised so that the distributor can be kept up-to-date with 
  445.     the latest version of VF).
  446.  
  447.         You are encouraged to pass a copy of VF along to your friends for 
  448.     evaluation.  Please encourage them to register their copy if they find 
  449.     that they can use it.  Fully registered users will receive a copy of 
  450.     the latest version of VF along with several bonus utilities.
  451.  
  452.         VF will eventually become the standard text file viewer for
  453.     DOSNIX and is currently being shipped  with the registered version.
  454.     This means that you can register VF either separately for $15.00
  455.     or with DOSNIX for $35.00.  To register your copy of VF or to purchase 
  456.     a site license, fill out the form and mail it to the author at the 
  457.     address below:
  458.  
  459.     
  460.                 Gerald M. Vrooman
  461.                             6400 NY Rt 79
  462.                             Chenango Forks, NY
  463.                             13746
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.                VF  REGISTRATION (ver. 1.20)
  471.  
  472.  
  473.  
  474.         NAME:     ____________________________________________________________
  475.  
  476.         ADDRESS:  ____________________________________________________________
  477.  
  478.                   ____________________________________________________________
  479.  
  480.                   ____________________________________________________________
  481.  
  482.  
  483.  
  484.     
  485.  
  486.  
  487.  
  488.  
  489.  
  490.     ____ Full registration @ $15.00  
  491.          (Includes a copy of the latest version
  492.           and bonus utilities.)                      ____________
  493.  
  494.  
  495.     ____ Basic Site License @ $40.00    
  496.          (Up to three computers)                  ____________
  497.  
  498.  
  499.  
  500.     ____ Additional computers @ $12.00                 ____________
  501.  
  502.  
  503.         ____ DOSNIX registration @ $35.00
  504.              (Includes VF)                                    ____________
  505.  
  506.  
  507.  
  508.     Total amount enclosed                                 ____________
  509.     
  510.  
  511.  
  512.  
  513.         Please circle one:      5.25" disk      3.5" disk
  514.  
  515.  
  516.