h/fish-shell
1
Fork 0
mirror of https://github.com/fish-shell/fish-shell.git synced 2026-05-14 22:11:16 -03:00
Code Issues Packages Projects Releases Wiki Activity

builtin_read: Remove --all-lines

Browse Source 
This was unused and needed to be warned about in the docs. Remove it
so nobody stumbles over it.

Fixes #5332.
This commit is contained in:
Fabian Homborg
2018-11-20 16:56:15 +01:00
parent fc9d8eec72
commit c729a97c43
2 changed files with 2 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
doc_src/read.txt
View File

@@ -45,8 +45,6 @@ The following options are available:
- `-L` or `--line` reads each line into successive variables, and stops after each variable has been filled. This cannot be combined with the `--delimiter` option.
- `-A` or `--all-lines` splits input into the given variables, separated by line breaks. The entire input stream is consumed and interactive mode is disabled. Probably only useful with `-a` to read all lines into a single array variable. Where possible, ` | while read --line` should be preferred over ` | read --all-lines` as the latter will block until the input stream has been consumed, leading to latency and decreased responsiveness.
Without the `--line` option, `read` reads a single line of input from standard input, breaks it into tokens, and then assigns one token to each variable specified in `VARIABLES`. If there are more tokens than variables, the complete remainder is assigned to the last variable.
If the `--delimiter` argument is not given, the variable `IFS` is used as a list of characters to split on. Relying on the use of `IFS` is deprecated and this behaviour will be removed in future versions. The default value of `IFS` contains space, tab and newline characters. As a special case, if `IFS` is set to the empty string, each character of the input is considered a separate token.