SF.net SVN: geany:[5419] trunk/src/dialogs.c

[ntrel at users.sourceforge.net]

Revision: 5419
          http://geany.svn.sourceforge.net/geany/?rev=5419&view=rev
Author:   ntrel
Date:     2010-11-18 18:53:12 +0000 (Thu, 18 Nov 2010)

Log Message:
-----------
Improve dialogs_show_input() documentation.

Modified Paths:
--------------
    trunk/src/dialogs.c

Modified: trunk/src/dialogs.c
===================================================================
--- trunk/src/dialogs.c	2010-11-18 18:27:01 UTC (rev 5418)
+++ trunk/src/dialogs.c	2010-11-18 18:53:12 UTC (rev 5419)
@@ -1035,8 +1035,9 @@
 /** 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,


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.