From ab3ae3fada4b9e0ff9040c986872e97a3cc1f3eb Mon Sep 17 00:00:00 2001
From: Robert Fewell <14uBobIT@gmail.com>
Date: Mon, 31 Oct 2022 11:45:45 +0000
Subject: [PATCH] Rename main window toolbar function.

Rename the main window function gnc_main_window_toolbar_find_menu_item
to gnc_main_window_toolbar_find_tool_item
---
 gnucash/gnome-utils/gnc-main-window.cpp  | 10 ++++++++--
 gnucash/gnome-utils/gnc-main-window.h    | 12 +++++++++++-
 gnucash/gnome/gnc-plugin-page-invoice.c  |  4 ++--
 gnucash/gnome/gnc-plugin-page-report.cpp |  2 +-
 4 files changed, 22 insertions(+), 6 deletions(-)

diff --git a/gnucash/gnome-utils/gnc-main-window.cpp b/gnucash/gnome-utils/gnc-main-window.cpp
index 442ffbff5bb..34163a2d8c8 100644
--- a/gnucash/gnome-utils/gnc-main-window.cpp
+++ b/gnucash/gnome-utils/gnc-main-window.cpp
@@ -3570,9 +3570,15 @@ gnc_main_window_get_action_group (GncMainWindow *window,
 
 
 GtkWidget *
-gnc_main_window_toolbar_find_menu_item (GncMainWindow *window, const gchar *action_name)
+gnc_main_window_toolbar_find_tool_item (GncMainWindow *window, const gchar *action_name)
 {
-    GncMainWindowPrivate *priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
+    GncMainWindowPrivate *priv;
+
+    g_return_val_if_fail (GNC_IS_MAIN_WINDOW(window), nullptr);
+    g_return_val_if_fail (action_name != nullptr, nullptr);
+
+    priv = GNC_MAIN_WINDOW_GET_PRIVATE(window);
+
     return gnc_find_toolbar_item (priv->toolbar, action_name);
 }
 
diff --git a/gnucash/gnome-utils/gnc-main-window.h b/gnucash/gnome-utils/gnc-main-window.h
index b70ac8cc043..c1373e4a806 100644
--- a/gnucash/gnome-utils/gnc-main-window.h
+++ b/gnucash/gnome-utils/gnc-main-window.h
@@ -271,7 +271,17 @@ void gnc_main_window_menu_item_vis_by_action (GncMainWindow *window,
 GtkWidget *gnc_main_window_menu_find_menu_item (GncMainWindow *window,
                                                 const gchar *action_name); //FIXMEb added
 
-GtkWidget * gnc_main_window_toolbar_find_menu_item (GncMainWindow *window,
+/** Find the toolbar item with the given action name for the window
+ *  specified.
+ *
+ *  @param window A pointer to the window whose user interface should
+ *  be updated.
+ *
+ *  @param action_name The action name of the tool item to find.
+ *
+ *  @return The found tool item widget or NULL.
+ */
+GtkWidget * gnc_main_window_toolbar_find_tool_item (GncMainWindow *window,
                                                     const gchar *action_name); //FIXMEb added
 
 /** A structure for defining alternate action names for use in the
diff --git a/gnucash/gnome/gnc-plugin-page-invoice.c b/gnucash/gnome/gnc-plugin-page-invoice.c
index 861f23caf98..0732c71629a 100644
--- a/gnucash/gnome/gnc-plugin-page-invoice.c
+++ b/gnucash/gnome/gnc-plugin-page-invoice.c
@@ -525,7 +525,7 @@ gnc_plugin_page_invoice_action_update (GncPluginPage *plugin_page,
        if (menu_item)
            gtk_menu_item_set_label (GTK_MENU_ITEM(menu_item), _(action_list[i].label));
 
-       tool_item = gnc_main_window_toolbar_find_menu_item (GNC_MAIN_WINDOW(GNC_PLUGIN_PAGE(plugin_page)->window),
+       tool_item = gnc_main_window_toolbar_find_tool_item (GNC_MAIN_WINDOW(GNC_PLUGIN_PAGE(plugin_page)->window),
                                                            action_list[i].action_name);
 
        if (tool_item)
@@ -540,7 +540,7 @@ gnc_plugin_page_invoice_action_update (GncPluginPage *plugin_page,
         if (menu_item)
             gtk_widget_set_tooltip_text (GTK_WIDGET(menu_item), _(tooltip_list[i].label));
 
-        tool_item = gnc_main_window_toolbar_find_menu_item (GNC_MAIN_WINDOW(GNC_PLUGIN_PAGE(plugin_page)->window),
+        tool_item = gnc_main_window_toolbar_find_tool_item (GNC_MAIN_WINDOW(GNC_PLUGIN_PAGE(plugin_page)->window),
                                                             tooltip_list[i].action_name);
 
         if (tool_item)
diff --git a/gnucash/gnome/gnc-plugin-page-report.cpp b/gnucash/gnome/gnc-plugin-page-report.cpp
index b731cf7d902..da1a624d2fa 100644
--- a/gnucash/gnome/gnc-plugin-page-report.cpp
+++ b/gnucash/gnome/gnc-plugin-page-report.cpp
@@ -1235,7 +1235,7 @@ gnc_plugin_page_report_menu_update (GncPluginPage *plugin_page,
         if (menu_item)
             gtk_widget_set_tooltip_text (GTK_WIDGET(menu_item), _(tooltip_list[i].label));
 
-        tool_item = gnc_main_window_toolbar_find_menu_item (GNC_MAIN_WINDOW(GNC_PLUGIN_PAGE(plugin_page)->window),
+        tool_item = gnc_main_window_toolbar_find_tool_item (GNC_MAIN_WINDOW(GNC_PLUGIN_PAGE(plugin_page)->window),
                                                             tooltip_list[i].action_name);
         if (tool_item)
         {