https://github.com/knu/p
p - a lazy wrapper for $PAGER
https://github.com/knu/p
Last synced: about 1 month ago
JSON representation
p - a lazy wrapper for $PAGER
- Host: GitHub
- URL: https://github.com/knu/p
- Owner: knu
- License: bsd-2-clause
- Created: 2012-03-15T08:35:10.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2017-05-13T17:05:01.000Z (about 9 years ago)
- Last Synced: 2025-01-26T01:41:46.536Z (over 1 year ago)
- Language: Shell
- Homepage:
- Size: 7.81 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# p - a lazy wrapper for `$PAGER`
## NAME
`p(1) - a lazy wrapper for $PAGER`
## SYNOPSIS
```
p
p ...
```
## DESCRIPTION
`p(1)` is a lazy wrapper for `$PAGER`, which brings any pager a
similar functionality of the `-F`/`--quit-if-one-screen` option of
`less(1)`.
When invoked as a piped pager (i.e. the standard input is not a
terminal) without a file argument, it delays a pager invocation until
it gets more lines than are displayable in the current terminal. The
line number limit is estimated by subtracting two from the terminal's
height to leave room for shell prompts.
If any argument is given or the standard input is a terminal, it
becomes eager enough to delegate everything to the pager. This means
calling `p` with a `-` (`... | p -`) always invokes the pager even if
it gets small input.
Lastly, if the standard output is not a terminal, it just passes the
standard input through to the standard output without calling a pager.
## ENVIRONMENT
- `PAGER`
The command (or command line) wrapped around and invoked by this
wrapper.
## SEE ALSO
[`less(1)`](http://www.freebsd.org/cgi/man.cgi?query=less&sektion=1)
## AUTHOR
Copyright (c) 2012 Akinori MUSHA.
Licensed under the 2-clause BSD license. See `LICENSE.txt` for
details.
Visit [GitHub Repository](https://github.com/knu/p) for the latest
information.