NAME

p - browse or page through files and filter unprintable characters

SYNOPSIS

p [ options ] [ file1 ... filen ]

DESCRIPTION

p reads the files from the argument list and displays them on standard out. If the argument list is empty and standard in is not connected to a terminal, p reads from standard in. After displaying a screen full of text, p stops and displays a MORE ? prompt. If p is reading input from a file and not from a pipe, it displays the percentage of characters already typed together with the MORE prompt.

p interprets non printable characters, such as control characters. Control characters are transformed into the printable character space and preceded by a "^" character. If the eight bit in a character is on and the character appears to unprintable, a tilde "~" character is preceded in addition. Tabs are expanded into spaces as usual on UNIX and lines that exceed the line length of the terminal are wrapped around and continued on the next line of the screen.

OPTIONS

All options can be abbreviated by their first letter.

length=#

Set the number of lines per page. If no termcap entry could be found length defaults to 24.

width=#

Set the number of characters per line. If no termcap entry could be found width defaults to 79.

-blank

Suppress multiple blank lines on the output.

-clear

Clear the screen before displaying each new page.

-debug

Print additional debugging information.

-dos

Hide carriage-return characters that are directly followed by a new-line.

-end

Mark the end of each line with the character '$'.

-help

Print a short summary of the available options and commands.

-nodos

Do not hide carriage-return characters that are directly followed by a new-line. This option is needed in order to make p binary transparent, so reading files that do not follow DOS newline conventions will not be automatically converted.

-raw

Do not expand control characters.

-raw8

Do not expand characters with top bit set.

-silent

Do not print a MORE ? prompt. Only do the formatting for the content of the files. This option may be used when p is only used as a filter.

-tab

Do not expand tabs to spaces, expand them to '^I'.

-visible

Underlining and bold sequences become visible.

-help

Prints a short summary of the p(1) options and exists.

-version

Prints the p(1) version number string and exists.

If a

COMMANDS

MORE ? prompt is displayed, the following commands are valid:

y,Y,<CR>,<LF>

Yes. Display the next full screen of text.

h,H

Half. Display the next half screen of text.

q,Q

Quarter. Display the next quarter screen of text.

l,L

Line. Display the next line of text.

1-9

Lines. Display the next 1-9 lines of text.

n,N

Next/No. Display the next file. If the current file is the last file in the list exit p.

p,P

Previous. Display the previous file. If the current file is the first file in the list just start to display the first file.

s,S

Stop. Exit the p program.

/pattern

Search. Start searching for pattern.

r,R

Research. Re search for previous pattern.

^L

Redraw. Redisplay the current screen content.

v,V

View (Edit). Start the editor in read only mode with cursor position set to the current line.

!

Shell. Execute a shell using the rest of the input line as shell command.

?

Help. Print a short help message that lists valid commands.

other

Error. All other input will cause a beep if the environment BEEP is not set to off.

If the end of a file is reached, p will start with the next file.

ENVIRONMENT

SHELL

For the shell to use for shell command escapes, file name globbing and similar.

EDITOR

The name of the editor (used for the v command).

HOME

To find the private files like ~/.termcap

TERM

The type of terminal for which the output should be formatted.

TERMCAP

This environment variable holds either a precompiled termcap entry or the pathname to be used to find a termcap database file. If it holds a precompiled entry that does not match the TERM environment, the termcap database is parsed as if the TERMCAP environment is not set.

TERMPATH

If TERMCAP is empty, then the TERMPATH environment is scanned for pathnames of files that contain a termcap database. It holds a list of filenames separated by colons or spaces (i.e., ":" or " "). If the TERMPATH symbol is not set, the files $HOME/.termcap and /etc/termcap are scanned in that order.

BEEP

The environment variable BEEP is used to suppress beeping when set to off. This helps to use p on a notebook in a meeting.

FILES

/etc/termcap

The system's terminal capabilities database.

~/.termcap

The private terminal capabilities database. This file is checked first, in case that the TERMPATH environment is not defined.

NOTES

If you type p with no arguments and do not redirect its standard input, p will display its usage message.

If the terminal driver is configured to strip the eight bit in characters, p will display a tilde character before any character that has the eight bit set (i.e. ~V).

BUGS

None currently known.

Mail bugs and suggestions to schilytools@mlists.in-berlin.de or open a ticket at https://codeberg.org/schilytools/schilytools/issues.

The mailing list archive may be found at:

https://mlists.in-berlin.de/mailman/listinfo/schilytools-mlists.in-berlin.de.

AUTHORS

Joerg Schilling and the schilytools project authors.

SOURCE DOWNLOAD

The source code for p is included in the schilytools project and may be retrieved from the schilytools project at Codeberg at

https://codeberg.org/schilytools/schilytools.

The download directory is

https://codeberg.org/schilytools/schilytools/releases.