"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "most.1" between
most-5.0.0a.tar.gz and most-5.1.0.tar.gz

About: most is a textfile paging program (supports multiple windows and can scroll left and right).

most.1  (most-5.0.0a)	:	most.1  (most-5.1.0)
MOST(1) General Commands Manual MOST(1)		MOST(1) MOST(1)
NAME		NAME
most - browse or page through a text file		most - browse or page through a text file
SYNOPSIS		SYNOPSIS
most [-1bCcdMstuvwz] [+lineno] [+c] [+d] [+s] [+u] [+/string] [filename..		most [ -1 ] [ -b ] [ -C ] [ -c ] [ -d ] [ -M ] [ -r ] [ -s ] [ -t
.]		] [ -u ] [ -v ] [ -w ] [ -z ] [
		+/string ] [ +line-number ] [ +d ] [ +s ] [ +u ] [ file... ]
DESCRIPTION		DESCRIPTION
most is a paging program that displays, one windowful at a time, the c		most is a paging program that displays, one windowful at a time, the cont
ontents of a file on a terminal.		ents of a file on a terminal.
It pauses after each windowful and prints on the window status line the s		It pauses after each windowful and prints on the window status line t
creen the file name, current		he screen the file name, current
line number, and the percentage of the file so far displayed.		line number, and the percentage of the file so far displayed.
Unlike other paging programs, most is capable of displaying an arbitr		Unlike other paging programs, most is capable of displaying an arbitrary
ary number of windows as long as		number of windows as long as
each window occupies at least two screen lines. Each window may contain		each window occupies at least two screen lines. Each window may cont
the same file or a different		ain the same file or a different
file. In addition, each window has its own mode. For example, one wi		file. In addition, each window has its own mode. For example, one windo
ndow may display a file with its		w may display a file with its
lines wrapped while another may be truncating the lines. Windows may be		lines wrapped while another may be truncating the lines. Windows may b
`locked' together in the sense		e `locked' together in the sense
that if one of the locked windows scrolls, all locked windows will		that if one of the locked windows scrolls, all locked windows will scrol
scroll. most is also capable of		l. most is also capable of
ignoring lines that are indented beyond a user specified value. This is		ignoring lines that are indented beyond a user specified value. This
useful when viewing computer		is useful when viewing computer
programs to pick out gross features of the code. See the `:o' command fo r a description of this feature.		programs to pick out gross features of the code. See the `:o' command fo r a description of this feature.
In addition to displaying ordinary text files, most can also display bi		In addition to displaying ordinary text files, most can also display bina
nary files as well as files with		ry files as well as files with
arbitrary ascii characters. When a file is read into a buffer, most exam		arbitrary ascii characters. When a file is read into a buffer, most ex
ines the first 32 bytes of the		amines the first 32 bytes of the
file to determine if the file is a binary file and then switches to the		file to determine if the file is a binary file and then switches to the a
appropriate mode. However, this		ppropriate mode. However, this
feature may be disabled with the -k option. See the description of the -		feature may be disabled with the -k option. See the description of th
b, -k, -v, and -t options for		e -b, -k, -v, and -t options for
further details.		further details.
Text files may contain combinations of underscore and backspace character s causing a printer to underline		Text files may contain combinations of underscore and backspace character s causing a printer to underline
or overstrike. When most recognizes this, it inserts the appropriate esc		or overstrike. When most recognizes this, it inserts the appropriate
ape sequences to achieve the		escape sequences to achieve the
desired effect. In addition, some files cause the printer to overstr		desired effect. In addition, some files cause the printer to overstrike
ike some characters by embedding		some characters by embedding
carriage return characters in the middle of a line. When this occurs, mo st displays the overstruck char-		carriage return characters in the middle of a line. When this occurs, mo st displays the overstruck char-
acter with a bold attribute. This feature facilitates the reading of U NIX man pages or a document pro-		acter with a bold attribute. This feature facilitates the reading of UNI X man pages or a document pro-
duced by runoff. In particular, viewing this document with most should i llustrate this behavior provided		duced by runoff. In particular, viewing this document with most should i llustrate this behavior provided
that the underline characters have not been stripped. This may be turned off with the -v option.		that the underline characters have not been stripped. This may be turned off with the -v option.
By default, lines with more characters than the terminal width are not wr apped but are instead truncated.		By default, lines with more characters than the terminal width are not wr apped but are instead truncated.
When truncation occurs, this is indicated by a `$' in the far right colum		When truncation occurs, this is indicated by a `$' in the far right col
n of the terminal screen. The		umn of the terminal screen. The
RIGHT and LEFT arrow keys may be used to view lines which extend past th		RIGHT and LEFT arrow keys may be used to view lines which extend past the
e margins of the screen. The -w		margins of the screen. The -w
option may be used to override this feature. When a window is wrapped, t		option may be used to override this feature. When a window is wrapped,
he character `\' will appear at		the character `\' will appear at
the right edge of the window.		the right edge of the window.
Commands are listed below.		Commands are listed below.
OPTIONS		OPTIONS
-1 VT100 mode. This is meaningful only on VMS systems. This optio		-1 VT100 mode. This is meaningful only on VMS systems. This option
n should be used if the terminal		should be used if the terminal
is strictly a VT100. This implies that the terminal does not hav		is strictly a VT100. This implies that the terminal does no
e the ability to delete and		t have the ability to delete and
insert multiple lines. VT102s and above have this ability.		insert multiple lines. VT102s and above have this ability.
-b Binary mode. Use this switch when you want to view files contain		-b Binary mode. Use this switch when you want to view files containi
ing 8 bit characters. most will		ng 8 bit characters. most will
display the file 16 bytes per line in hexadecimal notation. A typ		display the file 16 bytes per line in hexadecimal notation. A typi
ical line looks like:		cal line looks like:
01000000 40001575 9C23A020 4000168D ....@..u.#. @...		01000000 40001575 9C23A020 4000168D ....@..u.#. @...
When used with the -v option, the same line looks like:		When used with the -v option, the same line looks like:
^A^@^@^@ @^@^U u 9C #A0 @^@^V8D ....@..u.#. @...		^A^@^@^@ @^@^U u 9C #A0 @^@^V8D ....@..u.#. @...
-C Disable color support.		-C Disable color support.
		-c Make searches case-sensitive
