# /limit

Usage:

/LIMIT [-v] [-a] [-mstyle] [pattern]
/RELIMIT
/UNLIMIT

/Limit redraws the window, showing only lines that match pattern. It is then possible to scroll forward and backward within the "limited" window. The limit affects only the current screen, and stays in effect until /unlimit is called.

/Limit options:

-v
  show only lines that don't match pattern
-a
  show only lines that have attributes
-mstyle
  use matching style (simple, glob, or regexp), instead of the default %{matching}.

If pattern is given, only lines in the given range that match pattern will be recalled. The matching style is determined by the -m option if given, %{matching} otherwise. By default, the @more status field does not count lines that are omitted by /limit.

With no options or arguments, /limit returns 1 if a limit is in effect, 0 if not.

/unlimit disables the /limit so all lines are displayed.

During /limit, scrolling to any point, including the bottom, results in a More prompt that shows the number of lines (possibly 0) below the status line. In this state, /unlimit will leave the bottom visible line where it is, and redraw the unlimited lines above it. Thus, you can use /limit to find a line you are interested in, use the scrolling keys to position that line at the bottom of the window, then /unlimit to see the context of that line. But if you attempt to scroll past the bottom during /limit, the More prompt changes to "LIMIT ON"; in this state, /unlimit will redraw with the previously invisible last line at the bottom of the screen.

/relimit repeats the last /limit.

The default keybinding ^[L toggles the last limit off and on.

See: /recall

Back to index
Back to tf home page

Copyright © 2003, 2004, 2005 Ken Keys