.\" SCCSID: @(#)more.1	2.4	7/17/87.TH more 1.SH Namemore, page \- display file data at your terminal.SH Syntax.B more[\fB\-cdflsu\fR] [\fB\-\fIn\fR\|] [\fB\+\fIlinenumber\fR\|] [\fB\+/\fIpattern\fR\|][\|\fIname...\fR\|].PP.B page.I "more options".SH Description.NXB "more command" .NXB "terminal" "viewing one screenful at a time".NXR "page command".NXA "cat command" "more command"The.PN morefilter allows you to examine a fileone screenful of text at a time on a soft-copy terminal.It normally pauses after each screenful, printing --More-- at thebottom of the screen.If the user then types a carriage return, one more line is displayed.If the user presses the space bar,another screenful is displayed..SH Options.NXR "more command" "options".IP +\fIlinenumber\fR 12Start up at \fIlinenumber\fP..IP +/\fIpattern\fR Start up two lines before the line containing theregular expression \fIpattern\fP.The command line options are:.IP \fB\-c\fR Begins each page at the top of the screen and erases each line just before it draws onit.  This avoids scrolling the screen, making it easier to read while .PN more is writing.This option is ignored if the terminal does not have the abilityto clear to the end of a line..IP \fB\-d\fR Displays extended continuation prompt at end of each display.  The.PN morecommandprompts the user with the message "Pressspace to continue, \'q\' to quit." at the end of each screenful,and responds to subsequent illegal user input byprinting "Press \'h\' for instructions." instead of ringing the bell.This is useful if.B moreis being used as a filter in some setting,such as a class,where many users may be unsophisticated..IP \fB\-f\fR Counts logical text lines (does not fold long lines).  This option is recommended if.PN nroffoutput is being piped through.PN ul ,since the latter may generate escape sequences.These escape sequences contain characters which would ordinarily occupyscreen positions, but which do not print when they are sent to theterminal as part of an escape sequence.Thus.PN moremay think that lines are longer than they actually are, and foldlines erroneously..IP \fB\-l\fR Ignores line feeds (CTRL/Ls) and normally, pauses at line feeds.    If this option is not given,.PN morepauses after any line that contains a ^L, as if the end of ascreenful had been reached.Also, if a file begins with a form feed, the screen is clearedbefore the file is printed..IP \fB\-\fIn\fR Specifies number of line .PN moredisplays..IP \fB\-s\fR Squeezes multiple blank lines from the output, producing only one blankline.  Especially helpful when viewing.PN nroffoutput, this option maximizes the useful information presenton the screen..IP \fB\-u\fR Ignores all underlining in the data.  If the terminal canperform underlining or has a stand-out mode,.PN moreoutputs appropriate escape sequences to enable underlining or stand-outmode for underlined information in the source file.  The.I \-uoption suppresses this processing..PPIf the program is invoked as.B page,then the screen is cleared before each screenful is printed (but onlyif a full screenful is being printed), and.I k\- 1 ratherthan.I k\- 2 lines are printed in each screenful, where.I kis the number of lines the terminal can display..PPThe.PN morecommand looks in the file /etc/termcapto determine terminal characteristics,and to determine the default window size.On a terminal capable of displaying 24 lines,the default window size is 22 lines..PPThe.PN morecommand looks in the environment variable.I MOREto pre-set any flags desired.For example, if you prefer to view files usingthe.I \-cmode of operation, the.PN cshcommand.I "setenv MORE \-c"or the.PN shcommand sequence.I "MORE='-c' ; export MORE"would cause all invocations of.PN more ,including invocations by programs such as.PN manand.PN msgs ,to use this mode.Normally, the user places the command sequence which sets up the.I MOREenvironment variable in the .cshrcor .profile file..PPIf.PN moreis reading from a file, rather than a pipe,then a percentage is displayedalong with the --More-- prompt.This gives the fraction of the file (in characters,not lines) that has been read so far..PPOther sequences which may be typed when.PN morepauses, and their effects, are as follows(\fIi\fP is an optional integerargument, defaulting to 1) :.IP \fIi\|\fP<space> 12Display.I imore lines, (or another screenful if no argument is given).IP ^DDisplay 11 more lines (a ``scroll'').If.I iis given, then the scroll size is set to \fIi\|\fP..IP dSame as ^D (control-D).IP \fIi\|\fPzSame as typing a space except that \fIi\|\fP, if present, becomes the newwindow size..IP \fIi\|\fPsSkip \fIi\|\fP lines and print a screenful of lines.IP \fIi\|\fPfSkip \fIi\fP screenfuls and print a screenful of lines.IP "\fIi\|\fPb or \fIi\|\fP^B"Skip back \fIi\fP screenfuls and print a screenful of lines.IP "q or Q"Exit from.I more..IP =Display the current line number..IP vStart up the editor.PN viat the current line..IP "h or ?"Help command; give a description of all the.B morecommands..IP \fIi\|\fP/exprSearch for the \fIi\|\fP-th occurrenceof the regular expression \fIexpr.\fPIf there are less than \fIi\fP occurrences of \fIexpr\|\fP,and the input is a file (rather than a pipe),then the position in the file remains unchanged.Otherwise, a screenful is displayed, starting two lines before the placewhere the expression was found.The user's erase and kill characters may be used to edit the regularexpression.Erasing back past the first column cancels the search command.of the last regular expression entered..IP \fIi\|\fPnSearch for the \fIi\|\fP-th occurrence.IP '(single quote) Go to the point from which the last search started.If no search has been performed in the current file, this commandgoes back to the beginning of the file..IP !commandInvoke a shell with \fIcommand\|\fP. The characters `%' and `!' in "command" are replaced with thecurrent file name and the previous shell command respectively.If there is no current file name, `%' is not expanded.The sequences "\\%" and "\\!" are replaced by "%" and "!" respectively..IP \fIi\|\fP:nskip to the \fIi\|\fP-th next file given in the command line(skips to last file if n doesn't make sense).IP \fIi\|\fP:pSkip to the \fIi\|\fP-th previous file given in the command line.If this command is given in the middle of printing out afile, then.PN moregoes back to the beginning of the file. If \fIi\fP doesn't make sense,.PN moreskips back to the first file.If.PN moreis not reading from a file, the bell is rung and nothing else happens..IP :fDisplay the current file name and line number..IP ":q or :Q"Exit from .PN more.IP .(dot) Repeat the previous command..PPThe commands take effect immediately, that is, it is not necessary totype a carriage return.Up to the time when the command character itself is given,the user may hit the line kill character to cancel the numericalargument being formed.In addition, the user may hit the erase character to redisplay the--More--(xx%) message..PPAt any time when output is being sent to the terminal, the user canhit the quit key (normally control\-\\).The.PN morecommand stops sending output, and displays the usual --More--prompt.The user may then enter one of the above commands in the normal manner.Unfortunately, some output is lost when this is done, due to thefact that any characters waiting in the terminal's output queueare flushed when the quit signal occurs..PPThe terminal is set to.I noechomode by this program so that the output can be continuous.What you type not show on your terminal,except for the / and !commands..PPIf the standard output is not a teletype, then.PN moreacts just like.PN cat ,except that a header is printed before each file (if there ismore than one)..PPA sample usage of.PN morein previewing.PN nroffoutput would be.EXnroff \-ms doc.n | more \-s.EE.SH Files.DT/etc/termcap		Terminal data base.br/usr/lib/more.help	Help file.SH See Alsocsh(1), man(1), msgs(1), script(1), sh(1), environ(7).NXE "more command" .NXE "terminal" "viewing one screenful at a time"