path: root/Doc
diff options
authortaiyu <taiyu.len@gmail.com>2021-02-07 05:15:03 -0800
committerOliver Kiddle <opk@zsh.org>2021-02-13 01:01:40 +0100
commit3714ee0b5868a30d7556acab337889849a3c8226 (patch)
tree45c6279283d66a61666d1c96043bfa029bf5a3de /Doc
parent3d6e5b6231f0d80873c6f83924a48df223121e72 (diff)
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
Diffstat (limited to 'Doc')
1 files changed, 7 insertions, 3 deletions
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index 5f717d522..729b4e5d3 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -1838,14 +1838,18 @@ user is longer than the common prefix to the corresponding IDs.
kindex(insert-sections, completion style)
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
+completing names of manual pages. If set 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).
+The value may also be set to one of `tt(prepend)', or `tt(suffix)'.
+`tt(prepend)' behaves the same as `true' as in the above example, while
+`tt(suffix)' would complete tt(man ssh_<TAB>) as tt(man ssh_config.5).
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