Clarify some of the documentation a little. Add in a few example scripts

2003-01-22  Glynn Foster  <glynn.foster@sun.com>

	* help/C/zenity.xml: Clarify some of the documentation a little. Add
	in a few example scripts and commandlines. I'm pretty useless at
	this though, since I don't know how to write scripts.

	* TODO: Update accordingly. Only 2 things left.
This commit is contained in:
Glynn Foster 2003-01-22 01:50:28 +00:00 committed by Glynn Foster
parent 6a9d71fea3
commit c0b858a53c
3 changed files with 167 additions and 23 deletions

View File

@ -1,3 +1,11 @@
2003-01-22 Glynn Foster <glynn.foster@sun.com>
* help/C/zenity.xml: Clarify some of the documentation a little. Add
in a few example scripts and commandlines. I'm pretty useless at
this though, since I don't know how to write scripts.
* TODO: Update accordingly. Only 2 things left.
2003-01-21 Mike Newman <mike@gtnorthern.demon.co.uk> 2003-01-21 Mike Newman <mike@gtnorthern.demon.co.uk>
* src/text.c: fix a bug where a textbuffer was only being * src/text.c: fix a bug where a textbuffer was only being

1
TODO
View File

@ -1,3 +1,2 @@
* Add some accessibility I guess * Add some accessibility I guess
* Remove extraneous cruft from configure.in * Remove extraneous cruft from configure.in
* Start writing help documentation

View File

@ -169,6 +169,19 @@
detailed in the individual dialog sections. detailed in the individual dialog sections.
</para> </para>
<para>
When using &app;, make sure that any arguments to the command line options are surrounded by
a set of quotes ' ' or " " as in <command>&app; --calendar --dialog-title="Holiday Planner"
</command>, for example. If you do not use quotes, then it is likely that you will get
unexpected results.
</para>
<para>
For some of the dialogs, &app; supports the use of keyboard mnemonics. This allows you to
use an '_' before the letter you want the mnemonic for, as in "_Please choose a name:", for
example.
</para>
<para> <para>
The following exit codes are observed by &app;: The following exit codes are observed by &app;:
</para> </para>
@ -242,8 +255,11 @@
<para> <para>
To create a Calendar dialog, use <command>--calendar</command>. &app; will return the To create a Calendar dialog, use <command>--calendar</command>. &app; will return the
date selected to standard error. The following list of options are also available for date selected to standard error. If the day, month and year are not specified at the
the Calendar dialog: command line, &app; will pre-select the current date in the Calendar dialog.
</para>
<para>
The following list of options are available for the Calendar dialog:
</para> </para>
<variablelist> <variablelist>
@ -306,7 +322,19 @@
</screenshot> </screenshot>
</figure> </figure>
<!-- FIXME: Add an example of a script -->
<para>
The following script shows an example of how to use the Calendar dialog:
<programlisting>
#!/bin/sh
if zenity --calendar --dialog-title="Calendar selection" --text="Select a date from below" --day=18 --month=1 --year=2003
then echo $?
else echo "No date selected"
fi
</programlisting>
</para>
</sect1> </sect1>
@ -317,8 +345,10 @@
<para> <para>
To create a Text Entry dialog, use <command>--text-entry</command>. &app; returns the To create a Text Entry dialog, use <command>--text-entry</command>. &app; returns the
contents of the text entry to standard error. The following list of options are also contents of the text entry to standard error.
available for the Text Entry dialog: </para>
<para>
The following list of options are available for the Text Entry dialog:
</para> </para>
<variablelist> <variablelist>
@ -360,7 +390,18 @@
</screenshot> </screenshot>
</figure> </figure>
<!-- FIXME: Add an example of a script --> <para>
The following script shows an example of how to use the Calendar dialog:
<programlisting>
#!/bin/sh
if zenity --entry --dialog-title="Add a new entry" --text="Enter your _Password" --hide-text
then echo $?
else echo "No password entered"
fi
</programlisting>
</para>
</sect1> </sect1>
@ -373,8 +414,10 @@
There are 4 types of message dialogs in &app; - Error, Informational, Question and Warning. To There are 4 types of message dialogs in &app; - Error, Informational, Question and Warning. To
create an Error dialog, use <command>--error</command>. To create an Informational dialog, use create an Error dialog, use <command>--error</command>. To create an Informational dialog, use
<command>--info</command>. To create a Question dialog, use <command>--question</command>. To <command>--info</command>. To create a Question dialog, use <command>--question</command>. To
create a Warning dialog, use <command>--question</command>. The following list of options is create a Warning dialog, use <command>--question</command>.
available for the message dialogs. </para>
<para>
The following list of options are available for the message dialogs.
</para> </para>
<variablelist> <variablelist>
@ -444,7 +487,19 @@
</screenshot> </screenshot>
</figure> </figure>
<!-- FIXME: Add an example of a script --> <para>
The following script shows an example of how to use the Warning message dialog:
<programlisting>
#!/bin/bash
FILE_TYPE=$(file -b $NAUTILUS_SCRIPT_SELECTED_FILE_PATHS|awk '{ print $1}')
if [ "$FILE_TYPE" != "PNG" ]; then
zenity --warning --text="Could not rotate image :" --hide-text
fi
</programlisting>
</para>
</sect1> </sect1>
@ -455,8 +510,10 @@
<para> <para>
To create a File Selection dialog, use <command>--file-selection</command>. &app; returns To create a File Selection dialog, use <command>--file-selection</command>. &app; returns
the file or directory selected to standard error. The following list of options are also the file or directory selected to standard error.
available for the File Selection dialog: </para>
<para>
The following list of options are available for the File Selection dialog:
</para> </para>
<variablelist> <variablelist>
@ -484,7 +541,24 @@
</screenshot> </screenshot>
</figure> </figure>
<!-- FIXME: Add an example of a script --> <para>
The following script shows an example of how to use the File Selection dialog:
<programlisting>
#!/bin/sh
FILE=`zenity --file-selection --dialog-title="Select a file"'
case $? in
0)
echo "\"$FILE\" selected.";;
1)
echo "No file selected.";;
-1)
echo "No file selected.";;
esac
</programlisting>
</para>
</sect1> </sect1>
@ -497,8 +571,21 @@
To create a List dialog, use <command>--list</command>. &app; returns the entries of To create a List dialog, use <command>--list</command>. &app; returns the entries of
the first columns selected to standard error. If <command>--checklist</command> or the first columns selected to standard error. If <command>--checklist</command> or
<command>--radiolist</command> is used, then &app; will return the entries of the <command>--radiolist</command> is used, then &app; will return the entries of the
second columns selected to standard error. The following list of options are also second columns selected to standard error.
available for the File Selection dialog: </para>
<para>
</para>
With the List dialog, you must specify the number of columns to be displayed by
specifying the column headers. To fill data into this dialog, you may specify
entries column by column, row by row. If you are using a checklist or a radiolist
then your first pieces of data for each row must be either 'TRUE' or 'FALSE'. See
examples below for how to fill data into this dialog.
</para>
<para>
The following list of options are available for the List dialog:
</para> </para>
<variablelist> <variablelist>
@ -553,7 +640,17 @@
</screenshot> </screenshot>
</figure> </figure>
<!-- FIXME: Add an example of a script --> <para>
The following commandline shows an example of how to use the List dialog:
<programlisting>
zenity --list --dialog-title="Choose bugs you wish to view" \
--text="Select items from the list below." \
--column="Bug Number" --column="Severity" --column="Description" \
992383 Normal "GtkTreeView crashes on multiple selections" \
293823 High "GNOME Dictionary does not handle proxy" \
393823 Critical "Menu editing does not work in GNOME 2.0"
</programlisting>
</para>
</sect1> </sect1>
@ -563,8 +660,11 @@
<title>Progress</title> <title>Progress</title>
<para> <para>
To create a Progress dialog, use <command>--progress</command>. The following list To create a Progress dialog, use <command>--progress</command>.
of options are also available for the Progress dialog: </para>
<para>
The following list of options are available for the Progress dialog:
</para> </para>
<variablelist> <variablelist>
@ -607,7 +707,24 @@
</screenshot> </screenshot>
</figure> </figure>
<!-- FIXME: Add an example of a script --> <para>
The following script shows an example of how to use the Progress dialog:
<programlisting>
#!/bin/sh
(
echo "10" ; sleep 1
echo "20" ; sleep 1
echo "50" ; sleep 1
echo "75" ; sleep 1
echo "100" ; sleep 1
) |
zenity --progress --dialog-title="Update System Logs" --text="Updating mail logs..." --percentage=0
if [ "$?" = -1 ] ; then
zenity --error --text="Update cancelled."
fi
</programlisting>
</para>
</sect1> </sect1>
@ -617,8 +734,11 @@
<title>Text Information</title> <title>Text Information</title>
<para> <para>
To create a Text Information dialog, use <command>--text-info</command>. The following list To create a Text Information dialog, use <command>--text-info</command>.
of options are also available for the Text Information dialog: </para>
<para>
The following list of options are available for the Text Information dialog:
</para> </para>
<variablelist> <variablelist>
@ -633,7 +753,7 @@
<varlistentry> <varlistentry>
<term><varname>--editable</varname></term> <term><varname>--editable</varname></term>
<listitem> <listitem>
<para>Allow the displayed text to be edited and returned when the dialog is closed.</para> <para>Allow the displayed text to be edited and returned to standard error when the dialog is closed.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -653,7 +773,24 @@
</screenshot> </screenshot>
</figure> </figure>
<!-- FIXME: Add an example of a script --> <para>
The following script shows an example of how to use the Text Infomation dialog:
<programlisting>
#!/bin/sh
FILE=`zenity --file-selection --dialog-title="Select a file"'
case $? in
0)
zenity --text-info --dialog-title=$FILE --editable 2>/tmp/tmp.txt
1)
echo "No file selected.";;
-1)
echo "No file selected.";;
esac
</programlisting>
</para>
</sect1> </sect1>