Commit 1ba357e3 authored by Tassilo Horn's avatar Tassilo Horn

Add notice to visual commands section

* doc/misc/eshell.texi (Input/Output): Add notice that some tools
such as git call less with its -F option which omits pagination if
the contents is less than one page long.  This interferes with
eshell's visual (sub-)commands.
parent ba6c32b6
......@@ -654,6 +654,16 @@ not @samp{git status} -- use @code{eshell-visual-subcommands}; and for
commands that are visual only when passed certain options, use
@code{eshell-visual-options}.
Caution: Some tools such as Git use the pager @samp{less} by default
to paginate their output but call it with its @samp{-F} option. This
option causes @samp{less} to echo the output instead of paginating it
if the output is less than one page long. This causes undesirable
behavior if, e.g., @samp{git diff}, is defined as a visual subcommand.
It'll work if the output is big enough and fail if it is less than one
page long. If that occurs to you, search for configuration options
for calling @samp{less} without the @samp{-F} option. For Git, you
can do that using @samp{git config --global core.pager 'less -+F'}.
@section Redirection
Redirection is mostly the same in Eshell as it is in other command
shells. The output redirection operators @code{>} and @code{>>} as
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment