[gthumb] updated the write-to-disc manual section and added a help button

[Michael J. Chudobiak <mjc src gnome org>]

commit a8df2c88f289278375b368783d9a4a751b3e6f65
Author: Michael J. Chudobiak <mjc avtechpulse com>
Date:   Thu Jun 24 08:16:09 2010 -0400

    updated the write-to-disc manual section and added a help button

 extensions/burn_disc/gth-burn-task.c |   62 ++++++++++++++++++----------------
 help/C/gthumb.xml                    |   52 +++++++++-------------------
 2 files changed, 50 insertions(+), 64 deletions(-)
---
diff --git a/extensions/burn_disc/gth-burn-task.c b/extensions/burn_disc/gth-burn-task.c
index 91ef613..8ccb1bd 100644
--- a/extensions/burn_disc/gth-burn-task.c
+++ b/extensions/burn_disc/gth-burn-task.c
@@ -349,39 +349,42 @@ source_dialog_response_cb (GtkDialog   *dialog,
 			   int          response,
 			   GthBurnTask *task)
 {
-	gtk_widget_hide (task->priv->dialog);
-	gth_task_dialog (GTH_TASK (task), FALSE, NULL);
-
-	if (response == GTK_RESPONSE_OK) {
-		if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (_gtk_builder_get_widget (task->priv->builder, "selection_radiobutton")))) {
-			g_hash_table_replace (task->priv->content, g_file_get_uri (task->priv->location), g_list_reverse (task->priv->selected_files));
-			task->priv->selected_files = NULL;
-			burn_content_to_disc (task);
-		}
-		else {
-			gboolean recursive;
-
-			_g_object_list_unref (task->priv->selected_files);
-			task->priv->selected_files = NULL;
-
-			recursive = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (_gtk_builder_get_widget (task->priv->builder, "folder_recursive_radiobutton")));
-			task->priv->test = gth_main_get_general_filter ();
-			task->priv->file_source = gth_main_get_file_source (task->priv->location);
-			gth_file_source_for_each_child (task->priv->file_source,
-							task->priv->location,
-							recursive,
-							eel_gconf_get_boolean (PREF_FAST_FILE_TYPE, TRUE) ? GFILE_STANDARD_ATTRIBUTES_WITH_FAST_CONTENT_TYPE : GFILE_STANDARD_ATTRIBUTES_WITH_CONTENT_TYPE,
-							start_dir_func,
-							for_each_file_func,
-							done_func,
-							task);
+	if (response == GTK_RESPONSE_HELP) {
+		show_help_dialog (GTK_WINDOW (dialog), "gthumb-export-disk");
+	} else {	
+		gtk_widget_hide (task->priv->dialog);
+		gth_task_dialog (GTH_TASK (task), FALSE, NULL);
+
+		if (response == GTK_RESPONSE_OK) {
+			if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (_gtk_builder_get_widget (task->priv->builder, "selection_radiobutton")))) {
+				g_hash_table_replace (task->priv->content, g_file_get_uri (task->priv->location), g_list_reverse (task->priv->selected_files));
+				task->priv->selected_files = NULL;
+				burn_content_to_disc (task);
+			}
+			else {
+				gboolean recursive;
+
+				_g_object_list_unref (task->priv->selected_files);
+				task->priv->selected_files = NULL;
+
+				recursive = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (_gtk_builder_get_widget (task->priv->builder, "folder_recursive_radiobutton")));
+				task->priv->test = gth_main_get_general_filter ();
+				task->priv->file_source = gth_main_get_file_source (task->priv->location);
+				gth_file_source_for_each_child (task->priv->file_source,
+								task->priv->location,
+								recursive,
+								eel_gconf_get_boolean (PREF_FAST_FILE_TYPE, TRUE) ? GFILE_STANDARD_ATTRIBUTES_WITH_FAST_CONTENT_TYPE : GFILE_STANDARD_ATTRIBUTES_WITH_CONTENT_TYPE,
+								start_dir_func,
+								for_each_file_func,
+								done_func,
+								task);
+			}
 		}
+		else
+			gth_task_completed (GTH_TASK (task), NULL);
 	}
-	else
-		gth_task_completed (GTH_TASK (task), NULL);
 }
 
-
 static void
 gth_burn_task_exec (GthTask *base)
 {
@@ -391,6 +394,7 @@ gth_burn_task_exec (GthTask *base)
 	task->priv->dialog = gtk_dialog_new_with_buttons (_("Write to Disc"),
 							  GTK_WINDOW (task->priv->browser),
 							  GTK_DIALOG_NO_SEPARATOR,
+							  GTK_STOCK_HELP, GTK_RESPONSE_HELP,
 							  GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL,
 							  GTK_STOCK_OK, GTK_RESPONSE_OK,
 							  NULL);
diff --git a/help/C/gthumb.xml b/help/C/gthumb.xml
index 8c74f53..d0ee251 100644
--- a/help/C/gthumb.xml
+++ b/help/C/gthumb.xml
@@ -2039,7 +2039,23 @@
     <sect2 id="gthumb-export-disk">
       <title>Exporting To CD/DVD</title>
       <para>
-        To be documented.
+        To write a series of files to an optical disk (CD or DVD), or to create
+	an ISO disk image file, use the <menuchoice><guimenu>File
+        </guimenu><guimenu>Export To</guimenu><guimenuitem>Optical Disc</guimenuitem></menuchoice>
+	menu item.
+      </para>
+      <para>
+	You will be offered the choice of writing the currently selected files,
+	the entire current folder, or the entire current folder and its 
+	subfolders. Click <guibutton>OK</guibutton> when you have made
+	the appropriate selection.
+      </para>
+      <para>
+	The next dialog will select the destination disk, or the ISO file
+	to save. When you are ready to complete the process, click
+	<guibutton>Create Image</guibutton>. The optical disk writing
+	process will then commence, or the ISO file will be written,
+	completing the process.
       </para>
     </sect2>
 
@@ -2977,40 +2993,6 @@
          applications this checkbox should be enabled.
        </para>
     </sect2>
-    <sect2 id="gthumb-write-to-cd">
-      <title>To Write Images to a CD or DVD</title>
-       <para>To write a series of images to a CD or DVD, perform the following steps:
-       <orderedlist>
-        <listitem>
-          <para>Select the images you want to write to and choose
-            <menuchoice><guimenu>File</guimenu><guimenuitem>Write to CD
-            </guimenuitem></menuchoice>, &app; displays the
-            <guilabel>Write to CD</guilabel> dialog.
-          </para>
-        </listitem>
-        <listitem>
-          <para>Click on <guilabel>Current folder</guilabel> if you want to
-            write all of the images in the current folder and its subfolders.
-            Click on <guilabel>Selected images</guilabel> to write the current
-            selection only.
-          </para>
-        </listitem>
-        <listitem>
-          <para>Click on <guibutton>Ok</guibutton>. &app;, after preparing the
-            images for CD/DVD writing, displays the <filename>burn:///</filename>
-            location with <guilabel>Nautilus</guilabel>.
-          </para>
-        </listitem>
-        <listitem>
-          <para>Click on the <guilabel>Write to CD</guilabel> toolbar button or
-            choose
-            <menuchoice><guimenu>File</guimenu><guimenuitem>Write to CD
-            </guimenuitem></menuchoice>.  Images are written to the CD or DVD.
-          </para>
-        </listitem>
-       </orderedlist>
-      </para>
-    </sect2>
   </sect1>
   <sect1 id="scripts">
       <title>External Scripts and Hot Keys</title>