home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR8 / VWFILE.ZIP / VIEW85.DOC < prev    next >
Text File  |  1993-08-19  |  20KB  |  447 lines
  1.   
  2.                                                    
  3.                                       VIEW       ▌
  4.                                                  ▌
  5.                                    Version 8.5   ▌
  6.                                                  ▌
  7.                                  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  8.  
  9.        
  10.                         Copyright (c) 1993 Malcolm Drury
  11.  
  12.      Note: this package contains the following files:
  13.  
  14.                      VIEW85.EXE (file viewer version 8.5)
  15.                      VW85CFG.COM (customizer)
  16.                      VIEW85.DOC
  17.                      VIEWCUST.BAT - sample batch file
  18.                      FILE_ID.DIZ - description file for BBS
  19.  
  20.                      (zipped with PKZIP 1.10)
  21.  
  22. VIEW is a file viewing utility, allowing you to read ASCII,  WordPerfect
  23. (5.0, 5.1/5.2, including Windows, and 6.0), Microsoft Word (4 and 5 and
  24. WinWord 1 and 2), and Windows WRITE files, and to print all or part of them
  25. to file or printer. VIEW also allows you to search for text strings (both
  26. case-sensitive and case-insensitive), and print all lines that include or
  27. exclude a particular text string. You can also print files directly from the
  28. file selection menu, and you can split large files.
  29.  
  30. VW85CFG allows you to customize display colors for VIEW and also allows you
  31. to customize its printing, display and memory features.
  32.  
  33.  
  34.                          *** IMPORTANT ***
  35.  
  36. The author makes no warranty that the software in this package will work
  37. with your particular hardware configuration.  You use the programs entirely
  38. at your own risk, and the author will not be held liable for any damage
  39. caused to your hardware or software through their use. nor for any
  40. consequential damages.
  41.  
  42. Legalities aside, you should not run into difficulties with this software.
  43.  
  44.  
  45.                           **** SHAREWARE ****
  46.  
  47.  
  48. These programs are distributed as shareware, AND ARE NOT CRIPPLED!!.
  49. (Editorial note: I don't support "crippleware" - I want to know
  50. EXACTLY what I'm expected to pay for! Crippleware is, in my opinion,
  51. like test driving a Mercedes that's been fitted with a two-stroke engine!
  52. There, that's said - but each to his own.)
  53.  
  54. You do not have to register as a user, nor are you under any
  55. obligation to buy the program(s).  However, they are not free, and in
  56. the spirit of shareware, you are requested to make a small
  57. donation to the author if you find the software in this package useful,
  58. and if you continue to use it after an evaluation period of 30 days. This
  59. would both fulfill your moral obligation and help ensure the viability of
  60. the shareware concept, from which we all benefit.
  61.  
  62. The suggested contribution is $15 but less (or more!) would be fine. Pay what
  63. you think the software is worth to you. If you pay the recommended amount
  64. plus add $4 for shipping and handling, I will send you a 5 1/4" diskette
  65. with the latest version plus a selection of other shareware for you to
  66. evaluate, including Tony Caine's excellent 2COL and JETCOL utilities, which
  67. allow you to print files in double columns. Alternatively, send a blank
  68. diskette of your preferred size (5 1/4" 360kb or 1.2Mb, or 3 1/2" 720kb
  69. or 1.4 Mb) plus $3 s&h.
  70.  
  71. Should you decide to make a contribution, please remit to:
  72.  
  73.                    Malcolm Drury
  74.                    11 Adele Crescent
  75.                    Nepean
  76.                    ON  K2J 2T7
  77.                    Canada
  78.  
  79. Internet drury@gsc.emr.ca
  80. Compuserve 70574,3457
  81.  
  82. Bank notes would be fine!  Thank you. Please tell me where you
  83. got the software from (this helps me in knowing where to post updates), and,
  84. most importantly, which version it is.
  85.  
  86.  
  87. IF YOU HAVE PREVIOUSLY PAID FOR AN EARLIER VERSION  -  THANKS, AND
  88. OF COURSE YOU ARE NOT EXPECTED TO PAY AGAIN. YOUR INPUT, COMMENTS
  89. ETC. ARE ALWAYS WELCOME.
  90.  
  91. Please note that at the low contribution requested, I cannot provide direct
  92. technical support, nor automatically send upgrades, should they
  93. become available. If you have comments, questions, bug reports etc., please
  94. leave a message at my Compuserve or INTERNET address, or write to me via
  95. snail mail. I will endeavor to fix any problems you might encounter.
  96.  
  97. The software is supplied on an "as is" basis. You are free to distribute
  98. this software package provided that you distribute the ENTIRE package,
  99. including this documentation file. (This is necessary for others to be able
  100. to use it properly.  I've downloaded too many shareware packages that had
  101. been posted without accompanying documentation!).
  102.  
  103. I hope you find this package useful.
  104.  
  105.  
  106. Now to the fun stuff!
  107.  
  108.  
  109.         **************************************************
  110.  
  111. VIEW 
  112.  
  113. Usage:  view [d:][path][filename] [/a]
  114.  
  115. If you just type VIEW you will get a list of files on the current drive and
  116. directory, from which you can select the one to view. Similarly, if you
  117. type VIEW plus drive and directory parameters, you'll get a list of files
  118. on that drive and directory.
  119.  
  120. The /a switch, which MUST come after the filename, forces VIEW to display
  121. the file in stripped ASCII format. VIEW attempts to determine if a file
  122. is not a true word processor or text file, and forcs the ASCII display 
  123. acordingly. "Stripped" means the high order ASCII characters are omitted.
  124.  
  125. You can use the * wild-card character in a file name. Then you will get a
  126. list of files in the default or specified directory that match the * criteria.
  127.  
  128. e.g.  view *.doc   -  list of files with extension doc in the current
  129.                       directory
  130.  
  131.       view d:\docs -  list of all files on drive d, directory docs
  132.  
  133.       view d:\docs\*.txt  -  as above, but only files with extension txt
  134.  
  135.  
  136. Alternatively, you can specify a particular file:
  137.  
  138.       view c:\moredocs\readme.doc
  139.  
  140.       view c:\moredocs\another.one /a
  141.  
  142. If you do not specify a particular file, VIEW will allow you to select a
  143. new file from the list that meets your selection criteria.
  144.  
  145.  
  146. Using VIEW is pretty straightforward. Pressing F1 brings up a help menu,
  147. and the key features of the menu are permanently displayed on the bottom
  148. line.
  149.  
  150. Note that VIEW reads as much of a file as possible into memory, but if not
  151. all of a file can be read in it won't display the full file. This allows
  152. you to skip instantly to any part of the file in memory without disk reads.
  153. If you are not using DOS 5.0 or later, or a memory manager such as QEMM386
  154. or 386MAX, I strongly recommend you do so.
  155.  
  156. IMPORTANT: If you are running a DOS shell, the amount of memory available
  157. to VIEW may be much reduced. If you do have a file that is too big to fit
  158. into memory, there are two ways to proceed: first, if the file is not an
  159. ASCII one, convert it (see instructions for file selection menu). This
  160. usually reduces the size somewhat. Secondly, VIEW allows you to split the
  161. file into sequential ASCII components.
  162.  
  163. Note that if you have files with embedded graphics, the file size may be
  164. substantial - not to worry, VIEW will automatically bypass the graphics 
  165. information.
  166.  
  167. VIEW will automatically detect WordPerfect 5.0 and later, Microsoft Word and
  168. Windows WRITE formats.  However, you can override this by using the
  169. "/a" switch (see below).
  170.  
  171.  
  172. Flag usage: VIEW [drive][path]filename /x
  173.  
  174.                    where x =  a  -  force to display straight ASCII (i.e
  175.                                    without omitting formatting codes).
  176.  
  177.  
  178. ==============================================================================
  179.  
  180. THE VIEW SCREEN
  181.  
  182. The keys:
  183.  
  184. Navigate through the file using the cursor keys.  The right arrow scrolls
  185. right (what else?!), allowing you to view the ends of lines more than 80 
  186. characters long (e.g. WordPerfect files that use proportional fonts). Note
  187. that Word and Write files will automatically wrap before 80 columns.
  188.  
  189. F1       -  help menu; all menu items are avaliable directly from this menu
  190.             (i.e., while the menu is displayed, pressing F2 will activate
  191.             the appropriate function).
  192. F2       -  case-insensitive text search - matching text is shown in the
  193.             highlight color.
  194. Shift-F2 -  case-sensitive text search
  195. F3       -  find next occurrence of text defned by F2 or Shift-F2
  196. F4       -  toggle off text search
  197. F5       -  go to a particular line number
  198. F6       -  print all of file to printer or disk
  199. Shift-F6 -  this is a toggle for printing (to printer or disk) a block of
  200.             text. The first time you press Shift-F6, the current top line
  201.             is set as the beginning of the block.  The second time, the 
  202.             current top line is set as the end of the block, and the block
  203.             is printed to the location you specify.  While block select is
  204.             on, you will see a B at the bottom-left of the screen.
  205. F7       -  print all lines that specifically include or exclude a particular
  206.             text string
  207. F8       -  print screen
  208.             
  209. F6, Shift F6 and F7 all give you access to a user-defined function, which
  210.             causes the file you are viewing to be printed to a file called
  211.             viewcust.fil. It then calls a user-defined batch file (which you
  212.             must prepare) called  viewcust.bat.  The recommended use is to
  213.             print the file you are viewing in two columns using Tony Caine's
  214.             2COL (dot matrix) or JETCOL (laser printer) utilities. 
  215.             A sample viewcust.bat is included in this package. The function
  216.             produces a file called viewcust.fil that can be processed, via
  217.             viewcust.bat, by a calling function. Normally, this is deleted
  218.             when processing has finished. However, if you have not set aside
  219.             memory for the user-defined function (see configuartion, VW85CFG)
  220.             it is left on disk for you to process separately, if you wish.
  221.  
  222.                            IMPORTANT NOTE
  223.  
  224. If you are viewing a WordPerfect or Word file, it will not look
  225. the same as the version that you print from the word processing software.
  226. If the document uses a proportional font, or contains columns or tables,
  227. the appearance under VIEW will in all probability be different. This is 
  228. because of the way VIEW simplifies the formatting built into such documents.
  229. If VIEW were to be designed to show all formatting faithfully, it would be
  230. at least as big as the executable files used by the word processers
  231. themselves and would therefore lose its point as a quick viewer.
  232.  
  233. I have attempted to cover all formatting and embedded code possibilities,
  234. but with the power of both WordPerfect and Word, the possibilities are
  235. mind-boggling!  If you come across a file that does not seem to display
  236. properly - e.g. hangs mid-way through or displays garbage - please send it
  237. to me and I will attempt to fix the problem.
  238.  
  239. =============================================================================
  240.  
  241. THE FILE SELECTION MENU
  242.  
  243. If you have called VIEW without specifying a particular file, you have
  244. access to the file selection menu, which looks like this:-
  245.  
  246.  
  247. Currently in: F:\VIEW85\*.*  8 item(s)  (1 read)      
  248.  Use up and down arrows, PgDn, PgUp, Home, End to place file at top of window
  249.                               ┌──────────────┐                             
  250.       Press Enter to select »»│ file_id.diz  │«« this file or directory 
  251.                               │ view85.doc   │
  252.                               │ view85.exe   │        
  253.  UPPER CASE - directories     │ viewcust.bat │                   
  254.  lower case - files           │ vw85cfg.com  │                   
  255.                               │ distrib.doc  │                   
  256.  F1 - force ASCII display     │              │                   
  257.  F2 - normal display          │              │                   
  258.  F3 - convert/print directly  │              │                    
  259.  F4 - split file              │              │                   
  260.  Esc - exit to DOS            │              │                           
  261.                               │              │                           
  262.                               └──────────────┘                   
  263.                                                                                 
  264.                                                                           
  265.  
  266.  
  267.  
  268. Keys
  269.  
  270. Use the arrow and cursor keys to position the file you want to view, or
  271. the directory you want to change to, at the top of the file list.
  272.  
  273. Enter - view currently selected file OR change to currently selected
  274.         directory.
  275.  
  276. F1 - forces the file to be displayed as ASCII, without the high order
  277.      characters.  VIEW automatically selects this option for certain
  278.      types of files (e.g. EXE, COM, DLL files).
  279.  
  280. F2 - causes the file to be displayed without stripping the high order
  281.      characters (in fact, you should never need to use this!).  
  282.  
  283. F3 - allows you to convert a file to ASCII or print it directly without
  284.      viewing it, including via the user-defined function. 
  285.  
  286. F4 - allows you to split a file into sequential components in the same
  287.      directory. You choose  the filename; each sequential file increments
  288.      the last character of the filename extension by 1:  
  289.  
  290.           e.g. myfile.00a
  291.                myfile.00b
  292.                myfile.00c
  293.  
  294. This allows you to view the files rapidly in sequence when using the file
  295. menu. You specifyc the number of lines at which the original file should
  296. be split.
  297.  
  298. NOTE: these functions are only available from the file selection menu. If
  299.       you want to split the file hugefile.doc you should access it by
  300.       typing  view hugefile.*
  301.  
  302. F10 - tells you how many lines the current configuration can display, and
  303.       how much reserve memory you have. 
  304.  
  305.  
  306. ============================================================================
  307.  
  308.                        **** NEW IN VERSION 8.3 ****
  309.  
  310.             The following changes have been adopted:
  311.  
  312.             - VIEW allows you to view WordPerfect 6.0 files.
  313.  
  314.             - VIEW allows you to select files from a list, including
  315.               selecting a new file.
  316.  
  317.             - VIEW gives you access to a function you can define yourself.
  318.  
  319.  
  320.  
  321.                        **** NEW IN VERSION 8.4 ****
  322.  
  323.             The following changes have been adopted:
  324.  
  325.             - file selection menu enhanced to allow change directory,
  326.               print file, split file. Also, exiting from a file view now
  327.               brings you to the next file in the list.  The "n" key in 
  328.               8.3 is therefore no longer necessary.
  329.  
  330.             - Bug in "print lines containing specified text" (F7) has been
  331.               fixed.
  332.  
  333.             - A maximum number of files that can be read from the file 
  334.               selection menu has been set; the default can be changed by
  335.               the user.
  336.  
  337.  
  338.                        **** NEW IN VERSION 8.5 ****
  339.  
  340.             8.5 is basically the same as 8.4, but the memory allocation
  341.             method has been completely changed to prevent your system
  342.             from crashing. As part of this, 80 column word wrap has been
  343.             enabled for all files; this cannot be changed. 
  344.  
  345.  
  346. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  347.  
  348. VW85CFG
  349.  
  350. usage:  vw85cfg [filename]
  351.  
  352.         where filename is view.exe or an exact copy with some other file
  353.         name.
  354.  
  355. This program allows you to customize VIEW.EXE. 
  356.  
  357. Setting colors is self-explanatory.  However, VW85CFG also allows you to set
  358. some print parameters, such as number of lines per printed page, number of
  359. spaces to expand tabs, and number of spaces to leave for the left margin. 
  360.  
  361. It also allows you to choose whether the "delete file?" feature of
  362. VIEW is activated.  As a safety measure, the default is delete off. You can
  363. override this. Even with the feature on, a file will not
  364. be deleted until you have answered an "are you sure?" question.
  365.  
  366. Finally, VW85CFG allows you to override the default number of lines of
  367. display and display speeds.  VIEW as shipped is configured for normal
  368. display speed and hard coded to display 25 lines by 80 columns.  Try
  369. experimenting with the display parameters to get maximum benefit; if
  370. your system crashes - and there's a lot of non-standard hardware and BIOS
  371. software out there - just reconfigure VIEW to a lower display standard.
  372.  
  373. VW85CFG allows you to set the right margin for use with the word wrap
  374. feature.  The default is 12 - that is, VIEW counts characters per line and
  375. if it is within 12 of the rightmost screen column puts in a line feed if
  376. it finds a space.  This is not absolutely foolproof; you may find that
  377. setting the line wrap margin to greater than 12 gives better performance.
  378.  
  379. Next, VW85CFG allows you to change the default number of files that can
  380. be read in sequence from the file selection menu. Each time you read a file
  381. a small amount of memory is lost to the system (until you exit to DOS, when
  382. it is fully restored). To prevent memory allocation errors VIEW exits to
  383. DOS after a certain number of files have been read. The default is 50. If you
  384. wish to experiment with a higher number, you can do so via VW85CFG. Don't
  385. go above 100. If you find that your setting does cause a system freeze,
  386. just reduce the number. There is no "best" value - it depends on the amount
  387. of free RAM on your system, the nature and operations of any TSRs or memory
  388. managers you have running, etc.
  389.  
  390. Finally, VW85CFG allows you to reserve some memory for a user-defined
  391. function. When it loads, VIEW uses all available conventional memory for
  392. displaying files, in 80 column lines. You set aside memory for the user-
  393. defined function in 8000 byte blocks, equivalent to 100 lines of file. 
  394. There is a trade-off - the more memory you set aside for the user function,
  395. the fewer the lines before getting a "file too big" message. VIEW ships set
  396. for 112000 bytes reserved, enough for JETCOL. If you don't want a user-
  397. defined function, reduce this. You are asked to enter a number of 8000 byte
  398. blocks. You should enter at least 4 (VIEW needs some memory in reserve for
  399. other things).  TIP: to see how many lines can be displayed, and how many
  400. allocation units you have set, press F10 at the file selection menu.  If you
  401. have a low setting and you run into memory problems try increasing the
  402. reserve memory allocation.
  403.  
  404.  
  405. Malcolm Drury
  406. August 19th, 1993
  407.  
  408.  
  409. **************************************************************************
  410.  
  411.                          Look for the following shareware
  412.  
  413. VGAPAL40.ZIP - customize up to 4 VGA text color palettes, choosing from more
  414.              than 250,000 colors! (And see how many you can actually
  415.              discern!).  One palette can be used to create a small (2k) TSR
  416.              program that maintains your chosen scheme.  Alternatively, you
  417.              can set any of the palettes, or a grey-scale scheme, from a
  418.              non-TSR if memory is a problem.  (On CIS Ziffnet as vgacus.zip,
  419.              in ZNT:TIPS). BBS SEARCH: VGAPAL??.ZIP
  420.  
  421. DDIR92.ZIP -  double-column directory display that highlights new files,
  422.               flags system, hidden and read-only files, and optionally shows
  423.               the "dead" space on disk associated with each file or the total
  424.               space each file actually uses. Full file list sorting, and
  425.               can scroll back and forth within the file list. Has file
  426.               delete and protect/unprotect functions. (On Compuserve
  427.               Ziffnet as dirdpy.zip in forum ZNT:TIPS and PBSAPPS)
  428.               BBS SEARCH: DDIR??.ZIP
  429.  
  430. DSPACE61.ZIP - shows graphically hard disk space installed, used and free,
  431.                for all drives; second program shows graphically space on
  432.                designated drive (including floppy), and reports on installed
  433.                and available RAM, including XMS and EMS memory. (On CIS
  434.                Ziffnet as dskspc.zip, in ZNT:TIPS).
  435.                BBS SEARCH: DSPACE??.ZIP
  436.  
  437. IF YOU DO NOT FIND ANY OF THESE, LEAVE ME A MESSAGE!
  438.  
  439. CIS 70574,3457
  440. INTERNET drury@gsc.emr.ca
  441.  
  442. Malcolm Drury
  443. 11 Adele Crescent
  444. Nepean
  445. Ont.  K2J 2T7
  446. CANADA
  447.