From 557d1d7259229ee7dd762750f3bfbcd7412c8564 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Mon, 26 Feb 2018 19:58:01 +0000 Subject: 42399: document echo and behaviour of - and -- --- ChangeLog | 5 +++++ Doc/Zsh/builtins.yo | 9 +++++++++ 2 files changed, 14 insertions(+) diff --git a/ChangeLog b/ChangeLog index 4fe0bf5d6..e543f861f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2018-02-26 Peter Stephenson + + * 42399: Doc/Zsh/builtins.yo: better description of interaction + between echo and dashes. + 2018-02-22 Daniel Hahler * 42364: Completion/Unix/Command/_git: _git: fix __git_ignore_line to diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo index 6c7ec4b28..f460e48a5 100644 --- a/Doc/Zsh/builtins.yo +++ b/Doc/Zsh/builtins.yo @@ -504,6 +504,15 @@ pindex(BSD_ECHO, use of) The tt(-E) flag, or the tt(BSD_ECHO) option, can be used to disable these escape sequences. In the latter case, tt(-e) flag can be used to enable them. + +Note that for standards compliance a double dash does not terminate +option processing; instead, it is printed directly. However, a +single dash does terminate option processing, so the first dash, +possibly following options, is not printed, but everything following it +is printed as an argument. The single dash behaviour is different +from other shells. For a more portable way of printing text, see +tt(printf), and for a more controllable way of printing text within zsh, +see tt(print). ) module(echotc)(zsh/termcap) module(echoti)(zsh/terminfo) -- cgit 1.4.1