mirror of
https://github.com/fish-shell/fish-shell.git
synced 2026-04-23 10:51:14 -03:00
7a59540517
No need to define "cmd-foo" anchors; use :doc:`foo <cmds/foo>`
instead. If we want "cmd-foo" but it should be tested.
See also 38b24c2325 (docs: Use :doc: role when linking to commands,
2022-09-23).
85 lines
1.3 KiB
ReStructuredText
85 lines
1.3 KiB
ReStructuredText
echo - display a line of text
|
|
=============================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. synopsis::
|
|
|
|
echo [OPTIONS] [STRING]
|
|
|
|
Description
|
|
-----------
|
|
|
|
.. only:: builder_man
|
|
|
|
NOTE: This page documents the fish builtin ``echo``.
|
|
To see the documentation on any non-fish versions, use ``command man echo``.
|
|
|
|
``echo`` displays *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.
|
|
|
|
Unlike other shells, this echo accepts ``--`` to signal the end of the options.
|
|
|
|
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)
|
|
|
|
Example
|
|
-------
|
|
|
|
::
|
|
|
|
> echo 'Hello World'
|
|
Hello World
|
|
|
|
> echo -e 'Top\nBottom'
|
|
Top
|
|
Bottom
|
|
|
|
> echo -- -n
|
|
-n
|
|
|
|
See Also
|
|
--------
|
|
|
|
- the :doc:`printf <printf>` command, for more control over output formatting
|