home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / dos / tools / view97a / view97a.doc < prev    next >
Text File  |  1994-10-30  |  37KB  |  874 lines
  1.  
  2.                             VIEW - the file viewer      ▌
  3.                                                         ▌
  4.                                 Version 9.7a            ▌
  5.                                                         ▌
  6.                           ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  7.  
  8.  
  9.      Note: this package contains the following files:
  10.  
  11.                      VIEW.EXE (file viewer version 9.7a)
  12.                      VW97ACFG.COM (customizer)
  13.                      VIEW97A.DOC  - this file
  14.                      NEWIN97A.DOC - history and new features
  15.                      TROUBLE.DOC - possible problems, and solutions
  16.                      HOWDOI.DOC  - tips for using VIEW
  17.                      (zipped with PKZIP 2.04g)
  18.  
  19.  
  20. NOTE: If you are using VIEW to read this file, you can go to any section by
  21. pressing the down arrow until the topic in the following list of contents
  22. is at the top of the display, then pressing Enter.  Pressing Enter again
  23. brings you back to the list of contents.
  24.  
  25.  
  26. CONTENTS
  27. ========
  28.  
  29. WHAT IS VIEW?
  30. THE FINE PRINT
  31. SHAREWARE - THE CONCEPT
  32. THE SUGGESTED CONTRIBUTION
  33.  - Pay only once!
  34.  - Multiple copies
  35. TECHNICAL SUPPORT
  36. OVERVIEW
  37.  - Command line switches
  38.  - Text search
  39.  - Wild cards
  40.  - Examples
  41. BOOKMARKS
  42. THE VIEW SCREEN
  43. PRINT FUNCTIONS
  44. IMPORTANT NOTE
  45. AUTOMATIC DETECTION OF FILE FORMATS
  46. THE FILE SELECTION MENU
  47. CUSTOMIZING VIEW
  48. 2COL
  49. JETCOL
  50. COMPUSERVE ADDRESS
  51. INTERNET ADDRESS
  52. MORE SHAREWARE
  53.  
  54.                       *************************************
  55.  
  56.  
  57. WHAT IS VIEW? ▌
  58. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  59.  
  60.  
  61. VIEW is a file viewing utility for DOS.
  62.  
  63. ■ It allows you to view and print files in the following formats:
  64.  
  65.    -  Wordperfect versions 5.0 to 6.0
  66.    -  Word for Windows versions 1.0 to 6.0
  67.    -  Word for DOS
  68.    -  Ami Pro
  69.    -  Wordstar
  70.    -  Windows Write files
  71.    -  Windows Notepad files (which use the ANSI character set)
  72.    -  Windows CLP (clipboard) text files
  73.    -  ASCII files
  74.    -  ANSI files (e.g. created under UNIX)
  75.    -  Compuserve mail and messages
  76.  
  77. ■ You can print or save all or part of the files viewed.
  78.  
  79. ■ You can print or save to file only those lines containing or omitting
  80.   specified text.
  81.  
  82. ■ Printing can be done directly via the compressed print routines 2COL and
  83.   JETCOL (if you have them).  These shareware programs by Tony Caine are
  84.   provided to those who register VIEW.  They allow you to print in multiple
  85.   columns using small but highly legible fonts. Highly recommended!
  86.  
  87. ■ Windows help files can be viewed via a link to an external program HLP2DOC
  88.   (which is a freeware utility available on many BBS and provided to those
  89.   who register VIEW).
  90.  
  91. ■ VIEW allows you to search for text strings (both case-sensitive and
  92.   case-insensitive), including across multiple files.
  93.  
  94. ■ You can also print or convert files to ASCII directly from the file
  95.   selection menu.
  96.  
  97. ■ You can convert between ASCII and ANSI.
  98.  
  99. ■ You can save files in a format suitable for importing into word
  100.   processors without a hard return at the end of every line.
  101.  
  102.  
  103. ■ You can convert or print file directly without viewing, using command
  104.   line switches.
  105.  
  106. ■ Together, VIEW and 2COL/JETCOL offer a powerful file printing utility
  107.   that can be run under a wide variety of DOS and Windows shells and file
  108.   managers.
  109.  
  110. ■ VIEW can be identified as the file viewer for a wide range of DOS and
  111.   Windows shells and file managers, including archive display programs.
  112.  
  113. ■ VIEW is ideal as a viewer for e-mail attachments.
  114.  
  115. ■ VIEW can be customized for display color, and also its printing,
  116.   display and memory features.
  117.  
  118.  
  119. Note: as shipped VIEW is configured NOT to use the Windows help file
  120. translator HLP2DOC.  You must have this utility in a directory that is
  121. referred to in your PATH statement.  The link to HLP2DOC can be enabled by
  122. using the configuration program VW97ACFG.
  123.  
  124.  
  125. THE FINE PRINT  ▌
  126. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  127.  
  128.  
  129. The author makes no warranty that the software in this package will work
  130. with your particular hardware configuration.  You use the programs entirely
  131. at your own risk, and the author will not be held liable for any damage
  132. caused to your hardware or software through their use, nor for any
  133. consequential damages, loss of earnings, or loss of life, limb, health,
  134. sanity or personal relationship.  Legalities aside, you should not run into
  135. difficulties with this software.
  136.  
  137.  
  138.  
  139. SHAREWARE - THE CONCEPT ▌
  140. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  141.  
  142.  
  143. These programs are distributed as shareware, AND ARE NOT CRIPPLED!!.  Nor
  144. do they contain "nag" screens.  (Editorial note: I don't support
  145. "crippleware" - I want to know EXACTLY what I'm expected to pay for!
  146. Crippleware is, in my opinion, like test driving a Mercedes that's been
  147. fitted with a lawnmower engine! There, that's said - but each to his own.)
  148.  
  149. You do not have to register as a user, nor are you under any
  150. obligation to buy the program(s).  However, they are not free, and in
  151. the spirit of shareware, you are requested to make a small
  152. donation to the author if you find the software in this package useful,
  153. and if you continue to use it after an evaluation period of 30 days. This
  154. would both fulfill your moral obligation and help ensure the viability of
  155. the shareware concept, from which we all benefit.
  156.  
  157.  
  158. THE SUGGESTED CONTRIBUTION ▌
  159. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  160.  
  161. The suggested contribution is $25 US ($30 Canadian, 12 pounds sterling),
  162. but less (or more!) would be fine.  Pay what you think the software is
  163. worth to you.  If you pay the recommended amount or more, I will send you a
  164. diskette with the latest version plus a selection of other shareware for
  165. you to evaluate, including Tony Caine's excellent 2COL and JETCOL utilities
  166. and some useful freeware programs.
  167.  
  168. Should you decide to make a contribution, please remit to:
  169.  
  170.                    Malcolm Drury
  171.                    11 Adele Crescent
  172.                    Nepean
  173.                    ON  K2J 2T7
  174.                    Canada
  175.  
  176. INTERNET ADDRESS    drury@gsc.emr.ca
  177. COMPUSERVE ADDRESS  70574,3457
  178.  
  179. Bank notes in your local currency would be fine, as would international
  180. money orders made out in US or Canadian dollars.  Thank you.  Please tell me
  181. where you got the software from and, most importantly, which version it is.
  182.  
  183.  - Pay only once!
  184.    ==============
  185.  
  186. IF YOU HAVE PREVIOUSLY PAID FOR AN EARLIER VERSION - THANKS, AND OF COURSE
  187. YOU ARE NOT EXPECTED TO PAY AGAIN.  YOUR INPUT, COMMENTS ETC.  ARE ALWAYS
  188. WELCOME.
  189.  
  190.  
  191.  - Multiple copies
  192.    ===============
  193.  
  194. Please contact me if you would like to negotiate a price for multiple
  195. copies. I accept purchase orders, but cannot accept credit card orders.
  196.  
  197.  
  198. TECHNICAL SUPPORT ▌
  199. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  200.  
  201. Please note that at the low contribution requested, I cannot provide DIRECT
  202. technical support, nor automatically send upgrades, should they
  203. become available. If you have comments, questions, bug reports etc., please
  204. leave a message at my Compuserve or INTERNET address, or write to me via
  205. snail mail.  I will endeavor to fix any problems you might encounter.
  206. Users who have paid may, of course, download future upgrades free of charge.
  207. I will never post a deliberately crippled version of VIEW, nor a version
  208. that has any kind of "nag" message.  I also guarantee to honor the
  209. suggested contribution for the version of VIEW you are registering in the
  210. event that the contribution requested has increased for the current
  211. version; you will also receive the current version.  I hope my pricing
  212. policy will compensate for the lack of direct technical support and mailing
  213. of upgrades.
  214.  
  215. The software is supplied on an "as is" basis. You are free to distribute
  216. this software package provided that you distribute the ENTIRE package,
  217. including this documentation file. (This is necessary for others to be able
  218. to use it properly.  I've downloaded too many shareware packages that had
  219. been posted without accompanying documentation!).
  220.  
  221. I hope you find this package useful.
  222.  
  223.  
  224. Now to the fun stuff!
  225.  
  226.             ******************************************************
  227.  
  228.  
  229. OVERVIEW ▌
  230. ▄▄▄▄▄▄▄▄▄▌
  231.  
  232.  
  233. Usage:
  234.  
  235. view [d:][path][filename] [/sw1] [/sw2] [/sw3] [/sw4]  [text string to find]
  236.  
  237.  
  238. where switches /sw1, /sw2, /sw3 and /sw4 can be:
  239.  
  240.           /mnnn
  241.           /wnnn
  242.           /cfilename.cnv
  243.           /print
  244.           /ansi
  245.      (in which nnn is a three digit number)
  246.  
  247. /mnnn          - set aside nnn memory allocation units (see below)
  248. /wnnn          - set line wrap to nnn
  249. /cfilename.cnv - convert selected file to filename.cnv directly (i.e.
  250.                  without viewing it)
  251. /print         - print selected file directly (without viewing it)
  252.  
  253. NOTE 1: you should not use both /c and /print; if you do, only the first
  254.         one to appear in the command line will be used.
  255.  
  256. NOTE 2: the order of the switches is unimportant (except regarding Note 1)
  257.  
  258. NOTE 3: if you use any of the switches, you MUST include at least a drive
  259.         letter on the command line.  If not VIEW will tell you something
  260.         like "can't find /m056".
  261.  
  262.  
  263. If you just type VIEW you will get a list of files on the current drive and
  264. directory, from which you can select the one to view. Similarly, if you
  265. type VIEW plus drive and directory parameters, you'll get a list of files
  266. on that drive and directory.  From the file selection menu, you can
  267. change to any directory on the drive, or to any other drive.  Note that
  268. VIEW supports the * wild card character.
  269.  
  270.  
  271.  - Command line switches
  272.  =======================
  273.  
  274.   /mnnn
  275.   =====
  276.  
  277. If you include the switch /mnnn you will be able to allocate more memory for
  278. use by JETCOL, 2COL or HLP2DOC (see below).  The more memory you allocate
  279. for these programs the less is available to VIEW for loading files.  If you
  280. only use JETCOL, 2COL or HLP2DOC occasionally you should leave the memory
  281. allocation at the default level and use the /mnnn switch when you do want
  282. to use them.  If you use them frequently, you should probably permanently
  283. allocate sufficient memory using the configuration program VW97ACFG.COM.
  284. See later in this information file for more information on running JETCOL
  285. and 2COL.
  286.  
  287.   /wnnn
  288.   =====
  289.  
  290. If you use the /wnnn switch the line wrap is set at a maximum of 132
  291. columns and a minimum of 20.  The number of columns you want is determine
  292. by "nnn" which MUST be a three digit number (e.g.  070, 120).  In this mode
  293. you can use the left and right arrow keys to scroll the display to the left
  294. and right.  This mode is useful if you want to print files for which the
  295. line wrap is greater than 80 - for instance, program listings.  Note that
  296. VIEW will also run in true 132 mode (i.e. 132 columns actually displayed
  297. on screen if you have a video adapter that allows that mode).
  298.  
  299. (NOTE: when you use the /wnnn switch, the help line at the bottom
  300. of the screen will refer to "Cursor arrows".  When it is not used the
  301. left and right arrow function are disabled and the help line refers to "Up
  302. and down arrows").
  303.  
  304.   /print
  305.   ======
  306.  
  307. To print a file directly use the /print switch.  The settings for number of
  308. lines per page, left column indent etc.  used are those you have configured
  309. for VIEW.
  310.  
  311.   /c
  312.   ==
  313.  
  314. To convert a file to ASCII directly, use the /c switch - that is, /c
  315. followed immediately by the name of the CONVERTED file.  For example, to
  316. write a converted file called myfile.cnv the format of the switch would be
  317. /cmyfile.cnv The name of the converted file can include a full path (drive
  318. and directory plus sub-directory) if you wish, or it could be an alternate
  319. printer port.
  320.  
  321.  /ansi
  322.  =====
  323.  
  324. Convert a file that uses the ANSI character set (e.g.  Windows Notepad) to
  325. ASCII.
  326.  
  327.  
  328.  - Text search
  329.   ============
  330.  
  331. The text string to find MUST come after the filename, and after any
  332. switches used.  It allows you to search for the string in all files
  333. viewer until the "text search" function is switched off (see later).  Text
  334. entered from the command line is assumed to be case-insensitive.
  335.  
  336.  - Wild cards
  337.    ==========
  338.  
  339. You can use the * wild-card character in a file name. Then you will get a
  340. list of files in the default or specified directory that match the
  341. * criteria.  Any string identified on the command line for the text
  342. search function will be active for all files specified by the wild
  343. card option (unless it is changed or switched off when viewing one
  344. of the files).
  345.  
  346.  
  347.  - Examples
  348.    ========
  349.  
  350.       view *.doc   -  list of files with extension doc in the current
  351.                       directory
  352.  
  353.       view d:\docs -  list of all files on drive d, directory docs
  354.  
  355.       view d:\docs\*.txt  -  as above, but only files with extension txt
  356.  
  357.       view myfile.doc this is a string  - open myfile doc and search for
  358.                                           "this is my string"
  359.  
  360.  
  361.       view myfile.doc /m060 - open file myfile.doc after allocating 60
  362.                               block of memory for use by JETCOL, 2COL or
  363.                               HLP2DOC
  364.  
  365.       view d: /m050 - list all files on root directory of drive d: after
  366.                       allocating extra memory.
  367.  
  368.       view *.txt /w132 - list all matching files and display them in
  369.                          emulated 132 column mode.
  370.  
  371.  
  372.       view myfile.doc /w120 /print - print the file myfile.doc directly,
  373.                                      using 120 column word wrap.
  374.  
  375.  
  376.       view another.doc /cnew.doc - convert "another.doc" and save
  377.                                    converted file as "new.doc"
  378.  
  379.       view d:\docs\*.doc another string - list all matching files, and as
  380.                                           each is opened look for "another
  381.                                           string".  This search is in
  382.                                           effect for all subsequent files
  383.                                           until it is switched off.
  384.  
  385.       view d:\docs\*.doc /w120 yet another string - display all matching
  386.                                                     files in emulated 120
  387.                                                     column mode, and look
  388.                                                     for the string "yet
  389.                                                     another string".
  390.  
  391. Note on text search: VIEW will only find matches in complete lines, i.e.
  392. it will not find text that has wrapped.  For example, if the text to find
  393. is "cat sat on the mat" it would find the following:
  394.  
  395. One fine day the cat sat on the mat and ate a rat.
  396.  
  397. but not:
  398.  
  399. One fine day, the cat sat on
  400. the mat and ate a rat.
  401.  
  402. Note that VIEW reads as much of a file as possible into memory, but if
  403. not all of a file can be read in it won't display the full file. This
  404. allows you to skip instantly to any part of the file in memory without
  405. disk reads. If you are not using DOS 5.0 or later, or a memory manager
  406. such as QEMM386 or 386MAX, I strongly recommend you do so. If a file is
  407. too big, an overflow file is created; you can switch quickly between the
  408. two. The overflow should, in most circumstances, allow you to see all of
  409. the original file, unless it is really big. If the file IS really big,
  410. you can convert it to ASCII (from the file selection menu) and then split it
  411. into smaller components using a text editor.  When you convert to ASCII
  412. from the file selection menu the entire file is converted even if it is too
  413. big to view via VIEW.
  414.  
  415. VIEW will automatically detect WordPerfect 5.0 and later, Microsoft Word,
  416. Ami Pro and Windows WRITE formats. It attempts to detect other files that
  417. may not be ASCII and gives you the opportunity to display them as straight
  418. ASCII, as Wordstar - i.e. with the high-order characters stripped
  419. out, or in preview mode, or in preview mode.  It will automatically force
  420. to ASCII certain standard types of non-ASCII file (e.g. EXE, COM, DLL etc.).
  421.  
  422. Using VIEW is pretty straightforward. Pressing F1 brings up a help menu,
  423. and the key features of the menu are permanently displayed on the bottom
  424. line.
  425.  
  426. Every feature is accessible directly from the view screen, or from the menu
  427. screen.
  428.  
  429.  
  430. BOOKMARKS  ▌
  431. ▄▄▄▄▄▄▄▄▄▄▄▌
  432.  
  433.  
  434. VIEW allows you to place up to 200 bookmarks in the text you are viewing.
  435. This allows you to move quickly to preset places in the text that you have
  436. chosen.  In addition, when reading in an ASCII file, VIEW assigns a
  437. bookmark to any form feed character it finds.  The form feeds are not
  438. actually displayed, but by setting a bookmark you can move quickly to any
  439. place in the text where they occur.  See the following section for a
  440. description of the keys assigned to bookmark functions (they are: Ins, the
  441. grey + key, the grey - key, Shift-F5, and F8).
  442.  
  443.  
  444.  
  445. THE VIEW SCREEN  ▌
  446. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  447.  
  448.  
  449. The keys:
  450.  
  451. Navigate through the file using the cursor keys (up and down arrows, left
  452. and right arrows if in "wide screen" mode, PgUp, PgDn, Home, End).
  453.  
  454. Ins -         insert a bookmark at the text currently displayed at the top of the
  455.               display.
  456.  
  457. Grey + key -  go to the next bookmark.  If you are at the last one, this
  458.               key moves to the first one (that is, cycles through the
  459.               bookmarks).  First, though, it repeats the bookmark you are
  460.               currently at in order to indicate that you are at the last
  461.               one.
  462.  
  463. Grey - key -  go to the previous bookmark.  If you are at the first one, this
  464.               key moves to the last one (that is, cycles through the
  465.               bookmarks). First, though, it repeats the bookmark you are
  466.               currently at in order to indicate that you are at the first
  467.               one.
  468.  
  469. Enter       - find text currently displayed at the top of the display area.
  470.               Use this function for going directly to topics listed in the
  471.               contents.  NOTE: The Enter key is a toggle.  Press it a
  472.               second time to return to the point at which it was first
  473.               pressed.
  474.  
  475.  
  476. F1       -  help menu; all menu items are available directly from this menu
  477.             (i.e., while the menu is displayed, pressing F2 will activate
  478.             the appropriate function for that key).
  479. F2       -  case-INSENSITIVE text search - matching text is shown in the
  480.             highlight color. Unless the string to find has been defined from
  481.             the command line, the first time you press F2 the string is
  482.             defined. Subsequent presses of F2 find the next occurrence.
  483. F3       -  as for F2, but for case-SENSITIVE text.
  484. F4       -  toggle text search OFF.
  485.  
  486. (NOTE: when the text search function is enabled an asterisk (*) appears at
  487.  the bottom right corner of the screen.)
  488.  
  489. F5       -  go to a particular line number
  490. Shift F5 -  go to a particular bookmark number
  491. F6       -  print all of file to printer or disk
  492. Shift F6 -  set or reset HP and HP compatible printers that use the PCL4
  493.             command set (portrait or landscape mode, normal or compressed
  494.             print). This includes a user-definable command.
  495. F7       -  print all lines that specifically include or exclude a
  496.             particular text string
  497. F8       -  clear all bookmarks
  498. F9       -  this is a toggle for printing (to printer or disk) a block of
  499.             text. The first time you press F9, the current top line
  500.             is set as the beginning of the block.  The second time, the
  501.             current top line is set as the end of the block, and the block
  502.             is printed to the location you specify.  While block select is
  503.             on, you will see a message at the bottom-left of the screen
  504.             telling you the starting line of the block.
  505.  
  506. F10      -  changes the character set of the file being displayed from ANSI to
  507.             ASCII.  If you print to file after this conversion is made, the
  508.             file you print will use the converted (i.e. ASCII) character
  509.             set.  This feature is useful for converting Windows NOTEPAD
  510.             files and others created with the ANSI set (e.g.  text files
  511.             created under UNIX).
  512.  
  513. Shift F10- changed the character set of the file being displayed from
  514.            ASCII to ANSI.  As with F10, files printed to disk will contain
  515.            the ANSI character set.
  516.  
  517. Space bar- leave menu without enabling any of the features.
  518.  
  519. If you have read in a large file that has resulted in a temporary overflow
  520. file being created, the following keys are also activated:
  521.  
  522. n         - move to overflow file  ("n" means "next")
  523. p         - move to original file  ("p" means "previous")
  524.  
  525. If you hear a "beep" the function is not currently activated (e.g. already
  526. in that file, or you have blocked off text but not yet printed it).
  527.  
  528. When in "overflow" mode an identifying letter appears at the bottom-left
  529. of the display. "p" means you are in the second level, i.e. overflow
  530. file, and "n" means you are in the top level, i.e. original file.
  531. Note that in the second level, you will be told that the file is ASCII, and
  532. called overflow.viw. Not to worry: it still contains the overflow from
  533. the file you called to read.  Pressing the letter takes you to the
  534. <p>revious or <n>ext part of the file.
  535.  
  536.  
  537.  
  538. PRINT FUNCTIONS  ▌
  539. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  540.  
  541. Note: for the print functions, you have the following choices:
  542.  
  543.  - print to printer
  544.  - save to file (and you can also use this for printing to an alternate
  545.    printer port - just use the port name as the name of the file to be
  546.    saved)
  547.  - print directly via 2COL or JETCOL
  548.  - save file in format suitable for importing into word processor (as far
  549.    as possible VIEW puts hard returns where they are needed and omits
  550.    them where they are not).
  551.  
  552.  
  553.  
  554. F6 - F9    allow you to print to file, to printer, or via 2COL/JETCOL. The
  555.            latter function produces a file called cainelnk.fil, which is
  556.            deleted when processing has finished.  If you have not set aside
  557.            memory for 2COL/JETCOL (see configuration, VW97ACFG) you can
  558.            simply write a file (converted to ASCII) to disk and process it
  559.            separately with 2COL or JETCOL.  Alternatively, you can load
  560.            VIEW with the /mnnn command to allow to to allocate (temporarily)
  561.            enough memory to run 2COL or JETCOL.
  562.  
  563. F6         print entire file. You can include line numbers if you wish.
  564.  
  565. F7         print only those lines containing or omitting a text string you
  566.            define.
  567.  
  568. F8         Allows you to access JETCOL or 2COL directly (assuming you have
  569.            them of course!) to print the entire file.
  570.  
  571.            Pressing F8 allows you to enter a command line for JETCOL or 2COL,
  572.            thereby allowing you to set switches individually.  You should
  573.            NOT enter a file name - VIEW does this for you, as it uses a
  574.            special ASCII file. The true file name will be added to the end
  575.            of the printout.  If JETCOL or 2COL do not exist in a directory
  576.            that your PATH statement specifies, you must include the full
  577.            path in your command line.
  578.  
  579.            Example:   c:\jetcol\jetcol -W70     - prints the file using
  580.            JETCOL, which is in directory c:\jetcol; the single W switch
  581.            is activated.
  582.  
  583.            If when you try to print via JETCOL or 2COL nothing happens
  584.            except that the display returns immediately to VIEW, one of
  585.            two things is the probable culprit. Either JETCOL/2COL has not
  586.            been found, or you have not set aside enough memory for
  587.            VIEW to link to JETCOL/2COL.  For the former, check that
  588.            you entered the path properly.  For the latter, reconfigure
  589.            VIEW using VW97ACFG.COM and set aside 50 or so "memory
  590.            blocks" (the configuration program will tell you when to do
  591.            this), or load VIEW with the /mnnn command.
  592.  
  593.  
  594. F9         This key is a toggle to allow you to select a block of text for
  595.            printing.  The first time you press it the block starts at the
  596.            line currently at the top of the display; the second time the
  597.            line at the top is the end of the block.  Once selected, the
  598.            block can be printed as for the F6 key.
  599.  
  600.  
  601. IMPORTANT NOTE   ▌
  602. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  603.  
  604.  
  605. If you are viewing anything other than a straight ASCII or ANSI file, it
  606. will not look the same as the version that you print from the word processing
  607. software. If the document uses a proportional font, or contains columns
  608. or tables, the appearance under VIEW will in all probability be different.
  609. This is because of the way VIEW simplifies the formatting built into such
  610. documents. If VIEW were to be designed to show all formatting faithfully,
  611. it would be at least as big as the executable files used by the word
  612. processors themselves and would therefore lose its point as a quick viewer.
  613.  
  614. I have attempted to cover all formatting and embedded code possibilities,
  615. but with the power of WordPerfect, Word and Ami Pro, the possibilities
  616. are mind-boggling!  If you come across a file that does not seem to
  617. display properly - e.g. hangs mid-way through or displays garbage -
  618. please send it to me and I will attempt to fix the problem.
  619.  
  620. Note that Wordstar files may contain some extraneous characters,
  621. including "dot commands" such as .PA - however, they should
  622. certainly be readable.
  623.  
  624.  
  625.  
  626. AUTOMATIC DETECTION OF FILE FORMATS ▌
  627. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  628.  
  629. VIEW will automatically detect Word, Ami Pro, Windows Write, WordPerfect,
  630. Windows clipboard (CLP), Windows help files and ASCII files.  For others,
  631. it may tell you that the format is unknown, and give you some options:
  632.  
  633.  ┌──────────────────────────────────────────────────────────────────────────┐
  634.  │       Undetermined file format - please select display option:           │
  635.  │F1 show as ASCII   F2 - assume Wordstar  F3 preview   F4  don't view      │
  636.  │        Suggest F3 if you have not previously viewed this file            │
  637.  └──────────────────────────────────────────────────────────────────────────┘
  638.  
  639. F1 - means show the file as if it were a true ASCII file.  VIEW will
  640.      automatically assign certain types of file (e.g.  EXE, COM, BIN,
  641.      DLL) to this display mode.
  642.  
  643. F2 - means assume the file is Wordstar, and show it as a 7-bit ASCII
  644.      file (i.e. with high-order characters converted to the appropriate
  645.      low-order).  VIEW alerts you to the fact that the file MAY be
  646.      Wordstar.
  647.  
  648. F3 - means show the    file with high-order characters omitted.  Useful for
  649.      scanning for text strings and previewing files of unknown format.
  650.  
  651. F4 - means don't try to show the file.
  652.  
  653. If you choose F1 or F2, you will be asked which line wrap you want - that
  654. coded directly into the file, or the VIEW default.  You should choose
  655. the former first, as it will be appropriate for files with fewer than 80
  656. characters per line.  If the file has more than 80 characters per line,
  657. however, this display will cause lines to break within words.  In that
  658. case, try choosing VIEW's defaults. Just go with whichever suits you!
  659.  
  660.  
  661.  
  662. THE FILE SELECTION MENU ▌
  663. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  664.  
  665.  
  666. If you have called VIEW without specifying a particular file, you have
  667. access to the file selection menu, which looks like this:-
  668.  
  669.  
  670.                     D:\VIEW97A\*.*  -  9 item(s)  (0 read)
  671.     Keys:   PgDn PgUp Home;  Enter - select;  Esc - exit;   F1 - help
  672.      ASCII line wrap OFF
  673.    ┌───────────────────────────────────────────────────────────────────────┐
  674.    │ ..                                                                    │
  675.    │ file_id.diz                                                           │
  676.    │ newin97a.doc                                                          │
  677.    │ trouble.doc                                                           │
  678.    │ view.exe                                                              │
  679.    │ view9a7.doc                                                           │
  680.    │ vw97acfg.com                                                          │
  681.    |                                                                       |
  682.    │                                                                       │
  683.    └───────────────────────────────────────────────────────────────────────┘
  684.  ┌───────────────────────────────────────────────────────────────────────────┐
  685.  │UPPER CASE - directories   lower case - files   m - show memory parameters │
  686.  │F2 - set line wrap   F3 - toggle ASCII line wrap on/off   F4 - Wordstar    │
  687.  │F5 - preview mode  F6 - convert/print   F7 - new drive   F10 - ANSI on/off │
  688.  └───────────────────────────────────────────────────────────────────────────┘
  689.  
  690. THE KEYS:
  691.  
  692. Use the arrow and cursor keys to scroll through the list of files, and
  693. press Enter to view the highlighted file or to change to the highlighted
  694. directory.
  695.  
  696. F1 - brings up a help menu
  697.  
  698. F2 - allows you to change the column at which lines wrap.
  699.  
  700. F3 - toggles line wrap on and off.  When toggled OFF, line wrap occurs
  701.      according to the file's setting and ignores VIEW's setting.  In
  702.      this mode, lines in ASCII and Wordstar files may wrap within words.
  703.      When toggled ON VIEW prevents (as far as possible) breaks
  704.      appearing within words.  You can use this feature to reformat ASCII
  705.      files; for example, to change the width of lines.
  706.      NOTE: line wrap toggle is only used for ASCII or pseudo-ASCII
  707.      (e.g.  Wordstar) files.  It has no effect on WordPerfect, Word
  708.      etc. files.
  709.  
  710. F4 - tells VIEW to treat the file as Wordstar.
  711.  
  712. F5 - tells VIEW to treat the file as "unknown format".  High-order
  713.      characters are stripped out and error trapping routines are initiated
  714.      during the file read (e.g. missing end-of-file)
  715.  
  716. F6 - allows you to convert a file to ASCII or print it directly without
  717.      viewing it, including via 2COL/JETCOL.
  718.  
  719. Shift F6 - allows you to reset HP and HP-compatible printer mode for those
  720.            printers that recognize the PCL4 command set.
  721.  
  722. F7 - allows you to change to another drive.  A list of available drives is
  723.      displayed.  Just type in the drive letter you want and press "Return".
  724.      Note: this function default the file listing parameter to *.*, i.e.
  725.      it results in all files on the drive and directory shown being listed.
  726.  
  727. F10- the next file to be viewed will have its character set converted from
  728.      assumed ANSI (e.g.  Windows NOTEPAD) to ASCII.  F10 is a toggle -
  729.      press it a second time and this feature is switched off.
  730.  
  731. m  - tells you how many display lines are available and how many 2000 byte
  732.      memory blocks you have set aside.
  733.  
  734. Esc- exit to DOS
  735.  
  736.  
  737.  
  738.  
  739. CUSTOMIZING VIEW  ▌
  740. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  741.  
  742.  
  743. VW97ACFG
  744.  
  745. usage:  vw97acfg [filename]
  746.  
  747.         where filename is view.exe or an exact copy with some other file
  748.         name.  If the wrong version of VIEW is found, VW97ACFG will
  749.         tell you so.  NOTE: you may wish to rename this file to something
  750.         like vwcfg.com
  751.  
  752. This program allows you to customize VIEW.EXE.
  753.  
  754. Setting colors is self-explanatory.  However, VW97ACFG also allows you to set
  755. some print parameters, such as number of lines per printed page, number of
  756. spaces to expand tabs, and number of spaces to leave for the left margin.
  757.  
  758. After setting colors, VW97ACFG allows you to override the default number of
  759. lines of display and display speeds.  VIEW as shipped is configured
  760. for normal display speed and hard coded to display 25 lines by 80 columns.
  761. Try experimenting with the display parameters to get maximum benefit; if
  762. your system crashes - and there's a lot of non-standard hardware and BIOS
  763. software out there - just reconfigure VIEW to a lower display standard.
  764.  
  765. Next, you to choose whether the "delete file?" feature of VIEW is
  766. activated.  As a safety measure, you may wish to set this to "off".  Even
  767. with the feature on, a file will not be deleted until you have
  768. answered an "are you sure?" question.  Protected (read-only) files cannot
  769. be deleted directly from VIEW.
  770.  
  771. You can also configure some display and print parameters - the number of
  772. lines per printed page, the default printer port, and the offset from the
  773. left margin or printed output.
  774.  
  775. VW97ACFG allows you to set the column at which lines wrap.  The default is
  776. 66 - that is, VIEW counts characters per line and if it is within 14 of
  777. the rightmost screen column puts in a line feed if it finds a space.  This
  778. is not absolutely foolproof; you may find that setting the line wrap column
  779. to less than 66 gives better performance.  (NOTE: you can temporarily
  780. over-ride the default setting from the file selection menu).
  781.  
  782. Next, VW97ACFG allows you to change the default number of files that can
  783. be read in sequence from the file selection menu. Each time you read a file
  784. a small amount of memory is lost to the system (until you exit to DOS, when
  785. it is fully restored). To prevent memory allocation errors VIEW exits to
  786. DOS after a certain number of files have been read. The default is 50. If you
  787. wish to experiment with a higher number, you can do so via VW97ACFG. Don't
  788. go above 100. If you find that your setting does cause a system freeze,
  789. just reduce the number. There is no "best" value - it depends on the amount
  790. of free RAM on your system, the nature and operations of any TSRs or memory
  791. managers you have running, etc.  You should have no problems going with the
  792. default of 50.
  793.  
  794. Finally, VW97ACFG allows you to reserve some memory for use by 2COL
  795. or JETCOL.  When it loads, VIEW uses all available conventional memory
  796. for displaying files, in 80 column lines.  You must set aside memory for
  797. 2COL or JETCOL, in 2000 byte blocks, equivalent to 25 lines of file.
  798. There is a trade-off - the more memory you set aside for
  799. 2COL/JETCOL, the fewer the lines before getting a "file too big" message.
  800. Currently, 2COL and JETCOL require you to reserve about 50 blocks;
  801. if you don't want direct access to them you can reduce this.  However,
  802. VIEW itself needs some memory in reserve.  When asked to enter a
  803. number of 2000 byte blocks, you should enter at least 10, and
  804. probably 13 or 14, and at least 48 for access to 2COL and JETCOL.
  805. You may need to experiment a little to find the minimum number of
  806. memory blocks you need to allocate, as this will depend to some
  807. extent on how much conventional memory your computer has available.
  808. PLEASE READ THE ACCOMPANYING FILE "TROUBLE.DOC" FOR MORE INFORMATION
  809. ON THIS TOPIC.
  810.  
  811. SUGGESTION: Configure two versions of VIEW, one with and one without
  812. 2COL/JETCOL access.
  813.  
  814. Malcolm Drury
  815. October 29th, 1994
  816.  
  817.  
  818.  
  819.  
  820. **************************************************************************
  821.  
  822. MORE SHAREWARE
  823. ==============
  824.  
  825.             Look for the following shareware on Compuserve/Ziffnet or your
  826.             favorite BBS.  I post it as ZIP files, but it may also appear
  827.             as ARJ (or other format) files if re-posted by others.
  828.  
  829. VGAPAL40.ZIP - customize up to 4 VGA text color palettes, choosing from more
  830.                than 250,000 colors! (And see how many you can actually
  831.                discern!).  One palette can be used to create a small (2k) TSR
  832.                program that maintains your chosen scheme.  Alternatively, you
  833.                can set any of the palettes, or a grey-scale scheme, from a
  834.                non-TSR if memory is a problem.  (On CIS Ziffnet as vgacus.zip
  835.                in ZNT:TIPS). BBS SEARCH: VGAPAL??.*
  836.  
  837. DDIR98A.ZIP  - double-column directory display that highlights new files,
  838.               flags system, hidden and read-only files, and optionally shows
  839.               the "dead" space on disk associated with each file or the total
  840.               space each file actually uses. Full file list sorting, and
  841.               can scroll back and forth within the file list. Has file
  842.               delete and protect/unprotect functions.  Links to VIEW,
  843.               LIST and VPIC.  Also archive/unarchive files via libks to
  844.               PKZIP/PKUNZIP, ARJ and LHA.  (On Compuserve Ziffnet as
  845.               dirdpy.zip in forum ZNT:TIPS) BBS search: DDIR??.*
  846.  
  847. DSPACE64.ZIP - shows graphically hard disk space installed, used and free,
  848.                for all drives; second program shows graphically space on
  849.                designated drive (including floppy), and reports on installed
  850.                and available RAM, including XMS and EMS memory. (On CIS
  851.                Ziffnet as dskspc.zip, in ZNT:TIPS).
  852.                BBS SEARCH: DSPACE??.*
  853.  
  854. IF YOU DO NOT FIND ANY OF THESE, SEND ME A MESSAGE! USERS WHO REGISTER
  855. VIEW WILL RECEIVE THESE (OR THE LATEST VERSIONS).
  856.  
  857. You can also search your favorite BBS for 2COL and JETCOL.  Use the search
  858. terms 2COL????.* and JETCOL??.* Current versions are 2COL 5.4 and JETCOL
  859. 3.4.
  860.  
  861. Compuserve 70574,3457
  862. INTERNET drury@gsc.emr.ca
  863.  
  864. Malcolm Drury
  865. 11 Adele Crescent
  866. Nepean
  867. Ont.  K2J 2T7
  868. CANADA
  869.  
  870.  
  871. ==============================================================================
  872.  
  873.   This document was prepared using the BOXER (TM) text editor version 6.0a
  874.