git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/miscellany/less-177/less.man

   1
   2
   3
   4 LESS(1)                                                   LESS(1)
   5
   6
   7 N\bNA\bAM\bME\bE
   8        less - opposite of more
   9
  10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  11        l\ble\bes\bss\bs -\b-?\b?
  12        l\ble\bes\bss\bs [\b[-\b-[\b[+\b+]\b]a\baB\bBc\bcC\bCd\bde\beE\bEf\bfH\bHi\bim\bmM\bMn\bnN\bNq\bqQ\bQr\brs\bsS\bSu\buU\bUw\bw]\b]
  13             [\b[-\b-b\bb _\bb_\bu_\bf_\bs]\b] [\b[-\b-h\bh _\bl_\bi_\bn_\be_\bs]\b] [\b[-\b-j\bj _\bl_\bi_\bn_\be]\b] [\b[-\b-k\bk _\bk_\be_\by_\bf_\bi_\bl_\be]\b]
  14             [\b[-\b-{\b{o\boO\bO}\b} _\bl_\bo_\bg_\bf_\bi_\bl_\be]\b] [\b[-\b-p\bp _\bp_\ba_\bt_\bt_\be_\br_\bn]\b] [\b[-\b-P\bP _\bp_\br_\bo_\bm_\bp_\bt]\b] [\b[-\b-t\bt _\bt_\ba_\bg]\b]
  15             [\b[-\b-T\bT _\bt_\ba_\bg_\bf_\bi_\bl_\be]\b] [\b[-\b-x\bx _\bt_\ba_\bb]\b] [\b[-\b-y\by _\bl_\bi_\bn_\be_\bs]\b] [\b[-\b-[\b[z\bz]\b] _\bl_\bi_\bn_\be_\bs]\b]
  16             [\b[+\b+[\b[+\b+]\b]_\bc_\bm_\bd]\b] [\b[_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be]\b].\b..\b..\b.
  17
  18
  19 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  20        _\bL_\be_\bs_\bs  is  a  program similar to _\bm_\bo_\br_\be (1), but which allows
  21        backward movement in the file as well as forward movement.
  22        Also,  _\bl_\be_\bs_\bs  does  not  have to read the entire input file
  23        before starting, so with large input files  it  starts  up
  24        faster  than  text editors like _\bv_\bi (1).  _\bL_\be_\bs_\bs uses termcap
  25        (or terminfo on some systems), so it can run on a  variety
  26        of  terminals.  There is even limited support for hardcopy
  27        terminals.  (On a hardcopy terminal, lines which should be
  28        printed  at the top of the screen are prefixed with an up-
  29        arrow.)
  30
  31        Commands are based on both _\bm_\bo_\br_\be and _\bv_\bi_\b.  Commands  may  be
  32        preceded by a decimal number, called N in the descriptions
  33        below.  The number is used by some commands, as indicated.
  34
  35
  36 C\bCO\bOM\bMM\bMA\bAN\bND\bDS\bS
  37        In  the  following  descriptions, ^X means control-X.  ESC
  38        stands for the ESCAPE key; for example ESC-v means the two
  39        character sequence "ESCAPE", then "v".
  40
  41        h or H Help:  display a summary of these commands.  If you
  42               forget all the other commands, remember this one.
  43
  44
  45        SPACE or ^V or f or ^F
  46               Scroll forward N lines,  default  one  window  (see
  47               option  -z  below).   If  N is more than the screen
  48               size, only the final screenful is displayed.  Warn-
  49               ing:  some  systems use ^V as a special literaliza-
  50               tion character.
  51
  52
  53        z      Like SPACE, but if N is specified, it  becomes  the
  54               new window size.
  55
  56
  57        RETURN or ^N or e or ^E or j or ^J
  58               Scroll  forward  N  lines, default 1.  The entire N
  59               lines are displayed, even if N  is  more  than  the
  60               screen size.
  61
  62
  63
  64                                                                 1
  65
  66
  67
  68
  69
  70 LESS(1)                                                   LESS(1)
  71
  72
  73        d or ^D
  74               Scroll  forward  N  lines,  default one half of the
  75               screen size.  If N is specified, it becomes the new
  76               default for subsequent d and u commands.
  77
  78
  79        b or ^B or ESC-v
  80               Scroll  backward  N  lines, default one window (see
  81               option -z below).  If N is  more  than  the  screen
  82               size, only the final screenful is displayed.
  83
  84
  85        w      Like  ESC-v,  but if N is specified, it becomes the
  86               new window size.
  87
  88
  89        y or ^Y or ^P or k or ^K
  90               Scroll backward N lines, default 1.  The  entire  N
  91               lines  are  displayed,  even  if N is more than the
  92               screen size.  Warning: some systems  use  ^Y  as  a
  93               special job control character.
  94
  95
  96        u or ^U
  97               Scroll  backward  N  lines, default one half of the
  98               screen size.  If N is specified, it becomes the new
  99               default for subsequent d and u commands.
 100
 101
 102        r or ^R or ^L
 103               Repaint the screen.
 104
 105
 106        R      Repaint  the screen, discarding any buffered input.
 107               Useful if the file is changing while  it  is  being
 108               viewed.
 109
 110
 111        F      Scroll  forward,  and  keep trying to read when the
 112               end of file  is  reached.   Normally  this  command
 113               would  be used when already at the end of the file.
 114               It is a way to monitor the tail of a file which  is
 115               growing while it is being viewed.  (The behavior is
 116               similar to the "tail -f" command.)
 117
 118
 119        g or < or ESC-<
 120               Go to line N in the file, default 1  (beginning  of
 121               file).   (Warning: this may be slow if N is large.)
 122
 123
 124        G or > or ESC->
 125               Go to line N in the file, default the  end  of  the
 126               file.  (Warning: this may be slow if N is large, or
 127
 128
 129
 130                                                                 2
 131
 132
 133
 134
 135
 136 LESS(1)                                                   LESS(1)
 137
 138
 139               if N is not specified and  standard  input,  rather
 140               than a file, is being read.)
 141
 142
 143        p or % Go to a position N percent into the file.  N should
 144               be between 0 and  100.   (This  works  if  standard
 145               input  is  being read, but only if _\bl_\be_\bs_\bs has already
 146               read to the end of the file.  It  is  always  fast,
 147               but not always useful.)
 148
 149
 150        {      If  a  left  curly  bracket appears in the top line
 151               displayed on the screen, the { command will  go  to
 152               the  matching  right  curly  bracket.  The matching
 153               right curly bracket is  positioned  on  the  bottom
 154               line of the screen.  If there is more than one left
 155               curly bracket on the top line, a number  N  may  be
 156               used to specify the N-th bracket on the line.
 157
 158
 159        }      If a right curly bracket appears in the bottom line
 160               displayed on the screen, the } command will  go  to
 161               the matching left curly bracket.  The matching left
 162               curly bracket is positioned on the top line of  the
 163               screen.   If  there  is  more  than one right curly
 164               bracket on the top line, a number N may be used  to
 165               specify the N-th bracket on the line.
 166
 167
 168        (      Like  {,  but  applies  to  parentheses rather than
 169               curly brackets.
 170
 171
 172        )      Like }, but  applies  to  parentheses  rather  than
 173               curly brackets.
 174
 175
 176        [      Like  {, but applies to square brackets rather than
 177               curly brackets.
 178
 179
 180        ]      Like }, but applies to square brackets rather  than
 181               curly brackets.
 182
 183
 184        ESC-^F Followed  by  two characters, acts like {, but uses
 185               the two characters  as  open  and  close  brackets,
 186               respectively.   For  example, "ESC ^F < >" could be
 187               used to go forward to the > which matches the <  in
 188               the top displayed line.
 189
 190        ESC-^B Followed  by  two characters, acts like }, but uses
 191               the two characters  as  open  and  close  brackets,
 192               respectively.   For  example, "ESC ^B < >" could be
 193
 194
 195
 196                                                                 3
 197
 198
 199
 200
 201
 202 LESS(1)                                                   LESS(1)
 203
 204
 205               used to go backward to the < which matches the > in
 206               the bottom displayed line.
 207
 208        m      Followed by any lowercase letter, marks the current
 209               position with that letter.
 210
 211
 212        '      (Single quote.)  Followed by any lowercase  letter,
 213               returns to the position which was previously marked
 214               with  that  letter.   Followed  by  another  single
 215               quote,  returns  to  the position at which the last
 216               "large" movement command was executed.  Followed by
 217               a ^ or $, jumps to the beginning or end of the file
 218               respectively.  Marks are preserved when a new  file
 219               is examined, so the ' command can be used to switch
 220               between input files.
 221
 222
 223        ^X^X   Same as single quote.
 224
 225
 226        /pattern
 227               Search forward in the file for the N-th  line  con-
 228               taining the pattern.  N defaults to 1.  The pattern
 229               is a regular expression, as recognized by _\be_\bd_\b.   The
 230               search starts at the second line displayed (but see
 231               the -a and -j options, which change this).
 232
 233               Certain characters are special if  entered  at  the
 234               beginning  of  the pattern; they modify the type of
 235               search rather than become part of the pattern:
 236
 237               !      Search for lines which do NOT match the pat-
 238                      tern.
 239
 240               *      Search  multiple  files.   That  is,  if the
 241                      search reaches the end of the  current  file
 242                      without  finding a match, the search contin-
 243                      ues in the next file  in  the  command  line
 244                      list.
 245
 246               @      Begin  the  search  at the first line of the
 247                      first file in the command line list, regard-
 248                      less  of  what is currently displayed on the
 249                      screen or the  settings  of  the  -a  or  -j
 250                      options.
 251
 252
 253        ?pattern
 254               Search  backward in the file for the N-th line con-
 255               taining the pattern.  The search starts at the line
 256               immediately before the top line displayed.
 257
 258               Certain characters are special as in the / command:
 259
 260
 261
 262                                                                 4
 263
 264
 265
 266
 267
 268 LESS(1)                                                   LESS(1)
 269
 270
 271               !      Search for lines which do NOT match the pat-
 272                      tern.
 273
 274               *      Search  multiple  files.   That  is,  if the
 275                      search reaches the beginning of the  current
 276                      file  without  finding  a  match, the search
 277                      continues in the previous file in  the  com-
 278                      mand line list.
 279
 280               @      Begin  the  search  at  the last line of the
 281                      last file in the command line list,  regard-
 282                      less  of  what is currently displayed on the
 283                      screen or the  settings  of  the  -a  or  -j
 284                      options.
 285
 286
 287        ESC-/pattern
 288               Same as "/*".
 289
 290
 291        ESC-?pattern
 292               Same as "?*".
 293
 294
 295        n      Repeat  previous  search,  for N-th line containing
 296               the last pattern.  If the previous search was modi-
 297               fied by !, the search is made for the N-th line NOT
 298               containing the pattern.  If the previous search was
 299               modified by *, the search continues in the next (or
 300               previous) file if  not  satisfied  in  the  current
 301               file.   There  is  no effect if the previous search
 302               was modified by @.
 303
 304
 305        N      Repeat previous search, but in the  reverse  direc-
 306               tion.
 307
 308
 309        ESC-n  Repeat  previous  search,  but crossing file bound-
 310               aries.  The effect is as  if  the  previous  search
 311               were modified by *.
 312
 313
 314        ESC-N  Repeat  previous  search, but in the reverse direc-
 315               tion and crossing file boundaries.
 316
 317
 318        :e [filename]
 319               Examine a new file.  If the  filename  is  missing,
 320               the  "current"  file  (see  the  :n and :p commands
 321               below) from the list of files in the  command  line
 322               is re-examined.  A percent sign (%) in the filename
 323               is replaced by the name of  the  current  file.   A
 324               pound  sign  (#)  is  replaced  by  the name of the
 325
 326
 327
 328                                                                 5
 329
 330
 331
 332
 333
 334 LESS(1)                                                   LESS(1)
 335
 336
 337               previously examined file.  The filename is inserted
 338               into  the command line list of files so that it can
 339               be seen by subsequent :n and :p commands.   If  the
 340               filename  consists  of  several files, they are all
 341               inserted into the list of files and the  first  one
 342               is examined.
 343
 344
 345        ^X^V or E
 346               Same as :e.  Warning: some systems use ^V as a spe-
 347               cial literalization character.
 348
 349
 350        :n     Examine the next file (from the list of files given
 351               in  the command line).  If a number N is specified,
 352               the N-th next file is examined.
 353
 354
 355        :p     Examine the previous file in the command line list.
 356               If  a number N is specified, the N-th previous file
 357               is examined.
 358
 359
 360        :x     Examine the first file in the  command  line  list.
 361               If  a  number  N is specified, the N-th file in the
 362               list is examined.
 363
 364
 365        = or ^G or :f
 366               Prints  some  information  about  the  file   being
 367               viewed,  including its name and the line number and
 368               byte offset of the bottom line being displayed.  If
 369               possible,  it  also  prints the length of the file,
 370               the number of lines in the file and the percent  of
 371               the file above the last displayed line.
 372
 373
 374        -      Followed  by one of the command line option letters
 375               (see below), this will change the setting  of  that
 376               option  and print a message describing the new set-
 377               ting.  If the option letter  has  a  numeric  value
 378               (such  as  -b or -h), or a string value (such as -P
 379               or -t), a new value may be entered after the option
 380               letter.   If  no  new  value  is entered, a message
 381               describing the current setting is printed and noth-
 382               ing is changed.
 383
 384
 385        -+     Followed  by one of the command line option letters
 386               (see below), this will  reset  the  option  to  its
 387               default  setting and print a message describing the
 388               new setting.  (The  "-+_\bX"  command  does  the  same
 389               thing as "-+_\bX" on the command line.)  This does not
 390               work for string-valued options.
 391
 392
 393
 394                                                                 6
 395
 396
 397
 398
 399
 400 LESS(1)                                                   LESS(1)
 401
 402
 403        --     Followed by one of the command line option  letters
 404               (see  below),  this  will  reset  the option to the
 405               "opposite" of its default setting and print a  mes-
 406               sage  describing  the new setting.  (The "--_\bX" com-
 407               mand does the same thing as  "-_\bX"  on  the  command
 408               line.)   This  does not work for numeric or string-
 409               valued options.
 410
 411
 412        _      (Underscore.)  Followed by one of the command  line
 413               option  letters (see below), this will print a mes-
 414               sage describing the current setting of that option.
 415               The setting of the option is not changed.
 416
 417
 418        +cmd   Causes the specified cmd to be executed each time a
 419               new file is examined.  For example, +G causes  _\bl_\be_\bs_\bs
 420               to  initially display each file starting at the end
 421               rather than the beginning.
 422
 423
 424        V      Prints the version number of _\bl_\be_\bs_\bs being run.
 425
 426
 427        q or :q or :Q or ZZ or ESC ESC
 428               Exits _\bl_\be_\bs_\bs_\b.
 429
 430        The following three commands may  or  may  not  be  valid,
 431        depending on your particular installation.
 432
 433
 434        v      Invokes  an  editor  to edit the current file being
 435               viewed.  The editor is taken from  the  environment
 436               variable EDITOR, or defaults to "vi".  See also the
 437               discussion of LESSEDIT under the section on PROMPTS
 438               below.
 439
 440
 441        ! shell-command
 442               Invokes  a shell to run the shell-command given.  A
 443               percent sign (%) in the command is replaced by  the
 444               name  of  the  current  file.   A pound sign (#) is
 445               replaced by the name  of  the  previously  examined
 446               file.   "!!"  repeats  the last shell command.  "!"
 447               with no shell command simply invokes a  shell.   In
 448               all  cases, the shell is taken from the environment
 449               variable SHELL, or defaults to "sh".
 450
 451
 452        | <m> shell-command
 453               <m> represents any mark letter.  Pipes a section of
 454               the  input  file  to  the given shell command.  The
 455               section of the file to  be  piped  is  between  the
 456               first  line  on the current screen and the position
 457
 458
 459
 460                                                                 7
 461
 462
 463
 464
 465
 466 LESS(1)                                                   LESS(1)
 467
 468
 469               marked by the letter.  <m> may also be ^  or  $  to
 470               indicate beginning or end of file respectively.  If
 471               <m> is . or newline, the current screen is piped.
 472
 473
 474 O\bOP\bPT\bTI\bIO\bON\bNS\bS
 475        Command line options are described  below.   Most  options
 476        may be changed while _\bl_\be_\bs_\bs is running, via the "-" command.
 477
 478        Options are  also  taken  from  the  environment  variable
 479        "LESS".   For example, to avoid typing "less -options ..."
 480        each time _\bl_\be_\bs_\bs is invoked, you might tell _\bc_\bs_\bh_\b:
 481
 482        setenv LESS "-options"
 483
 484        or if you use _\bs_\bh_\b:
 485
 486        LESS="-options"; export LESS
 487
 488        The environment variable  is  parsed  before  the  command
 489        line,  so  command line options override the LESS environ-
 490        ment variable.  If an option appears in the LESS variable,
 491        it  can  be  reset  to  its default on the command line by
 492        beginning the command line option with "-+".
 493
 494        A dollar sign ($) may be used to  signal  the  end  of  an
 495        option string.  This is important only for options like -P
 496        which take a following string.
 497
 498        -?     This option displays  a  summary  of  the  commands
 499               accepted  by  _\bl_\be_\bs_\bs (the same as the h command).  If
 500               this  option  is  given,  all  other  options   are
 501               ignored,  and  _\bl_\be_\bs_\bs  exits after the help screen is
 502               viewed.  (Depending on how  your  shell  interprets
 503               the question mark, it may be necessary to quote the
 504               question mark, thus: "-\?".)
 505
 506        -a     Causes searches to start after the last  line  dis-
 507               played  on the screen, thus skipping all lines dis-
 508               played on the screen.  By default,  searches  start
 509               at the second line on the screen (or after the last
 510               found line; see the -j option).
 511
 512        -b_\bn    Causes  _\bl_\be_\bs_\bs  to  use  a  non-standard  number   of
 513               buffers.  Buffers are 1K, and by default 10 buffers
 514               are used (except if data in  coming  from  standard
 515               input;  see the -B option).  The number _\bn specifies
 516               a different number of buffers to use.
 517
 518        -B     Disables automatic allocation of buffers,  so  that
 519               only  the  default  number of buffers are used.  If
 520               more data is read than will fit in the buffers, the
 521               oldest data is discarded.  By default, when data is
 522               coming from standard input, buffers  are  allocated
 523
 524
 525
 526                                                                 8
 527
 528
 529
 530
 531
 532 LESS(1)                                                   LESS(1)
 533
 534
 535               automatically as needed to avoid loss of data.
 536
 537        -c     Causes  full screen repaints to be painted from the
 538               top line down.  By default,  full  screen  repaints
 539               are  done  by  scrolling  from  the  bottom  of the
 540               screen.
 541
 542        -C     The -C option is like -c, but the screen is cleared
 543               before it is repainted.
 544
 545        -d     The -d option suppresses the error message normally
 546               displayed if the terminal is dumb; that  is,  lacks
 547               some  important  capability, such as the ability to
 548               clear the screen or scroll backward.  The -d option
 549               does not otherwise change the behavior of _\bl_\be_\bs_\bs on a
 550               dumb terminal).
 551
 552        -e     Causes _\bl_\be_\bs_\bs to automatically exit the  second  time
 553               it  reaches  end-of-file.  By default, the only way
 554               to exit _\bl_\be_\bs_\bs is via the "q" command.
 555
 556        -E     Causes _\bl_\be_\bs_\bs to automatically exit the first time it
 557               reaches end-of-file.
 558
 559        -f     Forces  non-regular  files  to  be opened.  (A non-
 560               regular file is a directory  or  a  device  special
 561               file.)   Also suppresses the warning message when a
 562               binary file  is  opened.   By  default,  _\bl_\be_\bs_\bs  will
 563               refuse to open non-regular files.
 564
 565        -h_\bn    Specifies a maximum number of lines to scroll back-
 566               ward.  If it is necessary to scroll  backward  more
 567               than  _\bn lines, the screen is repainted in a forward
 568               direction instead.  (If the terminal does not  have
 569               the ability to scroll backward, -h0 is implied.)
 570
 571        -i     Causes  searches to ignore case; that is, uppercase
 572               and lowercase are considered identical.  Also, text
 573               which  is  overstruck or underlined can be searched
 574               for.  This option is ignored if any uppercase  let-
 575               ters appear in the search pattern.
 576
 577        -j_\bn    Specifies a line on the screen where "target" lines
 578               are to be positioned.  Target lines are the  object
 579               of  text  searches,  tag  searches, jumps to a line
 580               number, jumps to a file percentage, and jumps to  a
 581               marked position.  The screen line is specified by a
 582               number: the top line on the screen is 1,  the  next
 583               is  2,  and  so  on.  The number may be negative to
 584               specify a  line  relative  to  the  bottom  of  the
 585               screen:  the  bottom  line on the screen is -1, the
 586               second to the bottom is -2, and so on.  If  the  -j
 587               option  is used, searches begin at the line immedi-
 588               ately after the target line.  For example, if "-j4"
 589
 590
 591
 592                                                                 9
 593
 594
 595
 596
 597
 598 LESS(1)                                                   LESS(1)
 599
 600
 601               is  used, the target line is the fourth line on the
 602               screen, so searches begin at the fifth line on  the
 603               screen.
 604
 605        -k_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
 606               Causes _\bl_\be_\bs_\bs to open and interpret the named file as
 607               a _\bl_\be_\bs_\bs_\bk_\be_\by (1) file.  Multiple  -k  options  may  be
 608               specified.   If  a  file called .less exists in the
 609               user's home directory, this file is also used as  a
 610               _\bl_\be_\bs_\bs_\bk_\be_\by file.
 611
 612        -m     Causes  _\bl_\be_\bs_\bs  to prompt verbosely (like _\bm_\bo_\br_\be), with
 613               the  percent  into  the  file.   By  default,  _\bl_\be_\bs_\bs
 614               prompts with a colon.
 615
 616        -M     Causes  _\bl_\be_\bs_\bs  to  prompt  even  more verbosely than
 617               _\bm_\bo_\br_\be_\b.
 618
 619        -n     Suppresses line numbers.  The default (to use  line
 620               numbers)  may cause _\bl_\be_\bs_\bs to run more slowly in some
 621               cases, especially with a  very  large  input  file.
 622               Suppressing  line  numbers  with  the  -n flag will
 623               avoid this problem.  Using line numbers means:  the
 624               line number will be displayed in the verbose prompt
 625               and in the = command, and the v command  will  pass
 626               the current line number to the editor (see also the
 627               discussion of LESSEDIT in PROMPTS below).
 628
 629        -N     Causes a line number to be displayed at the  begin-
 630               ning of each line in the display.
 631
 632        -o_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
 633               Causes  _\bl_\be_\bs_\bs to copy its input to the named file as
 634               it is being viewed.  This  applies  only  when  the
 635               input file is a pipe, not an ordinary file.  If the
 636               file already exists, _\bl_\be_\bs_\bs will ask for confirmation
 637               before overwriting it.
 638
 639        -O_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
 640               The  -O option is like -o, but it will overwrite an
 641               existing file without asking for confirmation.
 642
 643               If no log file has been specified, the  -o  and  -O
 644               options  can  be used from within _\bl_\be_\bs_\bs to specify a
 645               log file.  Without a file name,  they  will  simply
 646               report  the  name of the log file.  The "s" command
 647               is equivalent to specifying -o from within _\bl_\be_\bs_\bs_\b.
 648
 649        -p_\bp_\ba_\bt_\bt_\be_\br_\bn
 650               The -p option on the command line is equivalent  to
 651               specifying  +/_\bp_\ba_\bt_\bt_\be_\br_\bn;  that  is,  it tells _\bl_\be_\bs_\bs to
 652               start at the first  occurence  of  _\bp_\ba_\bt_\bt_\be_\br_\bn  in  the
 653               file.
 654
 655
 656
 657
 658                                                                10
 659
 660
 661
 662
 663
 664 LESS(1)                                                   LESS(1)
 665
 666
 667        -P_\bp_\br_\bo_\bm_\bp_\bt
 668               Provides a way to tailor the three prompt styles to
 669               your own preference.  This option would normally be
 670               put  in  the LESS environment variable, rather than
 671               being typed in with each  _\bl_\be_\bs_\bs  command.   Such  an
 672               option  must  either be the last option in the LESS
 673               variable, or be terminated by a  dollar  sign.   -P
 674               followed  by  a  string changes the default (short)
 675               prompt to that string.  -Pm changes the medium (-m)
 676               prompt to the string, and -PM changes the long (-M)
 677               prompt.  Also, -P= changes the message  printed  by
 678               the  =  command  to  the  given string.  All prompt
 679               strings consist of a sequence of letters  and  spe-
 680               cial  escape sequences.  See the section on PROMPTS
 681               for more details.
 682
 683        -q     Causes moderately "quiet" operation:  the  terminal
 684               bell  is  not  rung if an attempt is made to scroll
 685               past the end of the file or before the beginning of
 686               the  file.  If the terminal has a "visual bell", it
 687               is used instead.  The bell will be rung on  certain
 688               other  errors, such as typing an invalid character.
 689               The default is to ring the  terminal  bell  in  all
 690               such cases.
 691
 692        -Q     Causes totally "quiet" operation: the terminal bell
 693               is never rung.
 694
 695        -r     Causes "raw" control characters  to  be  displayed.
 696               The  default is to display control characters using
 697               the caret notation; for example, a control-A (octal
 698               001)  is  displayed  as "^A".  Warning: when the -r
 699               flag is used, _\bl_\be_\bs_\bs cannot keep track of the  actual
 700               appearance of the screen (since this depends on how
 701               the screen responds to each type of control charac-
 702               ter).   Thus,  various display problems may result,
 703               such as long lines being split in the wrong  place.
 704
 705        -s     Causes  consecutive blank lines to be squeezed into
 706               a single blank line.  This is useful  when  viewing
 707               _\bn_\br_\bo_\bf_\bf output.
 708
 709        -S     Causes  lines  longer  than  the screen width to be
 710               chopped rather than folded.  That is, the remainder
 711               of a long line is simply discarded.  The default is
 712               to fold long lines; that is, display the  remainder
 713               on the next line.
 714
 715        -t_\bt_\ba_\bg  The  -t option, followed immediately by a TAG, will
 716               edit the file containing that  tag.   For  this  to
 717               work,  there  must  be  a file called "tags" in the
 718               current directory, which was  previously  built  by
 719               the  _\bc_\bt_\ba_\bg_\bs  (1)  command.   This option may also be
 720               specified from within _\bl_\be_\bs_\bs (using the - command) as
 721
 722
 723
 724                                                                11
 725
 726
 727
 728
 729
 730 LESS(1)                                                   LESS(1)
 731
 732
 733               a way of examining a new file.  The command ":t" is
 734               equivalent to specifying -t from within _\bl_\be_\bs_\bs_\b.
 735
 736        -T_\bt_\ba_\bg_\bs_\bf_\bi_\bl_\be
 737               Specifies a tags file to be used instead of "tags".
 738
 739        -u     Causes   backspaces  and  carriage  returns  to  be
 740               treated as printable characters; that is, they  are
 741               sent to the terminal when they appear in the input.
 742
 743        -U     Causes  backspaces  and  carriage  returns  to   be
 744               treated  as  control  characters; that is, they are
 745               handled as specified by the -r option.
 746
 747               By  default,  if  neither  -u  nor  -U  is   given,
 748               backspaces  which  appear adjacent to an underscore
 749               character are  treated  specially:  the  underlined
 750               text  is  displayed  using  the terminal's hardware
 751               underlining  capability.   Also,  backspaces  which
 752               appear between two identical characters are treated
 753               specially: the overstruck text is printed using the
 754               terminal's  hardware  boldface  capability.   Other
 755               backspaces are deleted, along  with  the  preceding
 756               character.   Carriage  returns immediately followed
 757               by a newline are deleted.  Other  carriage  returns
 758               are handled as specified by the -r option.
 759
 760        -w     Causes  blank  lines  to be used to represent lines
 761               past the end of the  file.   By  default,  a  tilde
 762               character is used.
 763
 764        -x_\bn    Sets  tab stops every _\bn positions.  The default for
 765               _\bn is 8.
 766
 767        -y_\bn    Specifies a maximum number of lines to scroll  for-
 768               ward.   If  it  is necessary to scroll forward more
 769               than _\bn lines, the screen is repainted instead.  The
 770               -c or -C option may be used to repaint from the top
 771               of the screen if desired.  By default, any  forward
 772               movement causes scrolling.
 773
 774        -[z]_\bn  Changes  the  default  scrolling  window  size to _\bn
 775               lines.  The default is one screenful.  The z and  w
 776               commands  can  also  be  used  to change the window
 777               size.  The "z" may be omitted, as in "-_\bn" for  com-
 778               patibility with _\bm_\bo_\br_\be_\b.
 779
 780        +      If a command line option begins with +\b+, the remain-
 781               der of that option is taken to be an  initial  com-
 782               mand  to _\bl_\be_\bs_\bs_\b.  For example, +G tells _\bl_\be_\bs_\bs to start
 783               at the end of the file rather than  the  beginning,
 784               and +/xyz tells it to start at the first occurrence
 785               of "xyz" in the file.  As a special case, +<number>
 786               acts  like  +<number>g;  that  is,  it  starts  the
 787
 788
 789
 790                                                                12
 791
 792
 793
 794
 795
 796 LESS(1)                                                   LESS(1)
 797
 798
 799               display at the specified line number (however,  see
 800               the  caveat  under  the "g" command above).  If the
 801               option starts with ++, the initial command  applies
 802               to every file being viewed, not just the first one.
 803               The + command described previously may also be used
 804               to  set  (or  change)  an initial command for every
 805               file.
 806
 807
 808 K\bKE\bEY\bY B\bBI\bIN\bND\bDI\bIN\bNG\bGS\bS
 809        You may define your own _\bl_\be_\bs_\bs commands by using the program
 810        _\bl_\be_\bs_\bs_\bk_\be_\by  (1)  to create a file called ".less" in your home
 811        directory.  This file specifies a set of command keys  and
 812        an  action associated with each key.  See the _\bl_\be_\bs_\bs_\bk_\be_\by man-
 813        ual page for more details.
 814
 815
 816 N\bNA\bAT\bTI\bIO\bON\bNA\bAL\bL C\bCH\bHA\bAR\bRA\bAC\bCT\bTE\bER\bR S\bSE\bET\bTS\bS
 817        There are three types of characters in the input file:
 818
 819        normal characters
 820               can be displayed directly to the screen.
 821
 822        control characters
 823               should not be displayed directly, but are  expected
 824               to  be  found  in  ordinary  text  files  (such  as
 825               backspace and tab).
 826
 827        binary characters
 828               cannot be displayed directly and are  not  expected
 829               to be found in text files.
 830
 831        By  default,  _\bl_\be_\bs_\bs  uses  the ASCII character set.  In the
 832        ASCII character set, characters with  values  between  128
 833        and  255  are treated as binary.  The LESSCHARSET environ-
 834        ment variable may be used to select another character set.
 835        If it is set to the value "latin1", the ISO 8859/1 charac-
 836        ter set is assumed.  Latin-1 is the same as ASCII,  except
 837        characters between 128 and 255 are treated as normal char-
 838        acters.  The only valid values for  LESSCHARSET  currently
 839        are "ascii" and "latin1".
 840
 841        In  special cases, it may be desired to tailor _\bl_\be_\bs_\bs to use
 842        a character set other than the  ones  definable  by  LESS-
 843        CHARSET.   In  this  case,  the environment variable LESS-
 844        CHARDEF can be used to define a character set.  It  should
 845        be set to a string where each character in the string rep-
 846        resents one character in the character set.  The character
 847        "."  is  used for a normal character, "c" for control, and
 848        "b" for binary.  A decimal number may be used for  repeti-
 849        tion.   For  example,  "bccc4b." would mean character 0 is
 850        binary, 1, 2 and 3 are control, 4, 5, 6 and 7 are  binary,
 851        and  8 is normal.  All characters after the last are taken
 852        to be the same as the last, so characters  9  through  255
 853
 854
 855
 856                                                                13
 857
 858
 859
 860
 861
 862 LESS(1)                                                   LESS(1)
 863
 864
 865        would be normal.  (This is an example, and does not neces-
 866        sarily represent any real character set.)
 867
 868        Setting LESSCHARDEF to "8bcccbcc18b95.b" is  the  same  as
 869        setting  LESSCHARSET  to  "ascii".  Setting LESSCHARDEF to
 870        "8bcccbcc18b95.33b." is the same as setting LESSCHARSET to
 871        "latin1".
 872
 873        Control  and  binary  characters are displayed in blinking
 874        mode.  Each such character is displayed in caret  notation
 875        if  possible  (e.g.  ^A for control-A).  Caret notation is
 876        used only if inverting the 0100 bit results  in  a  normal
 877        printable  character.   Otherwise,  the  character is dis-
 878        played as an octal number preceded by a  backslash.   This
 879        octal  format  can  be  changed  by setting the LESSBINFMT
 880        environment variable to a printf-style format string;  the
 881        default  is  '\%o'.   The blinking mode display of control
 882        and binary characters can be changed or disabled  by  pre-
 883        ceding  the  LESSBINFMT  format  string with a "*" and one
 884        character to select the mode: "*k" is  blinking,  "*d"  is
 885        bold,  "*u"  is underlined, and "*n" is normal (no special
 886        display  attribute).   For  example,  if   LESSBINFMT   is
 887        "*u[%x]",  binary  characters  are displayed in underlined
 888        hexadecimal surrounded by brackets.
 889
 890
 891 P\bPR\bRO\bOM\bMP\bPT\bTS\bS
 892        The -P option allows you to  tailor  the  prompt  to  your
 893        preference.   The  string  given to the -P option replaces
 894        the specified prompt string.  Certain  characters  in  the
 895        string are interpreted specially.  The prompt mechanism is
 896        rather complicated to provide flexibility, but  the  ordi-
 897        nary  user need not understand the details of constructing
 898        personalized prompt strings.
 899
 900        A percent sign followed by a single character is  expanded
 901        according to what the following character is:
 902
 903        %b_\bX    Replaced  by the byte offset into the current input
 904               file.  The b is  followed  by  a  single  character
 905               (shown  as  _\bX above) which specifies the line whose
 906               byte offset is to be used.  If the character  is  a
 907               "t", the byte offset of the top line in the display
 908               is used, an "m" means use the middle  line,  a  "b"
 909               means use the bottom line, a "B" means use the line
 910               just after the bottom line, and a "j" means use the
 911               "target" line, as specified by the -j option.
 912
 913        %B     Replaced by the size of the current input file.
 914
 915        %E     Replaced by the name of the editor (from the EDITOR
 916               environment variable).  See the discussion  of  the
 917               LESSEDIT feature below.
 918
 919
 920
 921
 922                                                                14
 923
 924
 925
 926
 927
 928 LESS(1)                                                   LESS(1)
 929
 930
 931        %f     Replaced by the name of the current input file.
 932
 933        %i     Replaced  by  the  index of the current file in the
 934               list of input files.
 935
 936        %l_\bX    Replaced by the line number of a line in the  input
 937               file.   The line to be used is determined by the _\bX,
 938               as with the %b option.
 939
 940        %L     Replaced by the line number of the last line in the
 941               input file.
 942
 943        %m     Replaced by the total number of input files.
 944
 945        %p_\bX    Replaced  by  the  percent  into  the current input
 946               file.  The line used is determined by the _\bX as with
 947               the %b option.
 948
 949        %s     Same as %B.
 950
 951        %t     Causes  any trailing spaces to be removed.  Usually
 952               used at the end of the string, but may appear  any-
 953               where.
 954
 955        %x     Replaced  by the name of the next input file in the
 956               list.
 957
 958        If any item is unknown (for  example,  the  file  size  if
 959        input is a pipe), a question mark is printed instead.
 960
 961        The  format  of the prompt string can be changed depending
 962        on certain conditions.  A question mark followed by a sin-
 963        gle  character acts like an "IF": depending on the follow-
 964        ing character, a condition is evaluated.  If the condition
 965        is  true,  any  characters following the question mark and
 966        condition character, up to a period, are included  in  the
 967        prompt.   If  the  condition is false, such characters are
 968        not included.  A colon appearing between the question mark
 969        and  the  period  can  be used to establish an "ELSE": any
 970        characters between the colon and the period  are  included
 971        in  the  string  if and only if the IF condition is false.
 972        Condition characters (which follow a  question  mark)  may
 973        be:
 974
 975        ?a     True  if  any  characters have been included in the
 976               prompt so far.
 977
 978        ?b_\bX    True if the byte offset of the  specified  line  is
 979               known.
 980
 981        ?B     True if the size of current input file is known.
 982
 983        ?e     True if at end-of-file.
 984
 985
 986
 987
 988                                                                15
 989
 990
 991
 992
 993
 994 LESS(1)                                                   LESS(1)
 995
 996
 997        ?f     True  if  there  is  an input filename (that is, if
 998               input is not a pipe).
 999
1000        ?l_\bX    True if the line number of the  specified  line  is
1001               known.
1002
1003        ?L     True  if  the  line  number of the last line in the
1004               file is known.
1005
1006        ?m     True if there is more than one input file.
1007
1008        ?n     True if this is the first prompt  in  a  new  input
1009               file.
1010
1011        ?p_\bX    True  if the percent into the current input file of
1012               the specified line is known.
1013
1014        ?s     Same as "?B".
1015
1016        ?x     True if there is a next input file (that is, if the
1017               current input file is not the last one).
1018
1019        Any characters other than the special ones (question mark,
1020        colon, period, percent, and  backslash)  become  literally
1021        part  of the prompt.  Any of the special characters may be
1022        included in the prompt literally by preceding  it  with  a
1023        backslash.
1024
1025        Some examples:
1026
1027        ?f%f:Standard input.
1028
1029        This  prompt  prints the filename, if known; otherwise the
1030        string "Standard input".
1031
1032        ?f%f .?ltLine %lt:?pt%pt\%:?btByte %bt:-...
1033
1034        This prompt would print the filename, if known.  The file-
1035        name  is  followed by the line number, if known, otherwise
1036        the percent if known, otherwise the byte offset if  known.
1037        Otherwise,  a  dash  is printed.  Notice how each question
1038        mark has a matching period, and how the % after the %pt is
1039        included literally by escaping it with a backslash.
1040
1041        ?n?f%f .?m(file %i of %m) ..?e(END) ?x- Next\: %x..%t
1042
1043        This  prints the filename if this is the first prompt in a
1044        file, followed by the "file N of N" message  if  there  is
1045        more than one input file.  Then, if we are at end-of-file,
1046        the string "(END)" is printed followed by the name of  the
1047        next  file, if there is one.  Finally, any trailing spaces
1048        are truncated.  This is the default  prompt.   For  refer-
1049        ence,  here are the defaults for the other two prompts (-m
1050        and -M respectively).  Each is broken into two lines  here
1051
1052
1053
1054                                                                16
1055
1056
1057
1058
1059
1060 LESS(1)                                                   LESS(1)
1061
1062
1063        for readability only.
1064
1065        ?n?f%f .?m(file %i of %m) ..?e(END) ?x- Next\: %x.:
1066             ?pB%pB\%:byte %bB?s/%s...%t
1067
1068        ?f%f .?n?m(file %i of %m) ..?ltline %lt?L/%L. :byte %bB?s/%s. .
1069             ?e(END) ?x- Next\: %x.:?pB%pB\%..%t
1070
1071        And here is the default message produced by the = command:
1072
1073        ?f%f .?m(file %i of %m) .?ltline %lt?L/%L. .
1074             byte %bB?s/%s. ?e(END) :?pB%pB\%..%t
1075
1076        The prompt expansion features are also  used  for  another
1077        purpose:  if  an environment variable LESSEDIT is defined,
1078        it is used as the command to be executed when the  v  com-
1079        mand  is  invoked.  The LESSEDIT string is expanded in the
1080        same way as the prompt strings.   The  default  value  for
1081        LESSEDIT is:
1082
1083             %E ?lm+%lm. %f
1084
1085        Note that this expands to the editor name, followed by a +
1086        and the line number, followed by the file name.   If  your
1087        editor  does  not  accept the "+linenumber" syntax, or has
1088        other differences in invocation syntax, the LESSEDIT vari-
1089        able can be changed to modify this default.
1090
1091
1092 E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT V\bVA\bAR\bRI\bIA\bAB\bBL\bLE\bES\bS
1093        COLUMNS
1094               Sets  the  number  of columns on the screen.  Takes
1095               precedence over the number of columns specified  by
1096               the TERM variable.
1097
1098        EDITOR The name of the editor (used for the v command).
1099
1100        HOME   Name  of  the user's home directory (used to find a
1101               .less file).
1102
1103        LESS   Flags which are passed to _\bl_\be_\bs_\bs automatically.
1104
1105        LESSBINFMT
1106               Format for  displaying  non-printable,  non-control
1107               characters.
1108
1109        LESSCHARDEF
1110               Defines a character set.
1111
1112        LESSCHARSET
1113               Selects a predefined character set.
1114
1115        LESSEDIT
1116               Editor  prototype  string (used for the v command).
1117
1118
1119
1120                                                                17
1121
1122
1123
1124
1125
1126 LESS(1)                                                   LESS(1)
1127
1128
1129               See discussion under PROMPTS.
1130
1131        LESSHELP
1132               Name of the help file.
1133
1134        LINES  Sets the number of  lines  on  the  screen.   Takes
1135               precedence  over  the  number of lines specified by
1136               the TERM variable.
1137
1138        SHELL  The shell used to execute the ! command, as well as
1139               to expand filenames.
1140
1141        TERM   The type of terminal on which _\bl_\be_\bs_\bs is being run.
1142
1143
1144 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
1145        lesskey(1)
1146
1147
1148 W\bWA\bAR\bRN\bNI\bIN\bNG\bGS\bS
1149        The  =  command  and prompts (unless changed by -P) report
1150        the line number of the line at the top of the screen,  but
1151        the  byte  and  percent  of  the line at the bottom of the
1152        screen.
1153
1154        If the :e command is used to name more than one file,  and
1155        one of the named files has been viewed previously, the new
1156        files may be entered into the list in an unexpected order.
1157
1158        The  handling of national character sets is nonstandard as
1159        well as insufficient for multibyte  characters.   It  will
1160        probably change in a later release.
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186                                                                18
1187
1188