about summary refs log tree commit diff
diff options
context:
space:
mode:
authorDaniel Shahaf <danielsh@apache.org>2020-01-15 19:50:54 +0000
committerDaniel Shahaf <danielsh@apache.org>2020-01-16 18:18:14 +0000
commit6f263b5e8972f7858ed389c96211e3828f8ae13a (patch)
tree53d6bbdb48d663de473bcbb7d288fe796c22738c
parent490478378f5f7bb89d70655c26be79691bb67339 (diff)
downloadzsh-6f263b5e8972f7858ed389c96211e3828f8ae13a.tar.gz
zsh-6f263b5e8972f7858ed389c96211e3828f8ae13a.tar.xz
zsh-6f263b5e8972f7858ed389c96211e3828f8ae13a.zip
45306: zstyle docs: Introduce the first synopsis in the same way as all others: with an item()().
-rw-r--r--ChangeLog3
-rw-r--r--Doc/Zsh/mod_zutil.yo13
2 files changed, 10 insertions, 6 deletions
diff --git a/ChangeLog b/ChangeLog
index 74b14eebb..a5c27f50e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2020-01-16  Daniel Shahaf  <danielsh@apache.org>
 
+	* 45306: Doc/Zsh/mod_zutil.yo: zstyle docs: Introduce the first
+	synopsis in the same way as all others: with an item()().
+
 	* unposted: Doc/Zsh/options.yo, Doc/Zsh/params.yo: docs: Fix
 	a cross-reference.
 
diff --git a/Doc/Zsh/mod_zutil.yo b/Doc/Zsh/mod_zutil.yo
index e556e2b37..5363037ab 100644
--- a/Doc/Zsh/mod_zutil.yo
+++ b/Doc/Zsh/mod_zutil.yo
@@ -49,7 +49,11 @@ in order to retrieve your preference into the scalar variable tt($REPLY).
 
 em(Usage)
 
-The first form (without arguments) lists the definitions.  Styles
+The forms that operate on patterns are the following.
+
+startitem()
+item(tt(zstyle) [ tt(-L) [ var(pattern) [ 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.
 
@@ -61,10 +65,7 @@ match any supplied pattern beginning `tt(:completion:)', not
 just tt(":completion:*"):  use tt(':completion:\*') to match that.
 The optional second argument limits the output to a specific var(style) (not a
 pattern).  tt(-L) is not compatible with any other options.
-
-The other forms are the following:
-
-startitem()
+)
 item(tt(zstyle) [ tt(-) | tt(-)tt(-) | tt(-e) ] var(pattern) var(style) var(string) ...)(
 vindex(reply, use of)
 Defines the given var(style) for the var(pattern) with the var(string)s as
@@ -93,7 +94,7 @@ combination is returned.
 )
 enditem()
 
-The other forms can be used to look up or test patterns.
+The other forms can be used to look up or test styles for a given context.
 
 startitem()
 item(tt(zstyle -s) var(context) var(style) var(name) [ var(sep) ])(