Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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

NAME
       more, page - browse or page through a text file

SYNOPSIS
       more [ -cdflsu ]	[ -lines ] [ +linenumber ] [ +/pattern ]
	    [ filename ... ]

       page  [	-cdflsu	 ] [ -lines ] [	+linenumber ] [	+/pattern ] [ filename
       ... ]

DESCRIPTION
       more is a filter	that displays the contents of a	text file on the  ter-
       minal,  one screenful at	a time.	 It normally pauses after each screen-
       ful, and	prints --More--	at the bottom of the screen.  more provides  a
       two-line	 overlap  between  screens for continuity.  If more is reading
       from a file rather than a pipe, the percentage of characters  displayed
       so far is also shown.

       more  scrolls up	to display one more line in response to	a RETURN char-
       acter; it displays another screenful in response	to a SPACE  character.
       Other commands are listed below.

       page clears the screen before displaying	the next screenful of text; it
       only provides a one-line	overlap	between	screens.

       more sets the terminal to noecho	mode, so that the output can  be  con-
       tinuous.	 Commands that you type	do not normally	show up	on your	termi-
       nal, except for the / and !  commands.

       If the standard output is not a terminal, more acts just	like  cat(1V),
       except that a header is printed before each file	in a series.

OPTIONS
       -c     Clear  before  displaying.   Redrawing  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.

       -d     Display error messages rather than ringing the terminal bell  if
	      an  unrecognized command is used.	 This is helpful for inexperi-
	      enced users.

       -f     Do not fold long lines.  This is useful when lines contain  non-
	      printing characters or escape sequences, such as those generated
	      when nroff(1) output is piped through ul(1).

       -l     Do not treat FORMFEED characters (CTRL-D)	as "page  breaks."  If
	      -l  is  not  used, more pauses to	accept commands	after any line
	      containing a ^L character	(CTRL-D).  Also, if a file begins with
	      a	FORMFEED, the screen is	cleared	before the file	is printed.

       -s     Squeeze.	Replace	multiple blank lines with a single blank line.
	      This is helpful when viewing nroff(1) output, on the screen.

       -u     Suppress generation of underlining escape	sequences.   Normally,
	      more  handles underlining, such as that produced by nroff(1), in
	      a	manner appropriate to the terminal.  If	the terminal can  per-
	      form  underlining	 or has	a stand-out mode, more supplies	appro-
	      priate escape sequences as called	for in the text	file.

       -lines Display the indicated number of lines in each screenful,	rather
	      than  the	 default  (the	number of lines	in the terminal	screen
	      less two).

       +linenumber
	      Start up at linenumber.

       +/pattern
	      Start up two lines above the line	containing the regular expres-
	      sion  pattern.   Note: unlike editors, this construct should not
	      end with a `/'.  If it does, then	the trailing slash is taken as
	      a	character in the search	pattern.

USAGE
   Environment
       more  uses  the	terminal's  termcap(5)	entry to determine its display
       characteristics,	and looks in the environment  variable	MORE  for  any
       preset  options.	 For instance, to page through files using the -c mode
       by default, set the value of this variable to -c.  (Normally, the  com-
       mand sequence to	set up this environment	variable is placed in the .lo-
       gin or .profile file).

   Commands
       The commands take effect	immediately;  it is not	necessary  to  type  a
       carriage	 return.   Up to the time when the command character itself is
       given, the user may type	the line kill character	to cancel the  numeri-
       cal  argument  being  formed.  In addition, the user may	type the erase
       character to redisplay the `--More--(xx%)' message.

       In the following	commands, i is a numerical argument (1 by default).

       iSPACE	 Display another screenful, or i more lines if i is specified.

       iRETURN	 Display another line, or i more lines,	if specified.

       i^D	 (CTRL-D) Display (scroll down)	11 more	lines.	 i  is	given,
		 the scroll size is set	to i.

       id	 Same as ^D.

       iz	 Same as SPACE,	except that i, if present, becomes the new de-
		 fault number of lines per screenful.

       is	 Skip i	lines and then print a screenful.

       if	 Skip i	screenfuls and then print a screenful.

       i^B	 (CTRL-B) Skip back i screenfuls and then print	a screenful.

       b	 Same as ^B (CTRL-D).

       q
       Q	 Exit from more.

       =	 Display the current line number.

       v	 Drop into the vi(1) editor at the current line	of the current
		 file.

       h	 Help.	Give a description of all the more commands.

       i/pattern Search	 for the ith occurrence	of the regular expression pat-
		 tern.	Display	the screenful starting two lines prior to  the
		 line  that  contains the ith match for	the regular expression
		 pattern, or the end of	a pipe,	 whichever  comes  first.   If
		 more is displaying a file and there is	no such	match, its po-
		 sition	in the file remains  unchanged.	  Regular  expressions
		 can  be edited	using erase and	kill characters.  Erasing back
		 past the first	column cancels the search command.

       in	 Search	for the	ith occurrence of the last pattern entered.

       '	 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.

       !command	 Invoke	a shell	to execute command.  The characters %  and  !,
		 when  used within command are replaced	with the current file-
		 name and the previous shell command, respectively.  If	 there
		 is  no	 current  filename, % is not expanded. Prepend a back-
		 slash to these	characters to escape expansion.

       i:n	 Skip to the ith next filename given in	the command  line,  or
		 to the	last filename in the list if i is out of range.

       i:p	 Skip  to the ith previous filename given in the command line,
		 or to the first filename if i is  out	of  range.   If	 given
		 while	more  is positioned within a file, go to the beginning
		 of the	file.  If more is reading from	a  pipe,  more	simply
		 rings the terminal bell.

       :f	 Display the current filename and line number.

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

       .	 Dot.  Repeat the previous command.

       ^\	 Halt  a  partial display of text.  more stops sending output,
		 and displays the usual	--More-- prompt.  Unfortunately,  some
		 output	is lost	as a result.

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

SEE ALSO
       cat(1V),	csh(1),	man(1),	script(1), sh(1), environ(5V), termcap(5)

BUGS
       Skipping	backwards is too slow on large files.

			       9 September 1987			       MORE(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | FILES | SEE ALSO | BUGS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=more&sektion=1&manpath=SunOS+4.1.3>

home | help