-d Omit the backslash mark used to denote a wrapped line.		-d Omit the backslash mark used to denote a wrapped line.
-M Disable the use of mmap.		-M Disable the use of mmap.
-s Squeeze. Replace multiple blank lines with a single blank line.		-r Default to using regexp searches
-z option turns off gunzip-on-the-fly.		-s Squeeze-mode. Replace multiple blank lines with a single blank li ne.
-v Display control characters as in `^A' for control A. Normally mos		-t Display tabs as ^I. If this option is immediately followed by
t does not interpret control		an integer, the integer sets the
characters.		tab width, e.g., -t4
-t Display tabs as `^I'. This option is meaningful only when used wi th the -v option.		-u Disable UTF-8 mode even if the locale dictates it
+lineno		+u Force UTF-8 mode. By default most will use the current locale to
Start up at lineno.		determine if UTF-8 mode should
		be used. The +u and -u switches allow the behavior to be overridd
		en
-c Make searches case sensitive. By default, they are not.		-v Display control characters as in `^A' for control A. Normally
		most does not interpret control
		characters.
-u Disable UTF-8 mode even if the locale dictates it.		-w Wrap lines
+u Force UTF-8 mode. By default most will use the current locale to		-z Disable gunzip-on-the-fly
determine if UTF-8 mode shoul be
used. The +u and -u switches allow the behavior to be overridden.		+/string
		Start up at the line containing the first occurrence of string
		+lineno
		Start up at the specified line-number
+d This switch should only be used if you want the option to delete a file while viewing it. This		+d This switch should only be used if you want the option to delete a file while viewing it. This
makes it easier to clean unwanted files out of a directory. The f ile is deleted with the interac-		makes it easier to clean unwanted files out of a directory. The f ile is deleted with the interac-
tive key sequence `:D' and then confirming with `y'.		tive key sequence `:D' and then confirming with `y'.
+/string		+s Secure Mode-- no edit, cd, shell, and reading files not already li
Start up at the line containing the first occurrence of string.		sted on the command line.
COMMAND USAGE		COMMAND USAGE
The commands take effect immediately; it is not necessary to type a carri		The commands take effect immediately; it is not necessary to type a carri
age return.		age return. In the following
		commands, i is a numerical argument (1 by default).
