From 9b45904539fe5c93cffb2ebb7e187582fa64c7e1 Mon Sep 17 00:00:00 2001 From: Fabian Boehm Date: Fri, 16 Dec 2022 20:41:36 +0100 Subject: [PATCH] docs/bind: Explain `commandline -f` Fixes #9399 --- CHANGELOG.rst | 2 +- doc_src/cmds/bind.rst | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 71b47f631..8b2e76ed0 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -1,4 +1,4 @@ -.. ignore: 2271 7717 8514 9028 9067 9089 9091 9099 9109 9111 9121 9134 9140 9141 9152 9154 9186 9206 9211 9214 9226 9241 9252 9265 9301 9303 9311 9341 9342 9382 9394 +.. ignore: 2271 7717 8514 9028 9067 9089 9091 9099 9109 9111 9121 9134 9140 9141 9152 9154 9186 9206 9211 9214 9226 9241 9252 9265 9301 9303 9311 9341 9342 9382 9394 9399 fish 3.6.0 (released ???) =================================== diff --git a/doc_src/cmds/bind.rst b/doc_src/cmds/bind.rst index 077874d18..3a481f40c 100644 --- a/doc_src/cmds/bind.rst +++ b/doc_src/cmds/bind.rst @@ -33,9 +33,9 @@ To find out what sequence a key combination sends, you can use :doc:`fish_key_re When ``COMMAND`` is a shellscript command, it is a good practice to put the actual code into a :ref:`function ` and simply bind to the function name. This way it becomes significantly easier to test the function while editing, and the result is usually more readable as well. -If a script produces output, it should finish by calling ``commandline -f repaint`` to tell fish that a repaint is in order. -Note that special input functions cannot be combined with ordinary shell script commands. The commands must be entirely a sequence of special input functions (from ``bind -f``) or all shell script commands (i.e., valid fish script). +.. note:: + Special input functions cannot be combined with ordinary shell script commands. The commands must be entirely a sequence of special input functions (from ``bind -f``) or all shell script commands (i.e., valid fish script). To run special input functions from regular fish script, use ``commandline -f`` (see also :doc:`commandline `). If a script produces output, it should finish by calling ``commandline -f repaint`` to tell fish that a repaint is in order. If no ``SEQUENCE`` is provided, all bindings (or just the bindings in the given ``MODE``) are printed. If ``SEQUENCE`` is provided but no ``COMMAND``, just the binding matching that sequence is printed.