[Emacs-diffs] master 1ba357e: Add notice to visual commands section

[Tassilo Horn]

branch: master
commit 1ba357e30518fdcc0b870870152f5434cb2540ba
Author: Tassilo Horn <address@hidden>
Commit: Tassilo Horn <address@hidden>

    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 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi
index 6d57a78..4ed894e 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