mirrors/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty synced 2026-07-23 16:58:09 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add a reference to piping to the index page

Browse Source
This commit is contained in:
Kovid Goyal
2018-09-10 08:19:14 +05:30
parent 9782f16635
commit be3ab90cff
2 changed files with 15 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/index.rst
View File

@@ -358,6 +358,14 @@ scrollback buffer in your favorite pager program (which is ``less`` by default).
Colors and text formatting are preserved. You can explore the scrollback buffer Colors and text formatting are preserved. You can explore the scrollback buffer
comfortably within the pager. comfortably within the pager.
Additionally, you can pipe the contents of the scrollback buffer to an
arbitrary, command running in a new window, tab or overlay, for example::
map f1 pipe @ansi window less +G -R
Would open the scrollback buffer in a new window when you press the :kbd:`F1`
key. See :sc:`show_scrollback` for details.
Frequently Asked Questions Frequently Asked Questions
--------------------------------- ---------------------------------

13
kitty/config_data.py
View File

@@ -830,19 +830,20 @@ You can pipe the contents of the current screen + history buffer as
:file:`STDIN` to an arbitrary program using the ``pipe`` function. For example, :file:`STDIN` to an arbitrary program using the ``pipe`` function. For example,
the following opens the scrollback buffer in less in an overlay window:: the following opens the scrollback buffer in less in an overlay window::
map f1 pipe @ansi overlay less +g -R map f1 pipe @ansi overlay less +G -R
Placeholders available are: @text (which is plain text) and @ansi (which Placeholders available are: @text (which is plain text) and @ansi (which
includes text styling escape codes). For only the current screen, use @screen includes text styling escape codes). For only the current screen, use @screen
or @ansi_screen. For the secondary screen, use @alternate and @ansi_alternate. or @ansi_screen. For the secondary screen, use @alternate and @ansi_alternate.
Note that the secondary screen is not currently displayed. For example if you The secondary screen is the screen not currently displayed. For
run a fullscreen terminal application, the secondary screen will be the screen example if you run a fullscreen terminal application, the secondary screen will
you return to when quitting the application. You can also use ``none`` for no be the screen you return to when quitting the application. You can also use
:file:`STDIN` input. ``none`` for no :file:`STDIN` input.
To open in a new window, tab or new OS window, use ``window``, ``tab``, or To open in a new window, tab or new OS window, use ``window``, ``tab``, or
``os_window`` respectively. You can also use ``none`` in which case the data ``os_window`` respectively. You can also use ``none`` in which case the data
will be piped into the program without creating any windows. ''')) will be piped into the program without creating any windows, useful if the
program is a GUI program that creates its own windows. '''))
# }}} # }}}