diff --git a/src/dialogs.c b/src/dialogs.c
index 90c66110..4fd06ee7 100644
--- a/src/dialogs.c
+++ b/src/dialogs.c
@@ -1035,8 +1035,9 @@ static void on_dialog_input(const gchar *str)
 /** Asks the user for text input.
  * @param title Dialog title.
  * @param parent The currently focused window, usually @c geany->main_widgets->window.
- * @param label_text Input label text.
- * @param default_text Text to display in the input.
+ * 	@c NULL can be used but is discouraged due to window manager effects.
+ * @param label_text Label text, or @c NULL.
+ * @param default_text Text to display in the input field, or @c NULL.
  * @return New copy of user input or @c NULL if cancelled.
  * @since 0.20. */
 gchar *dialogs_show_input(const gchar *title, GtkWindow *parent, const gchar *label_text,