1
0
Fork 0
mirror of git://git.code.sf.net/p/zsh/code synced 2025-10-04 20:40:57 +02:00
zsh/Doc/Zsh
Daniel Shahaf a0c0aa41d2 45111: zshmisc(1): Clarify the documentation of 'return' and 'exit' in conjunction with try/always
Having reviewed 20076, 20084, 21734, and 21735, my understanding is that
the original intention was:

- A 'return' in a function does run always-list
- An 'exit' outside a function does not run always-list
- A 'return' outside a function is treated as an 'exit'

All of which are the case today.  The remaining case, of 'exit' used
inside a function, was not specified by the referenced -workers@ posts;
does, as implemented, run the always-list; and furthermore, based in
21734 it's fair to assume that the original documentation was assuming
that 'exit' would be used outside of any function, just like it assumed
'return' would be used inside a function.

Therefore, have the documentation specify only the behaviour of 'exit'
outside any function, and leave the behaviour of 'exit' inside
a function unspecified.  Anyone who relied on the documentation of 'exit'
as documented until this commit would have run into the
documentation/implementation discrepancy described in 45075.
2019-12-22 03:21:09 +00:00
..
.cvsignore unposted: cvsignore VIM *.swp files 2003-05-05 06:14:49 +00:00
.distfiles 33047: use git to simplify massively source distribution file selection 2014-08-23 21:01:58 +01:00
.vimrc 35775: New zsh-specific yodl vim syntax highlighting. 2015-07-13 23:22:19 +00:00
arith.yo 36693: arithmetic rounds towards zero, document 2015-09-30 14:22:59 +01:00
builtins.yo 45009: POSIX_CD needs to suppress some forms of option. 2019-12-12 10:47:00 +00:00
calsys.yo 35075: improve manual format 2015-05-12 00:36:18 +09:00
compat.yo 32666: shell emulation doc addition 2014-06-13 21:32:58 +01:00
compctl.yo 35075: improve manual format 2015-05-12 00:36:18 +09:00
compsys.yo 45055: Clarify _files documentation 2019-12-20 15:31:34 -06:00
compwid.yo 44275: Fix compset -p/-s multibyte inconsistency and documentation 2019-05-08 16:35:08 -05:00
cond.yo 44981: Fix some typos in the documentation. 2019-12-04 21:31:17 +00:00
contrib.yo 45113: vcs_info docs: Clarify documentation of the %p/%u/%a patch-format expandos. 2019-12-22 03:21:04 +00:00
exec.yo 39566: Improve usefulness of command_not_found_handler. 2016-10-05 12:14:43 +01:00
expn.yo 44981: Fix some typos in the documentation. 2019-12-04 21:31:17 +00:00
filelist.yo 25958: make it possible to get docs for startup files correct 2008-10-30 12:09:18 +00:00
files.yo 25958: make it possible to get docs for startup files correct 2008-10-30 12:09:18 +00:00
func.yo unposted: a few cosmetic format fixes in docs 2015-11-13 01:03:38 +09:00
grammar.yo 45111: zshmisc(1): Clarify the documentation of 'return' and 'exit' in conjunction with try/always 2019-12-22 03:21:09 +00:00
index.yo 22360, 22365: support version 2 of Yodl 2006-03-20 11:06:22 +00:00
intro.yo 44364: refer to zsh base manual page in zsh all 2019-05-28 09:35:12 +01:00
invoke.yo unposted: YODL compatibility fix for --emulate 2017-09-13 10:45:00 +01:00
jobs.yo Delay processing "disown" for superjob. 2017-07-04 09:40:45 +01:00
manual.yo 36630: new function zsh_directory_name_generic 2015-09-25 21:30:34 +01:00
metafaq.yo Update distro docs to remove dead links 2018-07-17 09:30:47 +01:00
mod_attr.yo 28253: document -h argument to atribute commands 2010-09-12 18:56:40 +00:00
mod_cap.yo unposted: force latest version of files from vendor to main branch 2007-07-03 17:06:04 +00:00
mod_clone.yo 35075: improve manual format 2015-05-12 00:36:18 +09:00
mod_compctl.yo
mod_complete.yo unposted: force latest version of files from vendor to main branch 2007-07-03 17:06:04 +00:00
mod_complist.yo unposted: clarify ZLS_COLORS pattern matching contexts 2017-05-28 11:32:10 -07:00
mod_computil.yo 33206: fix compdescribe doc 2014-09-19 19:45:55 -07:00
mod_curses.yo 40726: add "zcurses resize" for sane terminal size change 2017-03-05 11:25:38 -08:00
mod_datetime.yo 43800: Add nanosecond support to strftime built-in 2018-11-13 13:01:01 -06:00
mod_db_gdbm.yo 40558, 40562: General improvements to zsh/db/gdbm module 2017-02-17 09:22:02 +00:00
mod_deltochar.yo
mod_example.yo unposted: force latest version of files from vendor to main branch 2007-07-03 17:06:04 +00:00
mod_files.yo 44153: rm: Accept -R as equivalent to -r 2019-03-21 22:04:55 -05:00
mod_langinfo.yo 16673: add langinfo module as an interface to locale information. 2002-02-19 02:14:08 +00:00
mod_mapfile.yo 44981: Fix some typos in the documentation. 2019-12-04 21:31:17 +00:00
mod_mathfunc.yo 43275: Add log2 to match func 2018-08-13 09:36:55 +01:00
mod_nearcolor.yo 43760: add documentation for true colour changes and nearcolor module 2018-11-05 22:24:16 +01:00
mod_newuser.yo 26185: fix two places where path to global zshenv was specified statically. 2008-12-29 04:33:52 +00:00
mod_parameter.yo 44981: Fix some typos in the documentation. 2019-12-04 21:31:17 +00:00
mod_pcre.yo unposted: a few cosmetic format fixes in docs 2015-11-13 01:03:38 +09:00
mod_private.yo Jun T. proofreading 2015-11-09 10:07:17 -08:00
mod_regex.yo 32493: some man page formatting fixes 2014-03-17 15:11:30 +00:00
mod_sched.yo unposted: reference use of widgets to effect editor changes from a sched command 2016-09-12 09:52:23 -07:00
mod_socket.yo 44480: Don't automatically close externally visible file descroptors. 2019-07-02 13:42:53 +01:00
mod_stat.yo 43075: Support nanosecond-precision time formatting 2018-06-20 17:29:56 -05:00
mod_system.yo 44480: Don't automatically close externally visible file descroptors. 2019-07-02 13:42:53 +01:00
mod_tcp.yo 18559, 18562: make modules use proper option arguments 2003-05-22 09:48:25 +00:00
mod_termcap.yo 14xxx: document $termcap and tweak mod_termcap/mod_terminfo docs 2001-04-23 23:24:18 +00:00
mod_terminfo.yo users/5986, 18380: arg support for echoti builtin. 2003-03-25 05:33:18 +00:00
mod_zftp.yo 35075: improve manual format 2015-05-12 00:36:18 +09:00
mod_zle.yo move ZLE builtin documentation from mod_zle.yo to zle.yo. 2001-03-28 14:39:57 +00:00
mod_zleparameter.yo users/21752: Extend zsh/zleparameter's $widgets' parameter's documentation. 2016-07-17 14:58:05 +00:00
mod_zprof.yo Mikael Magnusson: 28181: Remove a stray `)' that caused a ".RE" string to be output 2010-08-21 09:35:49 +00:00
mod_zpty.yo 43788: clarify zpty -w -n with no string argument 2018-11-07 12:36:05 +00:00
mod_zselect.yo 35075: improve manual format 2015-05-12 00:36:18 +09:00
mod_zutil.yo 45112: zshmodules: Explicitly document the return values of the 'zstyle' getters -s, -b, and -a. 2019-12-22 03:21:07 +00:00
modules.yo unposted: cross-reference zmodload from the modules intro doc. 2011-09-25 18:09:13 +00:00
options.yo 45009: POSIX_CD needs to suppress some forms of option. 2019-12-12 10:47:00 +00:00
params.yo 44981: Fix some typos in the documentation. 2019-12-04 21:31:17 +00:00
prompt.yo 43075: Support nanosecond-precision time formatting 2018-06-20 17:29:56 -05:00
redirect.yo 44964: zshmisc(1): Document APPEND_CREATE under the append redirection operators, >> and >>!. 2019-12-03 02:54:48 +00:00
restricted.yo 44387, edited: describe some problems with restricted mode 2019-06-06 21:09:42 +01:00
roadmap.yo 40641: docs: patterns: Add '|' to the overview. Clarify that it short-circuits. 2017-02-28 07:39:15 +00:00
seealso.yo 41461: complete list of zsh manual pages in manual introcution 2017-07-26 09:39:08 +01:00
tcpsys.yo 35075: improve manual format 2015-05-12 00:36:18 +09:00
zftpsys.yo 35311: typo in zfuput behaviour 2015-05-30 20:08:36 +01:00
zle.yo 45035: be explicit about the need for a # in colours specified as hex triplets 2019-12-16 11:21:10 +01:00