From ce950dd4b4b56e39a5011c54179832ba2ed04e61 Mon Sep 17 00:00:00 2001 From: Daniel Shahaf Date: Sun, 1 Dec 2019 00:04:46 +0000 Subject: 44962: vcs_info: Document internal function and variable --- ChangeLog | 4 ++++ Functions/VCS_Info/VCS_INFO_bydir_detect | 12 ++++++++++++ Functions/VCS_Info/vcs_info | 6 ++++++ 3 files changed, 22 insertions(+) diff --git a/ChangeLog b/ChangeLog index b01f47f5f..b040dd09b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2019-12-03 Daniel Shahaf + * 44962: Functions/VCS_Info/VCS_INFO_bydir_detect, + Functions/VCS_Info/vcs_info: vcs_info: Document internal function + and variable + * 44964: Doc/Zsh/redirect.yo: zshmisc(1): Document APPEND_CREATE under the append redirection operators, >> and >>!. diff --git a/Functions/VCS_Info/VCS_INFO_bydir_detect b/Functions/VCS_Info/VCS_INFO_bydir_detect index b20c05c9c..29b261413 100644 --- a/Functions/VCS_Info/VCS_INFO_bydir_detect +++ b/Functions/VCS_Info/VCS_INFO_bydir_detect @@ -2,6 +2,18 @@ ## Written by Frank Terbeck ## Distributed under the same BSD-ish license as zsh itself. +# Helper function for VCS_INFO_detect_* +# +# Usage: +# vcs_comm[detect_need_file]=FILENAMES VCS_INFO_bydir_detect DIRNAME +# where DIRNAME is a directory name and FILENAMES is a space-separated list +# of filenames. +# +# If any parent directory of the current working directory, other than the root +# directory, contains a subdirectory named DIRNAME that contains a file whose name +# is in FILENAMES, set vcs_comm[basedir] to the path of that parent directory and +# return true. Otherwise, return false. + setopt localoptions NO_shwordsplit local dirname=$1 local basedir="." file diff --git a/Functions/VCS_Info/vcs_info b/Functions/VCS_Info/vcs_info index d67ae6bf5..9f48bee75 100644 --- a/Functions/VCS_Info/vcs_info +++ b/Functions/VCS_Info/vcs_info @@ -59,6 +59,12 @@ vcs_info () { local -x LC_MESSAGES local -i maxexports local -a msgs + + # vcs_comm is used internally for passing values among VCS_INFO_* functions. + # It is not part of the public API. + # + # hook_com, backend_misc, and user_data are public API; see zshcontrib(1) + # and Misc/vcs_info-examples. local -A vcs_comm hook_com backend_misc user_data LC_MESSAGES=C -- cgit 1.4.1