NAME

docviewer - OpenWindows viewer for AnswerBook on-line documentation

SYNOPSIS

docviewer -d document-name -p tooltalk-procid [ -c card-catalog-file ]

AVAILABILITY

SUNWowrqd

DESCRIPTION

docviewer and navigator(1) constitute an OpenWindows application for viewing and navigating AnswerBook on-line document collections.

docviewer displays PostScript files found using navigator. docviewer lets you page through a document, print pages, magnify or reduce pages, and follow hypertext links and cross-references to other documents.

You should not start docviewer directly. It is started automatically by navigator as needed. If you are running several navigators simultaneously, they will each start their own docviewers.

OPTIONS

docviewer accepts most of the generic tool arguments described in xview(7), as well as the following options:

-d document-name

Specify the name of the document to be viewed.

-c card-catalog

Specify the name of the card catalog file used to locate AnswerBooks. See ab_cardcatalog(4) for more information.

-p tooltalk-procid

Specify the tooltalk process id of the navigator invoking this docviewer.

USAGE

Once a document is displayed in the docviewer window, you can view it as follows:

Page Turning

Click SELECT on the left and right arrow buttons at the top of the docviewer window to page back and forth through a document. The PgUp and PgDn keys on the keyboard perform the same functions. In addition, the Home and End keys let you page through a document one chapter at a time.

Page History

docviewer keeps track of each page visited. Click SELECT on the Go Back button until the window returns to the page you want to revisit, or use the Undo keyboard function.

Hypertext Links

docviewer has a simple hypertext mechanism. Hypertext links are displayed as rectangular outlines around words or graphics on a page. Double-clicking SELECT on a link causes docviewer to display the document and page to which the link points. Documents may have links to other documents within the same collection. Certain types of hypertext links can also initiate system processes. Double-clicking on these links will start up a program or shell script.

Page Magnification

Magnify or reduce the size of the document by pulling the resize corners on the docviewer window, or select the "View->Custom Magnification" menu item. Select the "View->Standard Magnification" menu item to reset the document to the standard size. For very high magnifications, select the "View->Partial Page" menu item so that the docviewer window still fits on the screen.

Printing

Click SELECT on the Print button to show the pop-up Print Window. In the Print Window, select the page or document to print, number of copies, and printing device (or file).

Page Information

Select the "Viewer->Page Info" menu item to show a pop-up window describing the chapter, book, and AnswerBook you are currently viewing.

ENVIRONMENT

AB_CARDCATALOG

Specify the name of the card catalog file used to locate AnswerBooks. See ab_cardcatalog(4) for more information.

SEE ALSO

navigator(1), viewprint(1), answerbook(1), ab_admin(1), ab_cardcatalog(4),

DIAGNOSTICS

docviewer(1) displays PostScript error messages in the console.

BUGS

The AnswerBook document naming syntax used by docviewer is not documented.

NOTES

PostScript is a trademark of Adobe Systems Incorporated.

AnswerBook is a trademark of Sun Microsystems, Inc., licensed to SunSoft, Inc.