From d98dd19c2f0f4a84675d07eff34c641949a40019 Mon Sep 17 00:00:00 2001 From: mitchell <70453897+667e-11@users.noreply.github.com> Date: Wed, 29 Dec 2010 17:21:04 -0500 Subject: The filter-through module handles selected text as stdin better. --- doc/manual/10_Advanced.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) (limited to 'doc/manual/10_Advanced.md') diff --git a/doc/manual/10_Advanced.md b/doc/manual/10_Advanced.md index 3295110a..74b56ddc 100644 --- a/doc/manual/10_Advanced.md +++ b/doc/manual/10_Advanced.md @@ -42,10 +42,16 @@ buffer (or a selection). You could do the following from the command entry: A simpler way would be to press `Alt+R` (`Ctrl+Apple+R` on Mac OSX), enter the shell command `sort`, and hit `Enter`. -For shell commands, if text is selected, all text on the lines containing the -selection is used as the standard input (stdin) to the command. Otherwise the -entire buffer is used. Either the selected text or buffer is replaced with the -standard output (stdout) of the command. +The standard input (stdin) for shell commands is determined as follows: + +* If text is selected and spans multiple lines, all text on the lines containing + the selection is used. However, if the end of the selection is at the + beginning of a line, only the EOL (end of line) characters from the previous + line are included as input. The rest of the line is excluded. +* If text is selected and spans a single line, only the selected text is used. +* If no text is selected, the entire buffer is used. + +The input text is replaced with the standard output (stdout) of the command. ## File Encoding -- cgit v1.2.3