xpreview Command

AIX Version 4.3 Commands Reference, Volume 6

xpreview Command

Purpose

Displays troff files on an X display.

Syntax

xpreview [ -BackingStore BackingStoreType ] [ -page Number ] [ ToolKitFlag ... ] { File | - }

Description

The xpreview command is an AIXwindows 2.1- and Motif2.1-based application that displays output from the troff command on an AIXwindows display. The troff command output file must be prepared for the devX100 device.

The user interface contains the standard AIXwindows interface controls for calling the root menu, iconifying the window, and setting the window to full screen size. The interface also includes a main window with a scrollable display area for text. Use the pushbuttons for Next, Previous, Goto Page, Print Page, Print File, and Newfile to manipulate the viewing document.

Mouse button three actuates a popup menu for configuring print capabilities. The menu includes an option to set the command line and another to select a printer queue. The command line dialog box expects command line input through the troff command. For example,

pic -Tibm3816 troff-input-file |tbl|troff -mm -Tibm3816

is an acceptable command line. The printer queue option displays a list of configured printer queues. If this option is not selected, the xpreview command uses the system-defined default queue.

When you are previewing an input file, the Print Page and Print File buttons require command line input. Note that once a printer queue is selected, it remains selected for the duration of the viewing session, or until an alternate printer queue is selected.

Fonts supported for the devX100 device in European locales are:

Times New Roman in normal, italic, and bold
Courier in normal and bold
Helvetica in normal and bold
Symbol

The xpreview command supports the following font sizes: 8, 10, 14, 18, 24, 30, and 36.

The xpreview command does not display files resulting from the troff command constructed for a device other than those described in this document.

To preview a file on a certain device, the xpreview command requires the fonts found in the following directories:

/usr/lib/X11/fonts directory for files formatted for font files other than Japanese
/usr/lib/X11/fonts/JP for Japanese font files

Xstation Support

The xpreview command can display the devX100 formatted files on an Xstation. The Xstation must be configured to include /usr/lib/X11/fonts/i18n in the font path. To preview Japanese character files, the font path should include /usr/lib/X11/fonts/JP.

Multibyte Support

The xpreview command supports multibye locales. Also, to display Japanese characters, Japanese 16-dot fonts (part of the Japanese BSL package) and 24- and 32-dot fonts (part of the AIXwindows font package) must be installed. To display Korean characters, Korean fonts (part of the Korean BSL package) must be installed.

Japanese support currently includes the following font sets:

In 16-dot: RomanKn12, Kanji12, and IBM_JPN12
In 24-dot: RomanKn17, Kanji17, and IBM_JPN17
In 32-dot: RomanKn23, Kanji23, and IBM_JPN23, or RomanKn23G, Kanji23G, and IBM_JPN23G

Korean support currently includes the following font sets:

In 16-dot, EnglHg16 and Hangul16
In 24-dot, EnglHg24 and Hangul24

Flags

The xpreview command accepts the standard X Toolkit command line flags, as well as the following flags:

-	Requires input to be read from standard input.
-help	Indicates that a brief summary of the allowed command line flags should be printed.
-BackingStore BackingStoreType	The -BackingStore flag causes the server to save the window contents so that when it is scrolled around the viewport, the window is painted from contents saved in server backing store. Redisplays of the drawing window can take up to a second or so. The BackingStoreType parameter can have one of the following values: Always, WhenMapped or NotUseful. Notes: Enter a space between the -BackingStore flag and its BackingStoreType parameter. Use of this flag requires that the server be started with backing store enabled.
-page Number	Specifies the page number of the document to be first displayed.
ToolKitFlag	The following standard X Toolkit flags are commonly used with the xpreview command: -bg Color Specifies the color to use for the background of the window. The default is white. -bg Color Specifies the color to use for the background of the window. The default is white. -fg Color Specifies the color to use for displaying text. The default is black. -geometry Geometry Specifies the preferred size and position of the window. -display Host:Display Specifies the X server to contact. -xrm ResourceString Specifies a resource string to be used.
File	Specifies the file to be printed.

Examples

To build files output by the troff command into files that are suitable for use with the xpreview command, enter the following commands:
```
troff-TX100 troff-input | xpreview
pic -TX100 pic-troff-input | tbl | troff -man -TX100 | xpreview
```
To build files output by the troff command into files that are suitable for use with the Japanese language version of the xpreview command, enter the following commands:
```
LANG=ja_JP
troff -TX100 troff-input | xpreview -
pic -TX100 pic-troff-input | tbl | troff -man -TX100 \
        | xpreview -
```

Files

/usr/lib/X11/app-defaults/XPreview	Contains user-configurable applications defaults file.
/usr/lib/X11/Ja_JP/app-defaults/XPreview	Contains user-configurable applications default file for the Japanese (IBM-932) locale.
/usr/lib/X11/ja_JP/app-defaults/XPreview	Contains user-configurable applications default file for the Japanese (IBM-eucJP) locale.
/usr/lib/X11/ko_KR/app-defaults/XPreview	Contains user-configurable applications default file for the Korean locale.
/usr/lib/X11/zh_TW/app-defaults/XPreview	Contains user-configurable applications default file for the Traditional Chinese locale.
/usr/lib/font/devX100	Contains troff fonts for devX100 devices.
/usr/lib/X11/fonts	Contains X fonts for 100 dpi devices.
/usr/lib/X11/fonts/JP	Contains X fonts for multi-byte characters.
/usr/lib/X11/fonts/JP	Contains X fonts for Japanese characters.

Related Information

The cat command, csplit command, diff command, lint command, lp command, lpr command, pg command, pr command, qprt command, sed command, sort command, tabs command, X command, xrdb command.

The eqn command, grap command, pic command, tbl command, troff command, X command, xrdb command.

AT&T Bell Laboratories Computing Science Technical Report No. 14, GRAP - A Language for Typesetting Graphs. Tutorial and User Manual by John L Bentley and Brian W. Kernighan.

The nl_langinfo subroutine in Technical Reference: Base Operating System and Extensions.

Some Applications of Inverted Indexes on the UNIX System by M.E. Lesk.

UNIX System V Documentor's Workbench Reference Manual. ISBN 0-13-943580-8. Prentice Hall.