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