Daniel Shahaf
94563d5ad1
49445: docs: Clean up some subsection references.
3 years ago
Oliver Kiddle
16d5d6a9da
49597: add a helper for completing numbers with unit suffixes and separate out defaults, ranges and units in completion descriptions
3 years ago
Arseny Maslennikov
12dc20832d
49575: clarify _alternative's action syntax
3 years ago
Oliver Kiddle
2fe9ab2813
49566: document the _default function
3 years ago
Oliver Kiddle
8ea5977222
49564: always use descriptions included in the file-patterns style and allow the recursive-files style to also work in those cases
3 years ago
Oliver Kiddle
9bdaf0197f
49562: remove old documentation for other-files tag that was removed in 36165
3 years ago
Oliver Kiddle
dfb7ac94bb
49561: add zformat -F option, similar to -f but ternary expressions check for existence instead of doing math evaluation
3 years ago
Oliver Kiddle
271cfc685b
49534, 49539: separate watch/log functionality out into a module
3 years ago
Oliver Kiddle
632fee7cdf
49528: allow multiple -D options to compadd
3 years ago
Marlon Richert
f2b6650b43
49521: Define correct behavior of || completion matchers
...
* Add xfail tests to show how :||= matchers should behave in order to
provide completion features that cannot be implemented with :|=
matchers.
* Update compwid.yo to further describe the correct behavior.
* Update compwid.yo to use completion terminology more consistently.
3 years ago
Bart Schaefer
fa4c88ca25
49456: clean up detection of private params in nested scopes, update doc
3 years ago
ivan tkachenko
99d915330a
49440: Make double-flag parameter expansion syntax more discoverable in docs
3 years ago
ivan tkachenko
02f75cf386
49435: Remove trailing whitespaces in expn.yo
3 years ago
Daniel Shahaf
ca94d3acda
unposted: Fix typos
3 years ago
Bart Schaefer
68c0fa68e2
49391: Document default bracketed-paste bindings
3 years ago
Stephane Chazelas
bb61da36aa
45180: clarify doc for POSIX EREs, fix an issue with PCRE when the replacement was empty or generated more than one element
3 years ago
zerkous
a6139bb0a9
49154: clarify status on exec failure
3 years ago
Bart Schaefer
a31fd3077d
48888: improve doc for $$ and $PPID, add fail test for PPID readonly-ness
3 years ago
Peter Stephenson
0a80579ed1
49307 with doc update: POSIX_TRAPS fix.
...
With POSIX_TRAPS set, an ignored signal stays ignored when entering
a subshell.
3 years ago
Daniel Shahaf
1449f81183
users/26734: docs: read: Notate the parameter name argument as optional.
3 years ago
Peter Stephenson
2912139261
48096: Update Sourceforge links to https://zsh.sourceforge.io/
3 years ago
Bart Schaefer
667901b6ba
49065: remove bad cross-reference
3 years ago
Daniel Shahaf
4202c0bbe3
48601/0004: docs: return: Give examples of using arithmetic evaluation.
3 years ago
Daniel Shahaf
b992d91059
48601/0003: docs: functions -M: Add a subheading and index entries.
3 years ago
Daniel Shahaf
f571aff1b2
48601/0002: docs: functions -M: Document the return status / result interdependency gotchas (cf. 48147).
3 years ago
Daniel Shahaf
6913eb6776
48601/0001: docs: functions -M: Move an example to be near the specification of the relevant flag
3 years ago
Marlon Richert
7383baf4cf
48853: improved handling of theme resets when changing prompt themes, especially for theme preview
3 years ago
Bart Schaefer
acd20254b5
48710: histed + other zed updates
3 years ago
Bart Schaefer
231c049c02
48707: fix keymap handling when zed invokes read-from-minibuffer; update doc
3 years ago
dana
093ba11970
unposted: docs: Update http:// FAQ links to https://
...
See 48613
3 years ago
dana
d4b78f6c54
48551: docs: Add disclaimer about POSIX compliance and emulation of other shells
3 years ago
dana
c23a0d84b0
48614: getopts: Calculate OPTIND according to POSIX_BUILTINS
3 years ago
Daniel Shahaf
2da0d8b52f
48767: docs: $SECONDS: Clarify what types may be set
3 years ago
Daniel Shahaf
b110d6d5af
48435 (tweaked): vcs_info docs: applied-string/unapplied-string: Correct an omission in the documentation and add an example.
...
The example code is a reduced version of my function from workers/47519,
with one bug fixed. (In workers/47519, if $1 doesn't contain spaces -
which is the case under hg mq - then $H and $s will be set to the same
value.)
Tweaked: Extended the contrib.yo hunk with details about mq.
3 years ago
Bart Schaefer
82ff9f24f1
48560: add TYPESET_TO_UNSET option to remove initialization of parameters
...
Changes typeset such that ${newparam-notset} yields "notset" and
"typeset -p newparam" does not show an assignment to the parameter. This
is similar to the default behavior of bash and ksh, with minor differences
in typeset output.
Also add tests for some POSIX incompatibilities plus minor changes for test
harness robustness.
3 years ago
Daniel Shahaf
e1f5172a48
45583/0008: vcs_info git: Use best practices in an example
...
The alias was vulnerable to SHORT_LOOPS syntax, not invokable from
scripts, etc..
3 years ago
Daniel Shahaf
2144d01102
45583/0007: vcs_info docs: vcs_info_lastmsg: Correct an ambiguous/wrong description.
3 years ago
Daniel Shahaf
517e1777a5
45583/0006: vcs_info docs: Change user-context name in an example, to avoid confusion with the special-casing of the value `command' in vcs_info_lastmsg.
3 years ago
Daniel Shahaf
ebcb20a9c0
45583/0005: vcs_info docs: Recommend use of prompt expandos rather than terminal escape sequences.
3 years ago
Daniel Shahaf
cc833e01fe
45583/0004: docs: Document that hook functions may rely on $? (see workers/48570).
3 years ago
Daniel Shahaf
9b5f80285d
45583/0003: docs: Fix rendering in the man page output
...
In the man page output, the text was underlined from the var()
to the end of the paragraph.
The texi output in affected. For instance, the text `name' in TeX
is now slanted Roman (\slshape\rmfamily) rather than slanted teletype
(\slshape\ttfamily).
3 years ago
Daniel Shahaf
d07c945e74
45583/0002 (tweaked): docs: Fix rendering of an example in the man page output
...
The texi output was unaffected. However, in the man page on my system,
everything after the example() was underlined and not indented.
3 years ago
Daniel Shahaf
32336eab92
45583/0001: docs: Minor markup tweak
3 years ago
Bart Schaefer
408a830483
47913: implement CASE_PATHS option to make NO_CASE_GLOB more sensible
3 years ago
Daniel Shahaf
e4a8740c78
48410: FAQ, METAFAQ: Mention zsh-security@.
3 years ago
Oliver Kiddle
714864a87b
48356: clarify (the intended) behaviour for the two anchor forms of matching control
3 years ago
Daniel Shahaf
3d2814072a
unposted: docs: _arguments: Fix a typo in the example.
3 years ago
dana
78cf455871
unposted: Improve documentation and add regression test for workers/47745
3 years ago
Martijn Dekker
9c0533931c
48073: Add fc -s as POSIX way of rerunning command without starting editor
3 years ago
Lawrence Velázquez
83cc7c6bf0
47830: Fix some documentation typos
3 years ago
taiyu
3714ee0b58
github #68 : support section suffix completion for man pages
...
Support prepend and suffix values for insert-sections
Add values for insert-sections for zstyle completion
3 years ago
Bart Schaefer
b8ec0ddba5
unposted: Add cindex entries for some subsections
3 years ago
Jun-ichi Takimoto
34eae73490
47731 (+unposted): add run-help assistant for btrfs
...
also fix format errors in contrib.yo
3 years ago
Bart Schaefer
5a9e632638
unposted: index compprefuncs and comppostfuncs
4 years ago
ivan tkachenko
038f537a2a
47547: docs: Specify the exact kind of quoting which is assumed when parsing arithmetic expressions
4 years ago
Mikael Magnusson
d3a6dee9cd
unposted: Fix typo 'my be' for typeset
4 years ago
Mikael Magnusson
8773f01f2b
47494, 47495: Add -n option to strftime
4 years ago
Axel Beckert
da534770fd
47468: Doc/Zsh/contrib.yo: Fix typo
4 years ago
Daniel Shahaf
00d20ed15e
users/26088: docs: zle -R: Clarify that it needs not be called in the normal course of things, but only when an immediate, interim redisplay is desired.
4 years ago
Bart Schaefer
63b6398b70
47364: Enable extendedglob in pattern with ${(*)name/pattern/replacement}
...
Mikael Magnusson: 47382: Completion for 47364
4 years ago
Oliver Kiddle
5668cace4a
47328: remove references to old zsh.org mail addresses
4 years ago
Mikael Magnusson
841188439b
47306: edit-command-line: add editor style
4 years ago
Daniel Shahaf
cdafe31e05
47313: docs: Document explicitly that the :P modifier returns a symlink-less path.
4 years ago
Daniel Shahaf
e2be2d061a
unposted: Update documentation for the move to new hosting.
4 years ago
Daniel Shahaf
fa51a38955
46240: Make the expansion of manref()() in ztexi.yo match its expansion in zman.yo.
...
The difference was mostly harmless in the common case "(see manref(foo)(42))",
which expanded to "(see man page foo(42))" under ztexi.yo, but in other
contexts the ztexi.yo expansion was was nonsensical; for example:
"the BSD manref(echo)(1) command"
"the string returned by the manref(getlogin)(3) system call"
"advisory file locking (via the manref(fcntl)(2) system call)"
"this is the exact opposite from manref(ls)(1),"
While there, copyedit some uses of manref()().
4 years ago
Daniel Shahaf
7dfc4f754e
users/24985: Clarify documentation of the ${(n)} and ${(-)} parameter expansion flags, and add a forward compatibility hatch to the latter.
4 years ago
Nuri Jung
89618fe37d
github #58 : docs: Note that the zsh/regex syntax is platform-dependent.
4 years ago
Pete Moore
4ab0d047c7
46194: docs: metafaq: Remove spurious closing bracket
4 years ago
Daniel Shahaf
b53f465481
unposted (cf. users/24972, users/24978): Use an ASCII hyphen/minus rather than a dash.
4 years ago
Peter Stephenson
4e0058afc5
users/24971: ${(-)var} sorts on signed integers
4 years ago
Daniel Shahaf
f636cde7b5
46132: docs: Use an itemized list in the documentation of the *(o) glob qualifier.
...
This should be easier to read, both as a tutorial and as a reference.
4 years ago
Daniel Shahaf
0cffb0a6b3
46072 + 46136: Add the 'zle $widget -f nolast' syntax, to improve add-zle-hook-widget support for multiple hook functions.
...
See workers/46004 for the use-case.
4 years ago
Daniel Shahaf
9575f2f1bf
users/24959/0002: Update aliases documentation for the addition of the ALIAS_FUNC_DEF option.
4 years ago
Daniel Shahaf
7f58463dd3
users/24959/0001: Extend documentation of global aliases.
4 years ago
Daniel Shahaf
4e3d08fea8
unposted: docs: Fix some markup and typos.
4 years ago
Daniel Shahaf
dd6e702ee4
46068 (tweaked) (was: github #57 ): region_highlight: Add memo= support.
...
This is useful when multiple plugins add region_highlight entries and
subsequently want to remove only their own entries. Without this
functionality, recognizing one's region_highlight entries is not trivial
because the 'start' and 'end' offsets are modified by editing of $BUFFER
and the highlight specification may not be unique or distinctive.
The tweaks are as follows:
- Change zfree() to zsfree() per workers/46070.
- Remove the mem.c hunk, as it changed the signature of only one out of
two alternative definitions of zsfree(). (The definition that hunk
touched is the one that's not used by default.)
4 years ago
Manuel Jacob
ae0129b49f
46091: Add code to Mercurial VCS backend to show topic if there is any.
...
"Topics" is an experimental concept in Mercurial that augments the
current branching concept (called "named branches").
For more information, see the not always up-to-date Mercurial Wiki page
https://www.mercurial-scm.org/wiki/TopicPlan .
4 years ago
Miroslav Koškár
33361e81bc
46049: docs: Correct the sense of the single-letter abstract of the GLOBAL_RCS option (-d)
4 years ago
Daniel Shahaf
c5f12fb732
unposted: zstyle docs: Fix typo.
...
This manifested as a trailing non-underlined ".RE" in the rendered man page.
(I guess that was a man page directive, but I'm not sure how the extraneous
closing parenthesis caused it to be rendered in the output.)
4 years ago
Peter Stephenson
3df604a4be
46026: Add CLOBBER_EMPTY option.
4 years ago
Bart Schaefer
086acd095d
unposted: remove blank line that messed up "man" formatting
4 years ago
Daniel Shahaf
7c2a740d0f
users/24843: zshcompsys(1): Point to the 'format' style from the 'tag-order' style.
4 years ago
Daniel Shahaf
deca7c9285
45730: _arguments: Add the -0 flag, which makes $opt_args be populated sanely.
...
Also, write/extend docstrings for sepjoin() and zjoin().
4 years ago
Daniel Shahaf
34d69acbef
45737 (+ docs, and update the test from 45722): zstyle: When determining the weight (specificity) of a pattern, consider the number of components before anything else, as documented.
4 years ago
Daniel Shahaf
7f73edad7a
45739: docs: Clarifications about zstyle patterns.
...
- Consistently use the term "pattern" rather than "context" or "style pattern"
- Correct statements about order of precedence of patterns
- Give the rationale for the "rule of thumb"
4 years ago
Daniel Shahaf
5d9f7975a9
45722: docs: Change zstyle example to a non-hierarchical one
4 years ago
Benjamin Esham
ff50d96b19
github #56 : typo: Add a single quote that had been missing
4 years ago
dana
1cac862b0f
unposted: zsh/system: Adjust documentation from workers/45708
4 years ago
Cedric Ware
25c9b61a66
45708: zsh/system: Enable sub-second timeout in zsystem flock
4 years ago
dana
f179dbf72a
45702: compsys: Improve documentation of {insert,separate}-sections
4 years ago
Peter Stephenson
28277a84dd
45684: Document - glob qualifier in error cases
4 years ago
dg1727
6ec97e1d48
45661: docs: Clarify the effect of KSH_ARRAYS on the (I) subscript.
4 years ago
Mikael Magnusson
8923d2a618
Add SHORT_REPEAT option
4 years ago
Daniel Shahaf
386d9ac8ff
45583/0008: Add the 'function -T' syntax.
...
Config/version.mk was bumped in the previous commit.
4 years ago
Daniel Shahaf
68d2a1bc22
unposted: ${(Z)}: Convert documentation to a description block.
4 years ago
Daniel Shahaf
e1946bacf8
45540: vcs_info git: In non-interactive rebases, compute patch names for unapplied patches.
4 years ago
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.
4 years ago
Daniel Shahaf
6f263b5e89
45306: zstyle docs: Introduce the first synopsis in the same way as all others: with an item()().
4 years ago
Daniel Shahaf
490478378f
unposted: docs: Fix a cross-reference.
4 years ago
Daniel Shahaf
c7bc62aa06
45287: zshexpn: Describe parameter elision and add some introductory prose
4 years ago
Daniel Shahaf
610b4b3028
users/24656: docs: Add an example of setting and querying zstyles
4 years ago
Peter Stephenson
8406a0d38e
users/24659: Cross-ref doc for matchers.
4 years ago
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.
4 years ago
Daniel Shahaf
99acc17bb6
unposted: Fix punctuation.
4 years ago
dana
2e521d7b63
45184: Clarify documentation of %-sequences understood by compadd -[Xx]
4 years ago
Daniel Shahaf
759daf2362
unposted (after 45183): Fix yodl error: "contrib.yo:4457: No macro: back(...)".
4 years ago
Stephane Chazelas
da19b67388
45183: Improve documentation examples
4 years ago
Daniel Shahaf
f3d18c3fb5
45160: zshexpn: Expand documentation of (S)
4 years ago
Sebastian Gniazdowski
408e75b903
45150 + 45152: zshexpn: Use a more minimal example in the documentation of (#b).
4 years ago
Daniel Shahaf
f7f2baac5e
45110: zshmisc(1): Fix markup of "try-list" and "always-list".
4 years ago
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.
4 years ago
Daniel Shahaf
105ca83aa2
45112: zshmodules: Explicitly document the return values of the 'zstyle' getters -s, -b, and -a.
4 years ago
Daniel Shahaf
6e5bba8cba
45113: vcs_info docs: Clarify documentation of the %p/%u/%a patch-format expandos.
4 years ago
dana
6fd4023825
45055: Clarify _files documentation
4 years ago
Daniel Shahaf
48ebe82b48
45073: regex-replace docs: Simplify grammar (avoid a double negative, state defaults first).
4 years ago
Oliver Kiddle
0655e17644
45035: be explicit about the need for a # in colours specified as hex triplets
4 years ago
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.
4 years ago
Martijn Dekker
bcde790c88
44981: Fix some typos in the documentation.
5 years ago
Daniel Shahaf
5b4a6dc7e0
44964: zshmisc(1): Document APPEND_CREATE under the append redirection operators, >> and >>!.
5 years ago
Daniel Shahaf
369e4a4057
unposted: _values: Use the formal parameter's name in the docstring.
5 years ago
Ned Batchelder
63cc5279b3
github #37 : Make it easier to understand what "fc -e" does.
5 years ago
Peter Stephenson
4fae525726
Copy functions using functions -c old new.
...
Documentation and test.
5 years ago
Bart Schaefer
adef791c82
44495: Mention coproc under $!
5 years ago
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.
5 years ago
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.
5 years ago
Stephane Chazelas
0b1725dcfc
44387, edited: describe some problems with restricted mode
5 years ago
Jim
06f5964284
44364: refer to zsh base manual page in zsh all
5 years ago
dana
c1a33575b4
44275: Fix compset -p/-s multibyte inconsistency and documentation
5 years ago
Oliver Kiddle
cd6fd2b0a3
44274: allow finer control of completion match soring with compadd's -o option
5 years ago
dana
78fb8aaccf
44198: Add cd_silent option to suppress all cd output
5 years ago
Roman Perepelitsa
c551937280
44215: Maintain LASTWIDGET across reset-prompt.
...
This avoids side effects of asynchronous notifications.
5 years ago
Matthew Martin
6f35d6c0d0
44202 (tweaked): _normal: Add -P to reset precommands
5 years ago
Matthew Martin
5facfd3280
44200 (tweaked): Completion: Append to precommands in _normal
5 years ago
Clinton Bunch
ea8d3ab3e4
44156 (tweaked): zsh/system: Add note about potential flock side-effects
...
(Minor adjustments to wording and formatting)
5 years ago
Matthew Martin
5267bdc4ef
44153: rm: Accept -R as equivalent to -r
5 years ago
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.
5 years ago
Charles Blake
084bf17c4b
44132: don't hash commands beginning with /
5 years ago
Matthew Martin
6331772c5b
44135: Add chmod builtin
5 years ago
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
5 years ago
Mikael Magnusson
d683d278c7
44011: Only use fg_start_code for non-truecolor
...
The sequence for truecolor uses a different prefix from palette colors
5 years ago
Peter Stephenson
88ad890c05
users/23829: add and coument file-split-chars style
5 years ago
Martijn Dekker
2d056ebc31
43945 (tweaked to remove test failure, noted in test):
...
Fix exit statuses from wait for POSIX_BUILTINS mode.
Also add tests.
5 years ago
Martijn Dekker
4215fcb107
43944: apply NO_UNSET consistently to arithmeitc
5 years ago
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.
5 years ago
Peter Stephenson
7292c063e8
43620: More care documenting command substitution including $(<...)
6 years ago
dana
5ad76492af
43800: Add nanosecond support to strftime built-in
6 years ago
Peter Stephenson
6529d52506
43788: clarify zpty -w -n with no string argument
6 years ago
Oliver Kiddle
c8ce1fe4c1
43760: add documentation for true colour changes and nearcolor module
6 years ago
Peter Stephenson
079f7f9d48
43694: More detail on multios.
...
Mention how opening files in multios differs from cat.
6 years ago
Daniel Shahaf
76a16498d5
43692: Generate man pages in the build dir, rather than the source dir.
...
The following files are still generated in the source dir (in
out-of-tree builds):
Doc/Zsh/manmodmenu.yo
Doc/Zsh/modlist.yo
Doc/Zsh/modmenu.yo
Doc/version.yo
Doc/zsh.idx
Doc/zsh.texi
META-FAQ
6 years ago