GUI: Add lots of tooltips

3 files changed, 41 insertions, 0 deletions

diff --git a/src/crystfelindexingopts.c b/src/crystfelindexingopts.c
index f2c1d06f..eccbf7a6 100644
--- a/src/crystfelindexingopts.c
+++ b/src/crystfelindexingopts.c
@@ -297,6 +297,7 @@ static GtkWidget *indexing_parameters(CrystFELIndexingOpts *io)
 	                 G_CALLBACK(cell_file_clear_sig), io);
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(button),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(hbox, "-p / --pdb (or CrystFEL format)");
 
 	/* Indexing method selector */
 	io->auto_indm = gtk_check_button_new_with_label("Automatically choose the indexing methods");
@@ -319,32 +320,38 @@ static GtkWidget *indexing_parameters(CrystFELIndexingOpts *io)
 	io->multi = gtk_check_button_new_with_label("Attempt to find multiple lattices per frame");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->multi),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->multi, "--multi");
 
 	/* --no-refine (NB inverse) */
 	io->refine = gtk_check_button_new_with_label("Refine the indexing solution");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->refine),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->refine, "--no-refine");
 
 	/* --no-retry (NB inverse) */
 	io->retry = gtk_check_button_new_with_label("Retry indexing if unsuccessful");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->retry),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->retry, "--no-retry");
 
 	/* --no-check-peaks (NB inverse) */
 	io->check_peaks = gtk_check_button_new_with_label("Check indexing solutions match peaks");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->check_peaks),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->check_peaks, "--no-check-peaks");
 
 	/* --no-check-cell (NB inverse) and --tolerance */
 	io->check_cell = gtk_check_button_new_with_label("Check indexing solutions against reference cell");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->check_cell),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->check_cell, "--no-check-cell");
 	expander = gtk_expander_new("Unit cell tolerances");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(expander),
 	                   FALSE, FALSE, 4.0);
 	tolerances = make_tolerances(io);
 	gtk_container_add(GTK_CONTAINER(expander), tolerances);
 	i_disable_if_not(io->check_cell, tolerances);
+	gtk_widget_set_tooltip_text(expander, "--tolerance");
 
 	/* --min-peaks (NB add one) */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -361,6 +368,7 @@ static GtkWidget *indexing_parameters(CrystFELIndexingOpts *io)
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(label),
 	                   FALSE, FALSE, 4.0);
 	i_disable_if_not(io->enable_hitfind, io->ignore_fewer_peaks);
+	gtk_widget_set_tooltip_text(hbox, "--min-peaks");
 
 	gtk_widget_show_all(box);
 
@@ -393,16 +401,19 @@ static GtkWidget *integration_parameters(CrystFELIndexingOpts *io)
 	                "Ring summation");
 	gtk_combo_box_text_append(GTK_COMBO_BOX_TEXT(io->integration_combo), "prof2d",
 	                "Two dimensional profile fitting");
+	gtk_widget_set_tooltip_text(hbox, "--integration={none,rings,prof2d}");
 
 	/* -cen */
 	io->centering = gtk_check_button_new_with_label("Center integration boxes on observed reflections");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->centering),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->centering, "--integration=xxx-cen");
 
 	/* --overpredict */
 	io->overpredict = gtk_check_button_new_with_label("Over-predict reflections (for post-refinement)");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->overpredict),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->overpredict, "--overpredict");
 
 	/* --push-res */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 0);
@@ -421,6 +432,7 @@ static GtkWidget *integration_parameters(CrystFELIndexingOpts *io)
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(label),
 	                   FALSE, FALSE, 4.0);
 	i_disable_if_not(io->limit_res, io->push_res);
+	gtk_widget_set_tooltip_text(io->limit_res, "--push-res");
 
 	/* --int-radii */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 0);
@@ -428,6 +440,7 @@ static GtkWidget *integration_parameters(CrystFELIndexingOpts *io)
 	                   FALSE, FALSE, 4.0);
 
 	label = gtk_label_new("Integration radii - inner:");
+	gtk_widget_set_tooltip_text(label, "--int-radius=inner,middle,outer");
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(label),
 	                   FALSE, FALSE, 4.0);
 	io->ir_inn = gtk_entry_new();
@@ -528,16 +541,22 @@ static GtkWidget *stream_parameters(CrystFELIndexingOpts *io)
 	io->exclude_nonhits = gtk_check_button_new_with_label("Exclude skipped frames from stream");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->exclude_nonhits),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->exclude_nonhits,
