pg.1: updates documentation

This commit is contained in:
Emma Tebibyte 2024-06-26 18:54:43 -06:00
parent 7142994367
commit 7a452794b1
Signed by: emma
GPG Key ID: 06FA419A1698C270

View File

@ -1,41 +1,52 @@
.\" Copyright (c) 2024 DTB <trinity@trinity.moe> .\" Copyright (c) 2024 DTB <trinity@trinity.moe>
.\" Copyright (c) 2024 Emma Tebibyte <emma@tebibyte.media>
.\" .\"
.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license, .\" 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/>. .\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.
.\"
.TH PG 1 .TH PG 1 2024-06-26 "Harakit X.X.X"
.SH NAME .SH NAME
pg \(en paginate pg \(en paginate
.\"
.SH SYNOPSIS .SH SYNOPSIS
pg pg
.RB ( -p .RB ( -p
.RB [ prompt ]) .RB [ prompt ])
.\"
.SH DESCRIPTION .SH DESCRIPTION
Pg prints standard input to standard output, accepting commands between pages. Print standard input to standard output, accepting commands between pages.
.\"
.SH OPTIONS .SH OPTIONS
.B -p .IP -p
.RS Replace the default prompt (\(lq: \(rq) with the option argument.
Replaces the default prompt (": ") with the next argument. .\"
.RE
.SH DIAGNOSTICS .SH DIAGNOSTICS
Pg returns an unsuccessful exit code if the tty couldn't be opened or if pg was In the event of an error, a debug message will be printed and the program will
invoked incorrectly (with any arguments). exit with the appropriate
.BR sysexits.h (3)
error code.
.\"
.SH RATIONALE .SH RATIONALE
Plan 9 from Bell Labs had p(1), a similar "cooked"-mode paginator (as opposed Plan 9 from Bell Labs had
to "raw" mode, which a vast majority of paginators use). .BR p (1),
a similar \(lqcooked\(rq-mode paginator (as opposed to \(lqraw\(rq mode, which a
vast majority of paginators use).
.\"
.SH AUTHOR
Written by DTB
.MT trinity@trinity.moe
.ME .
.\"
.SH COPYRIGHT
Copyright \(co 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later
<https://gnu.org/licenses/agpl.html>.
.\"
.SH SEE ALSO .SH SEE ALSO
.BR more (1p)
more(1)