home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / GRAFICOS / VIEW121.ZIP / VIEW121.DOC < prev    next >
Encoding:
Text File  |  1996-10-16  |  45.0 KB  |  1,077 lines

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