More (command)

more

Example output of the more command
Original author(s)	Daniel Halbert, Eric Shienbrood, Geoff Peck,[1] John Foderaro[2]
Developer(s)	DR, Microsoft, IBM, Toshiba, TSL, Jim Hall
Initial release	1978, 46–47 years ago
Written in	MS-DOS, PC-MOS: x86 assembly language FreeDOS, ReactOS: C
Operating system	Cross-platform
Type	Command
License	Unix, Unix-like: BSD License, CDDL MS-DOS: MIT FreeDOS, ReactOS: GPL v2 PC-MOS: GPL v3

In computing, more is a command to view (but not modify) the contents of a text file one screen at a time. It is available on Unix and Unix-like systems, DOS,^[3] Digital Research FlexOS,^[4] IBM/Toshiba 4690 OS,^[5] IBM OS/2,^[6] Microsoft Windows and ReactOS.^[7] Programs of this sort are called pagers.^[8] more is a very basic pager, originally allowing only forward navigation through a file, though newer implementations do allow for limited backward movement.

History

The more command was originally written by Daniel Halbert, a graduate student at the University of California, Berkeley, in 1978. It was later expanded on by Eric Shienbrood, Geoff Peck (added underlining, single spacing) and John Foderaro (added -c, more environment variable history). It was first included in 3.0 BSD, and has since become a standard program in all Unix systems. less, a similar command with the extended capability of allowing both forward and backward navigation through the file, was written by Mark Nudelman between 1983 and 1985 and is now included in most Unix and Unix-like systems.

The command is available in MS-DOS versions 2 and later.^[9] A more command is also part of ASCII's MSX-DOS2 Tools for MSX-DOS version 2.^[10] The Software Link's PC-MOS includes an implementation of more.^[11] Like the rest of the operating system, it is licensed under the GPL v3.^[12] The FreeDOS version was developed by Jim Hall and is licensed under the GPL v2.^[13] The command is also available in the KolibriOS Shell.^[14]

The numerical computing environments MATLAB and GNU Octave include a more function that turns output pagination on or off.^[15][16]

Usage

Unix-like

The command-syntax is:

more [options] [file_name]

If no file name is provided, more looks for input from standard input.

Once more has obtained input, it displays as much as can fit on the current screen and waits for user input to advance, with the exception that a form feed (^L) will also cause more to wait at that line, regardless of the amount of text on the screen. In the lower-left corner of the screen is displayed the text "--More--" and a percentage, representing the percent of the file that more has paged through. (This percentage includes the text displayed on the current screen.) When more reaches the end of a file (100%) it exits. The most common methods of navigating through a file are Enter, which advances the output by one line, and Space, which advances the output by one screen.

There are also other commands that can be used while navigating through the document; consult more's man page for more details.^[17]

Options

Options are typically entered before the file name, but can also be entered in the environment variable $MORE. Options entered in the actual command line will override those entered in the $MORE environment variable. Available options may vary between Unix systems, but a typical set of options is as follows:

• -num: This option specifies an integer which is the screen size (in lines).
• -d: more will prompt the user with the message [Press space to continue, 'q' to quit.] and will display [Press 'h' for instructions.] instead of ringing the bell when an illegal key is pressed.
• -l: more usually treats ^L (form feed) as a special character, and will pause after any line that contains a form feed. The -l option will prevent this behavior.
• -f: Causes more to count logical, rather than screen lines (i.e., long lines are not folded).
• -p: Do not scroll. Instead, clear the whole screen and then display the text.
• -c: Do not scroll. Instead, paint each screen from the top, clearing the remainder of each line as it is displayed.
• -s: Squeeze multiple blank lines into one.
• -u: Backspaces and carriage returns to be treated as printable characters;
• +/: This option specifies a string that will be searched for before each file is displayed. (Ex.: more +/Preamble gpl.txt)
• +num: Start at line number num.

Microsoft Windows and ReactOS

The ReactOS more command

The command-syntax is:^[18]

command | more [/c] [/p] [/s] [/tn] [+n]
more [[/c] [/p] [/s] [/tn] [+n]] < [Drive:] [Path] FileName
more [/c] [/p] [/s] [/tn] [+n] [files]

Examples

To display the file named letter.txt on the screen, the user can type either of the following two commands:

more letter.txt
type letter.txt | more

The command displays the first screen of information from letter.txt, and then the following prompt appears:

-- More—When the spacebar is pressed, the next screen of information will be displayed.

It is also possible to clear the screen and remove all extra blank lines before displaying the file:

more /c /s < letter.txt
type letter.txt | more /c /s

IBM OS/2

The command-syntax is:

MORE < [drive:][path]filename
command | more

• drive:\path\filename – Specifies the location of the file to display one screen at a time.
• command | – Specifies the command whose output will be displayed.

Example

Return the content of the OS/2 system directory using the dir command and display it one screen at a time using the more command:

[C:\]dir C:\OS2 | more

See also

• pg (Unix)
• less (Unix)
• most (Unix)

References

1. Early history of the more command
2. more(1) — Linux manual pages
3. "ibiblio.org FreeDOS Group -- FreeDOS Base". www.ibiblio.org.
4. "Users guide" (PDF). www.bitsavers.org. Retrieved 2020-01-30.
5. [1]^{[dead link‍]}
6. "JaTomes Help - OS/2 Commands". www.jatomes.com.
7. "reactos/reactos". GitHub. 3 January 2022.
8. "pager from FOLDOC". foldoc.org.
9. Wolverton, Van (2003). Running MS-DOS Version 6.22 (20th Anniversary Edition), 6th Revised edition. Microsoft Press. ISBN 0-7356-1812-7.
10. MSX-DOS2 Tools User's Manual by ASCII Corporation
11. "roelandjansen/pcmos386v501". GitHub. 2 January 2022.
12. Jansen, Roeland (8 February 2018). "pcmos386v501: PC-MOS/386 v5.01 final release including cdrom driver sources" – via GitHub.
13. "ibiblio.org FreeDOS Package -- more (FreeDOS Base)". www.ibiblio.org.
14. "Shell - KolibriOS wiki". wiki.kolibrios.org.
15. "Control paged output in Command Window - MATLAB more". www.mathworks.com.
16. "Function Reference: more". octave.sourceforge.io.
17. more: display files on a page-by-page basis – Shell and Utilities Reference, The Single UNIX Specification, Version 4 from The Open Group
18. "More". docs.microsoft.com.

Further reading

• Cooper, Jim (2001). Special Edition Using MS-DOS 6.22, Third Edition. Que Publishing. ISBN 978-0789725738.
• Kathy Ivens; Brian Proffit (1993). OS/2 Inside & Out. Osborne McGraw-Hill. ISBN 978-0078818714.
• Stanek, William R. (2008). Windows Command-Line Administrator's Pocket Consultant, 2nd Edition. Microsoft Press. ISBN 978-0735622623.
• McElhearn, Kirk (2006). The Mac OS X Command Line: Unix Under the Hood. John Wiley & Sons. ISBN 978-0470113851.

External links

• "FOLDOC entry for pager"; see definition #2.
• manpage of more
• more | Microsoft Docs
• Open source MORE implementation that comes with MS-DOS v2.0
• https://www.question-defense.com/documentation/linux-manpages/more