diff options
| author | Daniel Shahaf <danielsh@apache.org> | 2019-12-01 00:04:46 +0000 |
|---|---|---|
| committer | Daniel Shahaf <danielsh@apache.org> | 2019-12-03 02:56:01 +0000 |
| commit | ce950dd4b4b56e39a5011c54179832ba2ed04e61 (patch) | |
| tree | 2c3f9e9a6003768bfbdf97ac29ce68e570085628 | |
| parent | 5b4a6dc7e080dc3007ceb32f7f9689c5c4c2cd13 (diff) | |
| download | zsh-ce950dd4b4b56e39a5011c54179832ba2ed04e61.tar.gz zsh-ce950dd4b4b56e39a5011c54179832ba2ed04e61.tar.xz zsh-ce950dd4b4b56e39a5011c54179832ba2ed04e61.zip | |
44962: vcs_info: Document internal function and variable
| -rw-r--r-- | ChangeLog | 4 | ||||
| -rw-r--r-- | Functions/VCS_Info/VCS_INFO_bydir_detect | 12 | ||||
| -rw-r--r-- | Functions/VCS_Info/vcs_info | 6 |
3 files changed, 22 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog index b01f47f5f..b040dd09b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2019-12-03 Daniel Shahaf <danielsh@apache.org> + * 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 <ft@bewatermyfriend.org> ## 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 |