+	                            "--no-non-hits-in-stream");
 
 	/* --no-peaks-in-stream */
 	io->no_peaks_in_stream = gtk_check_button_new_with_label("Exclude peak search results from stream");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->no_peaks_in_stream),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->no_peaks_in_stream,
+	                            "--no-peaks-in-stream");
 
 	/* --no-refls-in-stream */
 	io->no_refls_in_stream = gtk_check_button_new_with_label("Exclude integrated intensities from stream");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(io->no_refls_in_stream),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(io->no_refls_in_stream,
+	                            "--no-refls-in-stream");
 
 	io->copy_metadata_store = gtk_list_store_new(1, G_TYPE_STRING);
 
@@ -557,6 +576,7 @@ static GtkWidget *stream_parameters(CrystFELIndexingOpts *io)
 
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(treeview),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(box, "--copy-header / --copy-hdf5-field");
 
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 4);
 	gtk_container_set_border_width(GTK_CONTAINER(hbox), 8);
diff --git a/src/crystfelmergeopts.c b/src/crystfelmergeopts.c
index 36429b22..304edfb4 100644
--- a/src/crystfelmergeopts.c
+++ b/src/crystfelmergeopts.c
@@ -158,6 +158,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	                          "Monochromatic Ewald sphere offset (offset)");
 	g_signal_connect(G_OBJECT(mo->model_combo), "changed",
 	                 G_CALLBACK(check_greyout), mo);
+	gtk_widget_set_tooltip_text(hbox, "--model");
 
 	/* Symmetry */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -169,6 +170,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	mo->symmetry = crystfel_symmetry_selector_new();
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->symmetry),
 	                   FALSE, FALSE, 0);
+	gtk_widget_set_tooltip_text(hbox, "--symmetry");
 
 	/* Scale, Bscale, post-ref on/off */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -177,12 +179,15 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	mo->scale = gtk_check_button_new_with_label("Scale intensities");
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->scale),
 	                   FALSE, FALSE, 0);
+	gtk_widget_set_tooltip_text(mo->scale, "--scale / --no-scale");
 	mo->bscale = gtk_check_button_new_with_label("Debye-Waller scaling");
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->bscale),
 	                   FALSE, FALSE, 0);
+	gtk_widget_set_tooltip_text(mo->bscale, "--no-Bscale");
 	mo->postref = gtk_check_button_new_with_label("Post-refinement");
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->postref),
 	                   FALSE, FALSE, 0);
+	gtk_widget_set_tooltip_text(mo->postref, "--no-pr");
 	check_on_toggle(mo->scale, mo);
 
 	/* Number of iterations */
@@ -196,6 +201,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	gtk_entry_set_width_chars(GTK_ENTRY(mo->niter), 4);
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->niter),
 	                   FALSE, FALSE, 0);
+	gtk_widget_set_tooltip_text(hbox, "--iterations");
 
 	/* Polarisation horiz/vert/unpolarized beam/no correction */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -215,11 +221,13 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	                          "No correction");
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->polarisation),
 	                   FALSE, FALSE, 0);
+	gtk_widget_set_tooltip_text(hbox, "--polarisation={horiz,vert,horiz50,none}");
 
 	/* deltaCChalf */
 	mo->deltacchalf = gtk_check_button_new_with_label("Reject bad patterns according to ΔCC½");
 	gtk_box_pack_start(GTK_BOX(box), GTK_WIDGET(mo->deltacchalf),
 	                   FALSE, FALSE, 0);
+	gtk_widget_set_tooltip_text(mo->deltacchalf, "--no-deltacchalf");
 
 	/* Detector saturation value */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -233,6 +241,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->max_adu),
 	                   FALSE, FALSE, 0);
 	check_on_toggle(mo->use_max_adu, mo);
+	gtk_widget_set_tooltip_text(hbox, "--max-adu");
 
 	/* Minimum measurements */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -245,6 +254,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	gtk_entry_set_width_chars(GTK_ENTRY(mo->min_measurements), 6);
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->min_measurements),
 	                   FALSE, FALSE, 0);
+	gtk_widget_set_tooltip_text(hbox, "--min-measurements");
 
 	/* Custom split */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -258,6 +268,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->custom_split_file),
 	                   FALSE, FALSE, 0);
 	check_on_toggle(mo->custom_split, mo);
+	gtk_widget_set_tooltip_text(hbox, "--custom-split");
 
 	/* Minimum pattern resolution */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -274,6 +285,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(label),
 	                   FALSE, FALSE, 0);
 	check_on_toggle(mo->min_res, mo);
