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

Multibyte Support

The xpreview command supports multibyte 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:

Examples

1. 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

2. 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