From de248c7265f9f1ac55696ed42fcb829eead7ef1b Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Wed, 15 Jan 2003 10:28:19 +0000 Subject: First initial template of the help documents. Still have to write the main 2003-01-15 Glynn Foster * help/C/Makefile.am, help/C/legal.xml, help/C/zenity-C.omf, help/C/zenity.xml, help/Makefile.am: First initial template of the help documents. Still have to write the main bulk of it. --- help/C/Makefile.am | 7 ++++ help/C/legal.xml | 76 +++++++++++++++++++++++++++++++++++ help/C/zenity-C.omf | 37 +++++++++++++++++ help/C/zenity.xml | 113 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 233 insertions(+) create mode 100644 help/C/Makefile.am create mode 100644 help/C/legal.xml create mode 100644 help/C/zenity-C.omf create mode 100644 help/C/zenity.xml (limited to 'help/C') diff --git a/help/C/Makefile.am b/help/C/Makefile.am new file mode 100644 index 00000000..d935337a --- /dev/null +++ b/help/C/Makefile.am @@ -0,0 +1,7 @@ +figdir = figures +docname = zenity +lang = C +omffile = zenity-C.omf +entities = legal.xml +include $(top_srcdir)/xmldocs.make +dist-hook: app-dist-hook diff --git a/help/C/legal.xml b/help/C/legal.xml new file mode 100644 index 00000000..ac97e1de --- /dev/null +++ b/help/C/legal.xml @@ -0,0 +1,76 @@ + + + Permission is granted to copy, distribute and/or modify this + document under the terms of the GNU Free Documentation + License (GFDL), Version 1.1 or any later version published + by the Free Software Foundation with no Invariant Sections, + no Front-Cover Texts, and no Back-Cover Texts. You can find + a copy of the GFDL at this link or in the file COPYING-DOCS + distributed with this manual. + + This manual is part of a collection of GNOME manuals + distributed under the GFDL. If you want to distribute this + manual separately from the collection, you can do so by + adding a copy of the license to the manual, as described in + section 6 of the license. + + + + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any GNOME documentation, and the members of + the GNOME Documentation Project are made aware of those + trademarks, then the names are in capital letters or initial + capital letters. + + + + DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED + UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE + WITH THE FURTHER UNDERSTANDING THAT: + + + + DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, + WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR + IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES + THAT THE DOCUMENT OR MODIFIED VERSION OF THE + DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR + A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE + RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE + OF THE DOCUMENT OR MODIFIED VERSION OF THE + DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR + MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, + YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY + CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY + SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER + OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS + LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED + VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER + EXCEPT UNDER THIS DISCLAIMER; AND + + + + UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL + THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), + CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, + INITIAL WRITER, ANY CONTRIBUTOR, OR ANY + DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION + OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH + PARTIES, BE LIABLE TO ANY PERSON FOR ANY + DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR + CONSEQUENTIAL DAMAGES OF ANY CHARACTER + INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS + OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR + MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR + LOSSES ARISING OUT OF OR RELATING TO USE OF THE + DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, + EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF + THE POSSIBILITY OF SUCH DAMAGES. + + + + + + diff --git a/help/C/zenity-C.omf b/help/C/zenity-C.omf new file mode 100644 index 00000000..8b9e5776 --- /dev/null +++ b/help/C/zenity-C.omf @@ -0,0 +1,37 @@ + + + + + Glynn Foster + + + + Glynn Foster + + + + + + Zenity + + + + 2003-15-01 + + + + + + User manual for Zenity. + + + + + + + + diff --git a/help/C/zenity.xml b/help/C/zenity.xml new file mode 100644 index 00000000..d44e7e35 --- /dev/null +++ b/help/C/zenity.xml @@ -0,0 +1,113 @@ + + + + zenity"> +]> + + + +
+ + + Zenity Manual + + 2003 + Sun Microsystems + + + + + + GNOME Documentation Project + + + Version 1.0 of Zenity Manual + + + Feedback Information + + To report a bug or make a suggestion regarding this + application or this documentation, please see the + + GNOME Feedback Page + + + + + + + Glynn + Foster + + GNOME Documentation Project + + + + + + + 1.0 + &date; + + Glynn Foster + + GNOME Documentation Project + + + + + + + + + + + License + + 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, of (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. + + + A copy of the + GNU General Public License + is included as an appendix to the + GNOME Users Guide + . You may also obtain a copy of the + GNU General Public License + from the Free Software Foundation by visiting + + their Web site + + or by writing to +
Free Software Foundation, Inc. + 59 Temple Place - Suite 330 + Boston, + MA + 02111-1307 + USA +
+ + + +
-- cgit From 4115d4e1f57c572b4efa1d6d9c9fc8541284f1db Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Wed, 15 Jan 2003 11:12:33 +0000 Subject: Add series id. --- help/C/zenity-C.omf | 1 + 1 file changed, 1 insertion(+) (limited to 'help/C') diff --git a/help/C/zenity-C.omf b/help/C/zenity-C.omf index 8b9e5776..ecc28822 100644 --- a/help/C/zenity-C.omf +++ b/help/C/zenity-C.omf @@ -32,6 +32,7 @@ + -- cgit From dee9ebb40b9160ab83be741f4a8121ec15f5d65b Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sat, 18 Jan 2003 14:28:54 +0000 Subject: Update the docs a little. I have absolutely no clue how the doc people 2003-01-18 Glynn Foster * help/C/zenity.xml: Update the docs a little. I have absolutely no clue how the doc people don't get tired of this. --- help/C/zenity.xml | 176 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 176 insertions(+) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index d44e7e35..53e96f61 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -67,6 +67,182 @@ + + + + Introduction + + + &app; allows allows you to display simple dialogs from the + command line or from shell scripts. + + + + The following list of dialogs are available with &app;: + + + + + + --calendar + + Display a Calendar dialog + + + + + --entry + + Display a Text Entry dialog + + + + + --error + + Display an Error dialog + + + + + --info + + Display an Informational dialog + + + + + --file-selection + + Display a File Slection dialog + + + + + --list + + Display a List dialog + + + + + --progress + + Display a Progress dialog + + + + + --question + + Display a Question dialog + + + + + --text-info + + Display a Text Information dialog + + + + + --warning + + Display a Warning dialog + + + + + + + + + + General Options + + + Each dialog shares some general command line options. If these + are not provided, there are some default values that depend on + the type of dialog being displayed. + + + + The following list of general options are available: + + + + + + --title=TITLE + + Specify the title of a dialog + + + + + --window-icon=ICON_PATH + + Specify the icon that should appear in the window frame of the dialog + + + + + + + + License -- cgit From 18760d406d64f71f7ca6fec5a7a01978418fa8f5 Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sat, 18 Jan 2003 18:02:14 +0000 Subject: Only some examples and some screenshots and we're mostly done for a first 2003-01-18 Glynn Foster * help/C/zenity.xml: Only some examples and some screenshots and we're mostly done for a first draft. * src/calendar.c: Don't set the text if it's NULL. * src/main.c: Swap the order of the commandline dialogs so that we're alphabetical. * src/zenity.glade: Add some default strings. --- help/C/zenity.xml | 401 ++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 347 insertions(+), 54 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 53e96f61..95984acc 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -86,74 +86,118 @@ --calendar - Display a Calendar dialog + Display a Calendar dialog. --entry - Display a Text Entry dialog + Display a Text Entry dialog. - + --error - Display an Error dialog + Display an Error dialog. - + --info - Display an Informational dialog + Display an Informational dialog. --file-selection - Display a File Slection dialog + Display a File Selection dialog. --list - Display a List dialog + Display a List dialog. --progress - Display a Progress dialog + Display a Progress dialog. --question - Display a Question dialog + Display a Question dialog. --text-info - Display a Text Information dialog + Display a Text Information dialog. --warning - Display a Warning dialog + Display a Warning dialog. + + + + + + Basic Use + + + &app; can only be used to create relatively simple dialogs, but is especially useful + when used in scripts. When a user has completed an action requested of them, and the + dialog closes, &app; prints any text specific to the dialog to standard error and + an exit code is returned. Information about what text is printed to standard error will be + detailed in the individual dialog sections. + + + + The following exit codes are observed by &app;: + + + + + + 0 + + The user has pressed either 'OK' or 'Close'. + + + + + 1 + + The user has pressed either 'Cancel' or closed the dialog through the window functions. + + + + + -1 + + An unexpected error has occurred. + + + + + @@ -176,72 +220,321 @@ --title=TITLE - Specify the title of a dialog + Specify the title of a dialog. --window-icon=ICON_PATH - Specify the icon that should appear in the window frame of the dialog + Specify the icon that should appear in the window frame of the dialog. + + + + + + + + + + + Calendar + + + To create a Calendar dialog, use --calendar. &app; will return the + date selected to standard error. The following list of options are also available for + the Calendar dialog: + + + + + + --text=TEXT + + Specify the text to appear in the Calendar dialog. + + + + + --day=DAY + + Specify the day to be pre-selected in the Calendar dialog. This must be a + number between 1 and 31. + + + + + + --month=MONTH + + Specify the day to be pre-selected in the Calendar dialog. This must be + a number between 1 and 12. + + + + + + --year=YEAR + + Specify the year to be pre-selected in the Calendar dialog. + + + + + --data-format=FORMAT + + Specify the format to be returned from the Calendar dialog after + the selection has been made. This defaults to a format depending + on your locale. The format must be of strftime + style eg. "%A %d/%m%y" + + + - -Calendar options - --text=STRING Set the dialog text - --day=INT Set the calendar day - --month=INT Set the calendar month - --year=INT Set the calendar year - --date-format=STRING Set the format for the returned date + + Text Entry -Text entry options - --text=STRING Set the dialog text - --entry-text=STRING Set the entry text - --hide-text Hide the entry text + + To create a Text Entry dialog, use --text-entry. &app; returns the + contents of the text entry to standard error. The following list of options are also + available for the Text Entry dialog: + -Info options - --text=STRING Set the dialog text + -Error options - --text=STRING Set the dialog text + + --text=TEXT + + Specify the text to appear in the Text Entry dialog. + + -File selection options - --filename=FILENAME Set the filename + + --entry-text=TEXT + + Specify the text to appear in the entry field of the Text Entry dialog. + + -List options - --column=STRING Set the column header - --checklist Use check boxes for first column - --radiolist Use radio buttons for first column - --separator=STRING Set output separator character + + --hide-text + + Specify that the text in the entry field of the Text Entry dialog be hidden. + + -Progress options - --text=STRING Set the dialog text - --percentage=INT Set initial percentage - --pulsate Pulsate progress bar + + + -Question options - --text=STRING Set the dialog text + -Text options - --filename=FILENAME Open file + + Messages -Warning options - --text=STRING Set the dialog text + + There are 4 types of message dialogs in &app; - Error, Informational, Question and Warning. To + create an Error dialog, use --error. To create an Informational dialog, use + --info. To create a Question dialog, use --question. To + create a Warning dialog, use --question. The following list of options is + available for the message dialogs. + -Miscellaneous options - --about About zenity - --version Print version + -Help options - -?, --help Show this help message - --usage Display brief usage message - ---> + + --text=TEXT + + Specify the text to appear in the message dialog. + + + + + + + + + + + + + File Selection + + + To create a File Selection dialog, use --file-selection. &app; returns + the file or directory selected to standard error. The following list of options are also + available for the File Selection dialog: + + + + + + --filename=FILENAME + + Specify the file or directory to be pre-selected in the File Selection dialog. + + + + + + + + + + + + + Lists + + + To create a List dialog, use --list. &app; returns the entries of + the first columns selected to standard error. If --checklist or + --radiolist is used, then &app; will return the entries of the + second columns selected to standard error. The following list of options are also + available for the File Selection dialog: + + + + + + --column=COLUMN + + Specify the column headers to appear in the List dialog. This option must be + called for each column that you want to appear in the dialog. + + + + + + --checklist + + Specify if the first column should contain check boxes in the List dialog. + + + + + + --radiolist + + Specify if the first column should contain radio boxes in the List dialog. + + + + + + --seperator=SEPERATOR + + Specify what seperator character should be used when the List dialog returns the selected entries. The + default character is '\'. If you want to specify a newline, use '\n'. + + + + + + + + + + + + + + Progress + + + To create a Progress dialog, use --progress. The following list + of options are also available for the Progress dialog: + + + + + + --text=TEXT + + Specify the text to appear in the Progress dialog. + + + + + --percentage=PERCENTAGE + + Specify the initial percentage that should be set in the Progress dialog. + + + + + --pulsate + + Specify if the Progress dialog should pulsate until an EOF character is read + from standard input. + + + + + + + + + + + + Text Information + + + To create a Text Information dialog, use --text-info. The following list + of options are also available for the Text Information dialog: + + + + + + --filename=FILENAME + + Specify the file to be loaded in the Text Information dialog. + + + + + + + + + + + + + Miscellaneous + + + The following list of options are also available for &app;: + + + + + + --about + + Display some information about &app;. + + + + + --version + + Print the version number of &app;. + + + + + + -- cgit From c41421c043ec92da0936ca8005f3e7841abd19cd Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sat, 18 Jan 2003 18:30:52 +0000 Subject: Add some screenshots for the help documentation. 2003-01-18 Glynn Foster * help/C/figures/zenity-calendar-screenshot.png, help/C/figures/zenity-entry-screenshot.png, help/C/figures/zenity-error-screenshot.png, help/C/figures/zenity-fileselection-screenshot.png, help/C/figures/zenity-information-screenshot.png, help/C/figures/zenity-list-screenshot.png, help/C/figures/zenity-progress-screenshot.png, help/C/figures/zenity-question-screenshot.png, help/C/figures/zenity-text-screenshot.png, help/C/figures/zenity-warning-screenshot.png: Add some screenshots for the help documentation. * src/entry.c, src/msg.c: Don't set the text if it's NULL. --- help/C/figures/zenity-calendar-screenshot.png | Bin 0 -> 16251 bytes help/C/figures/zenity-entry-screenshot.png | Bin 0 -> 6357 bytes help/C/figures/zenity-error-screenshot.png | Bin 0 -> 7214 bytes help/C/figures/zenity-fileselection-screenshot.png | Bin 0 -> 20965 bytes help/C/figures/zenity-information-screenshot.png | Bin 0 -> 8804 bytes help/C/figures/zenity-list-screenshot.png | Bin 0 -> 17694 bytes help/C/figures/zenity-progress-screenshot.png | Bin 0 -> 7280 bytes help/C/figures/zenity-question-screenshot.png | Bin 0 -> 10455 bytes help/C/figures/zenity-text-screenshot.png | Bin 0 -> 15419 bytes help/C/figures/zenity-warning-screenshot.png | Bin 0 -> 9222 bytes 10 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 help/C/figures/zenity-calendar-screenshot.png create mode 100644 help/C/figures/zenity-entry-screenshot.png create mode 100644 help/C/figures/zenity-error-screenshot.png create mode 100644 help/C/figures/zenity-fileselection-screenshot.png create mode 100644 help/C/figures/zenity-information-screenshot.png create mode 100644 help/C/figures/zenity-list-screenshot.png create mode 100644 help/C/figures/zenity-progress-screenshot.png create mode 100644 help/C/figures/zenity-question-screenshot.png create mode 100644 help/C/figures/zenity-text-screenshot.png create mode 100644 help/C/figures/zenity-warning-screenshot.png (limited to 'help/C') diff --git a/help/C/figures/zenity-calendar-screenshot.png b/help/C/figures/zenity-calendar-screenshot.png new file mode 100644 index 00000000..90589317 Binary files /dev/null and b/help/C/figures/zenity-calendar-screenshot.png differ diff --git a/help/C/figures/zenity-entry-screenshot.png b/help/C/figures/zenity-entry-screenshot.png new file mode 100644 index 00000000..27266649 Binary files /dev/null and b/help/C/figures/zenity-entry-screenshot.png differ diff --git a/help/C/figures/zenity-error-screenshot.png b/help/C/figures/zenity-error-screenshot.png new file mode 100644 index 00000000..36720d65 Binary files /dev/null and b/help/C/figures/zenity-error-screenshot.png differ diff --git a/help/C/figures/zenity-fileselection-screenshot.png b/help/C/figures/zenity-fileselection-screenshot.png new file mode 100644 index 00000000..6c0f47cc Binary files /dev/null and b/help/C/figures/zenity-fileselection-screenshot.png differ diff --git a/help/C/figures/zenity-information-screenshot.png b/help/C/figures/zenity-information-screenshot.png new file mode 100644 index 00000000..3dad60d6 Binary files /dev/null and b/help/C/figures/zenity-information-screenshot.png differ diff --git a/help/C/figures/zenity-list-screenshot.png b/help/C/figures/zenity-list-screenshot.png new file mode 100644 index 00000000..7f368243 Binary files /dev/null and b/help/C/figures/zenity-list-screenshot.png differ diff --git a/help/C/figures/zenity-progress-screenshot.png b/help/C/figures/zenity-progress-screenshot.png new file mode 100644 index 00000000..56ba2a37 Binary files /dev/null and b/help/C/figures/zenity-progress-screenshot.png differ diff --git a/help/C/figures/zenity-question-screenshot.png b/help/C/figures/zenity-question-screenshot.png new file mode 100644 index 00000000..1ed334d0 Binary files /dev/null and b/help/C/figures/zenity-question-screenshot.png differ diff --git a/help/C/figures/zenity-text-screenshot.png b/help/C/figures/zenity-text-screenshot.png new file mode 100644 index 00000000..4efee26a Binary files /dev/null and b/help/C/figures/zenity-text-screenshot.png differ diff --git a/help/C/figures/zenity-warning-screenshot.png b/help/C/figures/zenity-warning-screenshot.png new file mode 100644 index 00000000..fe6ffce9 Binary files /dev/null and b/help/C/figures/zenity-warning-screenshot.png differ -- cgit From 0d0c6bb6fa49c8cab55f5909614cede9331d79ae Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sat, 18 Jan 2003 19:04:26 +0000 Subject: Add in references to the screenshots. 2003-01-18 Glynn Foster * help/C/zenity.xml: Add in references to the screenshots. --- help/C/zenity.xml | 154 +++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 148 insertions(+), 6 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 95984acc..f84b3bc4 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -292,7 +292,21 @@ - +
+ Calendar dialog example + + + + + + + &app; Calendar dialog example + + + +
+ + @@ -332,6 +346,22 @@ +
+ Text Entry dialog example + + + + + + + &app; Text Entry dialog example + + + +
+ + + @@ -358,7 +388,63 @@ - +
+ Error dialog example + + + + + + + &app; Error dialog example + + + +
+ +
+ Informational dialog example + + + + + + + &app; Informational dialog example + + + +
+ +
+ Question dialog example + + + + + + + &app; Question dialog example + + + +
+ +
+ Warning dialog example + + + + + + + &app; Warning dialog example + + + +
+ + @@ -384,7 +470,21 @@ - +
+ File Selection dialog example + + + + + + + &app; File Selection dialog example + + + +
+ + @@ -439,7 +539,21 @@ - +
+ List Selection dialog example + + + + + + + &app; List dialog example + + + +
+ + @@ -478,7 +592,21 @@ - +
+ Progress dialog example + + + + + + + &app; Progress dialog example + + + +
+ + @@ -503,7 +631,21 @@ - +
+ Text Information dialog example + + + + + + + &app; Text Information dialog example + + + +
+ + -- cgit From 6d06f132d36a531885ae5fbe38be30c08ba4360c Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sat, 18 Jan 2003 19:19:20 +0000 Subject: Enable help documentation in the build. 2003-01-18 Glynn Foster * Makefile.am, configure.in, omf.make, xmldocs.make: Enable help documentation in the build. * help/C/zenity-C.omf, help/C/zenity.xml: Fix up silly errors. --- help/C/zenity-C.omf | 4 ++-- help/C/zenity.xml | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity-C.omf b/help/C/zenity-C.omf index ecc28822..a36c5180 100644 --- a/help/C/zenity-C.omf +++ b/help/C/zenity-C.omf @@ -2,11 +2,11 @@ - Glynn Foster + Glynn Foster <glynn.foster@sun.com> - Glynn Foster + Glynn Foster <glynn.foster@sun.com> + + + The following script shows an example of how to use the Calendar dialog: + + + #!/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 + + @@ -317,8 +345,10 @@ To create a Text Entry dialog, use --text-entry. &app; returns the - contents of the text entry to standard error. The following list of options are also - available for the Text Entry dialog: + contents of the text entry to standard error. + + + The following list of options are available for the Text Entry dialog: @@ -360,7 +390,18 @@ - + + The following script shows an example of how to use the Calendar dialog: + + + #!/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 + + @@ -373,8 +414,10 @@ There are 4 types of message dialogs in &app; - Error, Informational, Question and Warning. To create an Error dialog, use --error. To create an Informational dialog, use --info. To create a Question dialog, use --question. To - create a Warning dialog, use --question. The following list of options is - available for the message dialogs. + create a Warning dialog, use --question. + + + The following list of options are available for the message dialogs. @@ -444,7 +487,19 @@ - + + The following script shows an example of how to use the Warning message dialog: + + + #!/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 + + @@ -455,8 +510,10 @@ To create a File Selection dialog, use --file-selection. &app; returns - the file or directory selected to standard error. The following list of options are also - available for the File Selection dialog: + the file or directory selected to standard error. + + + The following list of options are available for the File Selection dialog: @@ -484,7 +541,24 @@ - + + The following script shows an example of how to use the File Selection dialog: + + + #!/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 + + @@ -497,8 +571,21 @@ To create a List dialog, use --list. &app; returns the entries of the first columns selected to standard error. If --checklist or --radiolist is used, then &app; will return the entries of the - second columns selected to standard error. The following list of options are also - available for the File Selection dialog: + second columns selected to standard error. + + + + + + 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. + + + + The following list of options are available for the List dialog: @@ -553,7 +640,17 @@ - + + The following commandline shows an example of how to use the List dialog: + + 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" + + @@ -563,8 +660,11 @@ Progress - To create a Progress dialog, use --progress. The following list - of options are also available for the Progress dialog: + To create a Progress dialog, use --progress. + + + + The following list of options are available for the Progress dialog: @@ -607,7 +707,24 @@ - + + The following script shows an example of how to use the Progress dialog: + + #!/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 + + @@ -617,8 +734,11 @@ Text Information - To create a Text Information dialog, use --text-info. The following list - of options are also available for the Text Information dialog: + To create a Text Information dialog, use --text-info. + + + + The following list of options are available for the Text Information dialog: @@ -633,7 +753,7 @@ --editable - Allow the displayed text to be edited and returned when the dialog is closed. + Allow the displayed text to be edited and returned to standard error when the dialog is closed. @@ -653,7 +773,24 @@ - + + The following script shows an example of how to use the Text Infomation dialog: + + #!/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 + + -- cgit From 78e286b17b6a8a4b4888acd625eb6112d7c11ded Mon Sep 17 00:00:00 2001 From: John Fleck Date: Fri, 24 Jan 2003 03:38:04 +0000 Subject: help/C/zenity.xml fixing tag mixup that made the docbook not valid 2003-01-23 John Fleck * help/C/zenity.xml fixing tag mixup that made the docbook not valid --- help/C/zenity.xml | 1 - 1 file changed, 1 deletion(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 591024bd..473c4aa4 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -576,7 +576,6 @@ - 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 -- cgit From 65daf49dc53cd37478602083790236c6d6cd8884 Mon Sep 17 00:00:00 2001 From: John Fleck Date: Fri, 24 Jan 2003 14:01:00 +0000 Subject: John Fleck John Fleck * help/C/zenity.xml fix typo --- help/C/zenity.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 473c4aa4..1d49f9b6 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -391,7 +391,7 @@ - The following script shows an example of how to use the Calendar dialog: + The following script shows an example of how to use the Text Entry dialog: #!/bin/sh -- cgit From b7bdcc563d1dd3eea1214fe12a74705a4e4ea823 Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sat, 1 Feb 2003 12:17:32 +0000 Subject: Update the docs for new --editable option in the List dialog. 2003-02-01 Glynn Foster * help/C/zenity.xml: Update the docs for new --editable option in the List dialog. --- help/C/zenity.xml | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 1d49f9b6..8e58e69f 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -614,6 +614,14 @@ + + --editable + + Allow the displayed items to be edited. + + + + --seperator=SEPERATOR -- cgit From 51b02f8b1d02128f5aba62b23ef2c1e94bee706b Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Mon, 5 May 2003 22:38:54 +0000 Subject: Update docs for new commandline options. 2003-05-05 Glynn Foster * help/C/zenity.xml: Update docs for new commandline options. --- help/C/zenity.xml | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 8e58e69f..4503a722 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -244,6 +244,20 @@ + + --width=WIDTH + + Specify the width of the dialog. + + + + + --height=HEIGHT + + Specify the height of the dialog. + + + @@ -580,7 +594,9 @@ 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. + examples below for how to fill data into this dialog. The List dialog may also be + filled by providing data from standard input, column by column, row by row, each + seperated by a newline. -- cgit From 70ea28f34c25cc21bac51286b7e2c767a2df5807 Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Mon, 19 May 2003 18:24:41 +0000 Subject: Make the progress dialog actually work and now uses g_io_channel. Woot! 2003-05-19 Glynn Foster * src/progress.c: Make the progress dialog actually work and now uses g_io_channel. Woot! Need to be able to cancel the dialog, which currently doesn't work too well. * TODO: Update. * help/C/zenity.xml: Update help documentation. --- help/C/zenity.xml | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 4503a722..6d6257ab 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -596,7 +596,8 @@ 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. The List dialog may also be filled by providing data from standard input, column by column, row by row, each - seperated by a newline. + seperated by a newline, however the column headers must appear with the + --column option. @@ -683,7 +684,9 @@ Progress - To create a Progress dialog, use --progress. + To create a Progress dialog, use --progress. Zenity reads data from + standard input line by line, determining whether it should update the text (if the + line is prefixed with a '#') or the percentage (if the line is a digit). @@ -736,12 +739,16 @@ #!/bin/sh ( echo "10" ; sleep 1 + echo "# Updating mail logs" ; sleep 1 echo "20" ; sleep 1 + echo "# Resetting cron jobs" ; sleep 1 echo "50" ; sleep 1 + echo "This line will just be ignored" ; sleep 1 echo "75" ; sleep 1 + echo "# Rebooting system" ; sleep 1 echo "100" ; sleep 1 ) | - zenity --progress --dialog-title="Update System Logs" --text="Updating mail logs..." --percentage=0 + zenity --progress --dialog-title="Update System Logs" --text="Scanning mail logs..." --percentage=0 if [ "$?" = -1 ] ; then zenity --error --text="Update cancelled." -- cgit From 1acd9cfed892c8a277199912d099f7c5ff7a94ca Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sat, 24 May 2003 01:36:24 +0000 Subject: Patch from Dagmar d'Surreal to correct help docs 2003-05-24 Glynn Foster * help/C/zenity.xml: Patch from Dagmar d'Surreal to correct help docs and script examples for the change from --dialog-title to --title. * THANKS, src/about.c: Add Dagmar. * src/progress.c: For now, just send a SIGHUP to the parent process - not entirely sure if this is the best thing to do right now. --- help/C/zenity.xml | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 6d6257ab..e7c9bfb7 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -171,7 +171,7 @@ When using &app;, make sure that any arguments to the command line options are surrounded by - a set of quotes ' ' or " " as in &app; --calendar --dialog-title="Holiday Planner" + a set of quotes ' ' or " " as in &app; --calendar --title="Holiday Planner" , for example. If you do not use quotes, then it is likely that you will get unexpected results. @@ -343,7 +343,7 @@ #!/bin/sh - if zenity --calendar --dialog-title="Calendar selection" --text="Select a date from below" --day=18 --month=1 --year=2003 + if zenity --calendar --title="Calendar selection" --text="Select a date from below" --day=18 --month=1 --year=2003 then echo $? else echo "No date selected" fi @@ -410,7 +410,7 @@ #!/bin/sh - if zenity --entry --dialog-title="Add a new entry" --text="Enter your _Password" --hide-text + if zenity --entry --title="Add a new entry" --text="Enter your _Password" --hide-text then echo $? else echo "No password entered" fi @@ -561,7 +561,7 @@ #!/bin/sh - FILE=`zenity --file-selection --dialog-title="Select a file"' + FILE=`zenity --file-selection --title="Select a file"' case $? in 0) @@ -667,7 +667,7 @@ The following commandline shows an example of how to use the List dialog: - zenity --list --dialog-title="Choose bugs you wish to view" \ + zenity --list --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" \ @@ -748,7 +748,7 @@ echo "# Rebooting system" ; sleep 1 echo "100" ; sleep 1 ) | - zenity --progress --dialog-title="Update System Logs" --text="Scanning mail logs..." --percentage=0 + zenity --progress --title="Update System Logs" --text="Scanning mail logs..." --percentage=0 if [ "$?" = -1 ] ; then zenity --error --text="Update cancelled." @@ -808,11 +808,11 @@ #!/bin/sh - FILE=`zenity --file-selection --dialog-title="Select a file"' + FILE=`zenity --file-selection --title="Select a file"' case $? in 0) - zenity --text-info --dialog-title=$FILE --editable 2>/tmp/tmp.txt + zenity --text-info --title=$FILE --editable 2>/tmp/tmp.txt 1) echo "No file selected.";; -- cgit From 626d95b752159fdcec1e7c08271f3eaca1113ab7 Mon Sep 17 00:00:00 2001 From: Mike Newman Date: Tue, 3 Jun 2003 21:52:16 +0000 Subject: Add --auto-close option to progress dialog. Closes dialog when 100% has been reached. Also update docs for new option. Fixes #114125. --- help/C/zenity.xml | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index e7c9bfb7..37e0fa24 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -709,6 +709,13 @@ + + --auto-close + + Closes the progress dialog when 100% has been reached. + + + --pulsate -- cgit From 0e4c879656dcb3a0f4ffbcc65e30b6120f65c05e Mon Sep 17 00:00:00 2001 From: Mike Newman Date: Mon, 9 Jun 2003 18:57:01 +0000 Subject: Allow multiple file selections. --- help/C/zenity.xml | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 37e0fa24..358fb813 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -539,6 +539,21 @@ + + --multiple + + Allow selection of mulitple filename in the File Selection dialog. + + + + + --separator=SEPARATOR + + Specify the character(s) which will divide between entries in the returned list of file names. The + default character is '|'. If you want to specify a newline, use '\n'. + + +
@@ -642,8 +657,8 @@ --seperator=SEPERATOR - Specify what seperator character should be used when the List dialog returns the selected entries. The - default character is '\'. If you want to specify a newline, use '\n'. + Specify what seperator character(s) should be used when the List dialog returns the selected entries. The + default character is '|'. If you want to specify a newline, use '\n'. -- cgit From 751d9a7bec8467c4fe4e596be51825fc27a5dfea Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Mon, 1 Sep 2003 08:27:59 +0000 Subject: Documentation updates from Nicholas Curran. Add Nicholas. 2003-09-01 Glynn Foster * help/C/zenity.xml: Documentation updates from Nicholas Curran. * THANKS, src/about.c: Add Nicholas. --- help/C/zenity.xml | 649 +++++++++++++++++++++++++++--------------------------- 1 file changed, 319 insertions(+), 330 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 358fb813..3d7bc75a 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -3,7 +3,7 @@ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ - zenity"> + Zenity"> ]> @@ -49,6 +49,13 @@ GNOME Documentation Project + + Nicholas + Curran + + GNOME Documentation Project + + @@ -73,87 +80,49 @@ Introduction - &app; allows allows you to display simple dialogs from the - command line or from shell scripts. + &app; displays simple GNOME dialogs. - The following list of dialogs are available with &app;: + &app; can display the following dialogs: - - - - --calendar - - Display a Calendar dialog. - - - - - --entry - - Display a Text Entry dialog. - - - - - --error - - Display an Error dialog. - - - - - --info - - Display an Informational dialog. - - - - - --file-selection - - Display a File Selection dialog. - - - - - --list - - Display a List dialog. - - - - - --progress - - Display a Progress dialog. - - - - - --question - - Display a Question dialog. - - - - - --text-info - - Display a Text Information dialog. - - - - - --warning - - Display a Warning dialog. - - - - + + + Calender dialog. + + + Text entry dialog. + + Various message dialogs including: + + + Error dialog. + + + Information dialog. + + + Question dialog. + + + Warning dialog. + + + + + File selection dialog. + + + List options dialog. + + + Progress dialog. + + + Text dialog. + + @@ -162,28 +131,34 @@ Basic Use - &app; can only be used to create relatively simple dialogs, but is especially useful - when used in scripts. When a user has completed an action requested of them, and the - dialog closes, &app; prints any text specific to the dialog to standard error and - an exit code is returned. Information about what text is printed to standard error will be - detailed in the individual dialog sections. + &app; creates simple dialogs. You can use &app; to create a script that + interacts graphically with the user. - + - When using &app;, make sure that any arguments to the command line options are surrounded by - a set of quotes ' ' or " " as in &app; --calendar --title="Holiday Planner" - , for example. If you do not use quotes, then it is likely that you will get - unexpected results. + When the user closes the dialog, + &app; prints text produced by the dialog to standard error. - 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. + Ensure that all arguments to &app; are surrounded by quotes. For example, use + zenity --calender --title="Holiday Planner" instead of + zenity --calender --title=Holiday Planner. + If you do not use quotes, you can get unexpected results. + + NOTE + + Some dialogs support the use of keyboard mnemonics. To specify the character to use as + the mnemonic, place an underscore before that character in the text of the dialog. For + example, to specify the 'P' as the keyboard mnemonic in the following sentence, use + "_Please choose a name". + + + - The following exit codes are observed by &app;: + &app; returns the following exit codes: @@ -219,13 +194,7 @@ General Options - Each dialog shares some general command line options. If these - are not provided, there are some default values that depend on - the type of dialog being displayed. - - - - The following list of general options are available: + All dialogs have the following general options: @@ -233,28 +202,28 @@ --title=TITLE - Specify the title of a dialog. + Specifies the title of a dialog. --window-icon=ICON_PATH - Specify the icon that should appear in the window frame of the dialog. + Specifies the icon that should appear in the window frame of the dialog. --width=WIDTH - Specify the width of the dialog. + Specifies the width of the dialog. --height=HEIGHT - Specify the height of the dialog. + Specifies the height of the dialog. @@ -265,15 +234,15 @@ - Calendar + Calendar Dialog - To create a Calendar dialog, use --calendar. &app; will return the - date selected to standard error. If the day, month and year are not specified at the - command line, &app; will pre-select the current date in the Calendar dialog. + Use --calender to create a Calender dialog. &app; returns the + date selected to standad error. The current date will be used by the dialog if + no date is given on the command line. - The following list of options are available for the Calendar dialog: + The Calender dialog has the following options: @@ -281,15 +250,15 @@ --text=TEXT - Specify the text to appear in the Calendar dialog. + Specifies the text to appear in the Calendar dialog. --day=DAY - Specify the day to be pre-selected in the Calendar dialog. This must be a - number between 1 and 31. + Specifies the day to be pre-selected in the Calendar dialog. The day + ust be a number between 1 and 31. @@ -297,7 +266,7 @@ --month=MONTH - Specify the day to be pre-selected in the Calendar dialog. This must be + Specifies the day to be pre-selected in the Calendar dialog. The day must be a number between 1 and 12. @@ -306,39 +275,25 @@ --year=YEAR - Specify the year to be pre-selected in the Calendar dialog. + Specifies the year to be pre-selected in the Calendar dialog. --date-format=FORMAT - Specify the format to be returned from the Calendar dialog after - the selection has been made. This defaults to a format depending + Specifies the format to be returned from the Calendar dialog after + the selection has been made. The default format depends on your locale. The format must be of strftime - style eg. "%A %d/%m%y" + style, for example "%A %d/%m%y". + -
- Calendar dialog example - - - - - - - &app; Calendar dialog example - - - -
- - - The following script shows an example of how to use the Calendar dialog: + The following script is an example of how to use the Calendar dialog: #!/bin/sh @@ -350,19 +305,34 @@ +
+ Calendar dialog example + + + + + + + &app; Calendar dialog example + + + +
+ - Text Entry + Text Entry Dialog - To create a Text Entry dialog, use --text-entry. &app; returns the + Use --text-entry to create a Text Entry dialog. + &app; returns the contents of the text entry to standard error. - The following list of options are available for the Text Entry dialog: + The Text Entry dialog has the following options: @@ -370,42 +340,28 @@ --text=TEXT - Specify the text to appear in the Text Entry dialog. + Specifies the text to appear in the Text Entry dialog. --entry-text=TEXT - Specify the text to appear in the entry field of the Text Entry dialog. + Specifies the text to appear in the entry field of the Text Entry dialog. --hide-text - Specify that the text in the entry field of the Text Entry dialog be hidden. + Specifies that the text in the entry field of the Text Entry dialog be hidden. -
- Text Entry dialog example - - - - - - - &app; Text Entry dialog example - - - -
- - The following script shows an example of how to use the Text Entry dialog: + The following script is an example of how to use the Text Entry dialog: #!/bin/sh @@ -417,92 +373,40 @@ - - - - - - Messages - - - There are 4 types of message dialogs in &app; - Error, Informational, Question and Warning. To - create an Error dialog, use --error. To create an Informational dialog, use - --info. To create a Question dialog, use --question. To - create a Warning dialog, use --question. - - - The following list of options are available for the message dialogs. - - - - - - --text=TEXT - - Specify the text to appear in the message dialog. - - - - - -
- Error dialog example - - - - - - - &app; Error dialog example - - - -
- -
- Informational dialog example +
+ Text Entry dialog example - + - &app; Informational dialog example + &app; Text Entry dialog example
+ -
- Question dialog example - - - - - - - &app; Question dialog example - - - -
+ -
- Warning dialog example - - - - - - - &app; Warning dialog example - - - -
+ + Message Dialogs - The following script shows an example of how to use the Warning message dialog: + &app; can create four types of message dialog. + Use the --text option to set the text shown in the + dialog. + + + Warning Dialog + + + Use --warning to create a Warning dialog. + + + + The following script is an example of how to use the Warning message dialog: #!/bin/bash @@ -513,21 +417,103 @@ zenity --warning --text="Could not rotate image :" --hide-text fi - + + +
+ Warning dialog example + + + + + + + &app; Warning dialog example + + + +
+ + + + Error Dialog + + + Use --error to create an Error dialog. + + +
+ Error dialog example + + + + + + + &app; Error dialog example + + + +
+ + + + Information Dialog + + + Use --info to create an Information dialog. + + +
+ Informational dialog example + + + + + + + &app; Informational dialog example + + + +
+ + + + Question Dialog + + + Use --question to create a Question dialog. + + +
+ Question dialog example + + + + + + + &app; Question dialog example + + + +
+ - File Selection + File Selection Dialog - To create a File Selection dialog, use --file-selection. &app; returns - the file or directory selected to standard error. + Use --file-selection to create a file selection + dialog. &app; returns + the files or directories selected to standard error. - The following list of options are available for the File Selection dialog: + The File Selection dialog has the following options: @@ -535,43 +521,29 @@ --filename=FILENAME - Specify the file or directory to be pre-selected in the File Selection dialog. + Specifies the file or directory to be selected in the File Selection dialog + when the dialog is first shown. --multiple - Allow selection of mulitple filename in the File Selection dialog. + Allows selection of multiple filenames in the File Selection dialog. --separator=SEPARATOR - Specify the character(s) which will divide between entries in the returned list of file names. The - default character is '|'. If you want to specify a newline, use '\n'. + Specifies the string used to divide the returned list of filenames. -
- File Selection dialog example - - - - - - - &app; File Selection dialog example - - - -
- - The following script shows an example of how to use the File Selection dialog: + The following script is an example of how to use the File Selection dialog: #!/bin/sh @@ -589,34 +561,45 @@ +
+ File Selection dialog example + + + + + + + &app; File Selection dialog example + + + +
+ - Lists + List Dialog - To create a List dialog, use --list. &app; returns the entries of - the first columns selected to standard error. If --checklist or - --radiolist is used, then &app; will return the entries of the - second columns selected to standard error. + Use --list to create a list dialog. &app; returns the entries in + the first column of text of selected rows to standard error. - - 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. The List dialog may also be - filled by providing data from standard input, column by column, row by row, each - seperated by a newline, however the column headers must appear with the - --column option. + Every column must be specified by the --column option. Data for + the dialog must specified column by column, row by row. Data can be provided to + the dialog through standard input. Each entry must be separated by a newline. - The following list of options are available for the List dialog: + If you use the --checklist or --radiolist + options, each row must start with either 'TRUE' or 'FALSE'. + + + + The List dialog has the following options: @@ -624,8 +607,9 @@ --column=COLUMN - Specify the column headers to appear in the List dialog. This option must be - called for each column that you want to appear in the dialog. + Specifies the column headers to appear in the List dialog. + You must call the --column option for + each column you want to appear in the dialog. @@ -633,7 +617,7 @@ --checklist - Specify if the first column should contain check boxes in the List dialog. + Specifies that the first column should contain check boxes in the List dialog. @@ -641,7 +625,7 @@ --radiolist - Specify if the first column should contain radio boxes in the List dialog. + Specifies that the first column should contain radio boxes in the List dialog. @@ -649,7 +633,7 @@ --editable - Allow the displayed items to be edited. + Allows the displayed items to be edited. @@ -657,14 +641,25 @@ --seperator=SEPERATOR - Specify what seperator character(s) should be used when the List dialog returns the selected entries. The - default character is '|'. If you want to specify a newline, use '\n'. + Specifies what string should be used when the List dialog returns the selected entries. + + The following commandline is an example of how to use the List dialog: + + zenity --list --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" + + +
List Selection dialog example @@ -679,33 +674,26 @@
- - The following commandline shows an example of how to use the List dialog: - - zenity --list --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" - - - - Progress + Progress Dialog - To create a Progress dialog, use --progress. Zenity reads data from - standard input line by line, determining whether it should update the text (if the - line is prefixed with a '#') or the percentage (if the line is a digit). + Use --progress to create a Progress dialog. + + + + &app; reads data from + standard input line by line. If a line is prefixed with a hash (#), the text is + updated with the text on that line. If a line contains only a number, the percentage + is updated with that number. - The following list of options are available for the Progress dialog: + The Progress dialog has the following options: @@ -713,14 +701,14 @@ --text=TEXT - Specify the text to appear in the Progress dialog. + Specifies the text to appear in the Progress dialog. --percentage=PERCENTAGE - Specify the initial percentage that should be set in the Progress dialog. + Specifies the initial percentage that should be set in the Progress dialog. @@ -734,29 +722,15 @@ --pulsate - Specify if the Progress dialog should pulsate until an EOF character is read + Specifies that the Progress dialog should pulsate until an EOF character is read from standard input. -
- Progress dialog example - - - - - - - &app; Progress dialog example - - - -
- - The following script shows an example of how to use the Progress dialog: + The following script is an example of how to use the Progress dialog: #!/bin/sh ( @@ -778,19 +752,33 @@ +
+ Progress dialog example + + + + + + + &app; Progress dialog example + + + +
+ - Text Information + Text Information Dialog - To create a Text Information dialog, use --text-info. + Use --text-info to create a Text Information dialog. - The following list of options are available for the Text Information dialog: + The Text Information dialog has the following options: @@ -798,35 +786,22 @@ --filename=FILENAME - Specify the file to be loaded in the Text Information dialog. + Specifies a file to be loaded in the Text Information dialog. --editable - Allow the displayed text to be edited and returned to standard error when the dialog is closed. + Allows the displayed text to be edited. The edited text is + returned to standard error when the dialog is closed. -
- Text Information dialog example - - - - - - - &app; Text Information dialog example - - - -
- - The following script shows an example of how to use the Text Infomation dialog: + The following script is an example of how to use the Text Infomation dialog: #!/bin/sh @@ -844,15 +819,29 @@ +
+ Text Information dialog example + + + + + + + &app; Text Information dialog example + + + +
+ - Miscellaneous + Miscellaneous Options - The following list of options are also available for &app;: + &app; has the following miscellaneous options: @@ -860,14 +849,14 @@ --about - Display some information about &app;. + Displays some information about &app;. --version - Print the version number of &app;. + Prints the version number of &app;. -- cgit From 9cb4c22a664a5387a0641ef83960e04a6fa27074 Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Tue, 20 Apr 2004 10:24:37 +0000 Subject: Fix documentation for text-info as pointed out by the grand master of the 2004-04-20 Glynn Foster * help/C/zenity.xml: Fix documentation for text-info as pointed out by the grand master of the zenity man page, Ross Burton. --- help/C/zenity.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 3d7bc75a..3aae3ca7 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -809,7 +809,7 @@ case $? in 0) - zenity --text-info --title=$FILE --editable 2>/tmp/tmp.txt + zenity --text-info --title=$FILE --filename=$FILE --editable 2>/tmp/tmp.txt 1) echo "No file selected.";; -- cgit From 0b175e1c580a18f60716beb2736dc5a6753918cc Mon Sep 17 00:00:00 2001 From: Ross Burton Date: Tue, 20 Apr 2004 10:54:21 +0000 Subject: Fix a typo in the manual --- help/C/zenity.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 3aae3ca7..0c2b9af4 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -89,7 +89,7 @@ - Calender dialog. + Calendar dialog. Text entry dialog. @@ -142,8 +142,8 @@ Ensure that all arguments to &app; are surrounded by quotes. For example, use - zenity --calender --title="Holiday Planner" instead of - zenity --calender --title=Holiday Planner. + zenity --calendar --title="Holiday Planner" instead of + zenity --calendar --title=Holiday Planner. If you do not use quotes, you can get unexpected results. @@ -237,12 +237,12 @@ Calendar Dialog - Use --calender to create a Calender dialog. &app; returns the + Use --calendar to create a Calendar dialog. &app; returns the date selected to standad error. The current date will be used by the dialog if no date is given on the command line. - The Calender dialog has the following options: + The Calendar dialog has the following options: -- cgit From 02955ce70f7fa58da88dc8d66e07520afb94f642 Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Wed, 28 Apr 2004 12:06:02 +0000 Subject: Fix the list dialog not being able to handle --text to change the text. It 2004-04-29 Glynn Foster * src/main.c, src/tree.c: Fix the list dialog not being able to handle --text to change the text. It was also intentional but must have fallen through the gaps. * data/zenity.1: Update * help/C/zenity.xml: Update. --- help/C/zenity.xml | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 0c2b9af4..a28b7c79 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -604,6 +604,13 @@ + + --text=TEXT + + Specifies the text to appear in the List dialog. + + + --column=COLUMN -- cgit From aac104540028bb54df98436f718c96645b3a3bdd Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sun, 18 Jul 2004 23:45:59 +0000 Subject: Fix up documentation for correct usage of the Text Entry dialog. Patch 2004-07-19 Glynn Foster * help/C/zenity.xml, help/sr/zenity.xml: Fix up documentation for correct usage of the Text Entry dialog. Patch from Baptiste Mille-Mathias. Fixes #141513. --- help/C/zenity.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index a28b7c79..f65de69b 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -327,7 +327,7 @@ Text Entry Dialog - Use --text-entry to create a Text Entry dialog. + Use --entry to create a Text Entry dialog. &app; returns the contents of the text entry to standard error. -- cgit From ffaed088561e8c0a085fd2797543aaef65419f0c Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Mon, 19 Jul 2004 01:01:28 +0000 Subject: Add new option for --print-column, based on a patch by Paul Bolle. Fixes 2004-07-19 Glynn Foster * src/main.c, src/tree.c, src/zenity.h, help/C/zenity.xml: Add new option for --print-column, based on a patch by Paul Bolle. Fixes #144496. --- help/C/zenity.xml | 9 +++++++++ 1 file changed, 9 insertions(+) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index f65de69b..4dc745d6 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -653,6 +653,15 @@ + + --print-column=COLUMN + + Specifies what column should be printed to standard output. The default is to return + the first column. 'ALL' may be specified to print out all columns. + + + + -- cgit From 3a3a047a710700afd4fe6dde22f7f0f8eeae87bb Mon Sep 17 00:00:00 2001 From: Breda McColgan Date: Wed, 18 Aug 2004 18:10:27 +0000 Subject: help/C/zenity.xml help/C/zenity-C.omf 2004-08-18 Breda McColgan * Updated the following files: * help/C/zenity.xml * help/C/zenity-C.omf * help/C/figures/zenity-calendar-screenshot.png * help/C/figures/zenity-entry-screenshot.png * help/C/figures/zenity-error-screenshot.png * help/C/figures/zenity-fileselection-screenshot.png * help/C/figures/zenity-information-screenshot.png * help/C/figures/zenity-list-screenshot.png * help/C/figures/zenity-progress-screenshot.png * help/C/figures/zenity-question-screenshot.png * help/C/figures/zenity-text-screenshot.png * help/C/figures/zenity-warning-screenshot.png * Added the following files: * help/C/l10n.txt * help/C/l10n_scripts/ * help/C/l10n_scripts/calendar.sh * help/C/l10n_scripts/cvs.txt * help/C/l10n_scripts/error.sh * help/C/l10n_scripts/filesel.sh * help/C/l10n_scripts/info.sh * help/C/l10n_scripts/list.sh * help/C/l10n_scripts/progress.sh * help/C/l10n_scripts/question.sh * help/C/l10n_scripts/text_entry.sh * help/C/l10n_scripts/text_info.sh * help/C/l10n_scripts/warning.sh See the help/C/l10n.txt file for information about l10n_scripts. --- help/C/figures/zenity-calendar-screenshot.png | Bin 16251 -> 15151 bytes help/C/figures/zenity-entry-screenshot.png | Bin 6357 -> 8317 bytes help/C/figures/zenity-error-screenshot.png | Bin 7214 -> 8392 bytes help/C/figures/zenity-fileselection-screenshot.png | Bin 20965 -> 45662 bytes help/C/figures/zenity-information-screenshot.png | Bin 8804 -> 9087 bytes help/C/figures/zenity-list-screenshot.png | Bin 17694 -> 19794 bytes help/C/figures/zenity-progress-screenshot.png | Bin 7280 -> 9029 bytes help/C/figures/zenity-question-screenshot.png | Bin 10455 -> 10920 bytes help/C/figures/zenity-text-screenshot.png | Bin 15419 -> 16246 bytes help/C/figures/zenity-warning-screenshot.png | Bin 9222 -> 10818 bytes help/C/l10n.txt | 88 ++ help/C/l10n_scripts/calendar.sh | 10 + help/C/l10n_scripts/cvs.txt | 51 + help/C/l10n_scripts/error.sh | 4 + help/C/l10n_scripts/filesel.sh | 13 + help/C/l10n_scripts/info.sh | 4 + help/C/l10n_scripts/list.sh | 8 + help/C/l10n_scripts/progress.sh | 18 + help/C/l10n_scripts/question.sh | 4 + help/C/l10n_scripts/text_entry.sh | 11 + help/C/l10n_scripts/text_info.sh | 17 + help/C/l10n_scripts/warning.sh | 4 + help/C/zenity-C.omf | 26 +- help/C/zenity.xml | 1087 +++++++++++--------- 24 files changed, 821 insertions(+), 524 deletions(-) create mode 100755 help/C/l10n.txt create mode 100755 help/C/l10n_scripts/calendar.sh create mode 100755 help/C/l10n_scripts/cvs.txt create mode 100755 help/C/l10n_scripts/error.sh create mode 100755 help/C/l10n_scripts/filesel.sh create mode 100755 help/C/l10n_scripts/info.sh create mode 100755 help/C/l10n_scripts/list.sh create mode 100755 help/C/l10n_scripts/progress.sh create mode 100755 help/C/l10n_scripts/question.sh create mode 100755 help/C/l10n_scripts/text_entry.sh create mode 100755 help/C/l10n_scripts/text_info.sh create mode 100755 help/C/l10n_scripts/warning.sh (limited to 'help/C') diff --git a/help/C/figures/zenity-calendar-screenshot.png b/help/C/figures/zenity-calendar-screenshot.png index 90589317..5dc3be6e 100644 Binary files a/help/C/figures/zenity-calendar-screenshot.png and b/help/C/figures/zenity-calendar-screenshot.png differ diff --git a/help/C/figures/zenity-entry-screenshot.png b/help/C/figures/zenity-entry-screenshot.png index 27266649..39d2fb24 100644 Binary files a/help/C/figures/zenity-entry-screenshot.png and b/help/C/figures/zenity-entry-screenshot.png differ diff --git a/help/C/figures/zenity-error-screenshot.png b/help/C/figures/zenity-error-screenshot.png index 36720d65..d26e0298 100644 Binary files a/help/C/figures/zenity-error-screenshot.png and b/help/C/figures/zenity-error-screenshot.png differ diff --git a/help/C/figures/zenity-fileselection-screenshot.png b/help/C/figures/zenity-fileselection-screenshot.png index 6c0f47cc..cc0d1a7e 100644 Binary files a/help/C/figures/zenity-fileselection-screenshot.png and b/help/C/figures/zenity-fileselection-screenshot.png differ diff --git a/help/C/figures/zenity-information-screenshot.png b/help/C/figures/zenity-information-screenshot.png index 3dad60d6..abb898ed 100644 Binary files a/help/C/figures/zenity-information-screenshot.png and b/help/C/figures/zenity-information-screenshot.png differ diff --git a/help/C/figures/zenity-list-screenshot.png b/help/C/figures/zenity-list-screenshot.png index 7f368243..6abf517e 100644 Binary files a/help/C/figures/zenity-list-screenshot.png and b/help/C/figures/zenity-list-screenshot.png differ diff --git a/help/C/figures/zenity-progress-screenshot.png b/help/C/figures/zenity-progress-screenshot.png index 56ba2a37..cf01c5e5 100644 Binary files a/help/C/figures/zenity-progress-screenshot.png and b/help/C/figures/zenity-progress-screenshot.png differ diff --git a/help/C/figures/zenity-question-screenshot.png b/help/C/figures/zenity-question-screenshot.png index 1ed334d0..e5363971 100644 Binary files a/help/C/figures/zenity-question-screenshot.png and b/help/C/figures/zenity-question-screenshot.png differ diff --git a/help/C/figures/zenity-text-screenshot.png b/help/C/figures/zenity-text-screenshot.png index 4efee26a..686b6007 100644 Binary files a/help/C/figures/zenity-text-screenshot.png and b/help/C/figures/zenity-text-screenshot.png differ diff --git a/help/C/figures/zenity-warning-screenshot.png b/help/C/figures/zenity-warning-screenshot.png index fe6ffce9..57f33082 100644 Binary files a/help/C/figures/zenity-warning-screenshot.png and b/help/C/figures/zenity-warning-screenshot.png differ diff --git a/help/C/l10n.txt b/help/C/l10n.txt new file mode 100755 index 00000000..f03a73fe --- /dev/null +++ b/help/C/l10n.txt @@ -0,0 +1,88 @@ +Zenity Manual V2.0 + +------------------------ +SUMMARY OF CHANGES +------------------------ + +Created by: Breda McColgan +Date: July 2004 +Manual version: 2.0 + +------------------------ +SCREENSHOT INSTRUCTIONS +------------------------ + +To create the screenshots, perform the following steps: +1. Create a directory called /tmp/l10n_scripts. +2. Copy the scripts to the /tmp/l10n_scripts directory. +3. Edit the appropriate script (see below) + to replace the English text with the localised text, where applicable. +4. Ensure that all scripts are executable. + If necessary, run the following command: + chmod +x +5. Run the script from the /tmp/l10n_scripts directory, as follows: + cd /tmp/l10n_scripts + . ./ + + +zenity-calendar-screenshot.png +============================== + + = calendar.sh + + +zenity-entry-screenshot.png +=========================== + + = text_entry.sh + + + +zenity-error-screenshot.png +=========================== + + = error.sh + + +zenity-fileselection-screenshot.png +=================================== + + = file_sel.sh + + +zenity-information-screenshot.png +================================= + + = info.sh + + +zenity-list-screenshot.png +========================== + + = list.sh + + +zenity-progress-screenshot.png +============================== + + = progress.sh + + +zenity-question-screenshot.png +============================== + + = question.sh + + +zenity-text-screenshot.png +========================== + + = text_info.sh +Select cvs.txt from the File Selector dialog. +Resize the window so that only the text appears -- no blank space. + + +zenity-warning-screenshot.png +============================= + + = warning.sh diff --git a/help/C/l10n_scripts/calendar.sh b/help/C/l10n_scripts/calendar.sh new file mode 100755 index 00000000..cf0f45e3 --- /dev/null +++ b/help/C/l10n_scripts/calendar.sh @@ -0,0 +1,10 @@ +#!/bin/sh + + if zenity --calendar \ + --title="Select a Date" \ + --text="Click on a date to select that date." \ + --day=10 --month=8 --year=2004 + then echo $? + else echo "No date selected" + fi + diff --git a/help/C/l10n_scripts/cvs.txt b/help/C/l10n_scripts/cvs.txt new file mode 100755 index 00000000..f470f666 --- /dev/null +++ b/help/C/l10n_scripts/cvs.txt @@ -0,0 +1,51 @@ +Getting the most out of CVS in GNOME +==================================== + +Introductory Beginnings- + +Current Versions System, CVS, is a powerful +method of allowing many developers +to work on the same source code. It is used + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/help/C/l10n_scripts/error.sh b/help/C/l10n_scripts/error.sh new file mode 100755 index 00000000..7d93857f --- /dev/null +++ b/help/C/l10n_scripts/error.sh @@ -0,0 +1,4 @@ +#!/bin/bash + + zenity --error \ + --text="Could not find /var/log/syslog." diff --git a/help/C/l10n_scripts/filesel.sh b/help/C/l10n_scripts/filesel.sh new file mode 100755 index 00000000..e9abe1d3 --- /dev/null +++ b/help/C/l10n_scripts/filesel.sh @@ -0,0 +1,13 @@ +#!/bin/sh + +FILE=`zenity --file-selection --title="Select a File"` + +case $? in + 0) + echo "\"$FILE\" selected.";; + 1) + echo "No file selected.";; + -1) + echo "No file selected.";; +esac + diff --git a/help/C/l10n_scripts/info.sh b/help/C/l10n_scripts/info.sh new file mode 100755 index 00000000..2c19cfb1 --- /dev/null +++ b/help/C/l10n_scripts/info.sh @@ -0,0 +1,4 @@ +#!/bin/bash + + zenity --info \ + --text="Merge complete. Updated 3 of 10 files." diff --git a/help/C/l10n_scripts/list.sh b/help/C/l10n_scripts/list.sh new file mode 100755 index 00000000..cc8304d3 --- /dev/null +++ b/help/C/l10n_scripts/list.sh @@ -0,0 +1,8 @@ +#!/bin/sh + +zenity --list \ + --title="Choose the Bugs You Wish to View" \ + --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" diff --git a/help/C/l10n_scripts/progress.sh b/help/C/l10n_scripts/progress.sh new file mode 100755 index 00000000..225c90ab --- /dev/null +++ b/help/C/l10n_scripts/progress.sh @@ -0,0 +1,18 @@ +#!/bin/sh +( +echo "10" ; sleep 1 +echo "# Updating mail logs" ; sleep 1 +echo "20" ; sleep 1 +echo "# Resetting cron jobs" ; sleep 1 +echo "50" ; sleep 1 +echo "This line will just be ignored" ; sleep 1 +echo "75" ; sleep 1 +echo "# Rebooting system" ; sleep 1 +echo "100" ; sleep 1 +) | +zenity --progress --title="Update System Logs" --text="Scanning mail logs..." --percentage=0 + +if [ "$?" = -1 ] ; then + zenity --error --text="Update cancelled." +fi + diff --git a/help/C/l10n_scripts/question.sh b/help/C/l10n_scripts/question.sh new file mode 100755 index 00000000..6ed9374d --- /dev/null +++ b/help/C/l10n_scripts/question.sh @@ -0,0 +1,4 @@ +#!/bin/bash + + zenity --question \ + --text="Are you sure you wish to proceed?" diff --git a/help/C/l10n_scripts/text_entry.sh b/help/C/l10n_scripts/text_entry.sh new file mode 100755 index 00000000..4afd006e --- /dev/null +++ b/help/C/l10n_scripts/text_entry.sh @@ -0,0 +1,11 @@ +#!/bin/sh + + if zenity --entry \ + --title="Add an Entry" \ + --text="Enter your _password:" \ + --entry-text "password" \ + --hide-text + then echo $? + else echo "No password entered" + fi + diff --git a/help/C/l10n_scripts/text_info.sh b/help/C/l10n_scripts/text_info.sh new file mode 100755 index 00000000..711e51d8 --- /dev/null +++ b/help/C/l10n_scripts/text_info.sh @@ -0,0 +1,17 @@ +#!/bin/sh + +FILE=`zenity --file-selection \ + --title="Select a File"` + +case $? in + 0) + zenity --text-info \ + --title=$FILE \ + --filename=$FILE \ + --editable 2>/tmp/tmp.txt;; + 1) + echo "No file selected.";; + -1) + echo "No file selected.";; +esac + diff --git a/help/C/l10n_scripts/warning.sh b/help/C/l10n_scripts/warning.sh new file mode 100755 index 00000000..a39af9ac --- /dev/null +++ b/help/C/l10n_scripts/warning.sh @@ -0,0 +1,4 @@ +#!/bin/bash + + zenity --warning \ + --text="Disconnect the power cable to avoid electrical shock." diff --git a/help/C/zenity-C.omf b/help/C/zenity-C.omf index a36c5180..1c0c646a 100644 --- a/help/C/zenity-C.omf +++ b/help/C/zenity-C.omf @@ -2,33 +2,25 @@ - Glynn Foster <glynn.foster@sun.com> + Sun Java Desktop System Documentation Team - - Glynn Foster <glynn.foster@sun.com> + Sun Java Desktop System Documentation Team - - - Zenity - - 2003-15-01 + 2004-08-17 - - - + + - User manual for Zenity. + User manual for the Zenity desktop application. - + + user's guide + diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 4dc745d6..66c99a0d 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -1,9 +1,15 @@ - - Zenity"> + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ + + + + + + Zenity"> + + + ]> @@ -11,67 +17,89 @@
- Zenity Manual + &appname; + &appname; Desktop Application Manual V&manrevision; 2003 - Sun Microsystems + 2004 + &publisher; - GNOME Documentation Project + &publisher; - Version 1.0 of Zenity Manual + &legal; - - Feedback Information - - To report a bug or make a suggestion regarding this - application or this documentation, please see the - - GNOME Feedback Page - - - - - Glynn - Foster - - GNOME Documentation Project - - - - Nicholas - Curran - - GNOME Documentation Project - - + + &author1; + &author2; + &publisher; + + + Glynn + Foster + + GNOME Documentation Project + + + + Nicholas + Curran + + GNOME Documentation Project + + - - 1.0 - 18-01-2003 - - Glynn Foster - - GNOME Documentation Project - - - + + &appname; Desktop Application Manual V&manrevision; + &date; + + &author1; &author2; + &publisher; + + + + + Zenity Manual V1.0 + January 2003 + + Glynn Foster + GNOME Documentation Project + + + + This manual describes version &appversion; of &appname;. + + + + Feedback + + To send feedback, follow the directions in the Feedback Page. + + + + + + zenity command + + + dialog creator + @@ -80,212 +108,286 @@ Introduction - &app; displays simple GNOME dialogs. - - - - &app; can display the following dialogs: + &app; enables you to create the following types of simple dialog: - - Calendar dialog. - - - Text entry dialog. - - Various message dialogs including: + Calendar + File selection + List + Message - - Error dialog. - - - Information dialog. - - - Question dialog. - - - Warning dialog. - + Error + Information + Question + Warning - - File selection dialog. - - - List options dialog. - - - Progress dialog. - - - Text dialog. - + Progress + Text entry + Text information - - - Basic Use + + + + Usage - &app; creates simple dialogs. You can use &app; to create a script that - interacts graphically with the user. - - - - When the user closes the dialog, - &app; prints text produced by the dialog to standard error. + When you write scripts, you can use &app; to create simple dialogs that interact graphically with the user, as follows: - + + + + You can create a dialog to obtain information from the user. For example, you can prompt the user to select a date from a calendar dialog, or to select a file from a file selection dialog. + + + + + You can create a dialog to provide the user with information. For example, you can use a progress dialog to indicate the current status of an operation, or use a warning message dialog to alert the user. + + + - Ensure that all arguments to &app; are surrounded by quotes. For example, use - zenity --calendar --title="Holiday Planner" instead of - zenity --calendar --title=Holiday Planner. - If you do not use quotes, you can get unexpected results. + When the user closes the dialog, &app; prints the text produced by the dialog to standard error. - NOTE + + When you write &app; commands, ensure that you place quotation marks around each argument. + + + For example, use: zenity --calendar --title="Holiday Planner" Do not use: zenity --calendar --title=Holiday Planner + + + If you do not use quotation marks, you might get unexpected results. + + + + + Access Keys - Some dialogs support the use of keyboard mnemonics. To specify the character to use as - the mnemonic, place an underscore before that character in the text of the dialog. For - example, to specify the 'P' as the keyboard mnemonic in the following sentence, use - "_Please choose a name". + 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. - + + 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: + + "_Choose a name". + + + Exit Codes &app; returns the following exit codes: + + + + + + + + Exit Code + + Description + + + + + + 0 + + + The user has pressed either OK or Close. + + + + + 1 + + + The user has either pressed Cancel, or used the window functions to close the dialog. + + + + + -1 + + + An unexpected error has occurred. + + + + + + + + + + + + + General Options + + + All &app; dialogs support the following general options: + + - 0 + =title - The user has pressed either 'OK' or 'Close'. + Specifies the title of a dialog. - + + + =icon_path + + Specifies the icon that is displayed in the window frame of the dialog. + + + - 1 + =width - The user has pressed either 'Cancel' or closed the dialog through the window functions. + Specifies the width of the dialog. - -1 + =height - An unexpected error has occurred. + Specifies the height of the dialog. - + - + - - General Options + + Help Options - All dialogs have the following general options: + &app; provides the following help options: - --title=TITLE + - Specifies the title of a dialog. + Displays help text. You can also use -? to specify this option. - --window-icon=ICON_PATH + - Specifies the icon that should appear in the window frame of the dialog. + Displays brief usage text. + + + + + + + + Miscellaneous Options + + + &app; also provides the following miscellaneous options: + + + + - --width=WIDTH + - Specifies the width of the dialog. + Displays the About &appname; dialog, which contains &app; version information, copyright information, and developer information. - --height=HEIGHT + - Specifies the height of the dialog. + Displays the version number of &app;. - + + + + + GTK+ Options + + + &app; supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity -? command. + + + + + Calendar Dialog - Use --calendar to create a Calendar dialog. &app; returns the - date selected to standad error. The current date will be used by the dialog if - no date is given on the command line. + Use the option to create a calendar dialog. &app; returns the selected date to standard error. If no date is specified on the command line, the dialog uses the current date. - The Calendar dialog has the following options: + The calendar dialog supports the following options: - --text=TEXT + =text - Specifies the text to appear in the Calendar dialog. + Specifies the text that is displayed in the calendar dialog. - --day=DAY + =day - Specifies the day to be pre-selected in the Calendar dialog. The day - ust be a number between 1 and 31. + Specifies the day that is selected in the calendar dialog. day must be a number between 1 and 31 inclusive. - --month=MONTH + =month - Specifies the day to be pre-selected in the Calendar dialog. The day must be - a number between 1 and 12. + Specifies the month that is selected in the calendar dialog. month must be a number between 1 and 12 inclusive. - --year=YEAR + =year - Specifies the year to be pre-selected in the Calendar dialog. + Specifies the year that is selected in the calendar dialog. - --date-format=FORMAT + =format - Specifies the format to be returned from the Calendar dialog after - the selection has been made. The default format depends - on your locale. The format must be of strftime - style, for example "%A %d/%m%y". + Specifies the format that is returned from the calendar dialog after date selection. The default format depends on your locale. format must be a format that is acceptable to the strftime function, for example %A %d/%m/%y. @@ -293,27 +395,32 @@ - The following script is an example of how to use the Calendar dialog: + The following example script shows how to create a calendar dialog: + + + #!/bin/sh + - - #!/bin/sh + if zenity --calendar \ + --title="Select a Date" \ + --text="Click on a date to select that date." \ + --day=10 --month=8 --year=2004 + then echo $? + else echo "No date selected" + fi + - if zenity --calendar --title="Calendar selection" --text="Select a date from below" --day=18 --month=1 --year=2003 - then echo $? - else echo "No date selected" - fi -
- Calendar dialog example + Calendar Dialog Example - &app; Calendar dialog example + &app; calendar dialog example @@ -321,71 +428,173 @@ - - - Text Entry Dialog + + + + File Selection Dialog - Use --entry to create a Text Entry dialog. - &app; returns the - contents of the text entry to standard error. - - - The Text Entry dialog has the following options: + Use the option to create a file selection dialog. &app; returns the selected files or directories to standard error. + + + The file selection dialog supports the following options: - --text=TEXT + =filename - Specifies the text to appear in the Text Entry dialog. + Specifies the file or directory that is selected in the file selection dialog when the dialog is first shown. - --entry-text=TEXT + - Specifies the text to appear in the entry field of the Text Entry dialog. + Allows the selection of multiple filenames in the file selection dialog. - --hide-text + =separator - Specifies that the text in the entry field of the Text Entry dialog be hidden. + Specifies the string that is used to divide the returned list of filenames. - The following script is an example of how to use the Text Entry dialog: + The following example script shows how to create a file selection dialog: + + + #!/bin/sh + + FILE=`zenity --file-selection --title="Select a File"` + + case $? in + 0) + echo "\"$FILE\" selected.";; + 1) + echo "No file selected.";; + -1) + echo "No file selected.";; + esac + + - - #!/bin/sh +
+ File Selection Dialog Example + + + + + + + &app; file selection dialog example + + + +
- if zenity --entry --title="Add a new entry" --text="Enter your _Password" --hide-text - then echo $? - else echo "No password entered" - fi - + + + + + + List Dialog + + + Use the option to create a list dialog. &app; returns the entries in the first column of text of selected rows to standard error. -
- Text Entry dialog example + + Data for the dialog must specified column by column, row by row. Data can be provided to the dialog through standard input. Each entry must be separated by a newline character. + + + + If you use the or options, each row must start with either 'TRUE' or 'FALSE'. + + + + The list dialog supports the following options: + + + + + + =column + + Specifies the column headers that are displayed in the list dialog. You must specify a option for each column that you want to display in the dialog. + + + + + + + + Specifies that the first column in the list dialog contains check boxes. + + + + + + + + Specifies that the first column in the list dialog contains radio boxes. + + + + + + + + Allows the displayed items to be edited. + + + + + + =separator + + Specifies what string is used when the list dialog returns the selected entries. + + + + + + + + The following example script shows how to create a list dialog: + + #!/bin/sh + + zenity --list \ + --title="Choose the Bugs You Wish to View" \ + --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" + + + + +
+ List Dialog Example - + - &app; Text Entry dialog example + &app; list dialog example
+ @@ -394,62 +603,55 @@ Message Dialogs - &app; can create four types of message dialog. - Use the --text option to set the text shown in the - dialog. + &app; can create four types of message dialog: - - Warning Dialog + + + Error + + + Information + + + Question + + + Warning + + + + +For each type, use the option to specify the text that is displayed in the dialog. + + + + Error Dialog - Use --warning to create a Warning dialog. + Use the option to create an error dialog. - The following script is an example of how to use the Warning message dialog: + The following example script shows how to create an error dialog: - - #!/bin/bash + + #!/bin/bash - FILE_TYPE=$(file -b $NAUTILUS_SCRIPT_SELECTED_FILE_PATHS|awk '{ print $1}') + zenity --error \ + --text="Could not find /var/log/syslog." + - if [ "$FILE_TYPE" != "PNG" ]; then - zenity --warning --text="Could not rotate image :" --hide-text - fi - - - -
- Warning dialog example - - - - - - - &app; Warning dialog example - - - -
- - - - Error Dialog - - - Use --error to create an Error dialog.
- Error dialog example + Error Dialog Example - &app; Error dialog example + &app; error dialog example @@ -460,18 +662,30 @@ Information Dialog - Use --info to create an Information dialog. + Use the option to create an information dialog. + + + + The following example script shows how to create an information dialog: + + + #!/bin/bash + + zenity --info \ + --text="Merge complete. Updated 3 of 10 files." + +
- Informational dialog example + Information Dialog Example - &app; Informational dialog example + &app; information dialog example @@ -482,209 +696,159 @@ Question Dialog - Use --question to create a Question dialog. + Use the option to create a question dialog. + + + + The following example script shows how to create a question dialog: + + + #!/bin/bash + + zenity --question \ + --text="Are you sure you wish to proceed?" + +
- Question dialog example + Question Dialog Example - &app; Question dialog example + &app; question dialog example
- - - - - - File Selection Dialog - - - Use --file-selection to create a file selection - dialog. &app; returns - the files or directories selected to standard error. - - - The File Selection dialog has the following options: - - - - - - --filename=FILENAME - - Specifies the file or directory to be selected in the File Selection dialog - when the dialog is first shown. - - + + Warning Dialog - - --multiple - - Allows selection of multiple filenames in the File Selection dialog. - - + + Use the option to create a warning dialog. + - - --separator=SEPARATOR - - Specifies the string used to divide the returned list of filenames. - - + + The following example script shows how to create a warning dialog: - + + #!/bin/bash + + zenity --warning \ + --text="Disconnect the power cable to avoid electrical shock." + - - The following script is an example of how to use the File Selection dialog: - - - #!/bin/sh - - FILE=`zenity --file-selection --title="Select a file"' - - case $? in - 0) - echo "\"$FILE\" selected.";; - 1) - echo "No file selected.";; - -1) - echo "No file selected.";; - esac - - + -
- File Selection dialog example - - - - - - - &app; File Selection dialog example - - - -
+
+ Warning Dialog Example + + + + + + + &app; warning dialog example + + + +
+ - - - - List Dialog + - - Use --list to create a list dialog. &app; returns the entries in - the first column of text of selected rows to standard error. - + + Progress Dialog - Every column must be specified by the --column option. Data for - the dialog must specified column by column, row by row. Data can be provided to - the dialog through standard input. Each entry must be separated by a newline. + Use the option to create a progress dialog. - If you use the --checklist or --radiolist - options, each row must start with either 'TRUE' or 'FALSE'. + &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. - + - The List dialog has the following options: + The progress dialog supports the following options: - --text=TEXT - - Specifies the text to appear in the List dialog. - - - - - --column=COLUMN + =text - Specifies the column headers to appear in the List dialog. - You must call the --column option for - each column you want to appear in the dialog. - + Specifies the text that is displayed in the progress dialog. - --checklist + =percentage - Specifies that the first column should contain check boxes in the List dialog. - + Specifies the initial percentage that is set in the progress dialog. - --radiolist + - Specifies that the first column should contain radio boxes in the List dialog. - - - - - - --editable - - Allows the displayed items to be edited. - - - - - - --seperator=SEPERATOR - - Specifies what string should be used when the List dialog returns the selected entries. - + Closes the progress dialog when 100% has been reached. - --print-column=COLUMN + - Specifies what column should be printed to standard output. The default is to return - the first column. 'ALL' may be specified to print out all columns. - + Specifies that the progress bar pulsates until an EOF character is read from standard input. - The following commandline is an example of how to use the List dialog: - - zenity --list --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" - + The following example script shows how to create a progress dialog: + + #!/bin/sh + ( + echo "10" ; sleep 1 + echo "# Updating mail logs" ; sleep 1 + echo "20" ; sleep 1 + echo "# Resetting cron jobs" ; sleep 1 + echo "50" ; sleep 1 + echo "This line will just be ignored" ; sleep 1 + echo "75" ; sleep 1 + echo "# Rebooting system" ; sleep 1 + echo "100" ; sleep 1 + ) | + zenity --progress \ + --title="Update System Logs" \ + --text="Scanning mail logs..." \ + --percentage=0 + + if [ "$?" = -1 ] ; then + zenity --error \ + --text="Update canceled." + fi + + + -
- List Selection dialog example +
+ Progress Dialog Example - + - &app; List dialog example + &app; progress dialog example @@ -692,96 +856,74 @@ - - - - Progress Dialog + - - Use --progress to create a Progress dialog. - + + Text Entry Dialog - &app; reads data from - standard input line by line. If a line is prefixed with a hash (#), the text is - updated with the text on that line. If a line contains only a number, the percentage - is updated with that number. - - - - The Progress dialog has the following options: + Use the option to create a text entry dialog. &app; returns the contents of the text entry to standard error. + + + The text entry dialog supports the following options: - --text=TEXT + =text - Specifies the text to appear in the Progress dialog. + Specifies the text that is displayed in the text entry dialog. - --percentage=PERCENTAGE + =text - Specifies the initial percentage that should be set in the Progress dialog. + Specifies the text that is displayed in the entry field of the text entry dialog. - --auto-close + - Closes the progress dialog when 100% has been reached. - - - - - --pulsate - - Specifies that the Progress dialog should pulsate until an EOF character is read - from standard input. + Hides the text in the entry field of the text entry dialog. - The following script is an example of how to use the Progress dialog: - - #!/bin/sh - ( - echo "10" ; sleep 1 - echo "# Updating mail logs" ; sleep 1 - echo "20" ; sleep 1 - echo "# Resetting cron jobs" ; sleep 1 - echo "50" ; sleep 1 - echo "This line will just be ignored" ; sleep 1 - echo "75" ; sleep 1 - echo "# Rebooting system" ; sleep 1 - echo "100" ; sleep 1 - ) | - zenity --progress --title="Update System Logs" --text="Scanning mail logs..." --percentage=0 - - if [ "$?" = -1 ] ; then - zenity --error --text="Update cancelled." - fi - + The following example script shows how to create a text entry dialog: + + + #!/bin/sh + + if zenity --entry \ + --title="Add an Entry" \ + --text="Enter your _password:" \ + --entry-text "password" \ + --hide-text + then echo $? + else echo "No password entered" + fi + + -
- Progress dialog example +
+ Text Entry Dialog Example - + - &app; Progress dialog example + &app; text entry dialog example
- @@ -790,60 +932,63 @@ Text Information Dialog - Use --text-info to create a Text Information dialog. + Use the option to create a text information dialog. - The Text Information dialog has the following options: + The text information dialog supports the following options: - --filename=FILENAME + =filename - Specifies a file to be loaded in the Text Information dialog. + Specifies a file that is loaded in the text information dialog. - --editable + - Allows the displayed text to be edited. The edited text is - returned to standard error when the dialog is closed. + Allows the displayed text to be edited. The edited text is returned to standard error when the dialog is closed. - The following script is an example of how to use the Text Infomation dialog: - - #!/bin/sh - - FILE=`zenity --file-selection --title="Select a file"' - - case $? in - 0) - zenity --text-info --title=$FILE --filename=$FILE --editable 2>/tmp/tmp.txt - - 1) - echo "No file selected.";; - -1) - echo "No file selected.";; - esac - + The following example script shows how to create a text information dialog: + + #!/bin/sh + + FILE=`zenity --file-selection \ + --title="Select a File"` + + case $? in + 0) + zenity --text-info \ + --title=$FILE \ + --filename=$FILE \ + --editable 2>/tmp/tmp.txt;; + 1) + echo "No file selected.";; + -1) + echo "No file selected.";; + esac + +
- Text Information dialog example + Text Information Dialog Example - &app; Text Information dialog example + &app; text information dialog example @@ -851,76 +996,4 @@ - - - - Miscellaneous Options - - - &app; has the following miscellaneous options: - - - - - - --about - - Displays some information about &app;. - - - - - --version - - Prints the version number of &app;. - - - - - - - - - - License - - 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, of (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. - - - A copy of the - GNU General Public License - is included as an appendix to the - GNOME Users Guide - . You may also obtain a copy of the - GNU General Public License - from the Free Software Foundation by visiting - - their Web site - - or by writing to -
Free Software Foundation, Inc. - 59 Temple Place - Suite 330 - Boston, - MA - 02111-1307 - USA -
- - -
-- cgit From e9f52ee103243408b11e8bb87a8cd2823debda48 Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sun, 22 Aug 2004 08:32:02 +0000 Subject: Update the documentation after Breda's commit, to add the new 2004-08-22 Glynn Foster * help/C/zenity.xml: Update the documentation after Breda's commit, to add the new --print-column option for the list dialog. --- help/C/zenity.xml | 9 +++++++++ 1 file changed, 9 insertions(+) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 66c99a0d..9d51f70d 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -564,6 +564,15 @@ + + =column + + Specifies what column should be printed out upon selection. The default column is + '1'. 'ALL' can be used to print out all columns in the list. + + + + -- cgit From 3e05834b4c23a5d5951403719b8594ff3d9fe30b Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Mon, 13 Sep 2004 07:51:51 +0000 Subject: Add new notification icon. Update for new files. Restructure code a little 2004-09-13 Glynn Foster * 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. --- help/C/figures/zenity-notification-screenshot.png | Bin 0 -> 3104 bytes help/C/l10n_scripts/notification.sh | 5 ++ help/C/zenity.xml | 70 +++++++++++++++++++++- 3 files changed, 73 insertions(+), 2 deletions(-) create mode 100644 help/C/figures/zenity-notification-screenshot.png create mode 100755 help/C/l10n_scripts/notification.sh (limited to 'help/C') diff --git a/help/C/figures/zenity-notification-screenshot.png b/help/C/figures/zenity-notification-screenshot.png new file mode 100644 index 00000000..c1b2c9a1 Binary files /dev/null and b/help/C/figures/zenity-notification-screenshot.png differ diff --git a/help/C/l10n_scripts/notification.sh b/help/C/l10n_scripts/notification.sh new file mode 100755 index 00000000..b7de9aba --- /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 9d51f70d..749a7416 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -115,6 +115,7 @@ Calendar File selection List + Notification Message Error @@ -248,7 +249,10 @@ =icon_path - Specifies the icon that is displayed in the window frame of the dialog. + 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'. + @@ -435,7 +439,8 @@ File Selection Dialog - Use the option to create a file selection dialog. &app; returns the selected files or directories to standard error. + Use the 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. The file selection dialog supports the following options: @@ -457,6 +462,20 @@ + + + + Allows only selection of directories in the file selection dialog. + + + + + + + Set the file selection dialog into save mode. + + + =separator @@ -501,6 +520,53 @@ + + + Notification Icon + + + + + + + + =text + + Specifies the text that is displayed in the notification area. + + + + + + + + The following example script shows how to create a notification icon: + + #!/bin/sh + + zenity --notification\ + --window-icon="info" \ + --text="There are system updates necessary!" + + + + +
+ Notification Icon Example + + + + + + + &app; notification icon example + + + +
+ + + -- cgit From 78a233fb606227260ee62ac6134b81db406f89b5 Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Mon, 25 Oct 2004 23:40:59 +0000 Subject: Patch from Lucas Rocha to fix #153277, and remove an extra link. 2004-10-26 Glynn Foster * help/C/zenity.xml: Patch from Lucas Rocha to fix #153277, and remove an extra link. --- help/C/zenity.xml | 1 - 1 file changed, 1 deletion(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 749a7416..7f7e3653 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -533,7 +533,6 @@ =text Specifies the text that is displayed in the notification area. - -- cgit From 717b814028ea3ade38710d32b561af46615358b9 Mon Sep 17 00:00:00 2001 From: Glynn Foster Date: Sun, 6 Feb 2005 23:13:16 +0000 Subject: Update docs to add the new goption help stuff. Update to be in line with 2005-02-07 Glynn Foster * help/C/zenity.xml: Update docs to add the new goption help stuff. * src/option.c: Update to be in line with the documentation descriptions. --- help/C/zenity.xml | 108 +++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 103 insertions(+), 5 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 7f7e3653..3b06c7d5 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -115,7 +115,7 @@ Calendar File selection List - Notification + Notification icon Message Error @@ -288,17 +288,115 @@ - Displays help text. You can also use -? to specify this option. + Displays shortened help text. - + - Displays brief usage text. + Displays full help text for all dialogs. - + + + + + Displays help text for general dialog options. + + + + + + + Displays help text for calendar dialog options. + + + + + + + Displays help text for text entry dialog options. + + + + + + + Displays help text for error dialog options. + + + + + + + Displays help text for information dialog options. + + + + + + + Displays help text for file selection dialog options. + + + + + + + Displays help text for list dialog options. + + + + + + + Displays help text for notification icon options. + + + + + + + Displays help text for progress dialog options. + + + + + + + Displays help text for question dialog options. + + + + + + + Displays help text for warning dialog options. + + + + + + + Displays help for text information dialog options. + + + + + + + Displays help for miscellaneous options. + + + + + + + Displays help for GTK+ options. + + + -- cgit From 6552d6b556a8b28378c917c8882894575c5f7969 Mon Sep 17 00:00:00 2001 From: Lucas Rocha Date: Mon, 25 Jul 2005 01:06:32 +0000 Subject: added gnome-doc-utils.make. added GNOME_DOC_INIT and removed 2005-07-24 Lucas Rocha * .cvsignore: added gnome-doc-utils.make. * configure.in: added GNOME_DOC_INIT and removed help/C/Makefile and help/sr/Makefile from AC_OUTPUT. * Makefile.am: added gnome-doc-utils.make to EXTRA_DIST and DISTCLEANFILES. Added DISTCHECK_CONFIGURE_FLAGS. * help/Makefile.am: migration to gnome-doc-utils. * help/zenity.omf.in: new OMF file to be used by gnome-doc-utils. * help/C/Makefile.am, help/C/zenity-C.omf: No longer needed. Removed. * help/C/zenity.xml: updates to be gnome-doc-utils compliant. * help/ChangeLog: new ChangeLog to keep track of doc updates. --- help/C/Makefile.am | 7 ------- help/C/zenity-C.omf | 30 ------------------------------ help/C/zenity.xml | 6 ++++-- 3 files changed, 4 insertions(+), 39 deletions(-) delete mode 100644 help/C/Makefile.am delete mode 100644 help/C/zenity-C.omf (limited to 'help/C') diff --git a/help/C/Makefile.am b/help/C/Makefile.am deleted file mode 100644 index d935337a..00000000 --- a/help/C/Makefile.am +++ /dev/null @@ -1,7 +0,0 @@ -figdir = figures -docname = zenity -lang = C -omffile = zenity-C.omf -entities = legal.xml -include $(top_srcdir)/xmldocs.make -dist-hook: app-dist-hook diff --git a/help/C/zenity-C.omf b/help/C/zenity-C.omf deleted file mode 100644 index 1c0c646a..00000000 --- a/help/C/zenity-C.omf +++ /dev/null @@ -1,30 +0,0 @@ - - - - - Sun Java Desktop System Documentation Team - - - Sun Java Desktop System Documentation Team - - - Zenity - - - 2004-08-17 - - - - - User manual for the Zenity desktop application. - - - user's guide - - - - - - - - diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 3b06c7d5..c9147c0e 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -38,14 +38,13 @@ &legal; - &author1; &author2; &publisher; - + Glynn Foster @@ -92,6 +91,9 @@ + + User manual for the Zenity desktop application. + -- cgit From f2e35ea95af851222c745ab4ec6574b28c344622 Mon Sep 17 00:00:00 2001 From: Maxim Dziumanenko Date: Sun, 21 Aug 2005 18:49:55 +0000 Subject: Updated Ukrainian translation. 2005-08-21 Maxim Dziumanenko * Updated Ukrainian translation. --- help/C/figures/zenity-calendar-screenshot.png | Bin 15151 -> 17446 bytes help/C/figures/zenity-entry-screenshot.png | Bin 8317 -> 8126 bytes help/C/figures/zenity-error-screenshot.png | Bin 8392 -> 10006 bytes help/C/figures/zenity-fileselection-screenshot.png | Bin 45662 -> 40680 bytes help/C/figures/zenity-information-screenshot.png | Bin 9087 -> 11188 bytes help/C/figures/zenity-list-screenshot.png | Bin 19794 -> 19985 bytes help/C/figures/zenity-progress-screenshot.png | Bin 9029 -> 9230 bytes help/C/figures/zenity-question-screenshot.png | Bin 10920 -> 11399 bytes help/C/figures/zenity-text-screenshot.png | Bin 16246 -> 23812 bytes help/C/figures/zenity-warning-screenshot.png | Bin 10818 -> 12332 bytes 10 files changed, 0 insertions(+), 0 deletions(-) (limited to 'help/C') diff --git a/help/C/figures/zenity-calendar-screenshot.png b/help/C/figures/zenity-calendar-screenshot.png index 5dc3be6e..db1578df 100644 Binary files a/help/C/figures/zenity-calendar-screenshot.png and b/help/C/figures/zenity-calendar-screenshot.png differ diff --git a/help/C/figures/zenity-entry-screenshot.png b/help/C/figures/zenity-entry-screenshot.png index 39d2fb24..f9322ecf 100644 Binary files a/help/C/figures/zenity-entry-screenshot.png and b/help/C/figures/zenity-entry-screenshot.png differ diff --git a/help/C/figures/zenity-error-screenshot.png b/help/C/figures/zenity-error-screenshot.png index d26e0298..67e094ee 100644 Binary files a/help/C/figures/zenity-error-screenshot.png and b/help/C/figures/zenity-error-screenshot.png differ diff --git a/help/C/figures/zenity-fileselection-screenshot.png b/help/C/figures/zenity-fileselection-screenshot.png index cc0d1a7e..08127f24 100644 Binary files a/help/C/figures/zenity-fileselection-screenshot.png and b/help/C/figures/zenity-fileselection-screenshot.png differ diff --git a/help/C/figures/zenity-information-screenshot.png b/help/C/figures/zenity-information-screenshot.png index abb898ed..30be6c63 100644 Binary files a/help/C/figures/zenity-information-screenshot.png and b/help/C/figures/zenity-information-screenshot.png differ diff --git a/help/C/figures/zenity-list-screenshot.png b/help/C/figures/zenity-list-screenshot.png index 6abf517e..b564e70e 100644 Binary files a/help/C/figures/zenity-list-screenshot.png and b/help/C/figures/zenity-list-screenshot.png differ diff --git a/help/C/figures/zenity-progress-screenshot.png b/help/C/figures/zenity-progress-screenshot.png index cf01c5e5..0f0236c6 100644 Binary files a/help/C/figures/zenity-progress-screenshot.png and b/help/C/figures/zenity-progress-screenshot.png differ diff --git a/help/C/figures/zenity-question-screenshot.png b/help/C/figures/zenity-question-screenshot.png index e5363971..d6ee77f0 100644 Binary files a/help/C/figures/zenity-question-screenshot.png and b/help/C/figures/zenity-question-screenshot.png differ diff --git a/help/C/figures/zenity-text-screenshot.png b/help/C/figures/zenity-text-screenshot.png index 686b6007..37d96dc3 100644 Binary files a/help/C/figures/zenity-text-screenshot.png and b/help/C/figures/zenity-text-screenshot.png differ diff --git a/help/C/figures/zenity-warning-screenshot.png b/help/C/figures/zenity-warning-screenshot.png index 57f33082..0d34d342 100644 Binary files a/help/C/figures/zenity-warning-screenshot.png and b/help/C/figures/zenity-warning-screenshot.png differ -- cgit From 91ace3021a452fa5b331a178598ff42e68abaac4 Mon Sep 17 00:00:00 2001 From: Lucas Rocha Date: Tue, 18 Oct 2005 13:21:10 +0000 Subject: refile zenity to GNOME|Utilities. Fixes #318831. Patch from Brent Smith 2005-10-18 Lucas Rocha * help/zenity.omf.in: refile zenity to GNOME|Utilities. Fixes #318831. Patch from Brent Smith . * help/C/zenity.xml: more meaningful abstract and standardized title. Fixes #318915. Patch from Brent Smith . --- help/C/zenity.xml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index c9147c0e..8e4c644a 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -17,7 +17,7 @@
- &appname; + &appname; Manual &appname; Desktop Application Manual V&manrevision; 2003 @@ -92,7 +92,9 @@ - User manual for the Zenity desktop application. + Zenity is a rewrite of gdialog, the GNOME port of dialog which allows you to + display dialog boxes from the commandline and shell scripts. + -- cgit From 4aba5e06ea09bd80e23f41f8c6e5cc0873414028 Mon Sep 17 00:00:00 2001 From: Maxim Dziumanenko Date: Fri, 17 Mar 2006 14:05:09 +0000 Subject: Restore original english screenshots mistakenly replaced by Ukrainian 2006-03-17 Maxim Dziumanenko * help/C/figures/*: Restore original english screenshots mistakenly replaced by Ukrainian screenshots on 2005-08-21 * uk/uk.po: * uk/figures/*.png: Update Ukrainian translation. --- help/C/figures/zenity-calendar-screenshot.png | Bin 17446 -> 15151 bytes help/C/figures/zenity-entry-screenshot.png | Bin 8126 -> 8317 bytes help/C/figures/zenity-error-screenshot.png | Bin 10006 -> 8392 bytes help/C/figures/zenity-fileselection-screenshot.png | Bin 40680 -> 45662 bytes help/C/figures/zenity-information-screenshot.png | Bin 11188 -> 9087 bytes help/C/figures/zenity-list-screenshot.png | Bin 19985 -> 19794 bytes help/C/figures/zenity-progress-screenshot.png | Bin 9230 -> 9029 bytes help/C/figures/zenity-question-screenshot.png | Bin 11399 -> 10920 bytes help/C/figures/zenity-text-screenshot.png | Bin 23812 -> 16246 bytes help/C/figures/zenity-warning-screenshot.png | Bin 12332 -> 10818 bytes 10 files changed, 0 insertions(+), 0 deletions(-) (limited to 'help/C') diff --git a/help/C/figures/zenity-calendar-screenshot.png b/help/C/figures/zenity-calendar-screenshot.png index db1578df..5dc3be6e 100644 Binary files a/help/C/figures/zenity-calendar-screenshot.png and b/help/C/figures/zenity-calendar-screenshot.png differ diff --git a/help/C/figures/zenity-entry-screenshot.png b/help/C/figures/zenity-entry-screenshot.png index f9322ecf..39d2fb24 100644 Binary files a/help/C/figures/zenity-entry-screenshot.png and b/help/C/figures/zenity-entry-screenshot.png differ diff --git a/help/C/figures/zenity-error-screenshot.png b/help/C/figures/zenity-error-screenshot.png index 67e094ee..d26e0298 100644 Binary files a/help/C/figures/zenity-error-screenshot.png and b/help/C/figures/zenity-error-screenshot.png differ diff --git a/help/C/figures/zenity-fileselection-screenshot.png b/help/C/figures/zenity-fileselection-screenshot.png index 08127f24..cc0d1a7e 100644 Binary files a/help/C/figures/zenity-fileselection-screenshot.png and b/help/C/figures/zenity-fileselection-screenshot.png differ diff --git a/help/C/figures/zenity-information-screenshot.png b/help/C/figures/zenity-information-screenshot.png index 30be6c63..abb898ed 100644 Binary files a/help/C/figures/zenity-information-screenshot.png and b/help/C/figures/zenity-information-screenshot.png differ diff --git a/help/C/figures/zenity-list-screenshot.png b/help/C/figures/zenity-list-screenshot.png index b564e70e..6abf517e 100644 Binary files a/help/C/figures/zenity-list-screenshot.png and b/help/C/figures/zenity-list-screenshot.png differ diff --git a/help/C/figures/zenity-progress-screenshot.png b/help/C/figures/zenity-progress-screenshot.png index 0f0236c6..cf01c5e5 100644 Binary files a/help/C/figures/zenity-progress-screenshot.png and b/help/C/figures/zenity-progress-screenshot.png differ diff --git a/help/C/figures/zenity-question-screenshot.png b/help/C/figures/zenity-question-screenshot.png index d6ee77f0..e5363971 100644 Binary files a/help/C/figures/zenity-question-screenshot.png and b/help/C/figures/zenity-question-screenshot.png differ diff --git a/help/C/figures/zenity-text-screenshot.png b/help/C/figures/zenity-text-screenshot.png index 37d96dc3..686b6007 100644 Binary files a/help/C/figures/zenity-text-screenshot.png and b/help/C/figures/zenity-text-screenshot.png differ diff --git a/help/C/figures/zenity-warning-screenshot.png b/help/C/figures/zenity-warning-screenshot.png index 0d34d342..57f33082 100644 Binary files a/help/C/figures/zenity-warning-screenshot.png and b/help/C/figures/zenity-warning-screenshot.png differ -- cgit From d661db7e4e425668f8a7faeaee043ba8bfd67a62 Mon Sep 17 00:00:00 2001 From: Lucas Rocha Date: Fri, 9 Jan 2009 00:03:05 +0000 Subject: document --timeout (Fixes bug #565133). Patch from Luca Bruno 2009-01-08 Lucas Rocha * data/zenity.1: document --timeout (Fixes bug #565133). Patch from Luca Bruno . svn path=/trunk/; revision=1460 --- help/C/zenity.xml | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 8e4c644a..350b1dcb 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -225,6 +225,14 @@ An unexpected error has occurred. + + + 5 + + + The dialog has been closed because the timeout has been reached. + + @@ -274,6 +282,13 @@ + + =timeout + + Specifies the timeout in seconds after which the dialog is closed. + + + -- cgit From c53b690b4e4d94d1c6b0a5cf33acfd704589d904 Mon Sep 17 00:00:00 2001 From: Lucas Rocha Date: Sat, 8 Aug 2009 11:11:08 +0100 Subject: Bug 572775 – Error in help browser documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit All zenity dialog outputs their results to standard output by default, not standard error. --- help/C/zenity.xml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 350b1dcb..0730e8f0 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -156,7 +156,7 @@ - When the user closes the dialog, &app; prints the text produced by the dialog to standard error. + When the user closes the dialog, &app; prints the text produced by the dialog to standard output. @@ -467,7 +467,7 @@ Calendar Dialog - Use the option to create a calendar dialog. &app; returns the selected date to standard error. If no date is specified on the command line, the dialog uses the current date. + Use the 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. The calendar dialog supports the following options: @@ -557,7 +557,7 @@ Use the 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. + output. The default mode of the file selection dialog is open. The file selection dialog supports the following options: @@ -689,7 +689,7 @@ List Dialog - Use the option to create a list dialog. &app; returns the entries in the first column of text of selected rows to standard error. + Use the option to create a list dialog. &app; returns the entries in the first column of text of selected rows to standard output. @@ -1053,7 +1053,7 @@ For each type, use the option to specify the text that i Text Entry Dialog - Use the option to create a text entry dialog. &app; returns the contents of the text entry to standard error. + Use the option to create a text entry dialog. &app; returns the contents of the text entry to standard output. The text entry dialog supports the following options: @@ -1142,7 +1142,7 @@ For each type, use the option to specify the text that i - Allows the displayed text to be edited. The edited text is returned to standard error when the dialog is closed. + Allows the displayed text to be edited. The edited text is returned to standard output when the dialog is closed. -- cgit From 81dc4ae2e2db09d4bfa087db9667a5cf2fbc061c Mon Sep 17 00:00:00 2001 From: Frederic Peters Date: Mon, 10 Aug 2009 03:29:53 +0100 Subject: Bug 541400 - document use of $WINDOWID variable --- help/C/zenity.xml | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 0730e8f0..393585b4 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -460,6 +460,19 @@ + + + + Environment Variables + + + Normally, &app; detects the terminal window from which it was launched + and keeps itself above that window. This behavior can be disabled by + unsetting the WINDOWID environment variable. + + + + -- cgit From 3e5676d329c1bc005e900aabdc3adf2f8a461721 Mon Sep 17 00:00:00 2001 From: Arx Cruz Date: Tue, 27 Jul 2010 12:46:55 -0300 Subject: Bug 624612 to update zenity help file --- help/C/zenity.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml index 393585b4..d156d212 100644 --- a/help/C/zenity.xml +++ b/help/C/zenity.xml @@ -1066,7 +1066,7 @@ For each type, use the option to specify the text that i Text Entry Dialog - Use the option to create a text entry dialog. &app; returns the contents of the text entry to standard output. + Use the option to create a text entry dialog. &app; returns the contents of the text entry to standard output. The text entry dialog supports the following options: -- cgit From f1bf713d0fcd86d38b119d95b276f67245123810 Mon Sep 17 00:00:00 2001 From: Yasumichi Akahoshi Date: Sat, 19 Nov 2011 02:55:00 +0900 Subject: Add mallard pages and update screenshots. Signed-off-by: Yasumichi Akahoshi --- help/C/calendar.page | 68 +++++ help/C/color-selection.page | 55 ++++ help/C/entry.page | 57 ++++ help/C/error.page | 30 +++ .../C/figures/zenity-colorselection-screenshot.png | Bin 0 -> 35025 bytes help/C/figures/zenity-forms-screenshot.png | Bin 0 -> 10000 bytes help/C/figures/zenity-password-screenshot.png | Bin 0 -> 5933 bytes help/C/figures/zenity-scale-screenshot.png | Bin 0 -> 4907 bytes help/C/file-selection.page | 70 +++++ help/C/forms.page | 83 ++++++ help/C/index.page | 25 ++ help/C/info.page | 30 +++ help/C/intro.page | 34 +++ help/C/list.page | 86 ++++++ help/C/message.page | 18 ++ help/C/notification.page | 39 +++ help/C/password.page | 50 ++++ help/C/progress.page | 79 ++++++ help/C/question.page | 30 +++ help/C/scale.page | 80 ++++++ help/C/text.page | 85 ++++++ help/C/usage.page | 292 +++++++++++++++++++++ help/C/warning.page | 30 +++ 23 files changed, 1241 insertions(+) create mode 100644 help/C/calendar.page create mode 100644 help/C/color-selection.page create mode 100644 help/C/entry.page create mode 100644 help/C/error.page create mode 100644 help/C/figures/zenity-colorselection-screenshot.png create mode 100644 help/C/figures/zenity-forms-screenshot.png create mode 100644 help/C/figures/zenity-password-screenshot.png create mode 100644 help/C/figures/zenity-scale-screenshot.png create mode 100644 help/C/file-selection.page create mode 100644 help/C/forms.page create mode 100644 help/C/index.page create mode 100644 help/C/info.page create mode 100644 help/C/intro.page create mode 100644 help/C/list.page create mode 100644 help/C/message.page create mode 100644 help/C/notification.page create mode 100644 help/C/password.page create mode 100644 help/C/progress.page create mode 100644 help/C/question.page create mode 100644 help/C/scale.page create mode 100644 help/C/text.page create mode 100644 help/C/usage.page create mode 100644 help/C/warning.page (limited to 'help/C') diff --git a/help/C/calendar.page b/help/C/calendar.page new file mode 100644 index 00000000..cd2191c2 --- /dev/null +++ b/help/C/calendar.page @@ -0,0 +1,68 @@ + + + + Use the --calendar option. + + Calendar Dialog +

+ Use the --calendar option to create a calendar dialog. Zenity returns the selected date to standard output. If no date is specified on the command line, the dialog uses the current date. +

+

+ The calendar dialog supports the following options: +

+ + + + + <cmd>--text</cmd>=<var>text</var> +

Specifies the text that is displayed in the calendar dialog.

+ + + + <cmd>--day</cmd>=<var>day</var> +

Specifies the day that is selected in the calendar dialog. day must be a number between 1 and 31 inclusive.

+ + + + <cmd>--month</cmd>=<var>month</var> +

Specifies the month that is selected in the calendar dialog. month must be a number between 1 and 12 inclusive.

+ + + + <cmd>--year</cmd>=<var>year</var> +

Specifies the year that is selected in the calendar dialog.

+ + + + <cmd>--date-format</cmd>=<var>format</var> +

Specifies the format that is returned from the calendar dialog after date selection. The default format depends on your locale. Format must be a format that is acceptable to the strftime function, for example %A %d/%m/%y.

+ + + + +

+ The following example script shows how to create a calendar dialog: +

+ + +#!/bin/sh + + +if zenity --calendar \ +--title="Select a Date" \ +--text="Click on a date to select that date." \ +--day=10 --month=8 --year=2004 + then echo $? + else echo "No date selected" +fi + + + +
+ Calendar Dialog Example + Zenity calendar dialog example + +
+ diff --git a/help/C/color-selection.page b/help/C/color-selection.page new file mode 100644 index 00000000..55402b92 --- /dev/null +++ b/help/C/color-selection.page @@ -0,0 +1,55 @@ + + + + Use the --color-selection option. + + Color Selection Dialog +

+ Use the --color-selection option to create a color selection dialog. +

+

+ The color selection dialog supports the following options: +

+ + + + + <cmd>--color</cmd>=<var>VALUE</var> +

Set the initial color.(ex: #FF0000)

+ + + + <cmd>--show-palette</cmd> +

Show the palette.

+ + + + +

+ The following example script shows how to create a color selection dialog: +

+ + +#!/bin/sh + +COLOR=`zenity --color-selection --show-palette` + +case $? in + 0) + echo "You selected $COLOR.";; + 1) + echo "No color selected.";; + -1) + echo "An unexpected error has occurred.";; +esac + + +
+ Password Entry Dialog Example + Zenity password entry dialog example + +
+ + diff --git a/help/C/entry.page b/help/C/entry.page new file mode 100644 index 00000000..69ad4641 --- /dev/null +++ b/help/C/entry.page @@ -0,0 +1,57 @@ + + + + Use the --entry option. + + Text Entry Dialog +

+ Use the --entry option to create a text entry dialog. Zenity returns the contents of the text entry to standard output. +

+

+ The text entry dialog supports the following options: +

+ + + + + <cmd>--text</cmd>=<var>text</var> +

Specifies the text that is displayed in the text entry dialog.

+ + + + <cmd>--entry-text</cmd>=<var>text</var> +

Specifies the text that is displayed in the entry field of the text entry dialog.

+ + + + <cmd>--hide-text</cmd> +

Hides the text in the entry field of the text entry dialog.

+ + + + +

+ The following example script shows how to create a text entry dialog: +

+ + +#!/bin/sh + +if zenity --entry \ +--title="Add new profile" \ +--text="Enter name of new profile:" \ +--entry-text "NewProfile" + then echo $? + else echo "No name entered" +fi + + + +
+ Text Entry Dialog Example + Zenity text entry dialog example + +
+ diff --git a/help/C/error.page b/help/C/error.page new file mode 100644 index 00000000..5c9113ac --- /dev/null +++ b/help/C/error.page @@ -0,0 +1,30 @@ + + + + Use the --error option. + + Error Dialog +

+ Use the --error option to create an error dialog. +

+ +

+ The following example script shows how to create an error dialog: +

+ + +#!/bin/bash + +zenity --error \ +--text="Could not find /var/log/syslog." + + + +
+ Error Dialog Example + Zenity error dialog example + +
+ diff --git a/help/C/figures/zenity-colorselection-screenshot.png b/help/C/figures/zenity-colorselection-screenshot.png new file mode 100644 index 00000000..bd9c9bba Binary files /dev/null and b/help/C/figures/zenity-colorselection-screenshot.png differ diff --git a/help/C/figures/zenity-forms-screenshot.png b/help/C/figures/zenity-forms-screenshot.png new file mode 100644 index 00000000..70e50eb5 Binary files /dev/null and b/help/C/figures/zenity-forms-screenshot.png differ diff --git a/help/C/figures/zenity-password-screenshot.png b/help/C/figures/zenity-password-screenshot.png new file mode 100644 index 00000000..987394cb Binary files /dev/null and b/help/C/figures/zenity-password-screenshot.png differ diff --git a/help/C/figures/zenity-scale-screenshot.png b/help/C/figures/zenity-scale-screenshot.png new file mode 100644 index 00000000..902db1f8 Binary files /dev/null and b/help/C/figures/zenity-scale-screenshot.png differ diff --git a/help/C/file-selection.page b/help/C/file-selection.page new file mode 100644 index 00000000..0ec8c5bd --- /dev/null +++ b/help/C/file-selection.page @@ -0,0 +1,70 @@ + + + + Use the --file-selection option. + + File Selection Dialog +

+ Use the --file-selection option to create a file selection dialog. Zenity returns the selected files or directories to standard + output. The default mode of the file selection dialog is open. +

+

+ The file selection dialog supports the following options: +

+ + + + + <cmd>--filename</cmd>=<var>filename</var> +

Specifies the file or directory that is selected in the file selection dialog when the dialog is first shown.

+ + + + <cmd>--multiple</cmd> +

Allows the selection of multiple filenames in the file selection dialog.

+ + + + <cmd>--directory</cmd> +

Allows only selection of directories in the file selection dialog.

+ + + + <cmd>--save</cmd> +

Set the file selection dialog into save mode.

+ + + + <cmd>--separator</cmd>=<var>separator</var> +

Specifies the string that is used to divide the returned list of filenames.

+ + + + +

+ The following example script shows how to create a file selection dialog: +

+ + +#!/bin/sh + +FILE=`zenity --file-selection --title="Select a File"` + +case $? in + 0) + echo "\"$FILE\" selected.";; + 1) + echo "No file selected.";; + -1) + echo "An unexpected error has occurred.";; +esac + + +
+ File Selection Dialog Example + Zenity file selection dialog example + +
+ diff --git a/help/C/forms.page b/help/C/forms.page new file mode 100644 index 00000000..fcf6c657 --- /dev/null +++ b/help/C/forms.page @@ -0,0 +1,83 @@ + + + + Use the --forms option. + + Forms Dialog +

+ Use the --forms option to create a forms dialog. +

+ +

+ The forms dialog supports the following options: +

+ + + + + <cmd>--add-entry</cmd>=<var>FieldName</var> +

Add a new Entry in forms dialog.

+ + + + --add-password<cmd></cmd>=<var>FieldName</var> +

Add a new Password Entry in forms dialog. (Hide text)

+ + + + <cmd>--add-calendar</cmd>=<var>FieldName</var> +

Add a new Calendar in forms dialog.

+ + + + <cmd>--text</cmd>=<var>TEXT</var> +

Set the dialog text.

+ + + + <cmd>--separator</cmd>=<var>SEPARATOR</var> +

Set output separator character. (Default: | )

+ + + + <cmd>--forms-date-format</cmd>=<var>PATTERN</var> +

Set the format for the returned date. The default format depends on your locale. format must be a Format that is acceptable to the strftime function, for example %A %d/%m/%y.

+ + + + +

+ The following example script shows how to create a forms dialog: +

+ + +#!/bin/sh + +zenity --forms --title="Add Friend" \ + --text="Enter information about your friend." \ + --separator="," \ + --add-entry="First Name" \ + --add-entry="Family Name" \ + --add-entry="Email" \ + --add-calendar="Birthday" >> addr.csv + +case $? in + 0) + echo "Friend added.";; + 1) + echo "No friend added." + ;; + -1) + echo "An unexpected error has occurred." + ;; +esac + + +
+ Forms Dialog Example + Zenity forms dialog example + +
+ diff --git a/help/C/index.page b/help/C/index.page new file mode 100644 index 00000000..96a9cd0d --- /dev/null +++ b/help/C/index.page @@ -0,0 +1,25 @@ + + + + Sun Java Desktop System Documentation Team + + + Glynn Foster + + + Nicholas Curran + + + + Yasumichi Akahoshi + yasumichi@vinelinux.org + + +Zenity Manual + +
+ Dialogs +
+ diff --git a/help/C/info.page b/help/C/info.page new file mode 100644 index 00000000..1ea62324 --- /dev/null +++ b/help/C/info.page @@ -0,0 +1,30 @@ + + + + Use the --info option. + + Info Dialog +

+ Use the --info option to create an information dialog. +

+ +

+ The following example script shows how to create an information dialog: +

+ + +#!/bin/bash + +zenity --info \ +--text="Merge complete. Updated 3 of 10 files." + + + +
+ Information Dialog Example + Zenity information dialog example + +
+ diff --git a/help/C/intro.page b/help/C/intro.page new file mode 100644 index 00000000..8a7bdec1 --- /dev/null +++ b/help/C/intro.page @@ -0,0 +1,34 @@ + + + + Zenity enables you to create the various types of simple dialog. + +Introduction +

+ Zenity enables you to create the following types of simple dialog: +

+ + +

Calendar

 +

File selection

 +

Forms

 +

List

 +

Notification icon

 +

Message

+ +

Error

 +

Information

 +

Question

 +

Warning

 + + +

Password entry

 +

Progress

 +

Text entry

 +

Text information

 +

Scale

 +

Color selection

 + + diff --git a/help/C/list.page b/help/C/list.page new file mode 100644 index 00000000..39e86cd4 --- /dev/null +++ b/help/C/list.page @@ -0,0 +1,86 @@ + + + + Use the --list option. + + List Dialog +

+ Use the --list option to create a list dialog. Zenity returns the entries in the first column of text of selected rows to standard output. +

+ +

+ Data for the dialog must specified column by column, row by row. Data can be provided to the dialog through standard input. Each entry must be separated by a newline character. +

+ +

+ If you use the --checklist or --radiolist options, each row must start with either 'TRUE' or 'FALSE'. +

+ +

+ The list dialog supports the following options: +

+ + + + + <cmd>--column</cmd>=<var>column</var> +

Specifies the column headers that are displayed in the list dialog. You must specify a --column option for each column that you want to display in the dialog. +

+ + + + <cmd>--checklist</cmd> +

Specifies that the first column in the list dialog contains check boxes. +

+ + + + <cmd>--radiolist</cmd> +

Specifies that the first column in the list dialog contains radio boxes. +

+ + + + <cmd>--editable</cmd> +

Allows the displayed items to be edited. +

+ + + + <cmd>--separator</cmd>=<var>separator</var> +

Specifies what string is used when the list dialog returns the selected entries. +

+ + + + <cmd>--print-column</cmd>=<var>column</var> +

Specifies what column should be printed out upon selection. The default column is + '1'. 'ALL' can be used to print out all columns in the list. +

+ + + + +

+ The following example script shows how to create a list dialog: +

+ +#!/bin/sh + +zenity --list \ + --title="Choose the Bugs You Wish to View" \ + --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" + + + +
+ List Dialog Example + Zenity list dialog example + +
+ diff --git a/help/C/message.page b/help/C/message.page new file mode 100644 index 00000000..a375efa7 --- /dev/null +++ b/help/C/message.page @@ -0,0 +1,18 @@ + + + + + Error, + Info, + Question, + Warning + + + Message Dialog +

+For each type, use the --text option to specify the text that is displayed in the dialog. +

+ + diff --git a/help/C/notification.page b/help/C/notification.page new file mode 100644 index 00000000..ac556378 --- /dev/null +++ b/help/C/notification.page @@ -0,0 +1,39 @@ + + + + Use the --notification option. + + Notification Icon +

+ Use the --notification option to create a notification icon. +

+ + + + + <cmd>--text</cmd>=<var>text</var> +

Specifies the text that is displayed in the notification area.

+ + + + +

+ The following example script shows how to create a notification icon: +

+ +#!/bin/sh + +zenity --notification\ + --window-icon="info" \ + --text="There are system updates necessary!" + + + +
+ Notification Icon Example + Zenity notification icon example + +
+ diff --git a/help/C/password.page b/help/C/password.page new file mode 100644 index 00000000..22094d89 --- /dev/null +++ b/help/C/password.page @@ -0,0 +1,50 @@ + + + + Use the --password option. + + Password Dialog +

+ Use the --password option to create a password entry dialog. +

+

+ The password entry dialog supports the following options: +

+ + + + <cmd>--username</cmd> +

Display the username field.

+ + + +

+ The following example script shows how to create a password entry dialog: +

+ + +#!/bin/sh + +ENTRY=`zenity --password --username` + +case $? in + 0) + echo "User Name: `echo $ENTRY | cut -d'|' -f1`" + echo "Password : `echo $ENTRY | cut -d'|' -f2`" + ;; + 1) + echo "Stop login.";; + -1) + echo "An unexpected error has occurred.";; +esac + + +
+ Password Entry Dialog Example + Zenity password entry dialog example + +
+ + diff --git a/help/C/progress.page b/help/C/progress.page new file mode 100644 index 00000000..caabb16a --- /dev/null +++ b/help/C/progress.page @@ -0,0 +1,79 @@ + + + + Use the --progress option. + + Progress Dialog +

+ Use the --progress option to create a progress dialog. +

+ +

+ Zenity 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. +

+ +

+ The progress dialog supports the following options: +

+ + + + + <cmd>--text</cmd>=<var>text</var> +

Specifies the text that is displayed in the progress dialog.

+ + + + <cmd>--percentage</cmd>=<var>percentage</var> +

Specifies the initial percentage that is set in the progress dialog.

+ + + + <cmd>--auto-close</cmd> +

Closes the progress dialog when 100% has been reached.

+ + + + <cmd>--pulsate</cmd> +

Specifies that the progress bar pulsates until an EOF character is read from standard input.

+ + + + +

+ The following example script shows how to create a progress dialog: +

+ + +#!/bin/sh +( +echo "10" ; sleep 1 +echo "# Updating mail logs" ; sleep 1 +echo "20" ; sleep 1 +echo "# Resetting cron jobs" ; sleep 1 +echo "50" ; sleep 1 +echo "This line will just be ignored" ; sleep 1 +echo "75" ; sleep 1 +echo "# Rebooting system" ; sleep 1 +echo "100" ; sleep 1 +) | +zenity --progress \ + --title="Update System Logs" \ + --text="Scanning mail logs..." \ + --percentage=0 + +if [ "$?" = -1 ] ; then + zenity --error \ + --text="Update canceled." +fi + + + +
+ Progress Dialog Example + Zenity progress dialog example + +
+ diff --git a/help/C/question.page b/help/C/question.page new file mode 100644 index 00000000..6e435c57 --- /dev/null +++ b/help/C/question.page @@ -0,0 +1,30 @@ + + + + Use the --question option. + + Question Dialog +

+ Use the --question option to create a question dialog. +

+ +

+ The following example script shows how to create a question dialog: +

+ + +#!/bin/bash + +zenity --question \ +--text="Are you sure you wish to proceed?" + + + +
+ Question Dialog Example + Zenity question dialog example + +
+ diff --git a/help/C/scale.page b/help/C/scale.page new file mode 100644 index 00000000..7d35b533 --- /dev/null +++ b/help/C/scale.page @@ -0,0 +1,80 @@ + + + + Use the --scale option. + + Scale Dialog +

+ Use the --scale option to create a scale dialog. +

+

+ The scale dialog supports the following options: +

+ + + + + <cmd>--text</cmd>=<var>TEXT</var> +

Set the dialog text. (Default: Adjust the scale value)

+ + + + <cmd>--value</cmd>=<var>VALUE</var> +

Set initial value. (Default: 0) You must specify value between minimum value to maximum value.

+ + + + <cmd>--min-value</cmd>=<var>VALUE</var> +

Set minimum value. (Default: 0)

+ + + + <cmd>--max-value</cmd>=<var>VALUE</var> +

Set maximum value. (Default: 100)

+ + + + <cmd>--step</cmd>=<var>VALUE</var> +

Set step size. (Default: 1)

+ + + + <cmd>--print-partial</cmd> +

Print value to standard output, whenever a value is changed.

+ + + + <cmd>--hide-value</cmd> +

Hide value on dialog.

+ + + + +

+ The following example script shows how to create a scale dialog: +

+ + +#!/bin/sh + +VALUE=`zenity --scale --text="Select window transparency." --value=50` + +case $? in + 0) + echo "You selected $VALUE%.";; + 1) + echo "No value selected.";; + -1) + echo "An unexpected error has occurred.";; +esac + + +
+ Password Entry Dialog Example + Zenity password entry dialog example + +
+ + diff --git a/help/C/text.page b/help/C/text.page new file mode 100644 index 00000000..f01166ec --- /dev/null +++ b/help/C/text.page @@ -0,0 +1,85 @@ + + + + Use the --text-info option. + + Text Information Dialog +

+ Use the --text-info option to create a text information dialog. +

+ +

+ The text information dialog supports the following options: +

+ + + + + <cmd>--filename</cmd>=<var>filename</var> +

Specifies a file that is loaded in the text information dialog.

+ + + + <cmd>--editable</cmd> +

Allows the displayed text to be edited. The edited text is returned to standard output when the dialog is closed.

+ + + + <cmd>--font</cmd>=<var>FONT</var> +

Specifies the text font.

+ + + + <cmd>--checkbox</cmd>=<var>TEXT</var> +

Enable a checkbox for use like a 'I read and accept the terms.'

+ + + + <cmd>--html</cmd> +

Enable html support.

+ + + + <cmd>--url</cmd>=<var>URL</var> +

Sets an url instead of a file. Only works if you use --html option.

+ + + + +

+ The following example script shows how to create a text information dialog: +

+ + +#!/bin/sh + +# You must place file "COPYING" in same folder of this script. +FILE=`dirname $0`/COPYING + +zenity --text-info \ + --title="License" \ + --filename=$FILE \ + --checkbox="I read and accept the terms." + +case $? in + 0) + echo "Start installation!" + # next step + ;; + 1) + echo "Stop installation!" + ;; + -1) + echo "An unexpected error has occurred." + ;; +esac + + +
+ Text Information Dialog Example + Zenity text information dialog example + +
+ diff --git a/help/C/usage.page b/help/C/usage.page new file mode 100644 index 00000000..6aab6005 --- /dev/null +++ b/help/C/usage.page @@ -0,0 +1,292 @@ + + + + You can use Zenity to create simple dialogs that interact graphically with the user. + +Usage +

+ When you write scripts, you can use Zenity to create simple dialogs that interact graphically with the user, as follows: +

+ + +

+ You can create a dialog to obtain information from the user. For example, you can prompt the user to select a date from a calendar dialog, or to select a file from a file selection dialog. +

+ + +

+ You can create a dialog to provide the user with information. For example, you can use a progress dialog to indicate the current status of an operation, or use a warning message dialog to alert the user. +

+ + +

+ When the user closes the dialog, Zenity prints the text produced by the dialog to standard output. +

+ + +

+ When you write Zenity commands, ensure that you place quotation marks around each argument. +

+

For example, use:

+ zenity --calendar --title="Holiday Planner" +

Do not use:

+ zenity --calendar --title=Holiday Planner +

+ If you do not use quotation marks, you might get unexpected results. +

+ + +
+ Access Keys +

+ 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. +

+

+ Some Zenity 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: +

+ "_Choose a name". +
+ +
+ Exit Codes +

+ Zenity returns the following exit codes: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
+

Exit Code

 +

Description

+

0

+ 		+

The user has pressed either OK or Close.

+
+

1

+ 		+

The user has either pressed Cancel, or used the window functions to close the dialog.

+
+

-1

+ 		+

An unexpected error has occurred.

+
+

5

+ 		+

The dialog has been closed because the timeout has been reached.

+
+ +
+ + + + +
+ General Options + +

+ All Zenity dialogs support the following general options: +

+ + + + + <cmd>--title</cmd>=<var>title</var> +

Specifies the title of a dialog.

+ + + + <cmd>--window-icon</cmd>=<var>icon_path</var> +

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'. +

+ + + + <cmd>--width</cmd>=<var>width</var> +

Specifies the width of the dialog.

+ + + + <cmd>--height</cmd>=<var>height</var> +

Specifies the height of the dialog.

+ + + + <cmd>--timeout</cmd>=<var>timeout</var> +

Specifies the timeout in seconds after which the dialog is closed.

+ + + + +
+ + + +
+ Help Options + +

+ Zenity provides the following help options: +

+ + + + + <cmd>--help</cmd> +

Displays shortened help text.

+ + + + <cmd>--help-all</cmd> +

Displays full help text for all dialogs.

+ + + + <cmd>--help-general</cmd> +

Displays help text for general dialog options.

+ + + + <cmd>--help-calendar</cmd> +

Displays help text for calendar dialog options.

+ + + + <cmd>--help-entry</cmd> +

Displays help text for text entry dialog options.

+ + + + <cmd>--help-error</cmd> +

Displays help text for error dialog options.

+ + + + <cmd>--help-info</cmd> +

Displays help text for information dialog options.

+ + + + <cmd>--help-file-selection</cmd> +

Displays help text for file selection dialog options.

+ + + + <cmd>--help-list</cmd> +

Displays help text for list dialog options.

+ + + + <cmd>--help-notification</cmd> +

Displays help text for notification icon options.

+ + + + <cmd>--help-progress</cmd> +

Displays help text for progress dialog options.

+ + + + <cmd>--help-question</cmd> +

Displays help text for question dialog options.

+ + + + <cmd>--help-warning</cmd> +

Displays help text for warning dialog options.

+ + + + <cmd>--help-text-info</cmd> +

Displays help for text information dialog options.

+ + + + <cmd>--help-misc</cmd> +

Displays help for miscellaneous options.

+ + + + <cmd>--help-gtk</cmd> +

Displays help for GTK+ options.

+ + + + +
+ + + +
+ Miscellaneous Options + +

+ Zenity also provides the following miscellaneous options: +

+ + + + + <cmd>--about</cmd> +

Displays the About Zenity dialog, which contains Zenity version information, copyright information, and developer information.

+ + + + <cmd>--version</cmd> +

Displays the version number of Zenity.

+ + + + +
+ + + +
+ GTK+ Options + +

+ Zenity supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity --help-gtk command. +

+ +
+ + + +
+ Environment Variables + +

+ Normally, Zenity detects the terminal window from which it was launched + and keeps itself above that window. This behavior can be disabled by + unsetting the WINDOWID environment variable. +

+ +
+ diff --git a/help/C/warning.page b/help/C/warning.page new file mode 100644 index 00000000..1b7a642f --- /dev/null +++ b/help/C/warning.page @@ -0,0 +1,30 @@ + + + + Use the --warning option. + + Warning Dialog +

+ Use the --warning option to create a warning dialog. +

+ +

+ The following example script shows how to create a warning dialog: +

+ + +#!/bin/bash + +zenity --warning \ +--text="Disconnect the power cable to avoid electrical shock." + + + +
+ Warning Dialog Example + Zenity warning dialog example + +
+ -- cgit From 141a9df617a99a809993797fb4a0d3e0e707500d Mon Sep 17 00:00:00 2001 From: Yasumichi Akahoshi Date: Mon, 21 Nov 2011 22:49:10 +0900 Subject: fixed screenshot on Adwita Signed-off-by: Yasumichi Akahoshi --- help/C/figures/zenity-calendar-screenshot.png | Bin 15151 -> 7216 bytes help/C/figures/zenity-colorselection-screenshot.png | Bin 35025 -> 32589 bytes help/C/figures/zenity-entry-screenshot.png | Bin 8317 -> 4190 bytes help/C/figures/zenity-error-screenshot.png | Bin 8392 -> 3814 bytes help/C/figures/zenity-fileselection-screenshot.png | Bin 45662 -> 22656 bytes help/C/figures/zenity-forms-screenshot.png | Bin 10000 -> 9210 bytes help/C/figures/zenity-information-screenshot.png | Bin 9087 -> 4124 bytes help/C/figures/zenity-list-screenshot.png | Bin 19794 -> 6777 bytes help/C/figures/zenity-notification-screenshot.png | Bin 3104 -> 12875 bytes help/C/figures/zenity-password-screenshot.png | Bin 5933 -> 5426 bytes help/C/figures/zenity-progress-screenshot.png | Bin 9029 -> 3898 bytes help/C/figures/zenity-question-screenshot.png | Bin 10920 -> 4445 bytes help/C/figures/zenity-scale-screenshot.png | Bin 4907 -> 4377 bytes help/C/figures/zenity-text-screenshot.png | Bin 16246 -> 9138 bytes help/C/figures/zenity-warning-screenshot.png | Bin 10818 -> 4443 bytes 15 files changed, 0 insertions(+), 0 deletions(-) (limited to 'help/C') diff --git a/help/C/figures/zenity-calendar-screenshot.png b/help/C/figures/zenity-calendar-screenshot.png index 5dc3be6e..b9b3333c 100644 Binary files a/help/C/figures/zenity-calendar-screenshot.png and b/help/C/figures/zenity-calendar-screenshot.png differ diff --git a/help/C/figures/zenity-colorselection-screenshot.png b/help/C/figures/zenity-colorselection-screenshot.png index bd9c9bba..0c21b214 100644 Binary files a/help/C/figures/zenity-colorselection-screenshot.png and b/help/C/figures/zenity-colorselection-screenshot.png differ diff --git a/help/C/figures/zenity-entry-screenshot.png b/help/C/figures/zenity-entry-screenshot.png index 39d2fb24..b3545ec6 100644 Binary files a/help/C/figures/zenity-entry-screenshot.png and b/help/C/figures/zenity-entry-screenshot.png differ diff --git a/help/C/figures/zenity-error-screenshot.png b/help/C/figures/zenity-error-screenshot.png index d26e0298..31bbc377 100644 Binary files a/help/C/figures/zenity-error-screenshot.png and b/help/C/figures/zenity-error-screenshot.png differ diff --git a/help/C/figures/zenity-fileselection-screenshot.png b/help/C/figures/zenity-fileselection-screenshot.png index cc0d1a7e..46973ef7 100644 Binary files a/help/C/figures/zenity-fileselection-screenshot.png and b/help/C/figures/zenity-fileselection-screenshot.png differ diff --git a/help/C/figures/zenity-forms-screenshot.png b/help/C/figures/zenity-forms-screenshot.png index 70e50eb5..a005d4f5 100644 Binary files a/help/C/figures/zenity-forms-screenshot.png and b/help/C/figures/zenity-forms-screenshot.png differ diff --git a/help/C/figures/zenity-information-screenshot.png b/help/C/figures/zenity-information-screenshot.png index abb898ed..2404eb89 100644 Binary files a/help/C/figures/zenity-information-screenshot.png and b/help/C/figures/zenity-information-screenshot.png differ diff --git a/help/C/figures/zenity-list-screenshot.png b/help/C/figures/zenity-list-screenshot.png index 6abf517e..684e6f37 100644 Binary files a/help/C/figures/zenity-list-screenshot.png and b/help/C/figures/zenity-list-screenshot.png differ diff --git a/help/C/figures/zenity-notification-screenshot.png b/help/C/figures/zenity-notification-screenshot.png index c1b2c9a1..4c3a0256 100644 Binary files a/help/C/figures/zenity-notification-screenshot.png and b/help/C/figures/zenity-notification-screenshot.png differ diff --git a/help/C/figures/zenity-password-screenshot.png b/help/C/figures/zenity-password-screenshot.png index 987394cb..a37653e5 100644 Binary files a/help/C/figures/zenity-password-screenshot.png and b/help/C/figures/zenity-password-screenshot.png differ diff --git a/help/C/figures/zenity-progress-screenshot.png b/help/C/figures/zenity-progress-screenshot.png index cf01c5e5..583de684 100644 Binary files a/help/C/figures/zenity-progress-screenshot.png and b/help/C/figures/zenity-progress-screenshot.png differ diff --git a/help/C/figures/zenity-question-screenshot.png b/help/C/figures/zenity-question-screenshot.png index e5363971..296f686d 100644 Binary files a/help/C/figures/zenity-question-screenshot.png and b/help/C/figures/zenity-question-screenshot.png differ diff --git a/help/C/figures/zenity-scale-screenshot.png b/help/C/figures/zenity-scale-screenshot.png index 902db1f8..37a3fc38 100644 Binary files a/help/C/figures/zenity-scale-screenshot.png and b/help/C/figures/zenity-scale-screenshot.png differ diff --git a/help/C/figures/zenity-text-screenshot.png b/help/C/figures/zenity-text-screenshot.png index 686b6007..52fcb793 100644 Binary files a/help/C/figures/zenity-text-screenshot.png and b/help/C/figures/zenity-text-screenshot.png differ diff --git a/help/C/figures/zenity-warning-screenshot.png b/help/C/figures/zenity-warning-screenshot.png index 57f33082..8210966c 100644 Binary files a/help/C/figures/zenity-warning-screenshot.png and b/help/C/figures/zenity-warning-screenshot.png differ -- cgit From ce02b2926773acbda524b1616f1bf8d322b38f53 Mon Sep 17 00:00:00 2001 From: Tiffany Antopolski Date: Sun, 18 Dec 2011 13:10:09 -0500 Subject: [help/C] remove old DocBook documentation. --- help/C/zenity.xml | 1203 ----------------------------------------------------- 1 file changed, 1203 deletions(-) delete mode 100644 help/C/zenity.xml (limited to 'help/C') diff --git a/help/C/zenity.xml b/help/C/zenity.xml deleted file mode 100644 index d156d212..00000000 --- a/help/C/zenity.xml +++ /dev/null @@ -1,1203 +0,0 @@ - - - - - - - Zenity"> - - - -]> - - - -
- - - &appname; Manual - &appname; Desktop Application Manual V&manrevision; - - 2003 - 2004 - &publisher; - - - - - - &publisher; - - - &legal; - - - - &author1; - &author2; - &publisher; - - - Glynn - Foster - - GNOME Documentation Project - - - - Nicholas - Curran - - GNOME Documentation Project - - - - - - - &appname; Desktop Application Manual V&manrevision; - &date; - - &author1; &author2; - &publisher; - - - - - Zenity Manual V1.0 - January 2003 - - Glynn Foster - GNOME Documentation Project - - - - - This manual describes version &appversion; of &appname;. - - - - Feedback - - To send feedback, follow the directions in the Feedback Page. - - - - - - Zenity is a rewrite of gdialog, the GNOME port of dialog which allows you to - display dialog boxes from the commandline and shell scripts. - - - - - - zenity command - - - dialog creator - - - - - - - Introduction - - - &app; enables you to create the following types of simple dialog: - - - - Calendar - File selection - List - Notification icon - Message - - Error - Information - Question - Warning - - - Progress - Text entry - Text information - - - - - - - - Usage - - - When you write scripts, you can use &app; to create simple dialogs that interact graphically with the user, as follows: - - - - - You can create a dialog to obtain information from the user. For example, you can prompt the user to select a date from a calendar dialog, or to select a file from a file selection dialog. - - - - - You can create a dialog to provide the user with information. For example, you can use a progress dialog to indicate the current status of an operation, or use a warning message dialog to alert the user. - - - - - When the user closes the dialog, &app; prints the text produced by the dialog to standard output. - - - - - When you write &app; commands, ensure that you place quotation marks around each argument. - - - For example, use: zenity --calendar --title="Holiday Planner" Do not use: zenity --calendar --title=Holiday Planner - - - If you do not use quotation marks, you might get unexpected results. - - - - - Access Keys - - 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. - - - 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: - - "_Choose a name". - - - - Exit Codes - - &app; returns the following exit codes: - - - - - - - - - - Exit Code - - Description - - - - - - 0 - - - The user has pressed either OK or Close. - - - - - 1 - - - The user has either pressed Cancel, or used the window functions to close the dialog. - - - - - -1 - - - An unexpected error has occurred. - - - - - 5 - - - The dialog has been closed because the timeout has been reached. - - - - - - - - - - - - - General Options - - - All &app; dialogs support the following general options: - - - - - - =title - - Specifies the title of a dialog. - - - - - =icon_path - - 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'. - - - - - - =width - - Specifies the width of the dialog. - - - - - =height - - Specifies the height of the dialog. - - - - - =timeout - - Specifies the timeout in seconds after which the dialog is closed. - - - - - - - - - - - Help Options - - - &app; provides the following help options: - - - - - - - - Displays shortened help text. - - - - - - - Displays full help text for all dialogs. - - - - - - - Displays help text for general dialog options. - - - - - - - Displays help text for calendar dialog options. - - - - - - - Displays help text for text entry dialog options. - - - - - - - Displays help text for error dialog options. - - - - - - - Displays help text for information dialog options. - - - - - - - Displays help text for file selection dialog options. - - - - - - - Displays help text for list dialog options. - - - - - - - Displays help text for notification icon options. - - - - - - - Displays help text for progress dialog options. - - - - - - - Displays help text for question dialog options. - - - - - - - Displays help text for warning dialog options. - - - - - - - Displays help for text information dialog options. - - - - - - - Displays help for miscellaneous options. - - - - - - - Displays help for GTK+ options. - - - - - - - - - - - Miscellaneous Options - - - &app; also provides the following miscellaneous options: - - - - - - - - Displays the About &appname; dialog, which contains &app; version information, copyright information, and developer information. - - - - - - - Displays the version number of &app;. - - - - - - - - - - - GTK+ Options - - - &app; supports the standard GTK+ options. For more information about the GTK+ options, execute the zenity -? command. - - - - - - - - Environment Variables - - - Normally, &app; detects the terminal window from which it was launched - and keeps itself above that window. This behavior can be disabled by - unsetting the WINDOWID environment variable. - - - - - - - - - Calendar Dialog - - - Use the 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. - - - The calendar dialog supports the following options: - - - - - - =text - - Specifies the text that is displayed in the calendar dialog. - - - - - =day - - Specifies the day that is selected in the calendar dialog. day must be a number between 1 and 31 inclusive. - - - - - - =month - - Specifies the month that is selected in the calendar dialog. month must be a number between 1 and 12 inclusive. - - - - - - =year - - Specifies the year that is selected in the calendar dialog. - - - - - =format - - Specifies the format that is returned from the calendar dialog after date selection. The default format depends on your locale. format must be a format that is acceptable to the strftime function, for example %A %d/%m/%y. - - - - - - - - The following example script shows how to create a calendar dialog: - - - #!/bin/sh - - - if zenity --calendar \ - --title="Select a Date" \ - --text="Click on a date to select that date." \ - --day=10 --month=8 --year=2004 - then echo $? - else echo "No date selected" - fi - - - - -
- Calendar Dialog Example - - - - - - - &app; calendar dialog example - - - -
- - - - - - - - File Selection Dialog - - - Use the option to create a file selection dialog. &app; returns the selected files or directories to standard - output. The default mode of the file selection dialog is open. - - - The file selection dialog supports the following options: - - - - - - =filename - - Specifies the file or directory that is selected in the file selection dialog when the dialog is first shown. - - - - - - - Allows the selection of multiple filenames in the file selection dialog. - - - - - - - Allows only selection of directories in the file selection dialog. - - - - - - - Set the file selection dialog into save mode. - - - - - =separator - - Specifies the string that is used to divide the returned list of filenames. - - - - - - - The following example script shows how to create a file selection dialog: - - - #!/bin/sh - - FILE=`zenity --file-selection --title="Select a File"` - - case $? in - 0) - echo "\"$FILE\" selected.";; - 1) - echo "No file selected.";; - -1) - echo "No file selected.";; - esac - - - -
- File Selection Dialog Example - - - - - - - &app; file selection dialog example - - - -
- - - - - - Notification Icon - - - - - - - - =text - - Specifies the text that is displayed in the notification area. - - - - - - - The following example script shows how to create a notification icon: - - #!/bin/sh - - zenity --notification\ - --window-icon="info" \ - --text="There are system updates necessary!" - - - - -
- Notification Icon Example - - - - - - - &app; notification icon example - - - -
- - - - - - - List Dialog - - - Use the option to create a list dialog. &app; returns the entries in the first column of text of selected rows to standard output. - - - - Data for the dialog must specified column by column, row by row. Data can be provided to the dialog through standard input. Each entry must be separated by a newline character. - - - - If you use the or options, each row must start with either 'TRUE' or 'FALSE'. - - - - The list dialog supports the following options: - - - - - - =column - - Specifies the column headers that are displayed in the list dialog. You must specify a option for each column that you want to display in the dialog. - - - - - - - - Specifies that the first column in the list dialog contains check boxes. - - - - - - - - Specifies that the first column in the list dialog contains radio boxes. - - - - - - - - Allows the displayed items to be edited. - - - - - - =separator - - Specifies what string is used when the list dialog returns the selected entries. - - - - - - =column - - Specifies what column should be printed out upon selection. The default column is - '1'. 'ALL' can be used to print out all columns in the list. - - - - - - - - The following example script shows how to create a list dialog: - - #!/bin/sh - - zenity --list \ - --title="Choose the Bugs You Wish to View" \ - --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" - - - - -
- List Dialog Example - - - - - - - &app; list dialog example - - - -
- - - - - - - Message Dialogs - - - &app; can create four types of message dialog: - - - - Error - - - Information - - - Question - - - Warning - - - - -For each type, use the option to specify the text that is displayed in the dialog. - - - - Error Dialog - - - Use the option to create an error dialog. - - - - The following example script shows how to create an error dialog: - - - #!/bin/bash - - zenity --error \ - --text="Could not find /var/log/syslog." - - - - -
- Error Dialog Example - - - - - - - &app; error dialog example - - - -
- - - - Information Dialog - - - Use the option to create an information dialog. - - - - The following example script shows how to create an information dialog: - - - #!/bin/bash - - zenity --info \ - --text="Merge complete. Updated 3 of 10 files." - - - - -
- Information Dialog Example - - - - - - - &app; information dialog example - - - -
- - - - Question Dialog - - - Use the option to create a question dialog. - - - - The following example script shows how to create a question dialog: - - - #!/bin/bash - - zenity --question \ - --text="Are you sure you wish to proceed?" - - - - -
- Question Dialog Example - - - - - - - &app; question dialog example - - - -
- - - - Warning Dialog - - - Use the option to create a warning dialog. - - - - The following example script shows how to create a warning dialog: - - - #!/bin/bash - - zenity --warning \ - --text="Disconnect the power cable to avoid electrical shock." - - - - -
- Warning Dialog Example - - - - - - - &app; warning dialog example - - - -
- - - - - - - - Progress Dialog - - - Use the option to create a progress dialog. - - - - &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. - - - - The progress dialog supports the following options: - - - - - - =text - - Specifies the text that is displayed in the progress dialog. - - - - - =percentage - - Specifies the initial percentage that is set in the progress dialog. - - - - - - - Closes the progress dialog when 100% has been reached. - - - - - - - Specifies that the progress bar pulsates until an EOF character is read from standard input. - - - - - - - The following example script shows how to create a progress dialog: - - #!/bin/sh - ( - echo "10" ; sleep 1 - echo "# Updating mail logs" ; sleep 1 - echo "20" ; sleep 1 - echo "# Resetting cron jobs" ; sleep 1 - echo "50" ; sleep 1 - echo "This line will just be ignored" ; sleep 1 - echo "75" ; sleep 1 - echo "# Rebooting system" ; sleep 1 - echo "100" ; sleep 1 - ) | - zenity --progress \ - --title="Update System Logs" \ - --text="Scanning mail logs..." \ - --percentage=0 - - if [ "$?" = -1 ] ; then - zenity --error \ - --text="Update canceled." - fi - - - - - -
- Progress Dialog Example - - - - - - - &app; progress dialog example - - - -
- - - - - - - Text Entry Dialog - - - Use the option to create a text entry dialog. &app; returns the contents of the text entry to standard output. - - - The text entry dialog supports the following options: - - - - - - =text - - Specifies the text that is displayed in the text entry dialog. - - - - - =text - - Specifies the text that is displayed in the entry field of the text entry dialog. - - - - - - - Hides the text in the entry field of the text entry dialog. - - - - - - - The following example script shows how to create a text entry dialog: - - - #!/bin/sh - - if zenity --entry \ - --title="Add an Entry" \ - --text="Enter your _password:" \ - --entry-text "password" \ - --hide-text - then echo $? - else echo "No password entered" - fi - - - - -
- Text Entry Dialog Example - - - - - - - &app; text entry dialog example - - - -
- - - - - - Text Information Dialog - - - Use the option to create a text information dialog. - - - - The text information dialog supports the following options: - - - - - - =filename - - Specifies a file that is loaded in the text information dialog. - - - - - - - Allows the displayed text to be edited. The edited text is returned to standard output when the dialog is closed. - - - - - - - The following example script shows how to create a text information dialog: - - #!/bin/sh - - FILE=`zenity --file-selection \ - --title="Select a File"` - - case $? in - 0) - zenity --text-info \ - --title=$FILE \ - --filename=$FILE \ - --editable 2>/tmp/tmp.txt;; - 1) - echo "No file selected.";; - -1) - echo "No file selected.";; - esac - - - - -
- Text Information Dialog Example - - - - - - - &app; text information dialog example - - - -
- - - -
-- cgit From 5d0afb8281792ee22591e3c40fea08f53e3b7b3d Mon Sep 17 00:00:00 2001 From: Tiffany Antopolski Date: Sun, 18 Dec 2011 13:14:05 -0500 Subject: [help/C] index.page: added license information. --- help/C/index.page | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'help/C') diff --git a/help/C/index.page b/help/C/index.page index 96a9cd0d..50e5d7e5 100644 --- a/help/C/index.page +++ b/help/C/index.page @@ -16,6 +16,10 @@ Yasumichi Akahoshi yasumichi@vinelinux.org + +

GNU Free Documentation License (GFDL)

+ + Zenity Manual -- cgit From 4897a8fa29d23249d7bc8acd9cfda4b8b12b3f4d Mon Sep 17 00:00:00 2001 From: Yasumichi Akahoshi Date: Fri, 23 Dec 2011 09:46:46 +0900 Subject: fixed figure title and desc of scale dialog. Signed-off-by: Yasumichi Akahoshi --- help/C/scale.page | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'help/C') diff --git a/help/C/scale.page b/help/C/scale.page index 7d35b533..29b20800 100644 --- a/help/C/scale.page +++ b/help/C/scale.page @@ -72,8 +72,8 @@ esac
- Password Entry Dialog Example - Zenity password entry dialog example + Scale Dialog Example + Zenity scale dialog example
-- cgit From 073e9de8b044dc633bc5b60c1cd99af3843e8d48 Mon Sep 17 00:00:00 2001 From: Yasumichi Akahoshi Date: Mon, 26 Dec 2011 15:59:52 +0900 Subject: fixed figure of color selection dialog. Signed-off-by: Yasumichi Akahoshi --- help/C/color-selection.page | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'help/C') diff --git a/help/C/color-selection.page b/help/C/color-selection.page index 55402b92..66adb1b3 100644 --- a/help/C/color-selection.page +++ b/help/C/color-selection.page @@ -47,8 +47,8 @@ esac
- Password Entry Dialog Example - Zenity password entry dialog example + Color Selection Dialog Example + Zenity color selection dialog example
-- cgit From e4c5d60ee2f54bf4db3057483214e50ffd140c6c Mon Sep 17 00:00:00 2001 From: Javier Jardón Date: Fri, 10 Aug 2012 02:40:15 +0900 Subject: Port to new documentation infrastructure --- help/C/legal.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'help/C') diff --git a/help/C/legal.xml b/help/C/legal.xml index ac97e1de..899282c3 100644 --- a/help/C/legal.xml +++ b/help/C/legal.xml @@ -6,7 +6,7 @@ by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS + url="help:fdl">link or in the file COPYING-DOCS distributed with this manual. This manual is part of a collection of GNOME manuals -- cgit From 1224a5a18b552d70575371c16df6052c9d17d98b Mon Sep 17 00:00:00 2001 From: Sindhu S Date: Tue, 5 Nov 2013 21:36:33 +0530 Subject: Add user help for --listen, bug 711396 --- .../zenity-notification-listen-screenshot.png | Bin 0 -> 21288 bytes help/C/notification.page | 30 ++++++++++++++++++--- 2 files changed, 27 insertions(+), 3 deletions(-) create mode 100644 help/C/figures/zenity-notification-listen-screenshot.png (limited to 'help/C') diff --git a/help/C/figures/zenity-notification-listen-screenshot.png b/help/C/figures/zenity-notification-listen-screenshot.png new file mode 100644 index 00000000..27f476f9 Binary files /dev/null and b/help/C/figures/zenity-notification-listen-screenshot.png differ diff --git a/help/C/notification.page b/help/C/notification.page index ac556378..f6dfd41f 100644 --- a/help/C/notification.page +++ b/help/C/notification.page @@ -16,7 +16,13 @@ <cmd>--text</cmd>=<var>text</var>

Specifies the text that is displayed in the notification area.

- + + <cmd>--listen</cmd>=icon: '<var>text</var>', message: '<var>text</var>', tooltip: '<var>text</var>', visible: '<var>text</var>', +

Listens for commands at standard input. At least one command must be specified. Commands are comma seperated. A command must be followed by a colon and a value.

+ +

The icon command also accepts four stock icon values such as error, info, question and warning.

+ +

@@ -30,10 +36,28 @@ zenity --notification\ --text="There are system updates necessary!" -

Notification Icon Example Zenity notification icon example
- + +

+ The following example script shows how to create a notification icon along with --listen: +

+ + +#!/bin/sh + +cat <<EOH| zenity --notification --listen +message: this is the message text +EOH + + +
+ Notification Icon with <cmd>--listen</cmd> Example + Zenity notification with --listen example + +
+ + \ No newline at end of file -- cgit From 3321275c4505a81562385c06b96725ab37ddd6b9 Mon Sep 17 00:00:00 2001 From: Andre Klapper Date: Sun, 23 Mar 2014 21:53:43 +0100 Subject: User docs: Make page ID the same as file name --- help/C/intro.page | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'help/C') diff --git a/help/C/intro.page b/help/C/intro.page index 8a7bdec1..e6f279be 100644 --- a/help/C/intro.page +++ b/help/C/intro.page @@ -1,6 +1,6 @@ + id="intro"> Zenity enables you to create the various types of simple dialog. -- cgit From df673425214678a75624b8f30ed634b2cedffc6b Mon Sep 17 00:00:00 2001 From: Sindhu S Date: Tue, 22 Apr 2014 22:19:17 +0530 Subject: help: Update notification.page Replace obsolete screenshots with new ones. Fix alignment of mallard tags. Update instructions for --listen. --- .../zenity-notification-listen-screenshot.png | Bin 21288 -> 21651 bytes help/C/figures/zenity-notification-screenshot.png | Bin 12875 -> 24580 bytes help/C/notification.page | 97 ++++++++++----------- 3 files changed, 44 insertions(+), 53 deletions(-) (limited to 'help/C') diff --git a/help/C/figures/zenity-notification-listen-screenshot.png b/help/C/figures/zenity-notification-listen-screenshot.png index 27f476f9..242478f0 100644 Binary files a/help/C/figures/zenity-notification-listen-screenshot.png and b/help/C/figures/zenity-notification-listen-screenshot.png differ diff --git a/help/C/figures/zenity-notification-screenshot.png b/help/C/figures/zenity-notification-screenshot.png index 4c3a0256..6f804b86 100644 Binary files a/help/C/figures/zenity-notification-screenshot.png and b/help/C/figures/zenity-notification-screenshot.png differ diff --git a/help/C/notification.page b/help/C/notification.page index f6dfd41f..62a63d82 100644 --- a/help/C/notification.page +++ b/help/C/notification.page @@ -6,58 +6,49 @@ Use the --notification option. Notification Icon -

- Use the --notification option to create a notification icon. -

- - - - - <cmd>--text</cmd>=<var>text</var> -

Specifies the text that is displayed in the notification area.

- - - <cmd>--listen</cmd>=icon: '<var>text</var>', message: '<var>text</var>', tooltip: '<var>text</var>', visible: '<var>text</var>', -

Listens for commands at standard input. At least one command must be specified. Commands are comma seperated. A command must be followed by a colon and a value.

- -

The icon command also accepts four stock icon values such as error, info, question and warning.

- - - - -

- The following example script shows how to create a notification icon: -

- -#!/bin/sh - -zenity --notification\ - --window-icon="info" \ - --text="There are system updates necessary!" - - -
- Notification Icon Example - Zenity notification icon example - -
- -

- The following example script shows how to create a notification icon along with --listen: -

- - -#!/bin/sh - -cat <<EOH| zenity --notification --listen -message: this is the message text -EOH - - -
- Notification Icon with <cmd>--listen</cmd> Example - Zenity notification with --listen example - -
+

Use the --notification option to create a notification icon.

+ + + + <cmd>--text</cmd>=<var>text</var> +

Specifies the text that is displayed in the notification area.

+ + + <cmd>--listen</cmd>=icon: '<var>text</var>', message: '<var>text</var>', tooltip: '<var>text</var>', visible: '<var>text</var>', +

Listens for commands at standard input. At least one command must be specified. Commands are comma seperated. A command must be followed by a colon and a value.

+ +

The icon command also accepts four stock icon values such as error, info, question and warning.

+ + + + +

The following example script shows how to create a notification icon:

+ + #!/bin/sh + + zenity --notification\ + --window-icon="info" \ + --text="There are system updates necessary!" + + +
+ Notification Icon Example + Zenity notification icon example + +
+ +

The following example script shows how to create a notification icon along with --listen:

+ + #!/bin/sh + cat <<EOH| zenity --notification --listen + message: this is the message text + EOH + + +
+ Notification Icon with <cmd>--listen</cmd> Example + Zenity notification with --listen example + +
\ No newline at end of file -- cgit From 1cdee563a1599d00539f1dc0060c3ee0825274ed Mon Sep 17 00:00:00 2001 From: Anders Jonsson Date: Wed, 1 Apr 2015 15:26:48 +0200 Subject: Fix typo in documentation --- help/C/notification.page | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'help/C') diff --git a/help/C/notification.page b/help/C/notification.page index 62a63d82..01a504e2 100644 --- a/help/C/notification.page +++ b/help/C/notification.page @@ -15,7 +15,7 @@ <cmd>--listen</cmd>=icon: '<var>text</var>', message: '<var>text</var>', tooltip: '<var>text</var>', visible: '<var>text</var>', -

Listens for commands at standard input. At least one command must be specified. Commands are comma seperated. A command must be followed by a colon and a value.

+

Listens for commands at standard input. At least one command must be specified. Commands are comma separated. A command must be followed by a colon and a value.

The icon command also accepts four stock icon values such as error, info, question and warning.

 @@ -51,4 +51,4 @@
- \ No newline at end of file + -- cgit From d0da299f5145e9a31824f834fd9147d5dda5c0f5 Mon Sep 17 00:00:00 2001 From: Andre Klapper Date: Sat, 23 Sep 2017 22:48:48 +0200 Subject: help: Remove id parameter from figure element, to pass 'yelp-check validate' --- help/C/calendar.page | 2 +- help/C/color-selection.page | 2 +- help/C/entry.page | 2 +- help/C/error.page | 2 +- help/C/file-selection.page | 2 +- help/C/forms.page | 2 +- help/C/info.page | 2 +- help/C/list.page | 2 +- help/C/notification.page | 4 ++-- help/C/password.page | 2 +- help/C/progress.page | 2 +- help/C/question.page | 2 +- help/C/scale.page | 2 +- help/C/text.page | 2 +- help/C/warning.page | 3 +-- 15 files changed, 16 insertions(+), 17 deletions(-) (limited to 'help/C') diff --git a/help/C/calendar.page b/help/C/calendar.page index cd2191c2..1c0a8d46 100644 --- a/help/C/calendar.page +++ b/help/C/calendar.page @@ -60,7 +60,7 @@ fi -
+
Calendar Dialog Example Zenity calendar dialog example diff --git a/help/C/color-selection.page b/help/C/color-selection.page index 66adb1b3..6bb7f3df 100644 --- a/help/C/color-selection.page +++ b/help/C/color-selection.page @@ -46,7 +46,7 @@ case $? in esac -
+
Color Selection Dialog Example Zenity color selection dialog example diff --git a/help/C/entry.page b/help/C/entry.page index 69ad4641..03b2db6e 100644 --- a/help/C/entry.page +++ b/help/C/entry.page @@ -49,7 +49,7 @@ fi -
+
Text Entry Dialog Example Zenity text entry dialog example diff --git a/help/C/error.page b/help/C/error.page index 5c9113ac..4d15ae8f 100644 --- a/help/C/error.page +++ b/help/C/error.page @@ -22,7 +22,7 @@ zenity --error \ -
+
Error Dialog Example Zenity error dialog example diff --git a/help/C/file-selection.page b/help/C/file-selection.page index 0ec8c5bd..9687d8f7 100644 --- a/help/C/file-selection.page +++ b/help/C/file-selection.page @@ -62,7 +62,7 @@ case $? in esac -
+
File Selection Dialog Example Zenity file selection dialog example diff --git a/help/C/forms.page b/help/C/forms.page index fcf6c657..a3d529c1 100644 --- a/help/C/forms.page +++ b/help/C/forms.page @@ -75,7 +75,7 @@ case $? in esac -
+
Forms Dialog Example Zenity forms dialog example diff --git a/help/C/info.page b/help/C/info.page index 1ea62324..8e8c8d5f 100644 --- a/help/C/info.page +++ b/help/C/info.page @@ -22,7 +22,7 @@ zenity --info \ -
+
Information Dialog Example Zenity information dialog example diff --git a/help/C/list.page b/help/C/list.page index 39e86cd4..776f33eb 100644 --- a/help/C/list.page +++ b/help/C/list.page @@ -78,7 +78,7 @@ zenity --list \ -
+
List Dialog Example Zenity list dialog example diff --git a/help/C/notification.page b/help/C/notification.page index 01a504e2..c82bd58a 100644 --- a/help/C/notification.page +++ b/help/C/notification.page @@ -31,7 +31,7 @@ --text="There are system updates necessary!" -
+
Notification Icon Example Zenity notification icon example @@ -45,7 +45,7 @@ EOH -
+
Notification Icon with <cmd>--listen</cmd> Example Zenity notification with --listen example diff --git a/help/C/password.page b/help/C/password.page index 22094d89..ed062a32 100644 --- a/help/C/password.page +++ b/help/C/password.page @@ -41,7 +41,7 @@ case $? in esac -
+
Password Entry Dialog Example Zenity password entry dialog example diff --git a/help/C/progress.page b/help/C/progress.page index caabb16a..3ed5260e 100644 --- a/help/C/progress.page +++ b/help/C/progress.page @@ -71,7 +71,7 @@ fi -
+
Progress Dialog Example Zenity progress dialog example diff --git a/help/C/question.page b/help/C/question.page index 6e435c57..3f586023 100644 --- a/help/C/question.page +++ b/help/C/question.page @@ -22,7 +22,7 @@ zenity --question \ -
+
Question Dialog Example Zenity question dialog example diff --git a/help/C/scale.page b/help/C/scale.page index 29b20800..78c2ac50 100644 --- a/help/C/scale.page +++ b/help/C/scale.page @@ -71,7 +71,7 @@ case $? in esac -
+
Scale Dialog Example Zenity scale dialog example diff --git a/help/C/text.page b/help/C/text.page index f01166ec..25d67728 100644 --- a/help/C/text.page +++ b/help/C/text.page @@ -77,7 +77,7 @@ case $? in esac -
+
Text Information Dialog Example Zenity text information dialog example diff --git a/help/C/warning.page b/help/C/warning.page index 1b7a642f..f470d847 100644 --- a/help/C/warning.page +++ b/help/C/warning.page @@ -21,8 +21,7 @@ zenity --warning \ --text="Disconnect the power cable to avoid electrical shock." - -
+
Warning Dialog Example Zenity warning dialog example -- cgit From b011066c32acb8b8a6a1ece5970a17be2ee4681a Mon Sep 17 00:00:00 2001 From: Andre Klapper Date: Mon, 25 Sep 2017 17:55:17 +0200 Subject: Remove unsupported parameters so yelp-check validates --- help/C/usage.page | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) (limited to 'help/C') diff --git a/help/C/usage.page b/help/C/usage.page index 6aab6005..96e9ea40 100644 --- a/help/C/usage.page +++ b/help/C/usage.page @@ -57,15 +57,15 @@ - - + - - + @@ -73,7 +73,7 @@

The user has pressed either OK or Close.

- + @@ -81,7 +81,7 @@

The user has either pressed Cancel, or used the window functions to close the dialog.

- + @@ -89,7 +89,7 @@

An unexpected error has occurred.

- + -- cgit
+

Exit Code

 +

Description

0

1

-1

5