In the following commands, i is a numerical argument (1 by default).
SPACE, CTRL-D, NEXT_SCREEN		SPACE, CTRL-D, NEXT_SCREEN
Display another windowful, or jump i windowfuls if i is specified.		Display another windowful, or jump i windowfuls if i is specified.
RETURN, DOWN_ARROW, V, CTRL-N		RETURN, DOWN_ARROW, V, CTRL-N
Display another line, or i more lines, if specified.		Display another line, or i more lines, if specified.
UP_ARROW, ^, CTRL-P		UP_ARROW, ^, CTRL-P
Display previous line, or i previous lines, if specified.		Display previous line, or i previous lines, if specified.
skipping to change at line 122		skipping to change at line 129
LEFT_ARROW, CTRL-B, <		LEFT_ARROW, CTRL-B, <
Scroll window right 60i columns to view lines that are beyond the left margin of the window.		Scroll window right 60i columns to view lines that are beyond the left margin of the window.
U, CTRL-U, DELETE, PREV_SCREEN		U, CTRL-U, DELETE, PREV_SCREEN
Skip back i windowfuls and then print a windowful.		Skip back i windowfuls and then print a windowful.
R, CTRL-R		R, CTRL-R
Redraw the window.		Redraw the window.
J, G If i is not specified, then prompt for a line number then jump to		J, G If i is not specified, then prompt for a line number then
that line otherwise just jump to		jump to that line otherwise just
line i.		jump to line i.
% If i is not specified, then prompt for a percent number then jump to that percent of the file oth-		% If i is not specified, then prompt for a percent number then jump to that percent of the file oth-
erwise just jump to i percent of the file.		erwise just jump to i percent of the file.
W, w If the current screen width is 80, make it 132 and vice-versa. Fo		W, w If the current screen width is 80, make it 132 and vice-ver
r other values, this command is		sa. For other values, this com-
ignored.		mand is ignored.
Q, CTRL-X CTRL-C, CTRL-K E		Q, CTRL-X CTRL-C, CTRL-K E
Exit from most. On VMS, ^Z also exits.		Exit from most. On VMS, ^Z also exits.
h, CTRL-H, HELP, PF2		h, CTRL-H, HELP, PF2
Help. Give a description of all the most commands. The most env ironment variable MOST_HELP must		Help. Give a description of all the most commands. The most envi ronment variable MOST_HELP must
be set for this to be meaningful.		be set for this to be meaningful.
f, /, CTRL-F, FIND, GOLD PF3		f, /, CTRL-F, FIND, GOLD PF3
Prompt for a string and search forward from the current line for i		Prompt for a string and search forward from the current line
th distinct line containing the		for ith distinct line containing
string. CTRL-G aborts.		the string. CTRL-G aborts.
? Prompt for a string and search backward for the ith distinct lin e containing the string. CTRL-G		? Prompt for a string and search backward for the ith distinct line containing the string. CTRL-G
aborts.		aborts.
n Search for the next i lines containing an occurrence of the last s earch string in the direction of		n Search for the next i lines containing an occurrence of the last s earch string in the direction of
the previous search.		the previous search.
m, SELECT, CTRL-@, CTRL-K M, PERIOD		m, SELECT, CTRL-@, CTRL-K M, PERIOD
Set a mark on the current line for later reference.		Set a mark on the current line for later reference.
INSERT_HERE, CTRL-X CTRL-X, COMMA, CTRL-K RETURN, GOLD PERIOD		INSERT_HERE, CTRL-X CTRL-X, COMMA, CTRL-K RETURN, GOLD PERIOD
Set a mark on the current line but return to previous mark. Thi s allows the user to toggle back		Set a mark on the current line but return to previous mark. This allows the user to toggle back
and forth between two positions in the file.		and forth between two positions in the file.
l, L Toggle locking for this window. The window is locked if there is a `*' at the left edge of the		l, L Toggle locking for this window. The window is locked if there is a `*' at the left edge of the
status line. Windows locked together, scroll together.		status line. Windows locked together, scroll together.
CTRL-X 2, CTRL-W 2, GOLD X		CTRL-X 2, CTRL-W 2, GOLD X
Split this window in half.		Split this window in half.
CTRL-X o, CTRL-W o, o, GOLDUP, GOLDDOWN		CTRL-X o, CTRL-W o, o, GOLDUP, GOLDDOWN
Move to other window.		Move to other window.
CTRL-X 0, CTRL-W 0, GOLD V		CTRL-X 0, CTRL-W 0, GOLD V
Delete this window.		Delete this window.
CTRL-X 1, CTRL-W 1, GOLD O		CTRL-X 1, CTRL-W 1, GOLD O
Delete all other windows, leaving only one window.		Delete all other windows, leaving only one window.
E, e Edit this file.		E, e Edit this file.
$, ESC $		$, ESC $
This is system dependent. On VMS, this causes most to spawn a subprocess. When the user exits		This is system dependent. On VMS, this causes most to spawn a sub process. When the user exits
the process, most is resumed. On UNIX systems, most simply suspen ds itself.		the process, most is resumed. On UNIX systems, most simply suspen ds itself.
:n Skip to the next filename given in the command line. Use the arro w keys to scroll forward or		:n Skip to the next filename given in the command line. Use the arrow keys to scroll forward or
backward through the file list. `Q' quits most and any other key selects the given file.		backward through the file list. `Q' quits most and any other key selects the given file.
:c Toggle case sensitive search.		:c Toggle case sensitive search.
:D Delete current file. This command is only meaningful with the +d switch.		:D Delete current file. This command is only meaningful with the +d switch.
:o, :O Toggle various options. With this key sequence, most displays a p rompt asking the user to hit one		:o, :O Toggle various options. With this key sequence, most displays a p rompt asking the user to hit one
of: bdtvw. The `b', `t', `v', and `w' options have the same meani ng as the command line switches.		of: bdtvw. The `b', `t', `v', and `w' options have the same meani ng as the command line switches.
For example, the `w' option will toggle wrapping on and off for th e current window.		For example, the `w' option will toggle wrapping on and off for th e current window.
The `d' option must be used with a prefix integer i. All lines in dented beyond i columns will not		The `d' option must be used with a prefix integer i. All lines in dented beyond i columns will not
be displayed. For example, consider the fragment:		be displayed. For example, consider the fragment:
int main(int argc, char **argv)		int main(int argc, char **argv)
{		{
int i;		int i;
		for (i = 0; i < argc, i++)
for (i = 0; i < argc, i++)		{
{		fprintf(stdout,"%i: %s\n",i,argv[i]);
fprintf(stdout,"%i: %s\n",i,argv[i]);		}
}		return 0;
return 0;		}
}
The key sequence `1:od' will cause most to display the file ignori ng all lines indented beyond the		The key sequence `1:od' will cause most to display the file ignori ng all lines indented beyond the
first column. So for the example above, most would display:		first column. So for the example above, most would display:
int main(int argc, char **argv)...		int main(int argc, char **argv)...
}		}
		where the `...' indicates lines that follow are not displayed.
where the `...' indicates lines follow are not displayed.
HINTS		HINTS
CTRL-G aborts the commands requiring the user to type something in at a prompt. The backquote key has a		CTRL-G aborts the commands requiring the user to type something in at a p rompt. The back-quote key has a
special meaning here. It is used to quote certain characters. This is u seful when search for the occur-		special meaning here. It is used to quote certain characters. This is u seful when search for the occur-
rence of a string with a control character or a string at the beginning of a line. In the latter case,		rence of a string with a control character or a string at the beginning o f a line. In the latter case,
to find the occurrence of `The' at the beginning of a line, enter `^JThe where ` quotes the CTRL-J.		to find the occurrence of `The' at the beginning of a line, enter `^JThe where ` quotes the CTRL-J.
ENVIRONMENT		ENVIRONMENT
most uses the following environment variables:		most uses the following environment variables:
MOST_SWITCHES		MOST_SWITCHES
This variable sets commonly used switches. For example, some peop		This variable sets commonly used switches. For example, som
le prefer to use most with the		e people prefer to use most with
-s option so that excess blank lines are not displayed. On VMS t		the -s option so that excess blank lines are not displayed. On VM
his is normally done done in the		S this is normally done done in
login.com through the line:		the login.com through the line:
$ define MOST_SWITCHES "-s"		$ define MOST_SWITCHES "-s"
MOST_EDITOR, SLANG_EDITOR		MOST_EDITOR, SLANG_EDITOR
Either of these environment variables specify an editor for most t		Either of these environment variables specify an editor for mo
o invoke to edit a file. The		st to invoke to edit a file. The
value can contain %s and %d formatting descriptors that represen		value can contain %s and %d formatting descriptors that represent
t the file name and line number,		the file name and line number,
respectively. For example, if JED is your editor, then set MOST_E DITOR to 'jed %s -g %d'.		respectively. For example, if JED is your editor, then set MOST_E DITOR to 'jed %s -g %d'.
MOST_HELP		MOST_HELP
This variable may be used to specify an alternate help file.		This variable may be used to specify an alternate help file.
MOST_INITFILE		MOST_INITFILE
Set this variable to specify the initialization file to load durin		Set this variable to specify the initialization file to load dur
g startup. The default action		ing startup. The default action
is to load the system configuration file and then a personal conf		is to load the system configuration file and then a personal confi
iguration file called .mostrc on		guration file called .mostrc on
Unix, and most.rc on other systems.		Unix, and most.rc on other systems.
CONFIGURATION FILE SYNTAX		CONFIGURATION FILE SYNTAX
When most starts up, it tries to read a system configuration file and the n a personal configuration file.		When most starts up, it tries to read a system configuration file and the n a personal configuration file.
These files may be used to specify keybindings and colors.		These files may be used to specify key-bindings and colors.
To bind a key to a particular function use the syntax:		To bind a key to a particular function use the syntax:
setkey function-name key-sequence		setkey function-name key-sequence
The setkey command requires two arguments. The function-name argument s pecifies the function that is to		The setkey command requires two arguments. The function-name argument sp ecifies the function that is to
be executed as a response to the keys specified by the key-sequence argum ent are pressed. For example,		be executed as a response to the keys specified by the key-sequence argum ent are pressed. For example,
setkey "up" "^P"		setkey "up" "^P"
indicates that when Ctrl-P is pressed then the function up is to be execu ted.		indicates that when Ctrl-P is pressed then the function up is to be execu ted.
Sometimes, it is necessary to first unbind a key-sequence before rebindin g it in order via the unsetkey		Sometimes, it is necessary to first unbind a key-sequence before rebind ing it in order via the unsetkey
function:		function:
unsetkey "^F"		unsetkey "^F"
Colors may be defined through the use of the color keyword in the the c onfiguration file using the syn-		Colors may be defined through the use of the color keyword in the the con figuration file using the syn-
tax:		tax:
color OBJECT-NAME FOREGROUND-COLOR BACKGROUND-COLOR		color OBJECT-NAME FOREGROUND-COLOR BACKGROUND-COLOR
Here, OBJECT-NAME can be any one of the following items:		Here, OBJECT-NAME can be any one of the following items:
status -- the status line		status -- the status line
underline -- underlined text		underline -- underlined text
overstrike -- overstriked text		overstrike -- overstruck text
normal -- anything else		normal -- anything else
See the sample configuration files for more information.		See the sample configuration files for more information.
BUGS		BUGS
Almost all of the known bugs or limitations of most are due to a desire t		Almost all of the known bugs or limitations of most are due to a desi
o read and interpret control		re to read and interpret control
characters in files. One problem concerns the use of backspace charac		characters in files. One problem concerns the use of backspace character
ters to underscore or overstrike		s to underscore or overstrike
other characters. most makes an attempt to use terminal escape sequences to simulate this behavior. One		other characters. most makes an attempt to use terminal escape sequences to simulate this behavior. One
side effect is the one does not always get what one expects when scrollin g right and left through a file.		side effect is the one does not always get what one expects when scrollin g right and left through a file.
When in doubt, use the -v and -b options of most.		When in doubt, use the -v and -b options of most.
		The regular-expression searches may fail to find strings that involve bac
		kspace/underscore used for high-
		lighting. The regular-expression syntax is described in the S-Lang Libra
		ry documentation.
