diff options
Diffstat (limited to 'usr/src/man/man1/more.1')
| -rw-r--r-- | usr/src/man/man1/more.1 | 168 |
1 files changed, 18 insertions, 150 deletions
diff --git a/usr/src/man/man1/more.1 b/usr/src/man/man1/more.1 index 34ab151bde..25522161b9 100644 --- a/usr/src/man/man1/more.1 +++ b/usr/src/man/man1/more.1 @@ -1,37 +1,37 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH more 1 "4 Nov 2005" "SunOS 5.11" "User Commands" +.TH MORE 1 "Nov 4, 2005" .SH NAME more, page \- browse or page through a text file .SH SYNOPSIS .LP .nf -\fB/usr/bin/more\fR [\fB-cdflrsuw\fR] [\fB-lines\fR] [+ \fIlinenumber\fR] +\fB/usr/bin/more\fR [\fB-cdflrsuw\fR] [\fB-lines\fR] [+ \fIlinenumber\fR] [+/ \fIpattern\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/bin/page\fR [\fB-cdflrsuw\fR] [\fB-lines\fR] [+ \fIlinenumber\fR] +\fB/usr/bin/page\fR [\fB-cdflrsuw\fR] [\fB-lines\fR] [+ \fIlinenumber\fR] [+/ \fIpattern\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/more\fR [\fB-cdeisu\fR] [\fB-n\fR \fInumber\fR] [\fB-p\fR \fIcommand\fR] +\fB/usr/xpg4/bin/more\fR [\fB-cdeisu\fR] [\fB-n\fR \fInumber\fR] [\fB-p\fR \fIcommand\fR] [\fB-t\fR \fItagstring\fR] [\fIfile\fR]... .fi .LP .nf -\fB/usr/xpg4/bin/more\fR [\fB-cdeisu\fR] [\fB-n\fR \fInumber\fR] [+ \fIcommand\fR] +\fB/usr/xpg4/bin/more\fR [\fB-cdeisu\fR] [\fB-n\fR \fInumber\fR] [+ \fIcommand\fR] [\fB-t\fR \fItagstring\fR] [\fIfile\fR]... .fi @@ -74,12 +74,10 @@ The following options are supported for both \fB/usr/bin/more\fR and \fB/usr/xpg4/bin/more\fR: .sp .ne 2 -.mk .na \fB\fB-c\fR \fR .ad .RS 7n -.rt Clears before displaying. Redraws the screen instead of scrolling for faster displays. This option is ignored if the terminal does not have the ability to clear to the end of a line. @@ -87,24 +85,20 @@ clear to the end of a line. .sp .ne 2 -.mk .na \fB\fB-d\fR \fR .ad .RS 7n -.rt Displays error messages rather than ringing the terminal bell if an unrecognized command is used. This is helpful for inexperienced users. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR \fR .ad .RS 7n -.rt Squeeze. Replaces multiple blank lines with a single blank line. This is helpful when viewing \fBnroff\fR(1) output on the screen. .RE @@ -115,12 +109,10 @@ helpful when viewing \fBnroff\fR(1) output on the screen. The following options are supported for \fB/usr/bin/more\fR only: .sp .ne 2 -.mk .na \fB\fB-f\fR \fR .ad .RS 15n -.rt Does not fold long lines. This is useful when lines contain nonprinting characters or escape sequences, such as those generated when \fBnroff\fR(1) output is piped through \fBul\fR(1). @@ -128,12 +120,10 @@ output is piped through \fBul\fR(1). .sp .ne 2 -.mk .na \fB\fB-l\fR \fR .ad .RS 15n -.rt Does not treat \fBFORMFEED\fR characters (Control-l) as page breaks. If \fB-l\fR is not used, \fBmore\fR pauses to accept commands after any line containing a \fB^L\fR character (Control-l). Also, if a file begins with a @@ -142,12 +132,10 @@ containing a \fB^L\fR character (Control-l). Also, if a file begins with a .sp .ne 2 -.mk .na \fB\fB-r\fR \fR .ad .RS 15n -.rt Normally, \fBmore\fR ignores control characters that it does not interpret in some way. The \fB-r\fR option causes these to be displayed as \fB^\fR\fIC\fR where \fIC\fR stands for any such control character. @@ -155,12 +143,10 @@ where \fIC\fR stands for any such control character. .sp .ne 2 -.mk .na \fB\fB-u\fR \fR .ad .RS 15n -.rt Suppresses generation of underlining escape sequences. Normally, \fBmore\fR handles underlining, such as that produced by \fBnroff\fR(1), in a manner appropriate to the terminal. If the terminal can perform underlining or has a @@ -170,12 +156,10 @@ in the text file. .sp .ne 2 -.mk .na \fB\fB-w\fR \fR .ad .RS 15n -.rt Normally, \fBmore\fR exits when it comes to the end of its input. With \fB-w\fR, however, \fBmore\fR prompts and waits for any key to be struck before exiting. @@ -183,35 +167,29 @@ exiting. .sp .ne 2 -.mk .na \fB\fB-\fR\fIlines\fR\fR .ad .RS 15n -.rt Displays the indicated number of \fIlines\fR in each screenful, rather than the default (the number of lines in the terminal screen less two). .RE .sp .ne 2 -.mk .na \fB\fB+\fR\fIlinenumber\fR\fR .ad .RS 15n -.rt Start up at \fIlinenumber\fR. .RE .sp .ne 2 -.mk .na \fB\fB+/\fR\fIpattern\fR\fR .ad .RS 15n -.rt Start up two lines above the line containing the regular expression \fIpattern\fR. \fBNote:\fR Unlike editors, this construct should \fInot\fR end with a `\fB/\fR.' If it does, then the trailing slash is taken as a character @@ -224,35 +202,29 @@ in the search pattern. The following options are supported for \fB/usr/xpg4/bin/more\fR only: .sp .ne 2 -.mk .na \fB\fB-e\fR \fR .ad .RS 17n -.rt Exits immediately after writing the last line of the last file in the argument list. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR \fR .ad .RS 17n -.rt Performs pattern matching in searches without regard to case. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR \fInumber\fR \fR .ad .RS 17n -.rt Specifies the number of lines per screenful. The \fInumber\fR argument is a positive decimal integer. The \fB-n\fR option overrides any values obtained from the environment. @@ -260,7 +232,6 @@ from the environment. .sp .ne 2 -.mk .na \fB\fB-p\fR \fIcommand\fR \fR .ad @@ -269,7 +240,6 @@ from the environment. \fB\fB+\fR\fIcommand\fR \fR .ad .RS 17n -.rt For each file examined, initially executes the \fBmore\fR command in the \fIcommand\fR argument. If the command is a positioning command, such as a line number or a regular expression search, set the current position to represent @@ -278,7 +248,7 @@ file. For example, the two commands: .sp .in +2 .nf -\fBmore -p 1000j file +\fBmore -p 1000j file more -p 1000G file\fR .fi .in -2 @@ -292,24 +262,20 @@ unsuccessful, the first line in the file will be the current position. .sp .ne 2 -.mk .na \fB\fB-t\fR \fItagstring\fR \fR .ad .RS 17n -.rt Writes the screenful of the file containing the tag named by the \fItagstring\fR argument. See the \fBctags\fR(1) utility. .RE .sp .ne 2 -.mk .na \fB\fB-u\fR\fR .ad .RS 17n -.rt Treats a backspace character as a printable control character, displayed as a ^H (Control-h), suppressing backspacing and the special handling that produces underlined or standout-mode text on some terminal types. Also, does not ignore @@ -349,29 +315,24 @@ In the following commands, \fIi\fR is a numerical argument (\fB1\fR by default). .sp .ne 2 -.mk .na \fB\fIi\fRSPACE \fR .ad .RS 13n -.rt Display another screenful, or \fIi\fR more lines if \fIi\fR is specified. .RE .sp .ne 2 -.mk .na \fB\fIi\fRRETURN \fR .ad .RS 13n -.rt Display another line, or \fIi\fR more lines, if specified. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBb\fR\fR .ad @@ -380,13 +341,11 @@ Display another line, or \fIi\fR more lines, if specified. \fB\fIi\fR\fB^B\fR\fR .ad .RS 13n -.rt (Control-b) Skip back \fIi\fR screenfuls and then print a screenful. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBd\fR\fR .ad @@ -395,7 +354,6 @@ Display another line, or \fIi\fR more lines, if specified. \fB\fIi\fR\fB^D\fR\fR .ad .RS 13n -.rt (Control-d) Scroll forward one half screenful or \fIi\fR more lines. If \fIi\fR is specified, the count becomes the default for subsequent \fBd\fR and \fBu\fR commands. @@ -403,51 +361,42 @@ commands. .sp .ne 2 -.mk .na \fB\fIi\fR\fBf\fR\fR .ad .RS 13n -.rt Skip \fIi\fR screens full and then print a screenful. .RE .sp .ne 2 -.mk .na \fB\fBh\fR\fR .ad .RS 13n -.rt Help. Give a description of all the \fBmore\fR commands. .RE .sp .ne 2 -.mk .na \fB\fB^L\fR \fR .ad .RS 13n -.rt (Control-l) Refresh. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBn\fR\fR .ad .RS 13n -.rt Search for the \fIi\|\fRth occurrence of the last \fIpattern\fR entered. .RE .sp .ne 2 -.mk .na \fB\fBq\fR \fR .ad @@ -456,63 +405,52 @@ Search for the \fIi\|\fRth occurrence of the last \fIpattern\fR entered. \fB\fBQ\fR \fR .ad .RS 13n -.rt Exit from \fBmore\fR. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBs\fR\fR .ad .RS 13n -.rt Skip \fIi\fR lines and then print a screenful. .RE .sp .ne 2 -.mk .na \fB\fBv\fR\fR .ad .RS 13n -.rt Drop into the \fBvi\fR editor at the current line of the current file. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBz\fR\fR .ad .RS 13n -.rt Same as SPACE, except that \fIi\fR, if present, becomes the new default number of lines per screenful. .RE .sp .ne 2 -.mk .na \fB\fB=\fR \fR .ad .RS 13n -.rt Display the current line number. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB/\fR\fIpattern\fR\fR .ad .RS 13n -.rt Search forward for the \fIi\|\fRth occurrence of the regular expression \fIpattern\fR. Display the screenful starting two lines before the line that contains the \fIi\|\fRth match for the regular expression \fIpattern\fR, or the @@ -524,12 +462,10 @@ the first column cancels the search command. .sp .ne 2 -.mk .na \fB\fB!\fR\fIcommand\fR\fR .ad .RS 13n -.rt Invoke a shell to execute \fIcommand\|\fR. The characters \fB%\fR and \fB!\fR, when used within \fIcommand\fR are replaced with the current filename and the previous shell command, respectively. If there is no current filename, \fB%\fR @@ -538,35 +474,29 @@ is not expanded. Prepend a backslash to these characters to escape expansion. .sp .ne 2 -.mk .na \fB\fB:f\fR\fR .ad .RS 13n -.rt Display the current filename and line number. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB:n\fR\fR .ad .RS 13n -.rt Skip to the \fIi\|\fRth next filename given in the command line, or to the last filename in the list if \fIi\fR is out of range. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB:p\fR\fR .ad .RS 13n -.rt Skip to the \fIi\|\fRth previous filename given in the command line, or to the first filename if \fIi\fR is out of range. If given while \fBmore\fR is positioned within a file, go to the beginning of the file. If \fBmore\fR is @@ -575,7 +505,6 @@ reading from a pipe, \fBmore\fR simply rings the terminal bell. .sp .ne 2 -.mk .na \fB\fB:q\fR\fR .ad @@ -584,7 +513,6 @@ reading from a pipe, \fBmore\fR simply rings the terminal bell. \fB\fB:Q\fR\fR .ad .RS 13n -.rt Exit from \fBmore\fR (same as \fBq\fR or \fBQ\fR). .RE @@ -594,35 +522,29 @@ Exit from \fBmore\fR (same as \fBq\fR or \fBQ\fR). The following commands are available only in \fB/usr/bin/more\fR: .sp .ne 2 -.mk .na \fB\fB\&'\fR\fR .ad .RS 9n -.rt Single quote. Go to the point from which the last search started. If no search has been performed in the current file, go to the beginning of the file. .RE .sp .ne 2 -.mk .na \fB\fB\&.\fR\fR .ad .RS 9n -.rt Dot. Repeat the previous command. .RE .sp .ne 2 -.mk .na \fB\fB^\|\e\fR\fR .ad .RS 9n -.rt Halt a partial display of text. \fBmore\fR stops sending output, and displays the usual \fB--More--\fR prompt. Some output is lost as a result. .RE @@ -633,119 +555,98 @@ the usual \fB--More--\fR prompt. Some output is lost as a result. The following commands are available only in \fB/usr/xpg4/bin/more\fR: .sp .ne 2 -.mk .na \fB\fIi\fR\fB^F\fR\fR .ad .RS 17n -.rt (Control-f) Skip \fIi\fR screens full and print a screenful. (Same as \fIi\fR\fBf\fR.) .RE .sp .ne 2 -.mk .na \fB\fB^G\fR\fR .ad .RS 17n -.rt (Control-g) Display the current line number (same as \fB=\fR). .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBg\fR\fR .ad .RS 17n -.rt Go to line number \fIi\fR with the default of the first line in the file. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBG\fR\fR .ad .RS 17n -.rt Go to line number \fIi\fR with the default of the Last line in the file. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBj\fR\fR .ad .RS 17n -.rt Display another line, or \fIi\fR more lines, if specified. (Same as \fIi\fRRETURN.) .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBk\fR\fR .ad .RS 17n -.rt Scroll backwards one or \fIi\fR lines, if specified. .RE .sp .ne 2 -.mk .na \fB\fBm\fR\fIletter\fR \fR .ad .RS 17n -.rt Mark the current position with the name \fIletter\fR. .RE .sp .ne 2 -.mk .na \fB\fBN\fR \fR .ad .RS 17n -.rt Reverse direction of search. .RE .sp .ne 2 -.mk .na \fB\fBr\fR \fR .ad .RS 17n -.rt Refresh the screen. .RE .sp .ne 2 -.mk .na \fB\fBR\fR \fR .ad .RS 17n -.rt Refresh the screen, discarding any buffered input. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fBu\fR\fR .ad @@ -754,7 +655,6 @@ Refresh the screen, discarding any buffered input. \fB\fIi\fR\fB^U\fR\fR .ad .RS 17n -.rt (Control-u) Scroll backwards one half a screen of \fIi\fR lines, if specified. If \fIi\fR is specified, the count becomes the new default for subsequent \fBd\fR and \fBu\fR commands. @@ -762,35 +662,29 @@ If \fIi\fR is specified, the count becomes the new default for subsequent .sp .ne 2 -.mk .na \fB\fBZZ\fR \fR .ad .RS 17n -.rt Exit from \fBmore\fR (same as \fBq\fR). .RE .sp .ne 2 -.mk .na \fB\fB:e\fR \fIfile\fR \fR .ad .RS 17n -.rt Examine (display) a new file. If no \fIfile\fR is specified, the current file is redisplayed. .RE .sp .ne 2 -.mk .na \fB\fB:t\fR \fItagstring\fR \fR .ad .RS 17n -.rt Go to the tag named by the \fItagstring\fR argument and scroll/rewrite the screen with the tagged line in the current position. See the \fBctags\fR utility. @@ -798,35 +692,29 @@ utility. .sp .ne 2 -.mk .na \fB\fB\&'\fR\fIletter\fR \fR .ad .RS 17n -.rt Return to the position that was previously marked with the name \fIletter\fR. .RE .sp .ne 2 -.mk .na \fB\fB\&''\fR \fR .ad .RS 17n -.rt Return to the position from which the last move of more than a screenful was made. Defaults to the beginning of the file. .RE .sp .ne 2 -.mk .na \fB\fIi\fR\fB?\fR[\fI!\fR]\fIpattern\fR\fR .ad .RS 17n -.rt Search backward in the file for the \fIi\fRth line containing the \fIpattern\fR. The \fI!\fR specifies to search backward for the \fIi\fRth line that does not contain the \fIpattern\fR. @@ -834,24 +722,20 @@ that does not contain the \fIpattern\fR. .sp .ne 2 -.mk .na \fB\fIi\fR\fB/\fR\fB!\fR\fIpattern\fR\fR .ad .RS 17n -.rt Search forward in the file for the \fIi\fRth line that does not contain the pattern. .RE .sp .ne 2 -.mk .na \fB\fB!\fR[\fIcommand\fR]\fR .ad .RS 17n -.rt Invoke a shell or the specified command. .RE @@ -875,46 +759,38 @@ The following environment variables also affect the execution of \fB/usr/xpg4/bin/more\fR: .sp .ne 2 -.mk .na \fB\fBCOLUMNS\fR \fR .ad .RS 12n -.rt Overrides the system selected horizontal screen size. .RE .sp .ne 2 -.mk .na \fB\fBEDITOR\fR \fR .ad .RS 12n -.rt Used by the \fBv\fR command to select an editor. .RE .sp .ne 2 -.mk .na \fB\fBLINES\fR \fR .ad .RS 12n -.rt Overrides the system selected vertical screen size. The \fB-n\fR option has precedence over \fBLINES\fR in determining the number of lines in a screen. .RE .sp .ne 2 -.mk .na \fB\fBMORE\fR \fR .ad .RS 12n -.rt A string specifying options as described in the OPTIONS section, above. As in a command line, The options must be separated by blank characters and each option specification must start with a \(mi. Any command line options are processed @@ -928,35 +804,29 @@ $MORE\fR \fIoptions operands\fR The following exit values are returned: .sp .ne 2 -.mk .na \fB\fB0\fR \fR .ad .RS 7n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fB>0\fR \fR .ad .RS 7n -.rt An error occurred. .RE .SH FILES .sp .ne 2 -.mk .na \fB\fB/usr/lib/more.help\fR\fR .ad .RS 22n -.rt help file for \fB/usr/bin/more\fR and \fB/usr/bin/page\fR only. .RE @@ -969,13 +839,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSINot enabled +CSI Not enabled .TE .SS "/usr/xpg4/bin/more" @@ -983,15 +852,14 @@ CSINot enabled .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -CSIEnabled +CSI Enabled _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO |