20293N/A--- zenity-2.30.0/help/C/zenity.xml.orig 2011-05-12 10:02:52.494961299 +0100
20293N/A+++ zenity-2.30.0/help/C/zenity.xml 2011-05-12 10:03:15.863829676 +0100
20293N/A+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
20293N/A+ <application>Zenity</application> enables you to create the following types of simple dialog:
20293N/A- When you write scripts, you can use &app; to create simple dialogs that interact graphically with the user, as follows:
20293N/A+ When you write scripts, you can use <application>Zenity</application> to create simple dialogs that interact graphically with the user, as follows:
20293N/A- When the user closes the dialog, &app; prints the text produced by the dialog to standard output.
20293N/A+ When the user closes the dialog, <application>Zenity</application> prints the text produced by the dialog to standard output.
20293N/A- When you write &app; commands, ensure that you place quotation marks around each argument.
20293N/A+ When you write <application>Zenity</application> commands, ensure that you place quotation marks around each argument.
20293N/A For example, use: <screen><userinput><command>zenity --calendar --title="Holiday Planner"</command></userinput></screen> Do not use: <screen><userinput><command>zenity --calendar --title=Holiday Planner</command></userinput></screen>
20293N/A An access key is a key that enables you to perform an action from the keyboard rather than use the mouse to choose a command from a menu or dialog. Each access key is identified by an underlined letter on a menu or dialog option.
20293N/A- Some &app; dialogs support the use of access keys. To specify the character to use as the access key, place an underscore before that character in the text of the dialog. The following example shows how to specify the letter 'C' as the access key:
20293N/A+ Some <application>Zenity</application> dialogs support the use of access keys. To specify the character to use as the access key, place an underscore before that character in the text of the dialog. The following example shows how to specify the letter 'C' as the access key:
20293N/A- <para>Displays the <guilabel>About &appname;</guilabel> dialog, which contains &app; version information, copyright information, and developer information.</para>
20293N/A+ <para>Displays the <guilabel>About Zenity</guilabel> dialog, which contains <application>Zenity</application> version information, copyright information, and developer information.</para>
20293N/A- &app; supports the standard GTK+ options. For more information about the GTK+ options, execute the <command>zenity -?</command> command.
20293N/A+ <application>Zenity</application> supports the standard GTK+ options. For more information about the GTK+ options, execute the <command>zenity -?</command> command.
20293N/A+ Normally, <application>Zenity</application> detects the terminal window from which it was launched
20293N/A- Use the <option>--calendar</option> option to create a calendar dialog. &app; returns the selected date to standard output. If no date is specified on the command line, the dialog uses the current date.
20293N/A+ Use the <option>--calendar</option> option to create a calendar dialog. <application>Zenity</application> returns the selected date to standard output. If no date is specified on the command line, the dialog uses the current date.
20293N/A <imagedata fileref="figures/zenity-calendar-screenshot.png" format="PNG"/>
20293N/A- Use the <option>--file-selection</option> option to create a file selection dialog. &app; returns the selected files or directories to standard
20293N/A+ Use the <option>--file-selection</option> option to create a file selection dialog. <application>Zenity</application> returns the selected files or directories to standard
20293N/A <imagedata fileref="figures/zenity-fileselection-screenshot.png" format="PNG"/>
20293N/A <imagedata fileref="figures/zenity-notification-screenshot.png" format="PNG"/>
20293N/A- Use the <option>--list</option> option to create a list dialog. &app; returns the entries in the first column of text of selected rows to standard output.
20293N/A+ Use the <option>--list</option> option to create a list dialog. <application>Zenity</application> returns the entries in the first column of text of selected rows to standard output.
20293N/A <imagedata fileref="figures/zenity-list-screenshot.png" format="PNG"/>
20293N/A <imagedata fileref="figures/zenity-error-screenshot.png" format="PNG"/>
20293N/A <imagedata fileref="figures/zenity-information-screenshot.png" format="PNG"/>
20293N/A <imagedata fileref="figures/zenity-question-screenshot.png" format="PNG"/>
20293N/A <imagedata fileref="figures/zenity-warning-screenshot.png" format="PNG"/>
20293N/A- &app; reads data from standard input line by line. If a line is prefixed with #, the text is updated with the text on that line. If a line contains only a number, the percentage is updated with that number.
20293N/A+ <application>Zenity</application> reads data from standard input line by line. If a line is prefixed with #, the text is updated with the text on that line. If a line contains only a number, the percentage is updated with that number.
20293N/A <imagedata fileref="figures/zenity-progress-screenshot.png" format="PNG"/>
20841N/A- Use the <option>--entry</option> option to create a text entry dialog. &app; returns the contents of the text entry to standard output.
20841N/A+ Use the <option>--entry</option> option to create a text entry dialog. <application>Zenity</application> returns the contents of the text entry to standard output.
20293N/A <imagedata fileref="figures/zenity-entry-screenshot.png" format="PNG"/>
20293N/A- --editable 2>/tmp/tmp.txt;;
20293N/A+ --editable 2>/tmp/tmp.txt;;
20293N/A <imagedata fileref="figures/zenity-text-screenshot.png" format="PNG"/>