AUTHOR		AUTHOR
John E. Davis		John E. Davis <jed@jedsoft.org>
davis@space.mit.edu
ACKNOWLEDGEMENTS		ACKNOWLEDGEMENTS
I would like to thank the users of most for valuable comments and critici		Over the years, many people have contributed to most in one way or anothe
sms. I would especially like to		r, e.g., via code patches, bug-
thank those individuals who have contributed code to most.		fixes, comments, or criticisms. I am particularly grateful to the very e
		arly adopters of the program who
		took a chance with a fledgling software project headed by someone lear
		ning the underlying language.
		These include:
Mats Akerberg, Henk D. Davids, Rex O. Livingston, and Mark Pizzolato c ontributed to the early VMS ver-		Mats Akerberg, Henk D. Davids, Rex O. Livingston, and Mark Pizzolato c ontributed to the early VMS ver-
sions of most. In particular, Mark worked on it to get it ready for DECU S.		sions of most. In particular, Mark worked on it to get it ready for DECU S.
Foteos Macrides <MACRIDES@SCI.WFEB.EDU> adapted most for use in cswing an		Foteos Macrides adapted most for use in cswing and gopher. A few feature
d gopher. A few features of the		s of the present version of most
present version of most was inspired from his work.		was inspired from his work.
I am grateful to Robert Mills <robert@jna.com.au> for re-writing th		I am grateful to Robert Mills for re-writing the search routines to use r
e search routines to use regular		egular expressions.
expressions.
Sven Oliver Moll <smol0075@rz.uni-hildesheim.de> came up with the idea of		Sven Oliver Moll came up with the idea of automatic detection of zipped f
automatic detection of zipped		iles.
files.
I would also like to thank Shinichi Hama for his valuable criticisms of m ost.		I would also like to thank Shinichi Hama for his valuable criticisms of m ost.
Javier Kohen was instrumental in the support for UTF-8.		Javier Kohen was instrumental in the support for UTF-8.
Thanks to David W. Sanderson (dws@cs.wisc.edu) for adapting the docume		Thanks to David W. Sanderson for adapting the early documentation to nrof
ntation to nroff man page source		f man page source format.
format.
May 1999 MOST(1)		17 February 2019 MOST(1)
End of changes. 59 change blocks.
147 lines changed or deleted		159 lines changed or added

---