═══ 1. HyperView PM Overview ═══ HyperView is a high performance file viewer with special features for isolating and extracting information from word processing and text files. It reads popular word processing formats, HTML files, OS/2 .INF and .HLP files, ASCII text files, and files compressed in the ZIP format. HyperView is blazingly fast and easy to use. HyperView lets you focus quickly on pertinent information by automatically searching and tagging lines of text. Lines of text may also be tagged and untagged manually. There is no limit on the number of lines that can be tagged. Tagged lines may then be viewed in a Condensed View Window. When a tagged line is highlighted in the Condensed View Window, it is displayed simultaneously with its surrounding text in the Main Text Window. This powerful feature lets you easily create a hyperview into your document. For additional information, try the quick tutorial. HyperView may be run as a stand-alone application or as an external file viewer for use with your favorite file manager. Context-sensitive help is available anywhere in HyperView by typing F1. ═══ 1.1. Quick Tutorial ═══ To get a quick feel for HyperView's capabilities, try this quick tutorial. Open the file HVPM.HLP. (That is correct. HVPM.HLP is the help file you are now viewing.) The first thing to notice is that HyperView converted the help file to text. HyperView views not only .INF and .HLP files; it also views ASCII files, word processing files, HTML files, and compressed files in ZIP archives. Type F (or f) to bring up the Search Dialog and start a search in the forward direction. In the text box type example. Now push the TAG push button (or type CTRL+ENTER). Scroll through the Main Text Window using the cursor keys or the scroll bar. Notice that each line containing the search phrase example is highlighted. Press TAB to switch to the Condensed View Window. HyperView isolates only those lines containing the search phrase. (If you had previously tagged any lines of text, they would also appear in the Condensed View Window.) Try navigating through the Condensed View Window and watch what happens in the Main Text Window. From the Condensed View Window, you may (among other things) type (1) TAB or ENTER to return to the Main Text Window keeping the relevant line in context, or (2) ESCAPE to return to wherever you were when you left the Main Text Window. Try experimenting with the items in the Window menu in the Main Text Window. For a popup menu in either window, you may either click mouse button 2 (right click) or type SHIFT+F10. Try tagging and untagging lines manually by double clicking or pressing the space bar. Perform another search and tag operation. Notice that tagged lines are persistent (i.e. they stay tagged until cleared by type C or selecting Clear tagged lines from a menu). Thus, you can effectively build an index into any document in just a few steps. Using a book index, you must flip back and forth between the index and the text. With a HyperView index, you simply click on a line in the Condensed View Window to bring up the corresponding text in the Main Text Window. Context-sensitive help is available anywhere in HyperView by typing F1. ═══ 1.2. Examples ═══ Example 1. You have a propensity for overusing the adverbs however and therefore. These words appear too frequently in an article you are writing. To decide where additional editing would be most appropriate, you would like to see where each word is used. Just tell HyperView to search and tag each line containing the word however. Then search again for all lines containing therefore. Now press TAB to switch to HyperView's Condensed View Window to see all lines containing either however or therefore. Please note that you can open a HyperView window to review the letter while it is still active in your word processor. Example 2. You are reviewing a collection of mail messages. You search and tag all lines containing the subject heading (Subj:, Topic:, etc.). This gives you a quick list of topics, from which you can easily extract messages of interest. Example 3. You are a scientist specializing in research on sickle cell anemia. A colleague asks you to review a paper she is writing about genetic disorders. You do not have to worry that her paper is formatted as a WordPerfect document and you shun DOS based word processors-HyperView reads WordPerfect. Moreover, you do not need to read the whole paper. Instead, you use HyperView's search and tag feature to perform three successive searches for (1) sickle, (2) hemoglobin, and (3) HgB. Switch to the Condensed View Window to view all lines containing one of the three words you searched for. As you move the cursor through the window, the line is shown in context in the Main Text Window. Extraneous lines may be untagged by positioning the cursor over the offending line and pressing the space bar or by double clicking the line. To return to the Main Text Window and read a section more thoroughly, type ENTER or press a mouse chord (both buttons simultaneously). You use Gather to save one or more sections of text to another file, or List Tagged Lines to save all tagged lines to a file. ═══ Cursor Keys ═══ Cursor movement in the Text and Condensed windows of the PM version follows the example set by the text mode version. Using the cursor keys, the cursor bar moves first-text does not move until the cursor bar reaches a screen boundary. For example, pressing the up arrow moves the cursor bar up one line. Text does not begin to scroll until the cursor bar reaches the top of the screen. The scroll bar in the Text Window (but not the Condensed View Window), uses a slightly different method of moving text. Clicking on one of the scroll arrows moves text first-the cursor bar follows the text until it reaches one of the screen limits. Pressing the scroll bar above or below the scroll box moves text up or down a screen without moving the cursor bar (unless that would put the cursor outside the range of text). Related topic: Preferences (for reassigning certain key functions) ═══ 2. Starting HyperView ═══ The full syntax for starting HyperView is: HVPM [options] [filespec] HyperView recognizes long file names and names with spaces. There is no need to place quotes around long file names with embedded spaces. If you do use quotes (through force of habit) place them around the entire file specification-not just the file name. If a filespec is omitted at startup, HyperView will open with a display of the current directory. If HyperView cannot locate a file specified on the command line, rather than give a file not found message, it will display a listing of the directory in which the file should be located. Because of its speed, HyperView is an ideal choice as an external file viewer for use with your favorite file manager. Another easy way to start HyperView is from the Workplace Shell. First create a HyperView program object. Then drag the icon of a file you wish to view and drop it on the HyperView icon. ═══ 2.1. Startup Options ═══ For your convenience, the following options are available when starting HyperView. Notice that each option consists of a slash (/) followed by a letter. The letter may be upper- or lower-case. All options must precede the filespec on the command line. /E Escape = exit The main HyperView window closes when you type ESCAPE from the Main Text Window. /R Raw Bypass HyperView's auto-recognition of special file formats. This is equivalent to checking the Raw box in the Files dialog. /K Keep resident For a higher level of integration with file manager and other programs when using HyperView as an external browser. /M Start minimized Start a minimized session. This is most useful for initializing HyperView in conjunction with the /K option. This option is ignored when a file is specified on the command line. ═══ 2.2. Keep Resident Option ═══ While in resident mode HyperView achieves a higher level of integration with file manager programs, such as FM/2, Mr.File/PM, and FileStar/2. You no longer have to exit from HVPM to load a new file. Instead, when your file manager tells HVPM to view a file, it will be loaded in the current HyperView window. HyperView almost becomes another of your file manager's windows, instead of being a separate application. Resident mode is enabled with the /K startup option. Please consult the section entitled Using HyperView with other programs for instructions. While in resident mode, several common keys take on a slightly different function, in keeping with HyperView's role as an adjunct to your file manager. As the name suggests, the objective of resident mode is to remain resident. In other words you do not want to exit the application each time you read a new file. Accordingly, typing ALT+F4 or double-clicking on the icon to the left of the title bar does not exit the HVPM resident session. Instead, ■ the main HyperView window is minimized, ■ the file you had been viewing is closed, and ■ HyperView attempts to return the focus to your file manager. When you type ESCAPE while in resident mode, HyperView will try to return the focus to your file manager, provided that the file manager window has not been minimized or hidden. If you use the /E startup option in conjunction with the /K option, then ESCAPE functions like ALT+F4 (as described in the preceding paragraph). If you really do wish to exit a HyperView resident session, type F3 (with confirmation) or CTRL+F3 (without confirmation). Selecting Close from the OS/2 Window List popup menu will also exit the resident session. The next time you start HVPM with the /K startup option a new resident session will be launched. If you use HyperView from the Workplace Shell, the simplest way to open a new file is by drag & drop: drag a file to an open HyperView window and drop it. You may also create a new HyperView program object with the /K option in the parameters entry field. Files dropped on a program object with the /K option will be opened into the same window. Dropping a file on a program object without the /K option will start a separate HyperView session. You may find it beneficial to initialize HyperView, before running it the first time from the Workplace Shell. ═══ 2.3. Using HyperView with Other Programs ═══ HyperView may be used with any program that allows the designation of an external file viewer. To achieve a higher level of integration with your file manager, use HyperView's resident option. When the resident option is in enabled, you no longer have to exit HyperView to load a new file. Instead, when your file manager tells HVPM to view a file, it will be loaded in the current HyperView window. HyperView acts as if it were another of your file manager's windows, instead of being a separate application. Examples: ■ FM/2 (FileManager/2) ■ FileStar/2 ■ Mr.File/PM The procedure for using HyperView with other programs should be very similar. Some programs (like FM/2) permit you to add a startup option after the file name (as you would do if typing from the command line). Others (like FileStar/2) have special entry fields for startup options (sometimes described as switches). Unfortunately, some programs do not permit startup options. Note that FM/2 uses the metastring %a as a shorthand to signify the full path name of the file to be viewed. In contrast, Mr.File/PM uses the / character and FileStar/2 automatically fills in the full path name. Other programs will use different abbreviations or may use no abbreviation. Some programs suspend operation until you finish viewing a file. In many cases, you may still configure a program of this type to run HyperView with the /K option. However, it will be necessary to initialize HyperView before running it from such a program. ═══ 2.3.1. FileManager/2 ═══ To use HyperView as an external file viewer with FM/2, the popular program by Mark Kimes: ■ select Config from the main menu, then Settings notebook, ■ click on the Viewers tab, and ■ fill in the full path name for HVPM.EXE in the text entry field for Viewer, followed by a space and the metastring %a. Thus if HVPM.EXE resides in C:\UTILITY, you would type C:\UTILITY\HVPM.EXE %a To run HyperView from FM/2 in resident mode, the command line for FM/2 would be C:\UTILITY\HVPM.EXE /K %a ═══ 2.3.2. FileStar/2 ═══ To use HyperView as an external file viewer with FileStar/2, Version 1: ■ Select Setup from the main menu to open the Settings Notebook, ■ click on the Path tab, ■ fill in the full path name for HVPM.EXE in the text entry field for Browse. Thus if HVPM.EXE resides in C:\UTILITY, you would type C:\UTILITY\HVPM.EXE %a To run HyperView from FileStar/2 in resident mode, push the Browse button (to the left of the entry field) and type /K in the Switches entry field. ═══ 2.3.3. Mr.File/PM ═══ To use HyperView with Mr.File/PM (a program in the IBM Employee Written Software series), create a command or association that reads: .START C:\UTILITY\HVPM.EXE //K / Please note that for Mr.File/PM (and only for Mr.File/PM), a dot (.) precedes the word START and there are two forward slashes (//) preceding the letter K. ═══ 2.4. Initializing HyperView ═══ In general, it is not necessary to initialize HyperView before running it in resident mode. There are two situations, however, where you may wish to initialize a resident HyperView session: ■ you plan to use the resident option from the Workplace Shell, or ■ you are running HyperView from a program that suspends activity during file viewing operations. In either case, add a line to your STARTUP.CMD file in the following form: START [d:\][path\]HVPM.EXE /K /M If HVPM.EXE is located on your system in the directory C:\UTILITY, the relevant line would read: START C:\UTILITY\HVPM.EXE /K /M This will launch a minimized HyperView session in resident mode, when you start OS/2. Thereafter, when you drag a file to the HVPM program object, it will be loaded in the resident session. This will also allow HyperView to take control over its own Window List entry. Otherwise, the Workplace Shell will control the HyperView PM window list entry. Similarly, after initializing HyperView, it may be run in resident mode, even from a program that suspends activity during file viewing operations. Before changing STARTUP.CMD, you may wish to determine whether initializing HyperView will be beneficial. To do so, open an OS/2 command line session and type: START C:\UTILITY\HVPM.EXE /K /M ═══ 3. Drag & Drop ═══ HyperView is drag & drop enabled. To open a new file, drag it to an open HyperView window and drop it. You can drag an HTML file directly from the Web Explorer to HyperView. Place the cursor anywhere in the Web Explorer's document window except over an image. Press and hold the Ctrl key and the right mouse button (MB2) simultaneously. Drag to an open HyperView window and release. Use drag and drop to open other objects, too. For example, CompuServe members may set Golden Compass (GCP) to index messages only for the last session. When you need to read an earlier message, drag an icon from the GCP desktop and drop it on an open HyperView window to view the entire contents of the message file. (You can also drag a GCP icon to a HyperView program object to open it, but dragging to an open HyperView window is faster.) When using Warp's pickup function to initiate a drag and drop operation, press Shift+RightClick (Shift+MB2) to drop a file on a HyperView window. Please note that HyperView only views one file at a time. Attempting to drag more than one file, will cause HyperView to reject the drag as an illegal operation. ═══ 4. Tagged Lines ═══ To appreciate HyperView's power, add the property of the tagged line to the features associated with traditional file viewers. A line may be tagged in one of two ways. HyperView can search through a text file and tag all lines matching your search criteria. For instance, if you took the quick tutorial, you tagged all lines containing the phrase example. Alternatively, a line may be tagged manually by double clicking on it or by pressing the space bar. As you read through a document, you may manually tag relevant lines to create a customized outline of pertinent information. You may also combine the two methods. In the Main Text Window, a tagged line is simply a line with a different color. HyperView's full power can be exploited with its Condensed View Window. In the condensed view, you focus solely on tagged lines. Or you may scroll through the tagged lines while simultaneously viewing them with their surrounding text in the Main Text Window. Tagged lines are persistent. This means that a line remains tagged until it is untagged. For example, you may have instructed HyperView to tag all lines containing the phrase example. You may now go back and tag all line lines containing the word extract. In the Condensed View Window, all lines containing either example or extract will be displayed. (This is essentially a Boolean OR search, except that (i) you do not need to remember any special syntax, (ii) there is no limitation on the number of searches that can be ORed, and (iii) you can mix case sensitive with case insensitive searches.) In addition, lines that do not easily lend themselves to easy detection by a search may be tagged manually. Inevitably, the results of any search will be over-inclusive. Therefore, a line may be untagged by double clicking or pressing the space bar. Tagged lines produce a form of reverse hypertext, allowing you to quickly isolate information from a document. ═══ 5. Condensed View Window ═══ The Condensed View Window consists only of tagged lines. You might think of it as an index into your document. Unlike an index, however, there is no need to flip back and forth between index and text. When a tagged line is highlighted in the Condensed View Window, it appears simultaneously with its surrounding text in the Main Text Window. The Main Text and Condensed View windows can be sized and positioned independently. This makes it particularly easy to isolate relevant information or to jump back and forth between non-contiguous sections text. To conserve space the Condensed View Window does not have a menu bar or a horizontal scroll bar. For a popup menu, you may either click mouse button 2 (right click) or type SHIFT+F10. Horizontal scrolling can be achieved using the cursor keys or via the scroll bar on the Main Text Window. To untag a line of text in the Condensed View Window, either position the cursor bar on the offending line and press the space bar, or point the mouse to the line and double click mouse button 1. Moving between the Text and Condensed Windows may be accomplished by clicking on the destination window with the mouse or by one of the following: ■ TAB moves back and forth between the Text and Condensed windows. ■ From the Condensed Window, typing ESCAPE returns you to the Main Text Window and to your previous position in the document. ■ Chord or ENTER swaps the Text and Condensed View Windows. Notice that when you TAB into the Condensed View Window, the text in the Main Text Window jumps to display the highlighted line in context, whereas if you swap into the Condensed View Window, it is first synchronized with the Main Text Window. If there are no tagged lines, the Condensed View Window disappears. Most of the shortcut keys applicable to the Text Window may be initiated in the Condensed View Window. ═══ 6. Mouse Support ═══ HyperView PM incorporates the common mouse instructions you expect to find in a PM application. Scroll bars adjust text horizontally and vertically. Pointing to a line of text with the mouse and clicking moves the cursor bar to the designated line. Gathering (selecting) text is accomplished by holding down mouse button 1, then dragging the mouse pointer to the last character to be gathered. Clicking mouse button 2 (right clicking) brings up a context menu. Two mouse instructions are unique: Double clicking mouse button 1 is equivalent to pressing the space bar. In the Main Text Window this will tag or untag a line of text. In the Condensed View Window, it will untag a line of text. Chord (pressing both mouse buttons simultaneously) swaps between Text and Condensed View windows. The chord is especially useful in the Condensed View Window, where you can point with the mouse to a line of interest and press a chord to jump back to the Text Window. The relevant line will be displayed in context. ═══ 7. Keyboard and Mouse Shortcuts ═══ ┌─────────────┬─────────────────────────┐ │Key │Function │ ├─────────────┼─────────────────────────┤ │ │File Functions │ ├─────────────┼─────────────────────────┤ │N │Files or ZIP Dialog │ │ │(entry field = file name)│ ├─────────────┼─────────────────────────┤ │O, \ │Files or ZIP Dialog │ │ │(entry field = *.*) │ ├─────────────┼─────────────────────────┤ │F3 │Exit (confirm) │ ├─────────────┼─────────────────────────┤ │CTRL+F3 │Exit (no confirm) │ ├─────────────┼─────────────────────────┤ │CTRL+F4 │Close file │ ├─────────────┼─────────────────────────┤ │ALT+F4 │Close window │ ├─────────────┼─────────────────────────┤ │ │Edit Functions │ ├─────────────┼─────────────────────────┤ │G │Start traditional gather │ ├─────────────┼─────────────────────────┤ │CTRL+/ │Gather all │ ├─────────────┼─────────────────────────┤ │F9 │Save gathered text to │ │ │file │ ├─────────────┼─────────────────────────┤ │CTRL+INSERT │Copy gathered text to │ │ │clipboard │ ├─────────────┼─────────────────────────┤ │CTRL+SHIFT+ │Append gathered text to │ │INSERT │clipboard │ ├─────────────┼─────────────────────────┤ │L │List tagged lines to file│ │ │or clipboard │ ├─────────────┼─────────────────────────┤ │Space │Tag/Untag line │ ├─────────────┼─────────────────────────┤ │C │Clear tagged lines │ ├─────────────┼─────────────────────────┤ │ │Search Functions │ ├─────────────┼─────────────────────────┤ │S │Search Dialog │ │ │(unchanged settings) │ ├─────────────┼─────────────────────────┤ │F │Search Dialog │ │ │(forward direction) │ ├─────────────┼─────────────────────────┤ │B │Search Dialog │ │ │(backwards direction) │ ├─────────────┼─────────────────────────┤ │+, = │Repeat last search │ │ │forward │ ├─────────────┼─────────────────────────┤ │- │Repeat last search back │ ├─────────────┼─────────────────────────┤ │CTRL+DOWN │Next tagged line │ ├─────────────┼─────────────────────────┤ │CTRL+UP │Previous tagged line │ ├─────────────┼─────────────────────────┤ │J │Jump to line number │ ├─────────────┼─────────────────────────┤ │ │View Functions │ ├─────────────┼─────────────────────────┤ │H │Hex view │ ├─────────────┼─────────────────────────┤ │R │Right margin │ ├─────────────┼─────────────────────────┤ │W │Word wrap toggle │ ├─────────────┼─────────────────────────┤ │T │Tab expansion toggle │ ├─────────────┼─────────────────────────┤ │ │Window Functions │ ├─────────────┼─────────────────────────┤ │TAB │Switch windows │ ├─────────────┼─────────────────────────┤ │ENTER │Swap windows │ ├─────────────┼─────────────────────────┤ │ │Search Dialog │ ├─────────────┼─────────────────────────┤ │CTRL+ENTER │Tag │ ├─────────────┼─────────────────────────┤ │ │Miscellaneous │ ├─────────────┼─────────────────────────┤ │SHIFT+F10 │Popup menu │ └─────────────┴─────────────────────────┘ ┌─────────────┬─────────────────────────┐ │Mouse │Function │ ├─────────────┼─────────────────────────┤ │MB1 │Tag/Untag line │ │double click │ │ ├─────────────┼─────────────────────────┤ │MB2 │Popup menu │ │single click │ │ ├─────────────┼─────────────────────────┤ │Chord │Swap windows │ └─────────────┴─────────────────────────┘ ═══ 8. File ═══ The menu items New and Open bring up the Files dialog. If you are viewing a ZIP file and you have not dismissed the ZIP View dialog, the ZIP View dialog will reappear. The only difference between New and Open, is that New inserts the name of the current file in the Name entry field, while Open inserts the mask "*.*". The backslash (\) is a hot key synonym for Open. Select Close to release the current file from memory, leaving a blank HyperView window. Note: It is not necessary to close a file before opening a new one. HyperView does this for you automatically. Related topic: Drag & Drop (for opening new file) ═══ 8.1. Files Dialog ═══ The Files dialog is an adaptation of the standard dialog provided by the Presentation Manager. It offers some enhancements over the standard dialog. A single TAB takes you directly into the Files list box. All the controls have mnemonics so you can jump quickly to the Directory or Drives control. Either type the name of the file you wish to view in the Name entry field or select a file from the Files list box. If the selected file is in one of HyperView's supported file formats, it will automatically be converted to text. If the file is a ZIP file, the ZIP View Dialog will appear. To bypass HyperView's auto-recognition feature, check the Raw check box. Note: You may type a directory name in the Name entry field to change to a new directory. When doing so, a final backslash is obligatory. In other words to change to E:\OS2, you must type "E:\OS2\". A final backslash is not required, however, when you specify a directory from the command line. ═══ 8.2. ZIP View Dialog ═══ The ZIP View dialog is invoked when you select a ZIP file from the Files dialog (or specify a ZIP file from the command line). The dialog presents information about the contents of a ZIP file. HyperView works in tandem with Info-ZIP's UNZIP.EXE to view compressed files directly, without making a copy on your hard drive. Compressed files with long file names and names with spaces may be viewed even on non-HPFS drives. If the selected file is in one of HyperView's supported file formats, it will automatically be converted to text. To bypass HyperView's auto-recognition feature, check the Raw check box. The Files push button brings up the Files dialog. Each time a ZIP file is selected for viewing, the ZIP view dialog slips behind the Main Text Window. To view another compressed file in a ZIP archive, select Open or New from the menu or type one of the associated hot keys (N, O, or \.) Alternatively, you can simply click on the ZIP View dialog to bring it to the foreground. Please note that ESCAPE dismisses the ZIP View dialog. ═══ 8.3. Exit ═══ Press F3 to exit HyperView with confirmation or CTRL+F3 to exit without confirmation. Alternatively, to exit without confirmation from the Main Text Window, press ALT+F4. In order to provide greater integration with file manager programs, these functions operate slightly differently in resident mode. ═══ 9. Edit ═══ The edit menu embraces two different functions: (1) gathering and (2) operations on tagged lines of text. Use the Gather command to save one or more contiguous lines of text. Gathering is like blocking or selecting text in a word processor. In contrast, the List command only copies tagged lines. Listing is loosely analogous to extracting a table of contents or an index from a word processing file. As you see, Gather and List perform two different functions. You should also be aware of a difference in the way they save text. List is line oriented-it saves lines of text from different parts of your file. If the tagged line does not end with a hard return, HyperView will add one to the end. In contrast, Gather is block oriented. It saves contiguous blocks of text. In general, HyperView does not modify Gathered text. This is usually only relevant with word processing files, which will have hard returns only at the ends of a paragraphs. This means that you can gather text from a Clearlook document and paste it into the Golden Compass editor without having to remove extraneous hard returns from the ends of each line. Use the format output option, to force HyperView to end each line of gathered text with a hard return. As described elsewhere, HyperView suggests different file name extensions for gathered and listed text. If you prefer, however, you may save both kinds of text to the same file. ═══ 9.1. Gather ═══ Gathering text is similar to selecting or blocking text in a word processor or editor. Text may be gathered, then copied or appended to the OS/2 clipboard or saved to a file. The easiest method of gathering text is with the mouse. Hold down mouse button 1 and drag the mouse over the gathered text. Using the mouse you may gather words and phrases. HyperView also supports two methods of gathering using the keyboard. With the keyboard, however, you cannot gather less than a line of text. In the traditional method, Gathering is initiated by choosing Start from the Edit menu or by pressing G. This is equivalent to pressing ALT+F4 in WordPerfect or F1 in XyWrite. The blocked text follows the cursor when you press a cursor key or when you move the cursor by performing a search or jumping to a new line. (The exception to this rule is when you move the cursor by manipulating the scroll bar with the mouse.) To quit a gather operation using this traditional method, press ESCAPE or click mouse button 1 anywhere in the Text Window. The modern method of Gathering is initiated by holding down the shift key and pressing one of the cursor keys. With this method, blocked text does not automatically follow the cursor when you perform a search or jump to a new line. You may extend gathered text, however, by ■ holding down the shift key and pressing a cursor key, or ■ positioning the mouse pointer on the last character to which you wish to extend the gathered text, holding down the shift key, and pressing mouse button 1. To quit a gather operation using the modern method, press ESCAPE, any cursor key, or click mouse button 1 anywhere in the Text Window. Finally, all the text in a document may be gathered by selecting Gather all from the menu, or by typing CTRL+/. Gathered text may be copied or appended to the clipboard, or saved to a file by selecting the appropriate option from the Edit menu or by pressing ENTER while a Gather operation is in progress. The following hot keys are also available: CTRL+INSERT Copy to clipboard CTRL+SHIFT+INSERT Append to clipboard F9 Save to file Please note that the cursor bar changes to a small transparent block on the left of the screen as it passes through gathered text. Be aware that the cursor bar disappears while you drag the mouse to gather text. Related topics: ■ Gather [Hex View] ■ Formatting Gathered Text ═══ 9.2. Gather [Hex View] ═══ Gather operations are supported while in Hex View using the same methods that are available for gathering text. (See Gather for more information.) Since there is no cursor bar in Hex View, gather operations start at the top of the screen when initiated with shifted cursor keys or by typing G. When gathering in Hex View, HyperView masks the following characters before copying them to the clipboard or saving them to a file: Null 00h Tab 09h Line feed 0Ah Carriage return 0Dh ═══ 9.3. Formatting Gathered Text ═══ The Format output function lets you format the output of gathered text before copying it to the clipboard or saving it to a file. Formatting may be applied either to ASCII or word processing files. But it is usually only relevant with word processing files. To understand the significance of formatting, you need to realize that, internally, HyperView stores the converted text of word processing files in stripped ASCII format. Correspondingly, without the format function, HyperView outputs text in the stripped ASCII format when copying it to the clipboard or saving it to a file. This is desirable when the target application is word wrap enabled and will flow the paragraphs. For example, you can gather text from a Clearlook document and paste it into a Golden Compass edit window without having to remove extraneous hard returns from the ends of each line. In other cases, however, it is more convenient to have a hard return at the end of each line. The Format function gives you a choice. The formatting options are accessed under the Edit and popup menus. Clicking on the little arrow in the Format output menu item (or pressing the right cursor key) brings up the format options. A check mark signifies the item is enabled. You may check either one, both, or none. There are two format settings: Expand tabs and Add hard return. The Expand tabs setting causes hard tabs to be converted to spaces. This should not be confused with Tab expansion on the View menu. The latter affects how tabs appear on screen. The former affects what is copied to the clipboard or saved to a file. The Add hard return format setting adds a hard return to the end of each line that does not already have one. If paragraph spacing is in effect, then HyperView will also add a hard return where required between paragraphs. Most people will want to enable both tab expansion and add hard return and then forget about this subject. For your convenience the menu options do not dismiss when checked. After making your selections, you can click on the 'OK' menu item to dismiss the menu. After selecting the type of formatting you prefer, you enable or disable formatting of clipboard operations by selecting the Format output menu item. A check mark next to the menu item means that HyperView will format text when copying or appending gathered text to the clipboard. To format gathered text when saving it to a file, use the Format check box in the Save to file dialog. If neither format option (i.e. expand tabs or add hard return) has been selected, then the Format check box will be grayed. All format preferences are preserved by HyperView from session to session. ═══ 9.4. List Tagged Lines ═══ Tagged lines may be copied or appended to the OS/2 clipboard or saved to a file. Select List tagged lines from the menu, or type L, to initiate a list of tagged lines. HyperView will extract a list of all tagged lines. The List command is only available when there are one or more tagged lines. ═══ 9.5. Clipboard ═══ HyperView will either copy or append gathered text, tagged lines, or hex format to the OS/2 clipboard. When text is copied to the clipboard, the previous contents are overwritten with the new contents. In contrast, appending text to the clipboard preserves the current clipboard contents and adds new text to the end. Text may then be transferred from the clipboard to your OS/2, Windows, or DOS application. Please note that the OS/2 clipboard is apparently limited to 64k of text. HyperView issues a warning, if a clipboard operation would exceed 64k. Bear in mind that attempting to append a small amount of text to the clipboard may cause the 64k limit to be exceeded, if the current contents of the clipboard are already close to the limit. ═══ 9.5.1. Using the OS/2 Clipboard ═══ HyperView lets you copy or append text directly to the OS/2 clipboard. After a clipboard operation, you may paste the contents into your OS/2, Windows, or DOS applications. In general, to paste text into an OS/2 Presentation Manager application, either select Paste from the Edit menu or press SHIFT+INSERT. To paste text into a Windows application, you must first enable sharing between the OS/2 and Windows clipboards. Open the settings notebook for the Windows application and select the Session tab. Now click on the Win-OS/2 settings button and set WIN_CLIPBOARD to On. After clipboard sharing has been enabled, the process of pasting text into your Windows application is the same as for OS/2 applications: either select Paste from the Edit menu or press SHIFT+INSERT. To paste text into a DOS or text mode OS/2 application, running in a window, first click on the icon to the left of the title bar or tap the ALT key. Now select Paste from the menu. If the application is running full screen and was started from a desktop program object, first return to the Desktop. Now click on the program object with mouse button 2 (right click) and select Paste from the menu. Whereas OS/2 and Windows applications can retrieve text from the clipboard in a single operation, DOS applications must retrieve text letter by letter. Please understand that this is not a limitation of HyperView or OS/2. It is an inherent limitation of DOS programs. It may, therefore, be preferable to avoid the clipboard for transferring a substantial amount of information to a DOS application. Instead, use the Gather or List command to save the text as a file, then retrieve the file into your DOS program. ═══ 9.6. Save to File ═══ Gathered text, tagged lines, and hex format may be saved to a file. The Save dialog prompts you for a filename. The first time in a session, HyperView suggests a file name with the same root name as the file you are viewing and the extension .HVG (i.e. HyperView gather), if you are gathering, .HVL, if you are listing, or .HVX in Hex View. Thus, if you gather text in NEWSLET.TXT, HyperView will propose the filename NEWSLET.HVG to hold the gathered text. Either accept this suggestion or edit it as you please. HyperView will remember an edited file name the next time you call the dialog in the same session. By default, HyperView appends text to the end of an existing file. Turn off the Append check box, if you prefer to overwrite the contents of a file. Check the Format check box to have HyperView format gathered text before saving it to a file. Note: If neither of the format options (i.e. expand tabs or add hard return) have been selected, then the Format check box will be grayed. Long file names are permitted when saving to an HPFS drive. ═══ 9.7. Manually Tagging and Untagging Lines ═══ There will be occasions when a search and tag operation tags too many lines or when it is more appropriate to tag a line manually. To untag a single line, point with the mouse to the offending line and double click. Alternatively, position the cursor bar on the line, then press the space bar. The line color will change back to the untagged color in the Main Text Window and will be removed from the Condensed View Window. Use the same procedure to tag a line in the Main Text Window. The line will be tagged and text on the line will change color to reflect the change. The line will be added to the Condensed View Window. ═══ 9.8. Clear Tagged Lines ═══ To clear all tagged lines, select Clear tagged lines from the Edit menu or type C, then confirm your intentions. The Condensed View Window disappears when all tagged lines have been cleared. ═══ 10. Search ═══ Searches are initiated with the Search Dialog. Follow-up searches may be performed most conveniently using the + (forward) and - (back) keys. The gray + and - keys on the numeric keypad are particularly useful for this purpose. The = key may also be used for repeat searches in the forward direction. S is the principal command for calling the Search Dialog. The S command brings up the Search Dialog, leaving the settings unchanged from the last time the dialog was invoked. For your convenience the F and B commands are also available to call the Search Dialog. F sets the Search Dialog to perform a forward search starting from the current position. Similarly, B sets the Search Dialog to perform a backward search starting from the current position. The Preferences Dialog is available, if you prefer to have F set the Search Dialog to begin at the top of the file. ═══ 10.1. Search Dialog ═══ The Search Dialog offers the following options: Search for Type a word or phrase (up to 76 characters long) in the entry field. You may also search for special characters that are not assigned a to a key on your keyboard. Case Sensitive Check this box to make searches case sensitive. A case sensitive search for the word "Check" will ignore "CHECK" and "check". Direction Forward searches search forward to the end of the file. Backward searches start at the current position and search backward to the beginning of the file. Start from A forward search may be started from the current position or from the beginning of the file. This setting has no relevance to backward searches and is ignored when searching backward. Tag Push TAG (or type CTRL+ENTER) to initiate a Search and Tag operation. HyperView will tag each line in the file that matches the search criteria in the dialog settings. Where found text occupies more than one line, only the first line will be tagged. Note: this option is not available in Hex View. Search Push SEARCH (or type ENTER) to initiate a search. When a match is found, the cursor will move to the matching line, if it is on the current screen, or to the fifth row, if the matching text is off-screen. This allows you to view search results in context, without the need to scroll back to view preceding text. Cancel Type ESCAPE to cancel the Search Dialog. ═══ 10.2. Search and Tag ═══ One of HyperView's most powerful features is the Search and Tag operation. HyperView initiates a Search and Tag operation when you push TAG (or type CTRL+ENTER) in the Search Dialog. HyperView will tag each line in the file that matches the search criteria in the dialog settings. Where found text occupies more than one line, only the first line will be tagged. Upon the successful completion of a Search and Tag operation, HyperView opens the Condensed View Window. The cursor bar will be positioned on the first line matching the search string. The cursor line moves to the top of the window for a forward search (or toward the bottom for a backward search). The rest of the Condensed View Window is filled with tagged lines (which may not match the results of your last search). Tagged lines are persistent. If you do another search, the lines tagged by the first search will remain tagged, until you untag them all with the Clear tagged lines command or untag them manually. ═══ 10.3. Searching for Special Characters ═══ You may search for special characters such as tabs, symbols, and accented characters that are not assigned to a key on your keyboard. To enter special characters into the search entry field: ■ Hold down the ALT key, ■ Type the decimal ASCII code number of the character on the numeric keypad, then ■ Release the ALT key. For example to search for a word containing the letter А (ASCII 128), hold down the ALT key, type the numbers 1, 2, and 8 on the numeric keypad, then release the ALT key. The ASCII codes for some common special characters are: Tab 9 Line feed 10 Carriage return 13 Paragraph symbol 20 Section symbol 21 ═══ 10.4. Repeating Searches ═══ You may repeat your last search without reopening the Search Dialog. To repeat a search in the forward directions, type + or =. Type - to repeat a search in the backward direction. Alternatively, you may click on the + and - buttons on the far right of the menu bar. The gray + and - keys on the numeric keypad are most convenient for repeating searches. When you use + and -, HyperView searches for the text in the entry field the last time any kind of search was performed. It does not matter whether the last search was a conventional search or a Search and Tag operation. The settings for Case sensitive will be honored, but the other settings are ignored. ═══ 10.5. Jump ═══ The Jump command (J) prompts you for a line number, then moves the cursor to that line. The number of lines in a file is given on the far right side of the status line at the bottom of the screen. In Hex View the Jump command moves the display to a specific offset in the file. Select the appropriate radio button to enter a destination offset in decimal or hex notation (leading zeros are optional). Your preference for decimal or hex notation is preserved from session to session. ═══ 11. View ═══ The View menu affects how text is displayed on screen. Options include hex view, settings for the right margin/layout, word wrap, display of tabs, and paragraph spacing of word processing files. ═══ 11.1. Hex View ═══ Type H (or select Hex from the View menu) to switch between text view and a conventional hexadecimal (or hex) view. In the case of word processing files, switching to Hex View will show HyperView's conversion of the document. If you wish to see the document in its native format: ■ Type N (or select New from the File menu), ■ Check the RAW check box in the Files dialog, ■ Push OK to load the file raw (i.e. without conversion). You may initiate searches while in Hex View as you would in text view. If the search is successful, HyperView will move the line containing the first letter of the search string to the top of the screen. Please note that a search string may extend across several lines in Hex View. Search and tag operations may not be initiated while in Hex View. Use the Jump command to move the display to a specific offset in the file. Gather operations are supported while in Hex View using the same methods for gathering that are available in the Main Text Window. When switching to and from Hex View, HyperView will attempt to preserve the position in the file. It is common, however, for the display to shift slightly because the notion of a line is different in hex and text view. In Hex View a line is 16 characters. In text view, a line takes into account the 'meaning' of those characters, e.g. line feeds, carriage returns, and tabs. To exit Hex View type H again or type ESCAPE. ═══ 11.2. Right Margin/Layout ═══ HyperView employs true word wrap. The screen column at which HyperView wraps text to the next line may be set with the Right Margin/Layout dialog. Separate right margin settings are maintained for ASCII and word processing files. The default right margin for ASCII files is 80 and 75 for word processing files. Note: For purposes of formatting, HyperView treats HTML, and .INF and .HLP files as if they were word processing documents. You may set tab stops for any value between 1 and 20. When Tab Expansion is enabled, HyperView will align text following a tab on the next column that is a multiple of the tab stop setting. Separate tab settings are maintained for ASCII and word processing files. Your margin, tab, and word wrap settings may be saved from session to session by pushing the Save button. If you frequently read ASCII files with hard returns at the end of the line, you may wish to turn off (uncheck) the word wrap setting for ASCII files. Many people prefer to have the occasional long line scroll off the screen rather than to have it wrap to an extra short line. Notice that the default push button for the Right Margin dialog is Change. This means that typing ENTER while the cursor focus is on one of the entry fields or check boxes is equivalent to pushing the Change push button. To save your settings for future sessions (something you will do only infrequently), push Save (or type ALT+S). Please note that a side-effect of altering the layout is to cause any tagged lines to be cleared. This happens because the new margin will result in changes to line lengths and the number of lines. When any lines are tagged, HyperView will issue a warning before bringing up the Right Margin/Layout dialog. ═══ 11.3. Word Wrap ═══ HyperView employs true word wrap. Word wrap may be toggled directly from the menu or by typing W. Word wrap may also be set and saved from session to session from the Right Margin/Layout dialog. The state of word wrap is maintained separately for ASCII and word processing files. Thus, you may have word wrap enabled for one and disabled for the other. When word wrap is enabled, the associated menu item will be checked. The relevant check box will also be set in the Right Margin dialog. Note: For purposes of formatting, HyperView treats HTML, and .INF and .HLP files as if they were word processing documents. HyperView will preserve the state of any tagged lines when disabling word wrap. The same is not true, however, when you enable word wrap. Here is the reason why. When word wrap is disabled, two or more lines are combined to form one long line. If one of the constituent lines was tagged while word wrap was enabled, HyperView knows to tag the resulting line. Going in the reverse direction, HyperView has no way of knowing which of the component lines should be tagged. Therefore, if there are any tagged lines, HyperView will issue a warning before enabling word wrap. ═══ 11.4. Tab Expansion ═══ When tab expansion is on, HyperView will align text following the tab on the next tab column. Thus, if a tab is the twelfth character on a line and tab stops are set to five, then the next text will print on column fifteen (the next column that is a multiple of five). When tab expansion is off, tabs appear in their native form-a character resembling a tiny "o". Tab stops may be set and saved from session to session from the Right Margin/Layout dialog. T is the shortcut key for toggling tab expansion. When tab expansion is enabled, the associated menu item will be checked. ═══ 11.5. Paragraph Spacing ═══ Formerly, word processors required two hard returns to separate paragraphs. In contrast, most modern word processors have an option for adding space to the end of a paragraph. HyperView's paragraph spacing option emulates the word processor's paragraph spacing-conveying a more natural look to word processing documents. Paragraph spacing is listed as an option in the View menu and the main window popup menu. When paragraph spacing is enabled, every paragraph will be separated from other text by a blank line. For this purpose, a paragraph is any text that is word wrapped (i.e. that has at least one soft return). Consider the paragraph in contrast to a line, which, as the name suggests, is complete on one line without any word wrapping. Although this feature can be turned on and off, you will probably wish to turn it on and leave it on. Toggling paragraph spacing will not affect the status of tagged lines. The paragraph spacing setting is remembered by HyperView from session to session. Notes: ■ Paragraph spacing is only observed for word processing files. ■ For purposes of formatting, HyperView treats HTML, and .INF and .HLP files as if they were word processing documents. ═══ 12. Options ═══ The items on the Options menu let you configure certain preferences, font sizes, colors and window settings. Margin and word wrap settings may be saved from the Right Margin dialog. Other options, such as format output and paragraph spacing, are automatically saved from session to session. ═══ 12.1. Preferences ═══ The Preferences Dialog lets you customize HyperView. Check the applicable preferences and push Save. By default, typing F sets the Search Dialog to begin searching at the end of the current line. Check F = Search from top so that HyperView sets the Search Dialog to begin a search from the top of the file instead. This setting only affects the initial setting when the dialog appears. You are still free to change the starting point inside the dialog. The Alternative Cursor Keys group lets you customize the operation of the cursor keys. By default, the Up and Down arrow keys move the HyperView cursor bar. Text does not begin to scroll until the cursor bar reaches the top or bottom of the screen. Check the Up/Dn box to make HyperView scroll text first. By default, the PgUp and PgDn keys first move the cursor to the top or bottom of the screen before displaying the previous or next screen of text. Check the PgUp/PgDn box to make HyperView move immediately to the previous or next screen. By default, the Home and End keys move directly to the beginning or end of the document. (If the screen is scrolled to the right, Home first moves the screen to the far left.) Check Home/End to make HyperView move the cursor to the top or bottom of the screen before moving to the beginning or end of the file. This setting is most useful if you are also using the alternative PgUp and PgDn keys. Note: Except for Home/End , the alternative settings do not affect the operation of the cursor keys during gather operations. ═══ 12.2. Font Size ═══ Available font sizes depend on your screen resolution. To preview the appearance of a font size, push the View button (or type ALT+V). The Change push button changes the font size only for the current session. Push Save to save the font size for future sessions. ═══ 12.3. Color Settings ═══ HyperView's default colors may be customized in the Color Settings dialog. First, select the screen element you wish to customize, then set the color. To restore the default colors, push Default. ═══ 12.4. Window Settings ═══ The Window Settings dialog lets you set window positions and sizes for the Main Text Window and the Condensed View Window. Alternatively, you may use this dialog to restore the default behavior for window actions. The dialog offers options for setting size and position at Startup, for Tile, and after a Search and Tag operation. Size and position the windows before opening the dialog. (Note that at least one line must be tagged before you can open the Condensed View Window.) Now check the action to which the window position is to be associated (Startup, Tile, Search and Tag). You may check more than one box to associate the same window positions with more than one action. There are two mutually exclusive options for Startup. You may have HyperView remember a specific size and position for Startup. Alternatively, you may instruct the program to remember the window positions when you exit the program and to use those positions at Startup. To restore the default behavior for any or all of the window actions, check the applicable boxes then push the Default button. The default behavior at startup is a window of 80 columns by about 20 rows, centered on the desktop. By default, the Condensed View Window, is sized at 5 rows immediately below the Main Text Window for Tile and after Search and Tag. ═══ 13. Window ═══ The Window menu item lets you control where and how the Main Text Window and the Condensed View Window are positioned on the screen. If there are no tagged lines, this menu item will be grayed. The choices under Window menu are to switch to the Condensed View Window, Swap or Tile the two windows, or Synchronize the Condensed View Window with the Main Text Window. ═══ 13.1. Condensed ═══ To jump from the Main Text Window to the Condensed View Window, select Condensed from the Window menu, or press TAB. Notice that when you switch to the Condensed View Window, the text in the Main Text Window shifts to show the highlighted line in context. Press ESCAPE to return to the Main Text Window and the same position you were at before entering the Condensed View Window. ═══ 13.2. Swap ═══ Swapping involves synchronizing the Condensed View Window with the Main Text Window, then overlaying it on top of the Main Text Window. The status line and horizontal scroll bar of the Main Text Window appear at the bottom of the Condensed View Window. A swap may also be achieved on the keyboard by pressing ENTER or with the mouse by pressing a chord. The chord is especially useful in the Condensed View Window. You can point with the mouse to a line of interest, press a chord, and jump back to the relevant line in the Main Text Window. ═══ 13.3. Tile ═══ By default, HyperView tiles the Condensed View Window by sizing it to five rows and positioning it immediately below the Main Text Window. Use the Window Settings dialog to permanently set window positions and sizes for Tile. ═══ 13.4. Synchronize ═══ When the Condensed View Window is active, the contents of the Main Text Window are synchronized to show the selected line in context. The reverse is not true. Scrolling through the Main Text Window has no effect on the contents of the Condensed View Window. The Synchronize item on the Window menu, synchronizes the Condensed View Window with the current contents of the Main Text Window. An example may make this concept clearer. Suppose you are browsing through the Condensed View Window. You find a line of interest and TAB back into the Main Text Window. You might scroll through several pages in the Main Text Window, passing a number of tagged lines in the process. Jumping back into the Condensed View Window, would return you to the starting point. Had you synchronized the two windows first, you would, in effect, skip over the tagged lines you had already perused in the Main Text Window. HyperView synchronizes the top line in the Condensed View Window with the first tagged line on the current screen in the Main Text Window. Notice that first is stressed. That is because the position of the cursor bar can sometimes by arbitrary with respect to the subject of interest. Accordingly, HyperView errs towards over-inclusiveness by starting with the first tagged line on the screen. Note that swapping windows (typing ENTER key or pressing a chord) automatically synchronizes the two windows. ═══ 14. Getting Help ═══ Context-sensitive help is available anywhere in HyperView by typing F1. Every menu item has its own help. Thus, you may browse through the drop-down menus of the menu bar and press F1 on menu items that you would like help on. Help on dialog boxes is available by typing F1 while the dialog box is displayed. Assume you are curious about the Format Output option on the Edit menu. Type ALT+E to activate the Edit menu. Now move the cursor to Format Output and type F1 to activate context-sensitive help. An even simpler method is to traverse the menu structure with the mouse in one hand, while typing F1 with the other hand . ═══ 15. File Formats ═══ HyperView reads ASCII files, word processing files, HTML files, .INF and .HLP files, and compressed files in ZIP archives (including self-extracting ZIP files). ═══ 15.1. ASCII Files ═══ ASCII files consist only of text. They can generally be divided into two sub-categories. Stripped ASCII is comparable to the way a word processor treats a paragraph-as one long line with a hard return at the end. In contrast, standard ASCII files end each line with a hard return. ASCII files created under OS/2 (and DOS) use a carriage return/line feed combination to end a line. HyperView also recognizes ASCII files generated under UNIX (line feed equals a hard return) and the Macintosh (carriage return equals a hard return). ═══ 15.2. Word Processing Files ═══ HyperView automatically recognizes and converts the following word processing formats: Ami Pro, Clearlook, DeScribe (versions 2 through 5), Microsoft Word for Windows (all versions) and WordPerfect (versions 5.x and 6.x). HyperView also recognizes HTML, .INF and .HLP, and ZIP files. A compressed file in one of HyperView's supported word processing formats, will be converted automatically to text. Internally, HyperView stores the converted text of word processing files in stripped ASCII format. Any file that HyperView does not recognize will be treated as if it were ASCII text. HyperView's mission is to allow you to isolate and extract information from word processing and text documents. Accordingly, when converting word processing files, it generally ignores most formatting such as headers, footers, centering, etc. It also ignores footnotes, endnotes, and graphics boxes that may contain text. When possible, HyperView will convert those characters that the word processor treats as special characters to their ASCII equivalents. If HyperView is unable to convert a character, it will substitute a space. Should you find that HyperView fails to convert a significant number of word processing characters, you may wish to have your word processor perform the conversion, then use HyperView to isolate information in the document. HyperView will perform best if the file is saved in stripped ASCII format-with a hard return at the end of a paragraph. To disable HyperView's automatic recognition and conversion of word processing files, check RAW from the Files or ZIP View Dialog. HyperView will then load the file raw-in its native binary format. ═══ 15.3. HTML Files ═══ HyperView automatically converts HTML files to text. For purposes of formatting, HyperView treats HTML files as if they were word processing documents. Accordingly, text is word wrapped, and word processing preferences for Right Margin/Layout and Paragraph Spacing are utilized. The HTML conversion goes beyond simply removing HTML tags: ■ Basic formatting instructions are observed. ■ All extraneous line end characters and spaces are removed, so that text flows naturally as if it were from a word processing document. ■ Alternative text is extracted from image tags. ■ All special characters are converted to their ASCII counterparts in keeping with the current code page. ■ Preformatted text is preserved, and line end characters in preformatted text are converted to a standard carriage return/line feed combination. Since HyperView is drag and drop enabled, you can drag an HTML file directly from the Web Explorer to HyperView. Place the cursor anywhere in the Web Explorer's document window except over an image. Press and hold the Ctrl key and the right mouse button (MB2) simultaneously. Drag to an open HyperView window and release. Two conditions must be satisfied for HyperView to automatically recognize an HTML file: ■ it must be an ASCII file with an extension of .HTM or .HTML (case is not significant), and ■ it must have at least one < (less than) symbol in the first 256 characters (typically there will be many). Note: To bypass HyperView's automatic conversion of HTML files, check the box next to Raw in the Files Dialog or use the /R startup option. ═══ 15.4. .INF and .HLP Files ═══ HyperView automatically converts OS/2 .INF and .HLP files to text. For purposes of formatting, HyperView treats .INF and .HLP files as if they were word processing documents. Accordingly, text is word wrapped, and word processing preferences for Right Margin/Layout and Paragraph Spacing are utilized. HyperView displays .INF and .HLP files as one document, rather than as a series of windows. If the .INF or .HLP file contains a title, it is displayed the top of the document. Most .INF and .HLP files are subdivided into topics, each of which is displayed in a separate window. HyperView displays the title of each topic preceded by the characters =| and followed by |=. The topic for this window would be displayed as follows: =| .INF and .HLP files |= Topics may have one or more levels of sub-topics. For each lower level, HyperView inserts two spaces in front of the topic title. Thus, a second level topic would be preceded by two spaces; a third level, by four spaces; and so on. Not all topics appear in the table of contents. When a topic is intended to be omitted from the table of contents, HyperView adds an asterisk (*) to the title. For example: =|* Hidden Topic |= Some topics do not have titles. A topic without a title is displayed as follows: =| |= To generate a table of contents, for an .INF or .HLP file, search and tag all lines containing the search string =| (Note that the second character is the vertical bar that is typically found above the backslash (\) key.) . Occasionally, a .HLP or .INF file will have long lines that are not intended to be word wrapped. The syntax diagrams contained in the OS/2 Command Reference are good examples of this kind of behavior. To view these extracts properly, you may have to increase the size of the right margin or momentarily turn off word wrap. ═══ 15.5. File Conversion Notes ═══ The following notes apply to the conversion process: Text contained in tables in word processing documents are typically converted to a series of discrete paragraphs on a cell by cell basis. Hidden text in Word for Windows documents is treated as ordinary text. In WordPerfect 6.x documents, hidden text is enclosed in square brackets, i.e. [This is how WordPerfect hidden text is converted.]. Word for Windows offers a fast save option in which only the changes to a document are saved. HyperView does not recognize these fast saved documents. For most users, it is advisable-for a variety of reasons-to disable Word's fast save option. As of the current release of HyperView, Microsoft had only partially documented the Word for Windows 6.0 file structure. Consequently, there is a small possibility that HyperView will not correctly convert a WinWord6 document. Encrypted WordPerfect and WinWord files are not readable. To view the binary contents of one of these files, check RAW in the Files or ZIP View Dialog. DeScribe uses a sophisticated frame structure. HyperView converts DeScribe text frames in the order they are stored in the document. Headers and footers are contained in frames, and HyperView displays the first instance of a header and footer. ═══ 15.6. ZIP Files ═══ To view a compressed file in a ZIP archive, you must have a copy of the OS/2 version of UNZIP.EXE. UNZIP.EXE must be located in a directory on your path. As of the date of this release of HyperView, the most current version of UnZip is 5.12. To determine whether you have the current version, open an OS/2 command window and type UNZIP -v. UnZip will display information about itself which should include a statement similar to the following: "UnZip 5.12 of 28 August 1994, by Info-ZIP". Note: To obtain the UnZip version number-and nothing but the version number-type UNZIP -vqqqq. If you don't already have a copy of UnZip the current version is unz512x2.exe and is available from many sources including the OS/2 Shareware BBS, ftp-os2.nmsu.edu and ftp.uu.net:/pub/archiving/zip/os2. You may also want to pick up its companion: zip201c2.exe. This release of HyperView PM does not support encrypted ZIP files. You may, however, use the text mode version of HyperView to view encrypted ZIP files. Please note HyperView does not currently support multi-volume archives or nested zip files. (A nested ZIP file is one that is zipped inside ZIP file.) Zero-length files are not displayed in HyperView's ZIP directory. ═══ 16. Program Notes ═══ HyperView PM is written entirely in assembly language. Charles Petzold's early articles in PC Magazine provided an informative introduction to assembler programming for the OS/2 platform. In developing the PM version of HyperView, I referred frequently to both versions of Petzold's OS/2 Presentation Manager Programming as well as to The Art of OS/2 Warp Programming by Panov, Salomon, and Panov. In addition, the assembly language programs and articles published in PC Magazine (some of which were republished in Ray Duncan's Power Programming with Microsoft Macro Assembler) frequently provided a starting point for attacking similar tasks in OS/2. Crescent Software's documentation and the assembly language source code for their BASIC language libraries were also useful. Zen of Assembly Language and Zen of Code Optimization by Michael Abrash are continuing sources of insight. Programmer's Technical Reference: The Processor and Coprocessor by Robert L. Hummel is another valuable reference. Information about the structure of ZIP files is contained in an Application Note published by PKWARE. The source code for UnZip from the Info-ZIP Group is an invaluable source of information about ZIP files. Because of the efforts of the Info-ZIP Group, OS/2 users have the benefit of the most popular archive format. The structure of .INF and .HLP files was first deciphered by Carl Hauser, expanded upon by Marcus Groeber, and further documented by Peter Childs in an article that appeared in EDM/2 (Volume 3, Issue 8). Pete Norloff's OS/2 Shareware BBS is an outstanding OS/2 resource-for developers and end users alike. Browsing through the list of files can be like rummaging through someone's attic, except that Pete's BBS has a much higher percentage of treasures. For others desiring to write assembly language programs for OS/2, MASM version 6.11 will run in an OS/2 DOS session with DPMI_DOS_API set to ENABLED and DPMI_MEMORY_LIMIT set to 10. For $15, Microsoft will downgrade owners of MASM 6.1 or greater to MASM 6.0b (the last version to run as a native OS/2 application). Programs assembled with MASM may be debugged with IPMD (the IBM PM debugger), which is packaged with IBM CSet++ FirstStep for OS/2. Herb Tyson-author of many outstanding books including Your OS/2 Warp Version 3 Consultant, Navigating the Internet with OS/2 Warp, and Word for Windows 6 Super Book-generously offered his advice on HyperView's features and assisted the author in procuring information on the file structures of DeScribe, WinWord and Ami Pro. ═══ 17. Where ═══ As of the date of this release, HyperView may be found on The OS/2 Shareware BBS 703-385-4325 The OS/2 Shareware BBS may also be reached over the Internet at telnet://bbs.os2bbs.com or its Web site at http://www.os2bbs.com BMT Micro's BBS 910-350-8061 for 14.4 connections 910-799-0923 for a direct 28.8 connection BMT also maintains a Web site at http://www.wilmington.net/bmtmicro/ and an FTP site at ftp.wilmington.net/bmtmicro HyperView is also available by FTP from hobbes.nmsu.edu/os2/editors HyperView is a charter member of the OS/2 Must Have Utilities List. You may obtain the current version of HyperView by visiting the Must Have Utilities Web site. The address of the Must Have site is subject to change. Currently, you may point your Web Explorer to http://www.os2.hammer.org/OS2 HyperView is also available on CompuServe in Library 18 of the OS2BVEN forum. On CompuServe the most current version is always known as HV.ZIP. ═══ 18. Support ═══ To receive support, please write to one of the following addresses. Be as specific as possible about any problems and be sure to supply the HyperView version number. The version number may be obtained by selecting Help from the menu, then About. Internet: mshacter@cpcug.org. CompuServe: 76170,1627 Michael H. Shacter 10309 Parkwood Drive Kensington, MD 20895-4041 ═══ 19. Registration ═══ HyperView is a user supported program. It is not public domain. An evaluation version is available from various sites, including CompuServe, the Internet, and BBSs. The evaluation version is designed to let you try the program for a 15-day trial period. An extended evaluation period is available for prospective business licensees. To continue using HyperView after the evaluation period expires, you must pay a $35 registration fee. This registration fee covers both the PM and text mode editions of HyperView. For business use, each person using HyperView at a site must be registered. Volume discounts and site licenses are available-please write for details. To register HyperView directly with the author, please send your check or money order to: Michael H. Shacter 10309 Parkwood Drive Kensington, Maryland 20895-4041 For your convenience, a registration form is included with this package. Individual credit card registrations are also accepted through BMT Micro. BMT accepts Visa, MasterCard, Discover, American Express, Optima, Diner's Club and Eurocard. BMT accepts registrations by mail, phone, fax and e-mail. CompuServe members may also register on-line using SWREG. HyperView's SWREG identification number is 8547. You will receive a registration key that lets you continue using HyperView without reminders. Note that you will not be sent a disk, only a registration key. After registering, you enter your name and registration number in the registration dialog, which appeared the first time you ran HyperView. Thereafter, the dialog may be accessed from the Help menu. ═══ 19.1. Register Dialog ═══ The Register dialog appears the first time you run HyperView. Thereafter, it may be accessed from the Help menu. When you register your copy of HyperView, you receive an acknowledgement with a registration number. Enter your name and registration number in the appropriate dialog entry fields. Please be sure to enter the required information exactly as it appears in the acknowledgement. A seemingly insignificant change in spelling, capitalization, or punctuation will lead to an error message. Push Evaluate to try HyperView for a 15-day trial period. ═══ 19.2. Evaluation ═══ HyperView is a user supported program. It is not public domain. The evaluation version is designed to let you try the program for a 15-day trial period. All of HyperView's features are enabled in the evaluation version. Reminders are furnished from time to time. Push I Agree to begin the trial period and to signify your willingness to register HyperView if you decide to continue using it after the trial period expires. An extended evaluation period is available for prospective business licensees. ═══ 19.3. Reminders ═══ HyperView depends on registered users. During the first 15 days of the HyperView evaluation period, there is a 25% chance that a reminder will appear when you load a new file. You may open seven or eight files without a reminder, or you may have two or three successive reminders. But on average, there will only be one reminder for each four files opened. After 15 days, the likelihood of a reminder jumps to 50% for each file opened. After 30 days, a reminder appears each time you open a new file. ═══ 19.4. E ═══ Example 1. You have a propensity for overusing the adverbs however and therefore. These words appear too frequently in an article you are writing. To decide where additional editing would be most appropriate, you would like to see where each word is used. Just tell HyperView to search and tag each line containing the word however. Then search again for all lines containing therefore. Now press TAB to switch to HyperView's Condensed View Window to see all lines containing either however or therefore. Please note that you can open a HyperView window to review the letter while it is still active in your word processor. Example 2. You are reviewing a collection of mail messages. You search and tag all lines containing the subject heading (Subj:, Topic:, etc.). This gives you a quick list of topics, from which you can easily extract messages of interest. Example 3. You are a scientist specializing in research on sickle cell anemia. A colleague asks you to review a paper she is writing about genetic disorders. You do not have to worry that her paper is formatted as a WordPerfect document and you shun DOS based word processors-HyperView reads WordPerfect. Moreover, you do not need to read the whole paper. Instead, you use HyperView's search and tag feature to perform three successive searches for (1) sickle, (2) hemoglobin, and (3) HgB. Switch to the Condensed View Window to view all lines containing one of the three words you searched for. As you move the cursor through the window, the line is shown in context in the Main Text Window. Extraneous lines may be untagged by positioning the cursor over the offending line and pressing the space bar or by double clicking the line. To return to the Main Text Window and read a section more thoroughly, type ENTER or press a mouse chord (both buttons simultaneously). You use Gather to save one or more sections of text to another file, or List Tagged Lines to save all tagged lines to a file. ═══ 19.5. F ═══ Example 1. You have a propensity for overusing the adverbs however and therefore. These words appear too frequently in an article you are writing. To decide where additional editing would be most appropriate, you would like to see where each word is used. Just tell HyperView to search and tag each line containing the word however. Then search again for all lines containing therefore. Now press TAB to switch to HyperView's Condensed View Window to see all lines containing either however or therefore. Please note that you can open a HyperView window to review the letter while it is still active in your word processor. Example 2. You are reviewing a collection of mail messages. You search and tag all lines containing the subject heading (Subj:, Topic:, etc.). This gives you a quick list of topics, from which you can easily extract messages of interest. Example 3. You are a scientist specializing in research on sickle cell anemia. A colleague asks you to review a paper she is writing about genetic disorders. You do not have to worry that her paper is formatted as a WordPerfect document and you shun DOS based word processors-HyperView reads WordPerfect. Moreover, you do not need to read the whole paper. Instead, you use HyperView's search and tag feature to perform three successive searches for (1) sickle, (2) hemoglobin, and (3) HgB. Switch to the Condensed View Window to view all lines containing one of the three words you searched for. As you move the cursor through the window, the line is shown in context in the Main Text Window. Extraneous lines may be untagged by positioning the cursor over the offending line and pressing the space bar or by double clicking the line. To return to the Main Text Window and read a section more thoroughly, type ENTER or press a mouse chord (both buttons simultaneously). You use Gather to save one or more sections of text to another file, or List Tagged Lines to save all tagged lines to a file. ═══ Mnemonic ═══ Mnemonic -an underlined letter in a dialog signifying that the dialog control can be accessed by pressing the corresponding key or, in some cases, ALT+ the corresponding key. ═══ Chord ═══ Chord -press both mouse buttons simultaneously. ═══ Offset ═══ Offset -the number of bytes from the beginning of the file. ═══ Filespec ═══ Filespec refers either to: ■ a file name, in which case HyperView will load the file at startup, or ■ a path, in which case HyperView will display a directory of files in the designated directory at startup. The path may be further limited by supplying a file mask. For example, the path C:\DeScribe\Data would result in a directory list of all files (*.*) in the C:\DeScribe\Data directory. Alternatively, the path C:\DeScribe\Data\*.doc would result in a directory list of all files with the .DOC extension (*.doc) in the C:\DeScribe\Data directory. ═══ HTML ═══ HTML -an abbreviation for Hypertext Markup Language, it is used to create hypertext files on the World Wide