home | help
MORE(1) 		     General Commands Manual			 MORE(1)

NAME
     more, page - file perusal filter for crt viewing

SYNOPSIS
     more  [  -d ] [ -f ] [ -l ] [ -n ] [ +linenumber ] [ +/pattern ] [ name ...
     ]

     page [ -d ] [ -f ] [ -l ] [ -n ] [ +linenumber ] [ +/pattern ] [  name  ...
     ]

DESCRIPTION
     More  is a filter which allows examination of a continuous text one screen-
     ful at a time on a soft-copy  terminal.   It  normally  pauses  after  each
     screenful, printing --More-- at the bottom of the screen.	If the user then
     types  a  carriage  return, one more line is displayed.  If the user hits a
     space, another screenful is displayed.  Other possibilites  are  enumerated
     later.

     The command line options are:

     -n     An	integer  which	is  the size (in lines) of the window which more
	    will use instead of the default.

     -d     More will prompt the user with the message "Hit space  to  continue,
	    Rubout  to	abort"	at the end of each screenful.  This is useful if
	    more is being used as a filter in some setting,  such  as  a  class,
	    where many users may be unsophisticated.

     -f     This  causes  more to count logical, rather than screen lines.  That
	    is, long lines are not folded.  This option is recommended if  nroff
	    output  is being piped through ul, since the latter may generate es-
	    cape sequences.  These escape  sequences  contain  characters  which
	    would ordinarily occupy screen postions, but which do not print when
	    they  are  sent to the terminal as part of an escape sequence.  Thus
	    more may think that lines are longer than  they  actually  are,  and
	    fold lines erroneously.

     -l     Do not treat ^L (form feed) specially.  If this option is not given,
	    more  will pause after any line that contains a ^L, as if the end of
	    a screenful had been reached.  Also, if a file begins  with  a  form
	    feed, the screen will be cleared before the file is printed.

     +linenumber
	    Start up at linenumber.

     +/pattern
	    Start up two lines before the line containing the regular expression
	    pattern.

     If  the  program is invoked as page, then the screen is cleared before each
     screenful is printed (but only if a full screenful is being printed), and k
     - 1 rather than k - 2 lines are printed in each screenful, where k  is  the
     number of lines the terminal can display.

     More  looks in the file /etc/termcap to determine terminal characteristics,
     and to determine the default window size.	On a terminal  capable	of  dis-
     playing 24 lines, the default window size is 22 lines.

     If  more  is  reading from a file, rather than a pipe, then a percentage is
     displayed along with the --More-- prompt.	This gives the fraction  of  the
     file (in characters, not lines) that has been read so far.

     Other sequences which may be typed when more pauses, and their effects, are
     as follows (i is an optional integer argument, defaulting to 1) :

     i<space>
	    display i more lines, (or another screenful if no argument is given)

     ^D     display  11  more  lines  (a  ``scroll'').	 If i is given, then the
	    scroll size is set to i.

     d	    same as ^D (control-D)

     iz     same as typing a space except that i, if present,  becomes	the  new
	    window size.

     is     skip i lines and print a screenful of lines

     if     skip i screenfuls and print a screenful of lines

     q or Q Exit from more.

     =	    Display the current line number.

     v	    Start up the editor vi at the current line.

     h	    Help command; give a description of all the more commands.

     i/expr search  for  the i-th occurrence of the regular expression expr.  If
	    there are less than i occurrences of expr, and the input is  a  file
	    (rather  than  a  pipe),  then  the position in the file remains un-
	    changed.  Otherwise, a screenful is displayed,  starting  two  lines
	    before  the  place where the expression was found.	The user's erase
	    and kill characters may be used  to  edit  the  regular  expression.
	    Erasing back past the first column cancels the search command.

     in     search  for  the  i-th occurrence of the last regular expression en-
	    tered.

     '	    (single quote) Go to the point from which the last	search	started.
	    If	no  search  has been performed in the current file, this command
	    goes back to the beginning of the file.

     !command
	    invoke a shell with command.  The characters `%' and  `!'  in  "com-
	    mand" are replaced with the current 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.

     i:n    skip  to the i-th next file given in the command line (skips to last
	    file if n doesn't make sense)

     i:p    skip to the i-th previous file given in the command line.	If  this
	    command  is  given	in  the middle of printing out a file, then more
	    goes back to the beginning of the file. If	i  doesn't  make  sense,
	    more  skips  back  to the first file.  If more is not reading from a
	    file, the bell is rung and nothing else happens.

     :f     display the current file name and line number.

     :q or :Q
	    exit from more (same as q or Q).

     .	    (dot) repeat the previous command.

     The commands take effect immediately, i.e., it is not necessary to  type  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 numerical ar-
     gument being formed.  In addition, the user may hit the erase character  to
     redisplay the --More--(xx%) message.

     At any time when output is being sent to the terminal, the user can hit the
     quit  key	(normally  control-\).	 More will stop sending output, and will
     display 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 the fact that any characters waiting in the  ter-
     minal's output queue are flushed when the quit signal occurs.

     The  terminal  is set to noecho mode by this program so that the output can
     be continuous.  What you type will thus not show on your  terminal,  except
     for the / and !  commands.

     If the standard output is not a teletype, then more acts just like cat, ex-
     cept that a header is printed before each file (if there is more than one).

     A sample usage of more in previewing nroff output would be

	  nroff -ms +2 doc.n | more

AUTHOR
     Eric Shienbrood

FILES
     /etc/termcap	 Terminal data base
     /usr/lib/more.help  Help file

SEE ALSO
     script(1)

4th Berkeley Distribution	     9/25/80				 MORE(1)

home | help