+	gtk_widget_set_tooltip_text(hbox, "--min-res");
 
 	/* push-res */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -291,6 +303,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(label),
 	                   FALSE, FALSE, 0);
 	check_on_toggle(mo->limit_res, mo);
+	gtk_widget_set_tooltip_text(hbox, "--push-res");
 
 	/* Detwin */
 	hbox = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 8);
@@ -303,6 +316,7 @@ static GtkWidget *merge_parameters(CrystFELMergeOpts *mo)
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(mo->detwin_sym),
 	                   FALSE, FALSE, 0);
 	check_on_toggle(mo->detwin, mo);
+	gtk_widget_set_tooltip_text(hbox, "-w");
 
 	check_greyout(NULL, mo);
 
diff --git a/src/gui_ambi.c b/src/gui_ambi.c
index 00f2ffe0..4403c999 100644
--- a/src/gui_ambi.c
+++ b/src/gui_ambi.c
@@ -202,6 +202,7 @@ static GtkWidget *make_ambigator_options(struct ambi_window *win)
 	                   FALSE, FALSE, 4.0);
 	crystfel_symmetry_selector_set_group_symbol(CRYSTFEL_SYMMETRY_SELECTOR(win->sym),
 	                                            proj->ambi_params.sym);
+	gtk_widget_set_tooltip_text(hbox, "-y / --symmetry");
 
 	hbox = gtk_hbox_new(FALSE, 0.0);
 	gtk_box_pack_start(GTK_BOX(vbox), GTK_WIDGET(hbox),
@@ -216,6 +217,7 @@ static GtkWidget *make_ambigator_options(struct ambi_window *win)
 	                                            proj->ambi_params.source_sym);
 	g_signal_connect(G_OBJECT(win->use_source_sym), "toggled",
 	                 G_CALLBACK(i_maybe_disable), win->source_sym);
+	gtk_widget_set_tooltip_text(hbox, "-w");
 
 	hbox = gtk_hbox_new(FALSE, 0.0);
 	gtk_box_pack_start(GTK_BOX(vbox), GTK_WIDGET(hbox),
@@ -232,6 +234,7 @@ static GtkWidget *make_ambigator_options(struct ambi_window *win)
 	                   FALSE, FALSE, 4.0);
 	g_signal_connect(G_OBJECT(win->use_operator), "toggled",
 	                 G_CALLBACK(i_maybe_disable), win->operator);
+	gtk_widget_set_tooltip_text(hbox, "--operator");
 
 	if ( proj->ambi_params.use_operator ) {
 		gtk_widget_set_sensitive(win->source_sym, FALSE);
@@ -254,6 +257,7 @@ static GtkWidget *make_ambigator_options(struct ambi_window *win)
 	gtk_entry_set_text(GTK_ENTRY(win->min_res), tmp);
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(win->min_res),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(win->min_res, "--lowres");
 	label = gtk_label_new("to");
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(label),
 	                   FALSE, FALSE, 4.0);
@@ -263,6 +267,7 @@ static GtkWidget *make_ambigator_options(struct ambi_window *win)
 	gtk_entry_set_text(GTK_ENTRY(win->max_res), tmp);
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(win->max_res),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(win->max_res, "--highres");
 	label = gtk_label_new("Å");
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(label),
 	                   FALSE, FALSE, 4.0);
@@ -289,6 +294,7 @@ static GtkWidget *make_ambigator_options(struct ambi_window *win)
 	                 G_CALLBACK(i_maybe_disable), win->ncorr);
 	set_active(win->use_ncorr, proj->ambi_params.use_ncorr);
 	gtk_widget_set_sensitive(win->ncorr, proj->ambi_params.use_ncorr);
+	gtk_widget_set_tooltip_text(hbox, "--ncorr");
 
 	hbox = gtk_hbox_new(FALSE, 0.0);
 	gtk_box_pack_start(GTK_BOX(vbox), GTK_WIDGET(hbox),
@@ -296,6 +302,7 @@ static GtkWidget *make_ambigator_options(struct ambi_window *win)
 	label = gtk_label_new("Number of iterations:");
 	gtk_box_pack_start(GTK_BOX(hbox), GTK_WIDGET(label),
 	                   FALSE, FALSE, 4.0);
+	gtk_widget_set_tooltip_text(hbox, "--iterations");
 	win->niter = gtk_entry_new();
 	gtk_entry_set_width_chars(GTK_ENTRY(win->niter), 2);
 	snprintf(tmp, 64, "%i", proj->ambi_params.niter);