docs: update year in libs docs

[thirdparty/util-linux.git] / text-utils / more.1

.\" Copyright (c) 1988, 1990 The Regents of the University of California.
.\" Copyright (c) 1988 Mark Nudleman
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	@(#)more.1	5.15 (Berkeley) 7/29/91
.\"
.\" Copyright (c) 1992 Rik Faith (faith@cs.unc.edu)
.\"
.TH MORE "1" "February 2014" "util-linux" "User Commands"
.SH NAME
more \- file perusal filter for crt viewing
.SH SYNOPSIS
.B more
[options]
.IR file ...
.SH DESCRIPTION
.B more
is a filter for paging through text one screenful at a time.  This version is
especially primitive.  Users should realize that
.BR less (1)
provides
.BR more (1)
emulation plus extensive enhancements.
.SH OPTIONS
Options are also taken from the environment variable
.B MORE
(make sure to precede them with a dash
.RB ( \- ))
but command-line options will override those.
.TP
.B \-d
Prompt with "[Press space to continue, 'q' to quit.]",
and display "[Press 'h' for instructions.]" instead of ringing
the bell when an illegal key is pressed.
.TP
.B \-l
Do not pause after any line containing a
.B \&^L
(form feed).
.TP
.B \-f
Count logical lines, rather than screen lines (i.e., long lines are not folded).
.TP
.B \-p
Do not scroll.  Instead, clear the whole screen and then display the text.
Notice that this option is switched on automatically if the executable is
named
.BR page .
.TP
.B \-c
Do not scroll.  Instead, paint each screen from the top, clearing the
remainder of each line as it is displayed.
.TP
.B \-s
Squeeze multiple blank lines into one.
.TP
.B \-u
Suppress underlining.
.TP
.BI \- number
The screen size to use, in
.I number
of lines.
.TP
.BI + number
Start displaying each file at line
.IR number .
.TP
.BI +/ string
The
.I string
to be searched in each file before starting to display it.
.TP
\fB\-\-help\fR
Display help text and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display version information and exit.
.SH COMMANDS
Interactive commands for
.B more
are based on
.BR vi (1).
Some commands may be preceded by a decimal number, called k in the
descriptions below.  In the following descriptions,
.B ^X
means
.BR control-X .
.PP
.RS
.PD 1
.TP 10
.BR h \ or \ ?
Help; display a summary of these commands.  If you forget all other
commands, remember this one.
.TP
.B SPACE
Display next k lines of text.  Defaults to current screen size.
.TP
.B z
Display next k lines of text.  Defaults to current screen size.  Argument
becomes new default.
.TP
.B RETURN
Display next k lines of text.  Defaults to 1.  Argument becomes new default.
.TP
.BR d \ or \ \&^D
Scroll k lines.  Default is current scroll size, initially 11.  Argument
becomes new default.
.TP
.BR q \ or \ Q \ or \ INTERRUPT
Exit.
.TP
.B s
Skip forward k lines of text.  Defaults to 1.
.TP
.B f
Skip forward k screenfuls of text.  Defaults to 1.
.TP
.BR b \ or \ \&^B
Skip backwards k screenfuls of text.  Defaults to 1.  Only works with files,
not pipes.
.TP
.B '
Go to the place where the last search started.
.TP
.B =
Display current line number.
.TP
.B \&/pattern
Search for kth occurrence of regular expression.  Defaults to 1.
.TP
.B n
Search for kth occurrence of last regular expression.  Defaults to 1.
.TP
.BR !command \ or \ :!command
Execute
.I command
in a subshell.
.TP
.B v
Start up an editor at current line.  The editor is taken from the environment
variable
.B VISUAL
if defined, or
.B EDITOR
if
.B VISUAL
is not defined, or defaults
to
.B vi
if neither
.B VISUAL
nor
.B EDITOR
is defined.
.TP
.B \&^L
Redraw screen.
.TP
.B :n
Go to kth next file.  Defaults to 1.
.TP
.B :p
Go to kth previous file.  Defaults to 1.
.TP
.B :f
Display current file name and line number.
.TP
.B \&.
Repeat previous command.
.RE
.SH ENVIRONMENT
The
.B more
command respects the following environment variables, if they exist:
.TP
.B MORE
This variable may be set with favored options to
.BR more .
.TP
.B SHELL
Current shell in use (normally set by the shell at login time).
.TP
.B TERM
The terminal type used by \fBmore\fR to get the terminal
characteristics necessary to manipulate the screen.
.TP
.B VISUAL
The editor the user prefers.  Invoked when command key
.I v
is pressed.
.TP
.B EDITOR
The editor of choice when
.B VISUAL
is not specified.
.SH SEE ALSO
.BR less (1),
.BR vi (1)
.SH AUTHORS
Eric Shienbrood, UC Berkeley
.br
Modified by Geoff Peck, UCB to add underlining, single spacing
.br
Modified by John Foderaro, UCB to add \-c and MORE environment variable
.SH HISTORY
The
.B more
command appeared in 3.0BSD.  This man page documents
.B more
version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux
community.  Documentation was produced using several other versions of the
man page, and extensive inspection of the source code.
.SH AVAILABILITY
The more command is part of the util-linux package and is available from
.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
Linux Kernel Archive
.UE .