Commit Graph

1955 Commits (master)

Author SHA1 Message Date
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