procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add notice to visual commands section

Browse source 
* 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.
This commit is contained in:
Tassilo Horn 2015-04-08 09:57:58 +02:00
parent ba6c32b6de
commit 1ba357e305
1 changed files with 10 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
doc/misc/eshell.texi
View file

@ -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