From 1ba357e30518fdcc0b870870152f5434cb2540ba Mon Sep 17 00:00:00 2001 From: Tassilo Horn Date: Wed, 8 Apr 2015 09:57:58 +0200 Subject: [PATCH] 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. --- doc/misc/eshell.texi | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index 6d57a78d170..4ed894e5a4c 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi @@ -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 -- 2.39.2