From 6f263b5e8972f7858ed389c96211e3828f8ae13a Mon Sep 17 00:00:00 2001 From: Daniel Shahaf Date: Wed, 15 Jan 2020 19:50:54 +0000 Subject: 45306: zstyle docs: Introduce the first synopsis in the same way as all others: with an item()(). --- ChangeLog | 3 +++ Doc/Zsh/mod_zutil.yo | 13 +++++++------ 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 + * 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) ])( -- cgit 1.4.1