YAP.1
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:11k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. YAP(1)                    Minix Programmer's Manual                     YAP(1)
  2. NAME
  3.      yap, more - yet another pager
  4. SYNOPSIS
  5.      yap [ -cnuq ] [ -n ] [ +command ] [ name ...  ]
  6. DESCRIPTION
  7.      Yap is a program allowing the user  to  examine  a  continuous  text  one
  8.      screenful  at  a time on a video display terminal.  It does so by pausing
  9.      after each screenful, waiting for  the  user  to  type  a  command.   The
  10.      commands  are  enumerated later.  Yap's main feature is, that it can page
  11.      both forwards and backwards, even when reading from standard input.
  12.      The command line options are:
  13.      -n   An integer which is the size (in lines) of a page (the initial page-
  14.           size.
  15.      -c   Normally, yap will display each page by beginning at the top of  the
  16.           screen  and erasing each line just before it displays on it. If your
  17.           terminal cannot erase a line, yap will clear the  screen  before  it
  18.           displays a page.
  19.           This avoids scrolling the screen, making it easier to read while yap
  20.           is  writing.   The -c option causes yap to scroll the screen instead
  21.           of beginning at the top of the screen.  This is also  done  if  your
  22.           terminal cannot either erase a line or clear the screen.
  23.      -u   Normally, yap handles underlining such as produced  by  nroff  in  a
  24.           manner  appropriate  to the particular terminal: if the terminal can
  25.           perform underlining well (t.i., the escape sequences for underlining
  26.           do  not  occupy  space on the screen), yap will underline underlined
  27.           information in the input. The -u option supresses this underlining.
  28.      -n   Normally, yap also recognises escape sequences for stand-out mode or
  29.           underlining mode in the input, and knows how much space these escape
  30.           sequences will occupy on the screen, so that yap will not fold lines
  31.           erroneously.  The -n option supresses this pattern matching.
  32.      -q   This option will cause yap to exit only on the "quit" command.
  33.      +command
  34.           command is taken to be an initial command to yap.
  35.      Yap uses the termcap(5) database to determine the  terminal  capabilities
  36.      and the default page-size.  It examines the $TERM environment variable to
  37.      identify the terminal type.  If $TERM is not set, it  defaults  to  dumb.
  38.      Yap  Also  examines  the  $TERMCAP  environment  variable  to  locate the
  39.      termcap(5)  database.   If  $TERMCAP  is  not   set,   it   defaults   to
  40.      /etc/termcap.
  41.                                     local                                    1
  42. YAP(1)                    Minix Programmer's Manual                     YAP(1)
  43.      Yap looks in  the  $YAP  environment  variable  to  pre-set  flags.   For
  44.      instance,  if  you  prefer  the  -c  mode of operation, just set the $YAP
  45.      environment variable to -c.
  46.      The commands of yap  can  be  bound  to  sequences  of  keystrokes.   The
  47.      environment  variable  $YAPKEYS may contain the bindings in the form of a
  48.      list of colon-separated `name=sequence'  pairs.   The  name  is  a  short
  49.      mnemonic  for  the command, the sequence is the sequence of keystrokes to
  50.      be typed to invoke the command.  This sequence may contain a  ^X  escape,
  51.      which  means control-X, and a X escape, which means X. The latter can be
  52.      used to get the characters `^', `' and `:' in the sequence.   There  are
  53.      two  keymaps  available, the default one and a user-defined one.  You can
  54.      switch between one and the other with the change keymap command.
  55.      The yap commands are described below.  The mnemonics for the commands are
  56.      given  in parentheses. The default key sequences (if any) are given after
  57.      the mnemonic.  Every command takes an optional  integer  argument,  which
  58.      may  be  typed  before  the  command.  Some  commands just ignore it. The
  59.      integer argument is referred to as i.  Usually, if i  is  not  given,  it
  60.      defaults to 1.
  61.      visit previous file (bf) P
  62.           Visit the i-th previous file given in the command line.
  63.      scroll one line up or go to line (bl) ^K or k
  64.           If i is not  given,  scroll  one  line  up.  Otherwise,  i  will  be
  65.           interpreted  as  a  line  number.  A  page  starting  with  the line
  66.           indicated will then be displayed.
  67.      bottom (bot) l or $
  68.           Go to the last line of the input.
  69.      display previous page (bp) -
  70.           Display the previous page, consisting  of  i  lines,  (or  page-size
  71.           lines if no argument is given).
  72.      display previous page and set pagesize (bps) Z
  73.           Display the previous page, consisting  of  i  lines,  (or  page-size
  74.           lines if no argument is given).  If i is given, the page-size is set
  75.           to i.
  76.      scroll up (bs) ^B
  77.           Scroll up  i  lines  (or  scroll-size  lines  if  i  is  not  given.
  78.           Initially, the scroll-size is 11).
  79.      search backwards for pattern (bse) ?
  80.           Search backwards for the i-th occurrence  of  a  regular  expression
  81.           which will be prompted for.  If there are less than i occurrences of
  82.           the  expression,  the  position  in  the  file  remains   unchanged.
  83.           Otherwise,  a page is displayed, starting two lines before the place
  84.                                     local                                    2
  85. YAP(1)                    Minix Programmer's Manual                     YAP(1)
  86.           where the expression was found. The user's erase and kill characters
  87.           may  be  used  to  edit the expression.  Erasing back past the first
  88.           character cancels the search command.
  89.           Note: Some systems do not have regex(3).  On those systems, searches
  90.           are still supported, but regular expressions are not.
  91.      skip lines backwards (bsl) S
  92.           Skip i lines backwards and display a page.
  93.      skip pages backwards (bsp) F
  94.           Skip i pages backwards and display a page.
  95.      scroll up and set scrollsize (bss) b
  96.           Scroll up i lines (or scroll-size lines if i is not given.  If i  is
  97.           given, the scroll-size is set to i.
  98.      change key map (chm) ^[
  99.           Change from the current key map to the other (if there is one).
  100.      exchange current page and mark (exg) x
  101.           Set the mark to the current page, and display the previously  marked
  102.           page.
  103.      visit next file (ff) N
  104.           Visit the i-th next file given in the command line.
  105.      scroll one line down or go to line (fl) ^J or ^M or j
  106.           If i is not given, scroll  one  line  down.  Otherwise,  i  will  be
  107.           interpreted  as  a  line  number.  A  page  starting  with  the line
  108.           indicated will then be displayed.
  109.      display next page (fp) <space>
  110.           Display the next page, consisting of i lines, (or page-size lines if
  111.           no argument is given).
  112.      display next page and set pagesize (fps) z
  113.           Display the next page, consisting of i lines, (or page-size lines if
  114.           no argument is given).  If i is given, the page-size is set to i.
  115.      scroll down (fs) ^D
  116.           Scroll down i lines (or scroll-size lines if no argument is given).
  117.      search forwards for pattern (fse) /
  118.           Search forwards for the i-th  occurrence  of  a  regular  expression
  119.           which will be prompted for.  If there are less than i occurrences of
  120.           the  expression,  the  position  in  the  file  remains   unchanged.
  121.           Otherwise,  a page is displayed, starting two lines before the place
  122.           where the expression was found. The user's erase and kill characters
  123.           may  be  used  to  edit the expression.  Erasing back past the first
  124.           character cancels the search command.
  125.                                     local                                    3
  126. YAP(1)                    Minix Programmer's Manual                     YAP(1)
  127.           Note: Some systems do not have regex(3).  On those systems, searches
  128.           are still supported, but regular expressions are not.
  129.      skip lines forwards (fsl) s
  130.           Skip i lines and display a page.
  131.      skip pages forwards (fsp) f
  132.           Skip i pages and display a page.
  133.      scroll down and set scrollsize (fss) d
  134.           Scroll down i lines (or scroll-size lines if i is not given.   If  i
  135.           is given, the scroll-size is set to i.
  136.      help (hlp) h
  137.           Give a short description of all commands that are  bound  to  a  key
  138.           sequence.
  139.      set a mark (mar) m
  140.           Set a mark on the current page.
  141.      repeat last search (nse) n
  142.           Search for the  i-th  occurrence  of  the  last  regular  expression
  143.           entered, in the direction of the last search.
  144.      repeat last search in other direction (nsr) r
  145.           Search for the  i-th  occurrence  of  the  last  regular  expression
  146.           entered, but in the other direction.
  147.      quit (qui) Q or q
  148.           Exit from yap.
  149.      redraw (red) ^L
  150.           Redraw the current page.
  151.      repeat (rep) .
  152.           Repeat the last command. This does not always make sense, so not all
  153.           commands can be repeated.
  154.      shell escape (shl) !
  155.           Invoke the shell with a command that will be prompted for.   In  the
  156.           command,  the  characters  `%' and `!' are replaced with the current
  157.           file  name  and  the  previous  shell  command  respectively.    The
  158.           sequences  `%'  and  `!' are replaced by `%' and `!' respectively.
  159.           The user's erase and  kill  characters  can  be  used  to  edit  the
  160.           command.  Erasing back past the first character cancels the command.
  161.      pipe to shell command (pip) |
  162.           Pipe the current input file  into  a  shell  command  that  will  be
  163.           prompted  for.   The  comments given in the description of the shell
  164.           escape command apply here too.
  165.                                     local                                    4
  166. YAP(1)                    Minix Programmer's Manual                     YAP(1)
  167.      go to mark (tom) '
  168.           Display the marked page.
  169.      top (top) ^^
  170.           Display a page starting with the first line of the input.
  171.      visit file (vis) e
  172.           Visit a new file. The filename will be prompted  for.  If  you  just
  173.           type a return, the current file is revisited.
  174.      write input to a file (wrf) w
  175.           Write the input to a file, whose name will be prompted for.
  176.      The commands take effect immediately, i.e., it is not necessary to type a
  177.      carriage  return.   Up  to  the  time when the command sequence itself is
  178.      given, the user may give an interrupt to cancel the command being formed.
  179. AUTHOR
  180.      Ceriel J.H. Jacobs
  181. FILES
  182.      /etc/termcap            Terminal capabilities data base
  183. SEE ALSO
  184.      termcap(5), regex(3).
  185. BUGS
  186.      Yap will find your terminal very stupid and act like it, if it has no way
  187.      of placing the cursor on the home position, or cannot either erase a line
  188.      or insert one.
  189.      In lines longer than  about  2000  characters,  a  linefeed  is  silently
  190.      inserted.
  191.      The percentage, given in the prompt when yap reads from a file (and knows
  192.      it), is not always very accurate.
  193.                                     local                                    5