zsh-workers
 help / color / Atom feed
* [PATCH] Improve documentation of {insert,separate}-sections
       [not found] ` <FA7C85D3-65A6-4EBC-8ACD-2319F02BE009@dana.is>
@ 2020-04-15  2:10   ` dana
  2020-04-15  9:09     ` Dave Woodfall
  0 siblings, 1 reply; 2+ messages in thread
From: dana @ 2020-04-15  2:10 UTC (permalink / raw)
  To: Zsh hackers list; +Cc: Dave Woodfall

Here's the insert-sections documentation i promised in users/24756. Also fixed
some inconsistent formatting and a typo

dana


diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index c2d20ca40..cbee305b6 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -1826,6 +1826,24 @@ be unsuccessful until that point.  If the value is any other
 string, menu completion will be started when the string typed by the
 user is longer than the common prefix to the corresponding IDs.
 )
+kindex(insert-sections, completion style)
+item(tt(insert-sections))(
+This style is used with tags of the form `tt(manuals.)var(X)' when
+completing names of manual pages. If set to `true' and the var(X) in the
+tag name matches the section number of the page being completed, the
+section number is inserted along with the page name. For example, given
+
+example(zstyle ':completion:*:manuals.*' insert-sections true)
+
+tt(man ssh_<TAB>) may be completed to tt(man 5 ssh_config).
+
+This is especially useful in conjunction with tt(separate-sections), as
+it ensures that the page requested of tt(man) corresponds to the one
+displayed in the completion listing when there are multiple pages with the
+same name (e.g., tt(printf(1)) and tt(printf(3))).
+
+The default for this style is `false'.
+)
 kindex(insert-tab, completion style)
 item(tt(insert-tab))(
 If this is set to `true', the completion system will
@@ -2445,7 +2463,7 @@ For example,
 example(zstyle ':completion:*' recursive-files '*/zsh/*')
 
 If the current directory is tt(/home/pws/zsh/Src), then
-tt(zle_tr)em(TAB) can be completed to tt(Zle/zle_tricky.c).
+tt(zle_tr<TAB>) can be completed to tt(Zle/zle_tricky.c).
 )
 kindex(regular, completion style)
 item(tt(regular))(
@@ -2502,12 +2520,13 @@ kindex(separate-sections, completion style)
 item(tt(separate-sections))(
 This style is used with the tt(manuals) tag when completing names of
 manual pages.  If it is `true', entries for different sections are
-added separately using tag names of the form `tt(manual.)var(X)',
+added separately using tag names of the form `tt(manuals.)var(X)',
 where var(X) is the section number.  When the tt(group-name) style is
 also in effect, pages from different sections will appear separately.
 This style is also used similarly with the tt(words) style when
 completing words for the dict command. It allows words from different
-dictionary databases to be added separately.
+dictionary databases to be added separately. See also tt(insert-sections).
+
 The default for this style is `false'.
 )
 kindex(show-ambiguity, completion style)


^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [PATCH] Improve documentation of {insert,separate}-sections
  2020-04-15  2:10   ` [PATCH] Improve documentation of {insert,separate}-sections dana
@ 2020-04-15  9:09     ` Dave Woodfall
  0 siblings, 0 replies; 2+ messages in thread
From: Dave Woodfall @ 2020-04-15  9:09 UTC (permalink / raw)
  To: Zsh hackers list

On 2020-04-14 21:10,
dana <dana@dana.is> put forth the proposition:
> Here's the insert-sections documentation i promised in users/24756. Also fixed
> some inconsistent formatting and a typo
>
> dana

Thanks Dana.

> diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
> <snip>
>

--
Dave

The antibloat squad!
For those interested in no bloat, minimal desktop Linux
gopher://tty1.uk/1/?minimal-linux
http://tty1.uk/minimal-linux
#minimallinux @ chat.freenode.net

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, back to index

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
     [not found] <20200406002612.GE9554@blackswan.r0t.uk>
     [not found] ` <FA7C85D3-65A6-4EBC-8ACD-2319F02BE009@dana.is>
2020-04-15  2:10   ` [PATCH] Improve documentation of {insert,separate}-sections dana
2020-04-15  9:09     ` Dave Woodfall

zsh-workers

Archives are clonable: git clone --mirror http://inbox.vuxu.org/zsh-workers

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://inbox.vuxu.org/vuxu.archive.zsh.workers


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git