OS/2 Shareware BBS: 5 Edit/05-Edit.zip/hv34.zip/HVPM.HLP

OS/2 Help File | 1996-06-06 | 76KB | 1,811 lines

ΓòÉΓòÉΓòÉ 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.


ΓòÉΓòÉΓòÉ <hidden> 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: [e-mail].
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.


ΓòÉΓòÉΓòÉ <hidden> 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.


ΓòÉΓòÉΓòÉ <hidden> Chord ΓòÉΓòÉΓòÉ

Chord      -press both mouse buttons simultaneously.


ΓòÉΓòÉΓòÉ <hidden> Offset ΓòÉΓòÉΓòÉ

Offset     -the number of bytes from the beginning of the file.


ΓòÉΓòÉΓòÉ <hidden> 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.


ΓòÉΓòÉΓòÉ <hidden> HTML ΓòÉΓòÉΓòÉ

HTML       -an abbreviation for Hypertext Markup Language, it is used to create
           hypertext files on the World Wide