pg.1 (2010 09)

pg(1) pg(1)

If the standard output is not a terminal,

pg is functionally equivalent to cat (see cat (1)), except that a

header is printed before each ﬁle if more than one ﬁle is speciﬁed.

EXTERNAL INFLUENCES

Environment Variables

LC_COLLATE determines the collating sequence used in evaluating regular expressions.

LC_CTYPE determines the interpretation of text as single and/or multi-byte characters, and the charac-

ters matched by character class expressions in regular expressions.

LANG determines the language in which messages are displayed.

LC_COLLATE or LC_CTYPE is not speciﬁed in the environment or is set to the empty string, the

value of LANG is used as a default for each unspeciﬁed or empty variable. If

LANG is not speciﬁed or is

set to the empty string, a default of "C" (see lang (5)) is used instead of

LANG. If any internationalization

variable contains an invalid setting,

pg behaves as if all internationalization variables are set to "C".

See environ (5).

International Code Set Support

Single- and multi-byte character code sets are supported.

EXAMPLES

To use

pg when reading system news:

news | pg -p "(Page %d):"

WARNINGS

If terminal tabs are not set every eight positions, undesirable results may occur.

When using

pg as a ﬁlter with another command that changes the terminal I/O options (such as

crypt (1)), terminal settings may not be restored correctly.

While waiting for terminal input,

pg responds to BREAK, DEL, and ˆ by terminating execution.

Between prompts, however, these signals interrupt pg’s current task and place the user in prompt mode.

These should be used with caution when input is being read from a pipe, because an interrupt is likely to

terminate the other commands in the pipeline.

Users of

more will ﬁnd that the z and f commands are available, and that the terminal

/, ˆ,or ? can

be omitted from the pattern search commands.

FILES

/usr/share/lib/terminfo/?/*

terminal information data base

/tmp/pg* temporary ﬁle when input is from a pipe