aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/echo.txt
blob: 4ce96cb41154e52ef4383ecac38fa17bb3b9c37c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
\section echo echo - display a line of text

\subsection echo-synopsis Synopsis
\fish{synopsis}
echo [STRING]
\endfish

\subsection echo-description Description

`echo` displays a string of text.

The following options are available:

- `-n`, Do not output a newline
- `-s`, Do not separate arguments with spaces
- `-E`, Disable interpretation of backslash escapes (default)
- `-e`, Enable interpretation of backslash escapes
- `-h`, `--help` Display this help

\subsection echo-escapes Escape Sequences

If `-e` is used, the following sequences are recognized:

- `\` backslash
- `\a` alert (BEL)
- `\b` backspace
- `\c` produce no further output
- `\e` escape
- `\f` form feed
- `\n` new line
- `\r` carriage return
- `\t` horizontal tab
- `\v` vertical tab
- `\0NNN` byte with octal value NNN (1 to 3 digits)
- `\xHH` byte with hexadecimal value HH (1 to 2 digits)

\subsection echo-example Example

`echo 'Hello World'` Print hello world to stdout

`echo -e 'Top\nBottom'` Print Top and Bottom on separate lines, using an escape sequence