From b9eb5607b351075778f3fd44d31126a3d0ac0328 Mon Sep 17 00:00:00 2001
From: Patrick McDermott <pj@pehjota.net>
Date: Fri, 03 Nov 2017 15:13:26 -0400
Subject: MqMainMenu: Add comments explaining macro parameters

---
(limited to 'src')

diff --git a/src/toolbars/navigation/main-menu.c b/src/toolbars/navigation/main-menu.c
index cf6e3d7..a3e94e5 100644
--- a/src/toolbars/navigation/main-menu.c
+++ b/src/toolbars/navigation/main-menu.c
@@ -205,6 +205,7 @@ create_edit_buttons(MqMainMenu *main_menu)
 	gtk_style_context_add_class(gtk_widget_get_style_context(box),
 		"linked");
 
+	/*         ID,    ICON,         TOOLTIP */
 	NEW_BUTTON(cut,   "edit-cut",   "Cut");
 	gtk_widget_set_sensitive(cut_button, FALSE);
 	webkit_web_view_can_execute_editing_command(
@@ -212,6 +213,7 @@ create_edit_buttons(MqMainMenu *main_menu)
 		WEBKIT_EDITING_COMMAND_CUT,
 		NULL, (GAsyncReadyCallback) can_edit_cb, cut_button);
 
+	/*         ID,    ICON,         TOOLTIP */
 	NEW_BUTTON(copy,  "edit-copy",  "Copy");
 	gtk_widget_set_sensitive(copy_button, FALSE);
 	webkit_web_view_can_execute_editing_command(
@@ -219,6 +221,7 @@ create_edit_buttons(MqMainMenu *main_menu)
 		WEBKIT_EDITING_COMMAND_COPY,
 		NULL, (GAsyncReadyCallback) can_edit_cb, copy_button);
 
+	/*         ID,    ICON,         TOOLTIP */
 	NEW_BUTTON(paste, "edit-paste", "Paste");
 	gtk_widget_set_sensitive(paste_button, FALSE);
 	webkit_web_view_can_execute_editing_command(
@@ -242,6 +245,7 @@ create_zoom_buttons(MqMainMenu *main_menu)
 	gtk_style_context_add_class(gtk_widget_get_style_context(box),
 		"linked");
 
+	/*         ID,         ICON,            TOOLTIP */
 	NEW_BUTTON(zoom_out,   "zoom-out",      "Zoom out");
 	NEW_BUTTON(zoom_reset, "zoom-original", "Reset zoom");
 	NEW_BUTTON(zoom_in,    "zoom-in",       "Zoom in");
@@ -285,22 +289,27 @@ create_main_grid(MqMainMenu *main_menu)
 	gtk_grid_set_row_homogeneous(GTK_GRID(grid), TRUE);
 	gtk_grid_set_column_homogeneous(GTK_GRID(grid), TRUE);
 
+	/*         Y, X, ICON,                     TOOLTIP */
 	NEW_BUTTON(0, 0, "window-new",             "New window");
 	NEW_BUTTON(0, 1, "edit-find",              "Find");
 	NEW_BUTTON(0, 2, "view-fullscreen",        "Full screen");
 
+	/*         Y, X, ICON,                     TOOLTIP */
 	NEW_BUTTON(1, 0, "document-open",          "Open file");
 	NEW_BUTTON(1, 1, "document-save-as",       "Save page");
 	NEW_BUTTON(1, 2, "mail-message-new",       "E-mail link");
 
+	/*         Y, X, ICON,                     TOOLTIP */
 	NEW_BUTTON(2, 0, "document-print-preview", "Print preview");
 	NEW_BUTTON(2, 1, "document-print",         "Print");
 	NEW_BUTTON(2, 2, "preferences-system",     "Inspector");
 
+	/*         Y, X, CB */
 	CLICKED_CB(0, 0, new_window_clicked_cb);
 	CLICKED_CB(0, 1, find_clicked_cb);
 	CLICKED_CB(0, 2, fullscreen_clicked_cb);
 
+	/*         Y, X, CB */
 	CLICKED_CB(1, 0, open_clicked_cb);
 	CLICKED_CB(1, 1, save_clicked_cb);
 	/* TODO: 1, 2: E-mail link */
@@ -310,6 +319,7 @@ create_main_grid(MqMainMenu *main_menu)
 	gtk_widget_set_sensitive(buttons[2 * BUTTON_COLS + 0], FALSE);
 	/* TODO: 2, 1: Print */
 	gtk_widget_set_sensitive(buttons[2 * BUTTON_COLS + 1], FALSE);
+	/*         Y, X, CB */
 	CLICKED_CB(2, 2, inspector_clicked_cb);
 
 	return grid;
@@ -374,6 +384,7 @@ create_application_buttons(MqMainMenu *main_menu)
 	GtkWidget *quit_button;
 	GtkWidget *grid;
 
+	/*         ID,    ICON,               LABEL,           TOOLTIP */
 	NEW_BUTTON(about, "help-about",       "About Marquee", "About Marquee");
 	NEW_BUTTON(quit,  "application-exit", NULL,            "Quit");
 
--
cgit v0.9.1