mirror of
https://github.com/fish-shell/fish-shell.git
synced 2026-05-01 01:51:14 -03:00
Convert \\subsection sections into rst format
This commit is contained in:
@@ -7,7 +7,8 @@ Synopsis
|
||||
read [OPTIONS] [VARIABLE ...]
|
||||
|
||||
|
||||
\subsection read-description Description
|
||||
Description
|
||||
------------
|
||||
|
||||
`read` reads from standard input and either writes the result back to standard output (for use in command substitution), or stores the result in one or more shell variables. By default, `read` reads a single line and splits it into variables on spaces or tabs. Alternatively, a null character or a maximum number of characters can be used to terminate the input, and other delimiters can be given. Unlike other shells, there is no default variable (such as `REPLY`) for storing the result - instead, it is printed on standard output.
|
||||
|
||||
@@ -71,11 +72,13 @@ maximum of 10 MiB (1048576 bytes); if the terminator is not reached before this
|
||||
is set to empty and the exit status is set to 122. This limit can be altered with the
|
||||
`fish_read_limit` variable. If set to 0 (zero), the limit is removed.
|
||||
|
||||
\subsection read-history Using another read history file
|
||||
Using another read history file
|
||||
------------
|
||||
|
||||
The `read` command supported the `-m` and `--mode-name` flags in fish versions prior to 2.7.0 to specify an alternative read history file. Those flags are now deprecated and ignored. Instead, set the `fish_history` variable to specify a history session ID. That will affect both the `read` history file and the fish command history file. You can set it to an empty string to specify that no history should be read or written. This is useful for presentations where you do not want possibly private or sensitive history to be exposed to the audience but do want history relevant to the presentation to be available.
|
||||
|
||||
\subsection read-example Example
|
||||
Example
|
||||
------------
|
||||
|
||||
The following code stores the value 'hello' in the shell variable `$foo`.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user