home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 February / PCWK0296.iso / sharewar / os2 / tekst / hypview / readme.doc < prev    next >
Text File  |  1995-08-04  |  15KB  |  341 lines
  1.                               HyperView
  2.                              Version 2.2
  3.  
  4.  
  5.               Copyright 1994, 1995 by Michael H. Shacter
  6.                          10309 Parkwood Drive
  7.                    Kensington, Maryland 20895-4041
  8.  
  9. HyperView is a high performance file viewer with special features for
  10. isolating and extracting information from word processing and text
  11. files.  It reads popular word processing formats, ASCII text files,
  12. and files compressed in the ZIP format.  HyperView is blazingly fast
  13. and easy to use.
  14.  
  15. HyperView lets you focus quickly on pertinent information by
  16. automatically tagging lines that match search criteria.  Lines of text
  17. may also be tagged and untagged manually.  There is no limit on the
  18. number of lines that can be tagged.  Tagged lines may then be viewed
  19. in condensed or split screen views.  These powerful features let you
  20. easily create a hyperview into your document.
  21.  
  22. There is no learning curve involved in trying the program.  Its power
  23. is packaged in a deceptively simple package.  From a user's
  24. perspective, it works like any other file viewer.
  25.  
  26. These are some of HyperView's features:
  27.  
  28.  ■ Automatically recognizes and reads popular word processing formats,
  29.    including:  Ami Pro, Clearlook, DeScribe (versions 2 through 5),
  30.    Microsoft Word for Windows (all versions) and WordPerfect (versions
  31.    5.x and 6.x).
  32.  
  33.  ■ Automatically recognizes compressed files in the ZIP format.  Works
  34.    in tandem with Info-ZIP's UNZIP.EXE to view compressed files
  35.    directly, without making a copy on your hard drive.  Compressed
  36.    files with long file names and names with spaces may be viewed even
  37.    on non-HPFS drives.  Encrypted archives are also supported (you
  38.    supply the password).
  39.  
  40.  ■ Tag and untag lines of text (a) automatically, from the search
  41.    dialog, and (b) manually, by pressing the space bar.
  42.  
  43.  ■ View files in full screen, condensed, or split screen views.
  44.  
  45.  ■ View files in hex format.
  46.  
  47.  ■ Loads files almost instantaneously.
  48.  
  49.  ■ Blazingly fast searches.
  50.  
  51.  ■ Tagged lines may be copied or appended to the OS/2 clipboard or to
  52.    a file.
  53.  
  54.  ■ All or part of a file may be gathered and copied or appended to the
  55.    OS/2 clipboard or to a file.
  56.  
  57.  ■ Directory listing to pick file for viewing and to navigate file
  58.    system.
  59.  
  60.  ■ Adjustable right margin for stripped ASCII and word processing
  61.    files.
  62.  
  63.  ■ Searches may cross line boundaries when working with word
  64.    processing and stripped ASCII files.
  65.  
  66.  ■ Ability to read from standard input on startup.
  67.  
  68.  ■ May be started from the OS/2 DOS command line or a DOS program
  69.    running in an OS/2 DOS session (VDM).
  70.  
  71.  ■ Supports long file names and names with spaces.
  72.  
  73.  ■ Case insensitive searches may be performed in any language.
  74.  
  75.  ■ Commands may be invoked without the use of shifted keystrokes.
  76.  
  77.  ■ Perfect for reading files when you must boot off a floppy or when
  78.    you run OS/2 without Presentation Manager.
  79.  
  80. This README file contains a brief description of HyperView.  It should
  81. be sufficient for most reasonably proficient computer users.  The
  82. accompanying User Reference Guide (HV.DOC) presents a complete
  83. explanation of all HyperView features and their usage.  HyperView
  84. offers some unique features for managing textual information.
  85. Consequently, regardless of your proficiency level, time spent
  86. perusing the manual may still prove rewarding.
  87.  
  88. HyperView is user supported software.  It is not free.  Information
  89. concerning registration and licensing of HyperView may be found at the
  90. end of the User Reference Guide in the section entitled
  91. "REGISTRATION".  Please also refer to the files BMT.FRM and
  92. REGISTER.FRM.  In brief, there is a $35 fee to register HyperView.
  93. For business use, each person using HyperView at a site must be
  94. registered.  Volume discounts are available.
  95.  
  96.  
  97.                             [Installation]
  98.  
  99. The following files are included in the HyperView package:
  100.  
  101.  HV.EXE                       HyperView program
  102.  HVAUX.EXE                    HyperView auxiliary program
  103.  HV.ICO                       HyperView icon
  104.  HV.DOC                       User Reference Guide
  105.  README.DOC                   This file
  106.  BMT.FRM                      Register by credit card with BMT Micro
  107.  REGISTER.FRM                 Register with author by check
  108.  WHATS.NEW                    List of enhancements
  109.  WHERE                        Where to find current version
  110.  FILE_ID.DIZ                  BBS description
  111.  
  112. There are no special requirements for installing HyperView.  Simply
  113. copy HV.EXE, HVAUX.EXE and HV.ICO to a convenient directory.  Please
  114. note that all three files *must* be located in the same directory.
  115. You will probably find it most practical to place HyperView in a
  116. directory on your path.  If you are upgrading from an earlier version
  117. of HyperView, be sure to replace the older copies of both HV.EXE and
  118. HVAUX.EXE.
  119.  
  120. To view a compressed file in a ZIP archive, you must have a copy of
  121. the OS/2 version of Info-ZIP's UNZIP.EXE.  As of the date of this
  122. release, the most current version of UnZip is 5.12.  UNZIP.EXE must be
  123. located in a directory on your path.  It is especially important to
  124. remember this requirement when you run HyperView after booting from a
  125. floppy or after using Warp's Alt-F1 startup option.  In either case,
  126. the system uses an alternative CONFIG.SYS, which may not include your
  127. customary path statement.
  128.  
  129. You may also wish to create a HyperView object on your desktop.
  130.  
  131.  
  132.                          [Starting HyperView]
  133.  
  134. The easiest way to start HyperView is from the Workplace Shell.  Drag
  135. the icon of a file you wish to view and drop it on the HyperView icon.
  136.  
  137. You may also start HyperView from any OS/2 command prompt.  The full
  138. syntax for starting HyperView is:
  139.  
  140.      HV [options] [filespec]
  141.  
  142. Filespec refers either to (1) a file name, in which case HyperView
  143. will load the file at startup, or (2) a path, in which case HyperView
  144. will open with a listing of file in the designated directory.  The
  145. path may be further limited by supplying a file mask.  For example,
  146. the path "C:\DeScribe\Data" would result in a directory list of all
  147. files (*.*) in the C:\DeScribe\Data directory.  Alternatively, the
  148. path "C:\DeScribe\Data\*.doc" would result in a directory list of all
  149. files with the .DOC extension (*.doc) in the C:\DeScribe\Data
  150. directory.
  151.  
  152. HyperView recognizes HPFS long file names.  There is no need to place
  153. quotes around long file names with embedded spaces.  If you do use
  154. quotes (through force of habit) place them around the entire file
  155. specification--not just the file name.
  156.  
  157. If a filespec is omitted at startup, HyperView will open with the
  158. current directory.  When HyperView cannot locate a file specified on
  159. the command line, rather than give a "file not found message", it will
  160. display a listing of the directory in which the file should be
  161. located.
  162.  
  163. From the directory listing you may select a file to view or navigate
  164. through your files.  For more information on using this feature,
  165. please see the section entitled "Files".
  166.  
  167.  
  168.                         [Command Line Options]
  169.  
  170. For your convenience, the following options are available when
  171. starting HyperView.  Notice that each option consists of a slash ("/")
  172. followed by a letter.  The letter may be upper- or lower-case.  All
  173. options must precede the filespec on the command line.
  174.  
  175. /F   Start HyperView in a full screen OS/2 session
  176. /W   Start HyperView in a windowed OS/2 session
  177. /M   Force HyperView to use monochrome
  178. /C   Force HyperView to use color (when it mistakenly
  179.      thinks you have a monochrome monitor)
  180. /A   Use alternative color scheme
  181. /R   Raw (do not convert word processing files)
  182. /B-  Force clipboard feature off
  183. /B+  Force clipboard feature on
  184. /Lnn Lines of text, where "nn" is a number from between 25 and 60.
  185.  
  186. If the /L command option is not employed, HyperView will automatically
  187. adjust to the number of rows on your display, which may be any value
  188. from 25 to 60.
  189.  
  190. HyperView may also be used with any program that allows the
  191. designation of an external file viewer.
  192.  
  193.  
  194.                [Starting HyperView From a DOS session]
  195.  
  196. HyperView may also be started from an OS/2 DOS session (i.e. from a
  197. VDM).  The same syntax is used to start HyperView from a VDM as from
  198. the OS/2 command line.  When started from a VDM, HyperView will
  199. default to OS/2 full screen display mode.  If you prefer to start
  200. HyperView in an OS/2 window, add the "/W" option to the command line.
  201.  
  202.  
  203.                           [Using HyperView]
  204.  
  205. Although HyperView offers advanced features, it utilizes a
  206. conventional user interface, requiring little, if no, effort to learn.
  207. In deference to those who have difficulty managing shifted keystrokes,
  208. virtually all HyperView commands can be accessed without using shifted
  209. keystrokes.
  210.  
  211. HyperView displays in one of three views.  In full screen view, all
  212. lines of text are displayed.  Tagged lines are differentiated with a
  213. distinctive color.  Condensed view is restricted to lines that have
  214. been tagged.  In split screen view, tagged lines are displayed in the
  215. upper screen.  The lower screen shows in context whichever line is
  216. highlighted in the upper screen.  The latter two views (condensed and
  217. split screen) are only  available when one or more lines have been
  218. tagged.
  219.  
  220. Lines may be tagged either (1) automatically with the search and tag
  221. feature of the Search Dialog, or (2) manually  with the space bar.
  222. Once a line is tagged, it remains tagged until untagged with the Clear
  223. Tags command or with the space bar.  Available command options are
  224. summarized below.  HyperView letter commands may be either upper- or
  225. lower-case.
  226.  
  227. The following commands are available in Full Screen view:
  228.  
  229.   Key                         Function
  230.  
  231. File Functions
  232.   <N>                         New File
  233.   <F5>                        Directory (Dialog)
  234.   <\>                         Directory (Express)
  235.   <F3>                        Exit (Confirm)
  236.   <Alt-F4>                    Exit (Leave screen)
  237.   <Alt-X>                     Exit (& CLS)
  238.  
  239. Edit Functions
  240.   <G>*                        Gather text to file or clipboard
  241.   <L>                         List tagged lines to file or clipboard
  242.   <Space>                     Tag/Untag line
  243.   <C>                         Clear tagged lines
  244.  
  245. Search Functions:
  246.   <S> ) Search                Search
  247.   <F> )  Dialog               Search Forward
  248.   <B> )                       Search Back
  249.   <+>, <=>                    Repeat Last Search Forward
  250.   <->                         Repeat Last Search Back
  251.   <J>                         Jump to line number
  252.  
  253. View Functions
  254.   <Enter>                     Full Screen
  255.   <Enter>/<F10>               Condensed
  256.   <CtrlEnter>/<F9>            Split Screen
  257.   <H>                         Hex toggle
  258.   <R>                         Right Margin
  259.   <W>                         Word wrap toggle
  260.   <T>                         Tab expansion toggle
  261.  
  262. Cursor Movement
  263.   <Up>                        Cursor Up
  264.   <Down>                      Cursor Down
  265.   <PgUp>                      Screen Up
  266.   <PgDn>                      Screen Down
  267.   <Home>**                    Top of File
  268.   <End>                       End of File
  269.   <Left>                      Screen Left 1 column
  270.   <Right>                     Screen Right 1 column
  271.   <CtrlLeft>                  Screen Left 5 columns
  272.   <CtrlRight>                 Screen Right 5 columns
  273.  
  274.  * Gather operations may also be commenced by holding down the shift
  275. key in combination with one of the cursor keys (Up, Down, PgUp, PgDn,
  276. Home or End).
  277.  
  278. ** When the screen has been scrolled right, the home key first returns
  279. the display to the beginning of the line.
  280.  
  281. Where appropriate, HyperView utilizes dialogs to solicit user input.
  282. The dialogs operate in the conventional manner.  Their usage is
  283. detailed in the User Reference Guide.
  284.  
  285.  
  286.                                [Files]
  287.  
  288. You can use HyperView's directory listing to select a file to view.
  289. The directory listing may be accessed by pressing "\" or by pressing
  290. Escape from full screen view.  In either case, HyperView takes you
  291. directly to the directory of the current file, positioning the cursor
  292. bar on the current file.
  293.  
  294. You may also access a directory listing by pressing F5, in which case
  295. the Files dialog will prompt you for a filespec.   The initial
  296. filespec will be for all files (*.*) in the current directory on the
  297. current drive.  The filespec may be changed by editing the current
  298. filespec or by typing a new one.  As explained in the manual, it is
  299. not necessary to enter a full filespec.  HyperView makes assumptions
  300. about any missing information.
  301.  
  302. HyperView will remember any changes you make to the mask component of
  303. the filespec.  Thus, if you change the mask to "*.doc", HyperView will
  304. remember the change each time you change a directory from the Files
  305. directory listing or call the Files dialog.  To change the mask again,
  306. or to revert back to "*.*", edit the mask appropriately or simply type
  307. the new mask by itself.  The file mask is limited to 30 characters.
  308. Any excess characters will be truncated.
  309.  
  310. To load a file, position the cursor on the file name and press Enter.
  311. A file may also be loaded in a new HyperView session by pressing
  312. Ctrl-Enter (or F9).
  313.  
  314. To change to a new directory, position the cursor bar on the
  315. appropriate directory name and press Enter.  To move to the parent
  316. directory (if any) of the current subdirectory, press Backspace or
  317. position the cursor on the ".." entry and press Enter.  To change to a
  318. new drive, press Ctrl and the key of the drive (i.e. Ctrl-A, for drive
  319. A:, Ctrl-C, for drive C:, etc.).  Pressing the first letter of a
  320. directory or file name will advance the cursor bar to the next entry
  321. beginning with that letter.
  322.  
  323.  
  324.                          [Viewing ZIP Files]
  325.  
  326. HyperView automatically recognizes compressed archives in the ZIP
  327. format.  When you select a ZIP file, HyperView will present a
  328. directory listing the contents of the ZIP file.
  329.  
  330. In general, HyperView's ZIP directory is sorted by file name.  A ZIP
  331. archive containing directory information, however, will be sorted
  332. first by path and then by file name.  The path of the compressed file
  333. (if any) will be displayed at the top of the screen.
  334.  
  335. To view a compressed file, position the cursor bar on the file name
  336. and press Enter.  Working in tandem with the Info-ZIP group's
  337. UNZIP.EXE, HyperView will load the file just as it would an
  338. uncompressed file.  A compressed file in one of HyperView's supported
  339. word processing formats, will be converted automatically.
  340.  
  341.