YAP.1
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:11k
- YAP(1) Minix Programmer's Manual YAP(1)
- NAME
- yap, more - yet another pager
- SYNOPSIS
- yap [ -cnuq ] [ -n ] [ +command ] [ name ... ]
- DESCRIPTION
- Yap is a program allowing the user to examine a continuous text one
- screenful at a time on a video display terminal. It does so by pausing
- after each screenful, waiting for the user to type a command. The
- commands are enumerated later. Yap's main feature is, that it can page
- both forwards and backwards, even when reading from standard input.
- The command line options are:
- -n An integer which is the size (in lines) of a page (the initial page-
- size.
- -c Normally, yap will display each page by beginning at the top of the
- screen and erasing each line just before it displays on it. If your
- terminal cannot erase a line, yap will clear the screen before it
- displays a page.
- This avoids scrolling the screen, making it easier to read while yap
- is writing. The -c option causes yap to scroll the screen instead
- of beginning at the top of the screen. This is also done if your
- terminal cannot either erase a line or clear the screen.
- -u Normally, yap handles underlining such as produced by nroff in a
- manner appropriate to the particular terminal: if the terminal can
- perform underlining well (t.i., the escape sequences for underlining
- do not occupy space on the screen), yap will underline underlined
- information in the input. The -u option supresses this underlining.
- -n Normally, yap also recognises escape sequences for stand-out mode or
- underlining mode in the input, and knows how much space these escape
- sequences will occupy on the screen, so that yap will not fold lines
- erroneously. The -n option supresses this pattern matching.
- -q This option will cause yap to exit only on the "quit" command.
- +command
- command is taken to be an initial command to yap.
- Yap uses the termcap(5) database to determine the terminal capabilities
- and the default page-size. It examines the $TERM environment variable to
- identify the terminal type. If $TERM is not set, it defaults to dumb.
- Yap Also examines the $TERMCAP environment variable to locate the
- termcap(5) database. If $TERMCAP is not set, it defaults to
- /etc/termcap.
- local 1
- YAP(1) Minix Programmer's Manual YAP(1)
- Yap looks in the $YAP environment variable to pre-set flags. For
- instance, if you prefer the -c mode of operation, just set the $YAP
- environment variable to -c.
- The commands of yap can be bound to sequences of keystrokes. The
- environment variable $YAPKEYS may contain the bindings in the form of a
- list of colon-separated `name=sequence' pairs. The name is a short
- mnemonic for the command, the sequence is the sequence of keystrokes to
- be typed to invoke the command. This sequence may contain a ^X escape,
- which means control-X, and a X escape, which means X. The latter can be
- used to get the characters `^', `' and `:' in the sequence. There are
- two keymaps available, the default one and a user-defined one. You can
- switch between one and the other with the change keymap command.
- The yap commands are described below. The mnemonics for the commands are
- given in parentheses. The default key sequences (if any) are given after
- the mnemonic. Every command takes an optional integer argument, which
- may be typed before the command. Some commands just ignore it. The
- integer argument is referred to as i. Usually, if i is not given, it
- defaults to 1.
- visit previous file (bf) P
- Visit the i-th previous file given in the command line.
- scroll one line up or go to line (bl) ^K or k
- If i is not given, scroll one line up. Otherwise, i will be
- interpreted as a line number. A page starting with the line
- indicated will then be displayed.
- bottom (bot) l or $
- Go to the last line of the input.
- display previous page (bp) -
- Display the previous page, consisting of i lines, (or page-size
- lines if no argument is given).
- display previous page and set pagesize (bps) Z
- Display the previous page, consisting of i lines, (or page-size
- lines if no argument is given). If i is given, the page-size is set
- to i.
- scroll up (bs) ^B
- Scroll up i lines (or scroll-size lines if i is not given.
- Initially, the scroll-size is 11).
- search backwards for pattern (bse) ?
- Search backwards for the i-th occurrence of a regular expression
- which will be prompted for. If there are less than i occurrences of
- the expression, the position in the file remains unchanged.
- Otherwise, a page is displayed, starting two lines before the place
- local 2
- YAP(1) Minix Programmer's Manual YAP(1)
- where the expression was found. The user's erase and kill characters
- may be used to edit the expression. Erasing back past the first
- character cancels the search command.
- Note: Some systems do not have regex(3). On those systems, searches
- are still supported, but regular expressions are not.
- skip lines backwards (bsl) S
- Skip i lines backwards and display a page.
- skip pages backwards (bsp) F
- Skip i pages backwards and display a page.
- scroll up and set scrollsize (bss) b
- Scroll up i lines (or scroll-size lines if i is not given. If i is
- given, the scroll-size is set to i.
- change key map (chm) ^[
- Change from the current key map to the other (if there is one).
- exchange current page and mark (exg) x
- Set the mark to the current page, and display the previously marked
- page.
- visit next file (ff) N
- Visit the i-th next file given in the command line.
- scroll one line down or go to line (fl) ^J or ^M or j
- If i is not given, scroll one line down. Otherwise, i will be
- interpreted as a line number. A page starting with the line
- indicated will then be displayed.
- display next page (fp) <space>
- Display the next page, consisting of i lines, (or page-size lines if
- no argument is given).
- display next page and set pagesize (fps) z
- Display the next page, consisting of i lines, (or page-size lines if
- no argument is given). If i is given, the page-size is set to i.
- scroll down (fs) ^D
- Scroll down i lines (or scroll-size lines if no argument is given).
- search forwards for pattern (fse) /
- Search forwards for the i-th occurrence of a regular expression
- which will be prompted for. If there are less than i occurrences of
- the expression, the position in the file remains unchanged.
- Otherwise, a page 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 expression. Erasing back past the first
- character cancels the search command.
- local 3
- YAP(1) Minix Programmer's Manual YAP(1)
- Note: Some systems do not have regex(3). On those systems, searches
- are still supported, but regular expressions are not.
- skip lines forwards (fsl) s
- Skip i lines and display a page.
- skip pages forwards (fsp) f
- Skip i pages and display a page.
- scroll down and set scrollsize (fss) d
- Scroll down i lines (or scroll-size lines if i is not given. If i
- is given, the scroll-size is set to i.
- help (hlp) h
- Give a short description of all commands that are bound to a key
- sequence.
- set a mark (mar) m
- Set a mark on the current page.
- repeat last search (nse) n
- Search for the i-th occurrence of the last regular expression
- entered, in the direction of the last search.
- repeat last search in other direction (nsr) r
- Search for the i-th occurrence of the last regular expression
- entered, but in the other direction.
- quit (qui) Q or q
- Exit from yap.
- redraw (red) ^L
- Redraw the current page.
- repeat (rep) .
- Repeat the last command. This does not always make sense, so not all
- commands can be repeated.
- shell escape (shl) !
- Invoke the shell with a command that will be prompted for. In the
- command, the characters `%' and `!' are replaced with the current
- file name and the previous shell command respectively. The
- sequences `%' and `!' are replaced by `%' and `!' respectively.
- The user's erase and kill characters can be used to edit the
- command. Erasing back past the first character cancels the command.
- pipe to shell command (pip) |
- Pipe the current input file into a shell command that will be
- prompted for. The comments given in the description of the shell
- escape command apply here too.
- local 4
- YAP(1) Minix Programmer's Manual YAP(1)
- go to mark (tom) '
- Display the marked page.
- top (top) ^^
- Display a page starting with the first line of the input.
- visit file (vis) e
- Visit a new file. The filename will be prompted for. If you just
- type a return, the current file is revisited.
- write input to a file (wrf) w
- Write the input to a file, whose name will be prompted for.
- The commands take effect immediately, i.e., it is not necessary to type a
- carriage return. Up to the time when the command sequence itself is
- given, the user may give an interrupt to cancel the command being formed.
- AUTHOR
- Ceriel J.H. Jacobs
- FILES
- /etc/termcap Terminal capabilities data base
- SEE ALSO
- termcap(5), regex(3).
- BUGS
- Yap will find your terminal very stupid and act like it, if it has no way
- of placing the cursor on the home position, or cannot either erase a line
- or insert one.
- In lines longer than about 2000 characters, a linefeed is silently
- inserted.
- The percentage, given in the prompt when yap reads from a file (and knows
- it), is not always very accurate.
- local 5