Include a Other Software section in Help file

[geeqie.git] / src / ui_utildlg.h

diff --git a/src/ui_utildlg.h b/src/ui_utildlg.h
index 192017e..ec8c4b7 100644 (file)
--- a/src/ui_utildlg.h
+++ b/src/ui_utildlg.h
@@ -1,13 +1,22 @@
 /*
- * (SLIK) SimpLIstic sKin functions
- * (C) 2004 John Ellis
- * Copyright (C) 2008 - 2010 The Geeqie Team
+ * Copyright (C) 2004 John Ellis
+ * Copyright (C) 2008 - 2016 The Geeqie Team
  *
  * Author: John Ellis
  *
- * This software is released under the GNU General Public License (GNU GPL).
- * Please read the included file COPYING for more information.
- * This software comes with no warranty of any kind, use at your own risk!
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
 #ifndef UI_UTILDLG_H
@@ -19,10 +28,10 @@
 typedef struct _GenericDialog GenericDialog;
 struct _GenericDialog
 {
-       GtkWidget *dialog;      /* window */
-       GtkWidget *vbox;        /* place to add widgets */
+       GtkWidget *dialog;      /**< window */
+       GtkWidget *vbox;        /**< place to add widgets */
 
-       GtkWidget *hbox;        /* button hbox */
+       GtkWidget *hbox;        /**< button hbox */
 
        gboolean auto_close;
 
@@ -30,8 +39,8 @@ struct _GenericDialog
        void (*cancel_cb)(GenericDialog *, gpointer);
        gpointer data;
 
-       /* private */
-       GtkWidget *cancel_button;
+       GtkWidget *cancel_button; /**< private */
+
 };
 
 typedef struct _FileDialog FileDialog;
@@ -50,7 +59,10 @@ struct _FileDialog
 };
 
 
-/* When parent is not NULL, the dialog is set as a transient of the window containing parent */
+/**
+ * @headerfile generic_dialog_new
+ * When parent is not NULL, the dialog is set as a transient of the window containing parent
+ */
 GenericDialog *generic_dialog_new(const gchar *title,
                                  const gchar *role,
                                  GtkWidget *parent, gboolean auto_close,
@@ -62,7 +74,7 @@ GtkWidget *generic_dialog_add_button(GenericDialog *gd, const gchar *stock_id, c
 void generic_dialog_attach_default(GenericDialog *gd, GtkWidget *widget);
 
 GtkWidget *generic_dialog_add_message(GenericDialog *gd, const gchar *icon_stock_id,
-                                     const gchar *heading, const gchar *text);
+                                     const gchar *heading, const gchar *text, gboolean expand);
 
 gboolean generic_dialog_get_alternative_button_order(GtkWidget *widget);
 
@@ -78,10 +90,12 @@ void file_dialog_close(FileDialog *fd);
 GtkWidget *file_dialog_add_button(FileDialog *fd, const gchar *stock_id, const gchar *text,
                                  void (*func_cb)(FileDialog *, gpointer), gboolean is_default);
 
-/* default_path is default base directory, and is only used if no history
- *  exists for history_key (HOME is used if default_path is NULL).
+/**
+ * @headerfile file_dialog_add_path_widgets
+ * default_path is default base directory, and is only used if no history
+ * exists for history_key (HOME is used if default_path is NULL).
  * path can be a full path or only a file name. If name only, appended to
- *  the default_path or the last history (see default_path)
+ * the default_path or the last history (see default_path)
  */
 void file_dialog_add_path_widgets(FileDialog *fd, const gchar *default_path, const gchar *path,
                                  const gchar *history_key, const gchar *filter, const gchar *filter_desc);
@@ -90,6 +104,7 @@ void file_dialog_add_filter(FileDialog *fd, const gchar *filter, const gchar *fi
 void file_dialog_clear_filter(FileDialog *fd);
 void file_dialog_sync_history(FileDialog *fd, gboolean dir_only);
 
-
+void generic_dialog_windows_load_config(const gchar **window_attributes, const gchar **attribute_values);
+void generic_dialog_windows_write_config(GString *outstr, gint indent);
 #endif
 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */