.\" Copyright (c) 2024 DTB <trinity@trinity.moe>
.\"
.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license,
.\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.

.TH PG 1

.SH NAME

pg \(en paginate

.SH SYNOPSIS

pg
.RB ( -p
.RB [ prompt ])

.SH DESCRIPTION

Pg prints standard input to standard output, accepting commands between pages.

.SH OPTIONS

.B -p
.RS
Replaces the default prompt (": ") with the next argument.
.RE

.SH DIAGNOSTICS

Pg returns an unsuccessful exit code if the tty couldn't be opened or if pg was
invoked incorrectly (with any arguments).

.SH RATIONALE

Plan 9 from Bell Labs had p(1), a similar "cooked"-mode paginator (as opposed
to "raw" mode, which a vast majority of paginators use).

.SH SEE ALSO

more(1)