From: Daniel Shahaf <danielsh@apache.org>
To: zsh-workers@zsh.org
Subject: [PATCH 2/2] zstyle docs: Unoverload a placeholder variable name.
Date: Wed, 15 Jan 2020 19:50:55 +0000 [thread overview]
Message-ID: <20200115195055.12465-2-danielsh@apache.org> (raw)
In-Reply-To: <20200115195055.12465-1-danielsh@apache.org>
Use 'pattern' to refer to things matched against contexts and 'metapattern'
to refer to things matched against patterns.
---
Doc/Zsh/mod_zutil.yo | 9 +++++----
1 file changed, 5 insertions(+), 4 deletions(-)
diff --git a/Doc/Zsh/mod_zutil.yo b/Doc/Zsh/mod_zutil.yo
index 5363037ab..24aebdfaf 100644
--- a/Doc/Zsh/mod_zutil.yo
+++ b/Doc/Zsh/mod_zutil.yo
@@ -7,7 +7,7 @@ The tt(zsh/zutil) module only adds some builtins:
startitem()
findex(zstyle)
-xitem(tt(zstyle) [ tt(-L) [ var(pattern) [ var(style) ] ] ])
+xitem(tt(zstyle) [ tt(-L) [ var(metapattern) [ var(style) ] ] ])
xitem(tt(zstyle) [ tt(-e) | tt(-) | tt(-)tt(-) ] var(pattern) var(style) var(string) ...)
xitem(tt(zstyle -d) [ var(pattern) [ var(style) ... ] ])
xitem(tt(zstyle -g) var(name) [ var(pattern) [ var(style) ] ])
@@ -52,14 +52,15 @@ em(Usage)
The forms that operate on patterns are the following.
startitem()
-item(tt(zstyle) [ tt(-L) [ var(pattern) [ var(style) ] ] ])(
+item(tt(zstyle) [ tt(-L) [ var(metapattern) [ var(style) ] ] ])(
Without arguments, lists style definitions. Styles
are shown in alphabetic order and patterns are shown in the order
tt(zstyle) will test them.
If the tt(-L) option is given, listing is done in the form of calls to
-tt(zstyle). The optional first argument is a pattern which will be matched
-against the string supplied as the pattern for the context; note that
+tt(zstyle). The optional first argument, var(metapattern), is a pattern which
+will be matched against the string supplied as var(pattern) when the style was
+defined. Note:
this means, for example, `tt(zstyle -L ":completion:*")' will
match any supplied pattern beginning `tt(:completion:)', not
just tt(":completion:*"): use tt(':completion:\*') to match that.
prev parent reply other threads:[~2020-01-15 21:38 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-01-15 19:50 [PATCH 1/2] zstyle docs: Introduce the first synopsis in the same way as all others: with an item()() Daniel Shahaf
2020-01-15 19:50 ` Daniel Shahaf [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20200115195055.12465-2-danielsh@apache.org \
--to=danielsh@apache.org \
--cc=zsh-workers@zsh.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.vuxu.org/mirror/zsh/
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).