Update search tool help.
jira/bin/jira-search.sh
-----------------------
o Help text growing long, refactor help text into jira-search/help.
o Added command line switches --help-* and --usage-*
jira/jira-search/help/utils.sh
------------------------------
o Added library functions for displaying context help.
o Display switch permutations for a given prefix.
o Display use cases for a given switch.
jira/jira-search/help/fixversion.switches
jira/jira-search/help/resolved.sh
jira/jira-search/help/resolved.switches
jira/jira-search/help/resolved.usage
jira/jira-search/help/user.switches
jira/jira-search/help/user.usage
-----------------------------------------
o Switch help and usage text.
Change-Id: I0cd34475521c2b42054fbe4e7966a6d3767f8f89
diff --git a/jira/jira-search/help/utils.sh b/jira/jira-search/help/utils.sh
new file mode 100644
index 0000000..53b237d
--- /dev/null
+++ b/jira/jira-search/help/utils.sh
@@ -0,0 +1,90 @@
+#!/bin/bash
+# -----------------------------------------------------------------------
+# Copyright 2024 Open Networking Foundation Contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http:#www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# -----------------------------------------------------------------------
+# SPDX-FileCopyrightText: 2024 Open Networking Foundation Contributors
+# SPDX-License-Identifier: Apache-2.0
+## --------------------------------------------------------------------
+## Intent:
+## --------------------------------------------------------------------
+
+## --------------------------------------------------------------------
+## --------------------------------------------------------------------
+function help_read()
+{
+ local -n ref=$1; shift
+ local path="$1"; shift
+
+ readarray text < <(grep -v -e '^#' "$path")
+ ref+=("${text[@]}")
+
+ return
+}
+
+## --------------------------------------------------------------------
+## --------------------------------------------------------------------
+function help_switch_show()
+{
+ local -a buffer=()
+
+ local helpwith
+ for helpwith in "$@"; do
+ local path="$pgm_help/${helpwith}.switches"
+ if [[ ! -e "$path" ]]; then
+ readarray fyls < <(find "$pgm_help" -name '*.switches')
+ echo "--usage-${helpwith} does not exist"
+ echo "Try one of:"
+ printf " %s\n" "${fyls[@]}"
+ error "OUTA HERE"
+ fi
+ help_read buffer "$path"
+ done
+
+ printf '%s' "${buffer[@]}"
+ return
+}
+
+## --------------------------------------------------------------------
+## --------------------------------------------------------------------
+function help_usage_show()
+{
+ local -a buffer=()
+
+ local helpwith
+ for helpwith in "$@"; do
+ local path="$pgm_help/${helpwith}.usage"
+ if [[ ! -e "$path" ]]; then
+ readarray fyls < <(find "$pgm_help" -name '*.usage')
+ echo "--usage-${helpwith} does not exist"
+ echo "Try one of:"
+ printf " %s\n" "${fyls[@]}"
+ error "OUTA HERE"
+ fi
+ help_read buffer "$path"
+ done
+
+ printf '%s' "${buffer[@]}"
+ return
+}
+
+## --------------------------------------------------------------------
+## --------------------------------------------------------------------
+function help_with()
+{
+ help_switch_show "$@"
+ help_usage_show "$@"
+}
+
+# [EOF]