Commit Graph

55 Commits

Author SHA1 Message Date
Bart Schaefer 21fe2dce44 52753: Clarify "nocorrect" when introducing precommand modifiers. 2024-03-13 21:10:23 -07:00
Bart Schaefer 29503debc7 51558: Clarify "for" with positional parameters and named reference. 2023-03-11 13:22:10 -08:00
Bart Schaefer acb15e3cc9 51403: Tests and documentation for 51402, clean up some other tests. 2023-02-12 11:57:31 -08:00
Axel Beckert b76dcecfe3 50840: Doc/Zsh/grammar.yo: Correct NO_MATCH to NOMATCH 2022-10-25 12:49:48 +02:00
Peter Stephenson 0a80579ed1 49307 with doc update: POSIX_TRAPS fix.
With POSIX_TRAPS set, an ignored signal stays ignored when entering
a subshell.
2021-08-26 09:46:39 +01:00
Daniel Shahaf 9575f2f1bf users/24959/0002: Update aliases documentation for the addition of the ALIAS_FUNC_DEF option. 2020-06-27 00:53:02 +00:00
Daniel Shahaf 7f58463dd3 users/24959/0001: Extend documentation of global aliases. 2020-06-27 00:53:02 +00:00
Mikael Magnusson 8923d2a618 Add SHORT_REPEAT option 2020-04-02 07:42:16 +02:00
Daniel Shahaf 386d9ac8ff 45583/0008: Add the 'function -T' syntax.
Config/version.mk was bumped in the previous commit.
2020-03-22 02:23:53 +00:00
Daniel Shahaf f7f2baac5e 45110: zshmisc(1): Fix markup of "try-list" and "always-list". 2019-12-22 03:21:11 +00:00
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
Joey Pabalinas 552ebe6082 43904 (plus tweak): zshmisc(1): document term being optional if `in word' is omitted
In code such as:

> hobbes% () { for arg do print -r $arg; done; } 1 2 3
> 1
> 2
> 3

the implicit positional parameters added when the `in word ...'
list is omitted also implicitly append the separator term, making
the above code valid, albeit seemingly violating the syntax listed
in the documentation.

This is related to the various forms of alternative syntax and is
the intended behavior of the parsing code, so correct the minor
contradiction in the for loop documentation.
2018-12-17 12:02:43 +00:00
Daniel Shahaf ba752d2eb5 42261: docs: Expand documentation of $histchars[1]. Joint with Matthew Martin. 2018-01-13 17:52:59 +00:00
Daniel Shahaf 660df206c1 41939: docs: Move aliases corner case to the dangerous bends section. (after 41482) 2017-10-30 13:30:08 +00:00
Peter Stephenson ff3e47e9f4 41842: aliasing documentation update 2017-10-10 09:59:31 +01:00
Daniel Shahaf a5482971b7 40744: Document the SHORT_LOOPS 'function' syntax.
It's already mentioned in passing in zshoptions(1).
2017-03-08 10:04:34 +00:00
Jun-ichi Takimoto d5ba08af49 unposted: a few cosmetic format fixes in docs 2015-11-13 01:03:38 +09:00
Peter Stephenson 39b28980f3 various posts: Implement assignment parsing for typeset.
Typeset assignments now work like raw assignments except
for no "+=" and no GLOB_ASSIGN.

Documented in typeset builtin doc and mentioned in release notes.

Tests to ensure basic sanity.

Enabled by default, can be turned off by "disable -r" with typeset
family of commands.
2015-06-24 10:21:12 +01:00
Peter Stephenson a95f2c6071 35250: Fix case documentation (SH_GLOB) 2015-05-21 10:43:32 +01:00
Jun-ichi Takimoto 36a55e278e 35034: improve manual format up to Chapter18 2015-05-06 10:45:21 +09:00
Barton E. Schaefer 32b4cb0e73 34734: further aliasing adjustments and doc
restrict token aliasing (34641) to global aliases; tighten up POSIX_ALIASES to better match spec; update Aliasing doc to cover this and clarify older behavior

2015-03-18  Peter Stephenson  <p.stephenson@samsung.com>

	* 34723: configure.ac: turn off fixed site function directory if
