Provided by: mate-dialogs-common_1.6.2-1ubuntu1_all 
NAME
matedialog - display GTK+ dialogs
SYNOPSIS
matedialog [options]
DESCRIPTION
matedialog 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, matedialog --question will return either 0 or 1, depending on whether the
user pressed OK or Cancel. matedialog --entry will output on standard output what the user
typed into the text entry field.
Comprehensive documentation is available in the MATE Help Browser, under MATE/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
--notification
Display notification icon
--progress
Display progress indication dialog
--question
Display question dialog
--text-info
Display text information dialog
--warning
Display warning dialog
--scale
Display scale dialog
--color-selection
Display color selection dialog
General options
--title=TITLE
Set the dialog title
--window-icon=ICONPATH
Set the window icon with the path to an image. Alternatively, one of the four stock
icons can be used: 'error', 'info', 'question' or 'warning'
--width=WIDTH
Set the dialog width
--height=HEIGHT
Set the dialog height
--timeout=TIMEOUT
Set the dialog timeout in seconds
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=PATTERN
Set the format for the returned date. The default depends on the user locale or be
set with the strftime style. For example %A %d/%m/%y
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
--no-wrap
Do not enable text wrapping
File selection options
--filename=FILENAME
Set the file or directory to be selected by default
--multiple
Allow selection of multiple filenames in file selection dialog
--directory
Activate directory-only selection
--save Activate save mode
--separator=SEPARATOR
Specify separator character when returning multiple filenames
--confirm-overwrite
Confirm file selection if filename already exists
--file-filter=NAME | PATTERN1 PATTERN2
Sets a filename filter
Info options
--text=STRING
Set the dialog text
--no-wrap
Do not enable text wrapping
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
--multiple
Allow multiple rows to be selected
--editable
Allow changes to text
--print-column=NUMBER
Specify what column to print to standard output. The default is to return the first
column. 'ALL' may be used to print all columns.
--hide-column=NUMBER
Hide a specific column
--hide-header
Hides the column headers
Notification options
--text=STRING
Set the notification text
--listen
Listen for commands on stdin. Commands include 'message', 'tooltip', 'icon', and
'visible' separated by a colon. For example, 'message: Hello world', 'visible:
false', or 'icon: /path/to/icon'. The icon command also accepts the four stock
icon: 'error', 'info', 'question', and 'warning'
Progress options
--text=STRING
Set the dialog text
--percentage=INT
Set initial percentage
--auto-close
Close dialog when 100% has been reached
--auto-kill
Kill parent process if cancel button is pressed
--pulsate
Pulsate progress bar
--no-cancel
Hides the cancel button
Question options
--text=STRING
Set the dialog text
--no-wrap
Do not enable text wrapping
--ok-label
Set the text of the OK button
--cancel-label
Set the text of the cancel button
Text options
--filename=FILENAME
Open file
--editable
Allow changes to text
Warning options
--text=STRING
Set the dialog text
--no-wrap
Do not enable text wrapping
Scale options
--text=STRING
Set the dialog text
--value=VALUE
Set initial value
--min-value=VALUE
Set minimum value
--max-value=VALUE
Set maximum value
--step=VALUE
Set step size
--print-partial
Print partial values
--hide-value
Hide value
Color selection options
--color=VALUE
Set the initial color
--show-palette
Show the palette
Miscellaneous options
-?, --help
Show summary of options.
--about
Display an about dialog.
--version
Show version of program.
Also the standard GTK+ options are accepted.
ENVIRONMENT
Normally, matedialog 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.
EXAMPLES
Display a file selector with the title Select a file to remove. The file selected is
returned on standard output.
matedialog --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.
matedialog --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.
matedialog --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' | matedialog --list --title "Search Results" --text "Finding all
header files.." --column "Files"
Show an icon in the notification area
matedialog --notification --window-icon=update.png --text "System update
necessary!"
Display a weekly shopping list in a check list dialog with Apples and Oranges pre selected
matedialog --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 $HOME -name '*.ps' | matedialog --progress --pulsate
AUTHOR
MateDialog was written by Glynn Foster <glynn.foster@sun.com>.
This manual page was written by Ross Burton <ross@burtonini.com>.
SEE ALSO
gdialog(1), dialog(1)
February 1st, 2003 MATEDIALOG(1)