Daniel Shahaf
68d2a1bc22
unposted: ${(Z)}: Convert documentation to a description block.
2020-03-20 02:28:11 +00:00
Daniel Shahaf
e1946bacf8
45540: vcs_info git: In non-interactive rebases, compute patch names for unapplied patches.
2020-03-15 00:18:28 +00:00
Daniel Shahaf
0a7bfc0bd2
45307: zstyle docs: Unoverload a placeholder variable name.
...
Use 'pattern' to refer to things matched against contexts and 'metapattern'
to refer to things matched against patterns.
2020-01-16 18:18:17 +00:00
Daniel Shahaf
6f263b5e89
45306: zstyle docs: Introduce the first synopsis in the same way as all others: with an item()().
2020-01-16 18:18:14 +00:00
Daniel Shahaf
490478378f
unposted: docs: Fix a cross-reference.
2020-01-16 16:32:39 +00:00
Daniel Shahaf
c7bc62aa06
45287: zshexpn: Describe parameter elision and add some introductory prose
2020-01-15 22:35:09 +00:00
Daniel Shahaf
610b4b3028
users/24656: docs: Add an example of setting and querying zstyles
2020-01-14 17:42:36 +00:00
Peter Stephenson
8406a0d38e
users/24659: Cross-ref doc for matchers.
2020-01-14 14:00:03 +00:00
Peter Stephenson
2ce5f6d79a
users/24628 (fixed): More doc for selectw-word-style widgets.
...
Add example of how to add a new binding for a widget that fixes
a particular word behaviour using styles.
2020-01-11 14:07:19 +00:00
Daniel Shahaf
99acc17bb6
unposted: Fix punctuation.
2020-01-10 12:46:32 +00:00
dana
2e521d7b63
45184: Clarify documentation of %-sequences understood by compadd -[Xx]
2020-01-05 12:04:46 -06:00
Daniel Shahaf
759daf2362
unposted (after 45183): Fix yodl error: "contrib.yo:4457: No macro: back(...)".
2020-01-02 16:08:51 +00:00
Stephane Chazelas
da19b67388
45183: Improve documentation examples
2020-01-01 22:02:48 -06:00
Daniel Shahaf
f3d18c3fb5
45160: zshexpn: Expand documentation of (S)
2019-12-31 17:22:10 +00:00
Sebastian Gniazdowski
408e75b903
45150 + 45152: zshexpn: Use a more minimal example in the documentation of (#b).
2019-12-28 21:11:47 +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
Daniel Shahaf
105ca83aa2
45112: zshmodules: Explicitly document the return values of the 'zstyle' getters -s, -b, and -a.
2019-12-22 03:21:07 +00:00
Daniel Shahaf
6e5bba8cba
45113: vcs_info docs: Clarify documentation of the %p/%u/%a patch-format expandos.
2019-12-22 03:21:04 +00:00
dana
6fd4023825
45055: Clarify _files documentation
2019-12-20 15:31:34 -06:00
Daniel Shahaf
48ebe82b48
45073: regex-replace docs: Simplify grammar (avoid a double negative, state defaults first).
2019-12-18 00:33:51 +00:00
Oliver Kiddle
0655e17644
45035: be explicit about the need for a # in colours specified as hex triplets
2019-12-16 11:21:10 +01:00
Peter Stephenson
cb4dc95643
45009: POSIX_CD needs to suppress some forms of option.
...
Otherwise forms of argument allowed by POSIX are interpreted as
options instead.
2019-12-12 10:47:00 +00:00
Martijn Dekker
bcde790c88
44981: Fix some typos in the documentation.
2019-12-04 21:31:17 +00:00
Daniel Shahaf
5b4a6dc7e0
44964: zshmisc(1): Document APPEND_CREATE under the append redirection operators, >> and >>!.
2019-12-03 02:54:48 +00:00
Daniel Shahaf
369e4a4057
unposted: _values: Use the formal parameter's name in the docstring.
2019-11-08 14:09:18 +00:00
Ned Batchelder
63cc5279b3
github #37 : Make it easier to understand what "fc -e" does.
2019-09-04 02:33:19 +00:00
Peter Stephenson
4fae525726
Copy functions using functions -c old new.
...
Documentation and test.
2019-08-03 19:53:51 +01:00
Bart Schaefer
adef791c82
44495: Mention coproc under $!
2019-07-08 17:55:06 -07:00
Peter Stephenson
3bdf4d6641
44480: Don't automatically close externally visible file descroptors.
...
These are descriptors marked FDT_EXTERNAL.
Make all sysopen'ed file descriptors FDT_EXTERNAL.
Make =(...) call closem() consistent with other substitutions.
Document file descriptors are left open.
2019-07-02 13:42:53 +01:00
Peter Stephenson
b8dc5a7f6d
44435: Handling digita arguments for :h and :t.
...
Pick number of leading or trailing path components to substitute.
Active in history, brace parameters, glob qualifiers.
Add tests for all three environments.
2019-06-20 11:13:05 +01:00
Stephane Chazelas
0b1725dcfc
44387, edited: describe some problems with restricted mode
2019-06-06 21:09:42 +01:00
Jim
06f5964284
44364: refer to zsh base manual page in zsh all
2019-05-28 09:35:12 +01:00
dana
c1a33575b4
44275: Fix compset -p/-s multibyte inconsistency and documentation
2019-05-08 16:35:08 -05:00
Oliver Kiddle
cd6fd2b0a3
44274: allow finer control of completion match soring with compadd's -o option
2019-05-07 23:24:49 +02:00
dana
78fb8aaccf
44198: Add cd_silent option to suppress all cd output
2019-04-12 14:00:19 -05:00
Roman Perepelitsa
c551937280
44215: Maintain LASTWIDGET across reset-prompt.
...
This avoids side effects of asynchronous notifications.
2019-04-10 09:41:04 +01:00
Matthew Martin
6f35d6c0d0
44202 (tweaked): _normal: Add -P to reset precommands
2019-04-04 18:45:19 -05:00
Matthew Martin
5facfd3280
44200 (tweaked): Completion: Append to precommands in _normal
2019-04-04 18:45:19 -05:00
Clinton Bunch
ea8d3ab3e4
44156 (tweaked): zsh/system: Add note about potential flock side-effects
...
(Minor adjustments to wording and formatting)
2019-03-22 17:11:19 -05:00
Matthew Martin
5267bdc4ef
44153: rm: Accept -R as equivalent to -r
2019-03-21 22:04:55 -05:00
Peter Stephenson
876dccfe73
Update doc from previous commit.
...
Make it clear it's commands whose names begin with a /
that aren't hashed. Obviously commands whose paths
begin with a / are OK, duh.
2019-03-19 14:22:34 +00:00
Charles Blake
084bf17c4b
44132: don't hash commands beginning with /
2019-03-19 14:09:50 +00:00
Matthew Martin
6331772c5b
44135: Add chmod builtin
2019-03-18 22:17:54 -05:00
dana
632023acc2
44100: zparseopts: Add -F option, completion, tests; improve documentation
...
* Enable zparseopts to perform basic usage validation (aborting on an
unrecognised option-like parameter)
* Officially document the resolution of ambiguous option specs
2019-03-12 19:03:56 -05:00
Mikael Magnusson
d683d278c7
44011: Only use fg_start_code for non-truecolor
...
The sequence for truecolor uses a different prefix from palette colors
2019-01-23 11:51:42 +01:00
Peter Stephenson
88ad890c05
users/23829: add and coument file-split-chars style
2019-01-08 14:19:19 +00:00
Martijn Dekker
2d056ebc31
43945 (tweaked to remove test failure, noted in test):
...
Fix exit statuses from wait for POSIX_BUILTINS mode.
Also add tests.
2018-12-30 18:11:43 +00:00
Martijn Dekker
4215fcb107
43944: apply NO_UNSET consistently to arithmeitc
2018-12-30 18:03:02 +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