Add new notification icon. Update for new files. Restructure code a little

2004-09-13  Glynn Foster  <glynn.foster@sun.com>

	* data/Makefile.am, data/zenity-notification.png: Add new
	notification icon.
	* src/Makefile.am: Update for new files.
	* src/about.c, src/calendar.c, src/entry.c, src/fileselection.c,
	src/progress.c, src/text.c, src/tree.c, src/msg.c: Restructure code a
	little bit for new utility functions for setting window icons.
	* src/eggtrayicon.c, src/eggtrayicon.h: New files for notification area
	support.
	* src/main.c, src/notification.c, src/util.c, src/util.h, src/zenity.h:
	Add support for notification area.
	* data/zenity.1, help/*: Update docs for notification and new file
	selection changes.

3 files changed, 73 insertions, 2 deletions

diff --git a/help/C/figures/zenity-notification-screenshot.png b/help/C/figures/zenity-notification-screenshot.png
new file mode 100644
index 0000000..c1b2c9a
--- /dev/null
+++ b/help/C/figures/zenity-notification-screenshot.png
diff --git a/help/C/l10n_scripts/notification.sh b/help/C/l10n_scripts/notification.sh
new file mode 100755
index 0000000..b7de9ab
--- /dev/null
+++ b/help/C/l10n_scripts/notification.sh
@@ -0,0 +1,5 @@
+#!/bin/sh
+                                                                                                                                                             
+/gnome/head/cvs/zenity/src/zenity --notification \
+--window-icon="info" \
+--text="There are system updates necessary!"
diff --git a/help/C/zenity.xml b/help/C/zenity.xml
index 9d51f70..749a741 100644
--- a/help/C/zenity.xml
+++ b/help/C/zenity.xml
@@ -115,6 +115,7 @@
         <listitem><para>Calendar</para></listitem>
 	<listitem><para>File selection</para></listitem>
 	<listitem><para>List</para></listitem>
+	<listitem><para>Notification</para></listitem>
         <listitem><para>Message</para>
             <itemizedlist>
 	        <listitem><para>Error</para></listitem>
@@ -248,7 +249,10 @@
       <varlistentry>
         <term><option>--window-icon</option>=<replaceable>icon_path</replaceable></term>
 	<listitem>
-	  <para>Specifies the icon that is displayed in the window frame of the dialog.</para>
+	  <para>Specifies the icon that is displayed in the window frame of the dialog. There are
+	        4 stock icons also available by providing the following keywords - 'info', 'warning', 'question' and
+	        'error'.
+          </para>
 	</listitem>
       </varlistentry>
 
@@ -435,7 +439,8 @@
     <title>File Selection Dialog</title>
 
     <para>
-	Use the <option>--file-selection</option> option to create a file selection dialog. &app; returns the selected files or directories to standard error. 
+	Use the <option>--file-selection</option> option to create a file selection dialog. &app; returns the selected files or directories to standard 
+        error. The default mode of the file selection dialog is open.
     </para>
     <para>
 	The file selection dialog supports the following options:
@@ -458,6 +463,20 @@
       </varlistentry>
 
       <varlistentry>
+	<term><option>--directory</option></term>
+	<listitem>
+	  <para>Allows only selection of directories in the file selection dialog.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><option>--save</option></term>
+	<listitem>
+	  <para>Set the file selection dialog into save mode.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
 	<term><option>--separator</option>=<replaceable>separator</replaceable></term>
 	<listitem>
 	  <para>Specifies the string that is used to divide the returned list of filenames.</para>
@@ -501,6 +520,53 @@
 
   </sect1>
 
+<!-- ==== Notification Options ====== -->
+  <sect1 id="zenity-notification-options">
+    <title>Notification Icon</title>
+
+    <para>
+    </para>
+
+    <variablelist>
+
+      <varlistentry>
+        <term><option>--text</option>=<replaceable>text</replaceable></term>
+	<listitem>
+	  <para>Specifies the text that is displayed in the notification area.</para>
+	  </para>
+	</listitem>
+      </varlistentry>
+
+    </variablelist>
+
+    <para>
+      The following example script shows how to create a notification icon:
+      <programlisting>
+        #!/bin/sh
+
+        zenity --notification\
+          --window-icon="info" \
+          --text="There are system updates necessary!"
+      </programlisting>
+
+    </para>
+
+    <figure id="zenity-notification-screenshot">
+      <title>Notification Icon Example</title>
+      <screenshot>
+        <mediaobject>
+          <imageobject>
+              <imagedata fileref="figures/zenity-notification-screenshot.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+              <phrase>&app; notification icon example</phrase>
+          </textobject>
+        </mediaobject>
+      </screenshot>
+   </figure>
+													  
+  </sect1>
+
 <!-- ==== List Options ====== -->
 
   <sect1 id="zenity-list-options">