fish-shell/doc_src/cmds/echo.rst
Aurelio Jargas 0304135d2b
docs: Use \ instead of \\ in examples (#7286)
Instead of informing the bell character (hex 07), the example was using
an escaped \ followed by x07.

    $ echo \\x07
    \x07
    $ echo \x07

    $ echo \x07 | od -a
    0000000 bel  nl
    0000002
    $

* docs: Use \u instead of \\u

Instead of informing the Unicode character 慡, this example was using an
escaped \ followed by u6161.

    $ echo \\u6161
    \u6161
    $ echo \u6161
    慡

Before:

    $ string escape --style=var 'a1 b2'\\u6161 | string unescape --style=var
    a1 b2\u6161

Now:

    $ string escape --style=var 'a1 b2'\u6161 | string unescape --style=var
    a1 b2慡
2020-08-26 18:29:03 +02:00

78 lines
1.2 KiB
ReStructuredText

.. _cmd-echo:
echo - display a line of text
=============================
Synopsis
--------
::
echo [OPTIONS] [STRING]
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
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 :ref:`printf <cmd-printf>` command, for more control over output formatting