ZENITY(1)							    ZENITY(1)



NAME
       zenity - display GTK+ dialogs

SYNOPSIS
       zenity [options]

DESCRIPTION
       zenity is a program that will display GTK+ dialogs, and return (either
       in the return code, or on  standard  output)  the  users	 input.	 This
       allows  you  to	present information, and ask for information from the
       user, from all manner of shell scripts.

       For example, zenity --question will return either 0 or 1, depending on
       whether	the  user pressed OK or Cancel. zenity --entry will output on
       standard output what the user typed into the text entry field.

       Comprehensive documentation is available in the	GNOME  Help  Browser,
       under GNOME/Utilities.

OPTIONS
       This  program  follows  the  usual  GNU command line syntax, with long
       options starting with two dashes ('-').


       Dialog options


       --calendar
	      Display calendar dialog

       --entry
	      Display text entry dialog

       --error
	      Display error dialog

       --file-selection
	      Display file selection dialog

       --info Display info dialog

       --list Display list dialog

       --progress
	      Display progress indication dialog

       --question
	      Display question dialog

       --text-info
	      Display text information dialog

       --warning
	      Display warning dialog


       General options


       --title=TITLE
	      Set the dialog title

       --window-icon=ICONPATH
	      Set the window icon

       --width=WIDTH
	      Set the dialog width

       --height=HEIGHT
	      Set the dialog height

       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 options


       --text=STRING
	      Set the dialog text

       --entry-text=STRING
	      Set the entry text

       --hide-text
	      Hide the entry text


       Error options

       --text=STRING
	      Set the dialog text


       File selection options

       --filename=FILENAME
	      Set the filename

       --multiple
	      Allow selection of multiple filenames in file selection dialog

       --separator=SEPARATOR
	      Specify separator character when returning multiple filenames


       Info options

       --text=STRING
	      Set the dialog text


       List options


       --text=STRING
	      Set the dialog text

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

       --editable
	      Allow changes to text

       --print-column=STRING
	      Specify what column to print to standard output. The default is
	      to  return  the  first  column.  'ALL' may be used to print all
	      columns.


       Progress options


       --text=STRING
	      Set the dialog text

       --percentage=INT
	      Set initial percentage

       --auto-close
	      Close dialog when 100% has been reached

       --pulsate
	      Pulsate progress bar

	      Question options

       --text=STRING
	      Set the dialog text


       Text options


       --filename=FILENAME
	      Open file

       --editable
	      Allow changes to text


       Warning options


       --text=STRING
	      Set the dialog text


       Miscellaneous options


       -?, --help
	      Show summary of options.

       --about
	      Display an about dialog.

       --version
	      Show version of program.


       Also the standard GTK+ options are accepted.


EXAMPLES
       Display a file selector with the title Select a file  to	 remove.  The
       file selected is returned on standard output.

	      zenity  --title="Select a file to remove" --file-selection

       Display	a  text	 entry dialog with the title Select Host and the text
       Select the host you would like to  flood-ping.  The  entered  text  is
       returned on standard output.

	      zenity   --title	"Select Host" --entry --text "Select the host
	      you would like to flood-ping"

       Display a dialog, asking Microsoft Windows has been found!  Would  you
       like to remove it?. The return code will be 0 (true in shell) if OK is
       selected, and 1 (false) if Cancel is selected.

	      zenity  --question --title "Alert"  --text  "Microsoft  Windows
	      has been found! Would you like to remove it?"

       Show the search results in a list dialog with the title Search Results
       and the text Finding all header files....

	      find . -name '*.h' | zenity  --title  "Search  Results"  --text
	      "Finding all header files.." --column "Files"

       Display	a weekly shopping list in a check list dialog with Apples and
       Oranges pre selected

	      zenity --list --checklist --column "Buy" --column	 "Item"	 TRUE
	      Apples TRUE Oranges FALSE Pears FALSE Toothpaste

       Display a progress dialog while searching for all the postscript files
       in your home directory

       find 'echo $HOME' '*.ps' | zenity --progress --pulsate

AUTHOR
       Zenity was written by Glynn Foster .

       This manual page was written by Ross Burton .


SEE ALSO
       gdialog(1), dialog(1)



			      February 1st, 2003		    ZENITY(1)

UNIX/Linux commands referenced on this page:

1. display
2. file
3. info
4. column
5. host
6. find
7. echo