2015-03-18 18:01:54 -07:00
Barton E. Schaefer 7e994fe145 34712: clarify words that may be aliased 2015-03-15 23:33:19 -07:00
Peter Stephenson dded99b085 33679: Note on patter s in case statements
They work exactly like groups in other patterns, despite contrary
indications.
2014-11-19 15:48:58 +00:00
Barton E. Schaefer c080bd52bc 33319: fix parens in example from 33312 2014-10-01 21:31:20 -07:00
Peter Stephenson 5e516898d7 33312: document redirections applied to function definitions 2014-10-01 20:36:55 +01:00
Peter Stephenson f6b322979b Attempt to improve doc for assignment 2014-07-08 09:38:48 +01:00
Peter Stephenson 6336347c9e fix my own merge conflict with grammar changes 2014-06-09 09:50:37 +01:00
Jun T 2ba4aa275e 32755: move incorrectly placed line in grammar.yo 2014-06-09 09:45:47 +01:00
Jun T d7ca50c872 32715: doc formatting fixes 2014-06-06 22:02:04 +01:00
Eric Cook e1ff0a8bab 32603: fix documentation of status after try / always 2014-05-09 09:53:44 +01:00
Peter Stephenson 27a41679b6 30803: Vin Shelton: missing menu entry in grammar.yo 2012-11-18 18:45:39 +00:00
Peter Stephenson 7c56d77184 30789: Add CONTINUE_ON_ERROR for old behaviour.
New behaviour is for scripts to exit on error instead of returning
to top level and executing the next command.
2012-11-15 21:08:15 +00:00
Frank Terbeck 756f17a755 A.Costa: unposted: grammar.yo, ChangeLog-3.1: Fix typo to "definition" 2012-02-01 12:53:48 +00:00
Peter Stephenson e3182c18de 29955++: IGNORE_CLOSE_BRACES option 2011-12-08 19:42:07 +00:00
Peter Stephenson 851b8e1510 28377: document more alias problems 2010-11-17 16:35:27 +00:00
Peter Stephenson eff9d597f3 unposted: typo plus rephrase of alias quoting bit 2010-10-27 12:29:13 +00:00
Peter Stephenson e27a65dd6c 28375: clarify how to quote aliases from expansion 2010-10-27 11:28:29 +00:00
Peter Stephenson 8ac97f3308 27648, 267650/1, unposted README change:
Turn off repeat and turn on ulimit in emulation modes
2010-02-03 18:34:32 +00:00
Peter Stephenson 5d02862484 users/14387 (tweaked): alternative zsh syntax is not going to be removed 2009-09-15 13:51:12 +00:00
Peter Stephenson 1c29f641c6 Mikael: 25143: spelling corrections
25144: report supported bases
25139: fix number
2008-06-10 08:50:35 +00:00
Peter Stephenson 547adf2021 25018: Omari Norman: completion for awk, join, sort 2008-05-13 16:08:35 +00:00
Clint Adams 3c8d53036c 24513, 24514, 24515, 24516, 24517, 24518, 24519, 24520, 24521: typo fixes from A. Costa. 2008-02-01 19:59:45 +00:00
Peter Stephenson 8ce657c2cb Phil Pennock + tweaks: 23398 + more tweaks: exec compatibility options 2007-05-08 10:02:58 +00:00
Peter Stephenson de272e0309 23115: ";|" at end of case clause causes later patterns to be tested 2007-01-19 21:36:00 +00:00
Peter Stephenson ce43e4a22c unposted c.f. 21735: document return as exit in try block in script 2005-09-19 15:19:21 +00:00
Peter Stephenson db44e186c9 c.f. 21071: always use "status" in return and exit status docs 2005-04-01 12:03:53 +00:00
Peter Stephenson d591334e9d 20076, 20084: { ... } always { ... } syntax. 2004-06-22 13:09:55 +00:00
Bart Schaefer c17b40b6a0 Fix errors introduced by 15354. 2001-07-24 13:16:08 +00:00
Bart Schaefer 5fcfa125bd Better indexing and misc. cleanup in the first tenth or so of the doc. 2001-07-10 08:59:17 +00:00
Peter Stephenson c4d9fa80a5 15264: improved doc for variant complex commands 2001-07-05 17:23:05 +00:00