diff options
Diffstat (limited to 'Master/texmf/doc/man/man1/tcdialog.1')
-rw-r--r-- | Master/texmf/doc/man/man1/tcdialog.1 | 48 |
1 files changed, 45 insertions, 3 deletions
diff --git a/Master/texmf/doc/man/man1/tcdialog.1 b/Master/texmf/doc/man/man1/tcdialog.1 index c99e4fbd8ce..5168fb3dd62 100644 --- a/Master/texmf/doc/man/man1/tcdialog.1 +++ b/Master/texmf/doc/man/man1/tcdialog.1 @@ -1,6 +1,6 @@ '\" t -.\" $Id: dialog.1,v 1.115 2008/07/27 22:49:40 tom Exp $ -.\" Copyright 2005-2007,2008 Thomas E. Dickey +.\" $Id: dialog.1,v 1.120 2010/01/18 10:19:07 tom Exp $ +.\" Copyright 2005-2008,2010 Thomas E. Dickey .\" .\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU Lesser General Public License, version 2.1 @@ -29,7 +29,7 @@ .RE .. . -.TH DIALOG 1 "" "$Date: 2008/07/27 22:49:40 $" +.TH DIALOG 1 "" "$Date: 2010/01/18 10:19:07 $" .SH NAME dialog \- display dialog boxes from shell scripts .SH SYNOPSIS @@ -240,6 +240,12 @@ this can be used to dump a sample configuration file to the file specified by .IR file "." . +.IP "\fB--date-format \fIformat" +If the host provides \fBstrftime\fP, +this option allows you to specify the format of the date printed for +the \fB--calendar\fP widget. +The time of day (hour, minute, second) are the current local time. +. .IP "\fB--defaultno" Make the default value of the \fByes/no\fP @@ -399,6 +405,11 @@ Prints the size of each dialog box to \fBdialog\fP's output. Prints \fBdialog\fR's version to \fBdialog\fP's output. This may be used alone, without other options. . +.IP "\fB--scrollbar \fIstring" +For widgets holding a scrollable set of data, +draw a scrollbar on its right-margin. +This does not respond to the mouse. +. .IP "\fB--separate-output" For checklist widgets, output result one line at a time, with no quoting. This facilitates parsing by another program. @@ -453,6 +464,12 @@ Specify the number of spaces that a tab character occupies if the The default is 8. This option is only effective for the \fBtextbox\fP widget. . +.IP "\fB--time-format \fIformat" +If the host provides \fBstrftime\fP, +this option allows you to specify the format of the time printed for +the \fB--timebox\fP widget. +The day, month, year values in this case are for the current local time. +. .IP "\fB--timeout \fIsecs" Timeout (exit with error code) if no user response within the given number of seconds. @@ -519,6 +536,7 @@ Use tab or backtab to move between windows. If the year is given as zero, the current date is used as an initial value. .IP On exit, the date is printed in the form day/month/year. +The format can be overridden using the \fB--date-format\fP option. . . .IP "\fB--checklist \fItext height width list-height \fR[ \fItag item status \fR] \fI..." @@ -528,6 +546,9 @@ box is similar to a \fBmenu\fP box; there are multiple entries presented in the form of a menu. +Another difference is +that you can indicate which entry is currently selected, by setting its +.IR status " to " on "." Instead of choosing one entry among the entries, each entry can be turned on or off by the user. The initial on/off state of each entry is specified by @@ -921,6 +942,7 @@ left-, up-, right- and down-arrows. Use tab or backtab to move between windows. .IP On exit, the result is printed in the form hour:minute:second. +The format can be overridden using the \fB--time-format\fP option. . . .IP "\fB--yesno \fItext height width" @@ -1104,12 +1126,32 @@ button is pressed. if the .BR Extra button is pressed. +4 +if the +.BR Item Help +button is pressed. .TP 5 -1 if errors occur inside \fBdialog\fP or \fBdialog\fP is exited by pressing the \fIESC\fP key. . .\" ************************************************************************ +.SH PORTABILITY +\fBdialog\fP works with X/Open curses. +However, some implementations have deficiencies: +.RS 3 +.TP 3 +- +HPUX curses (and perhaps others) do not open the terminal properly for +the \fInewterm\fP function. +This interferes with \fBdialog\fP's \fB--input-fd\fP option, +by preventing cursor-keys and similar escape sequences from being recognized. +.TP 3 +- +NetBSD curses does not support subwindows of subwindows. +\fBdialog\fP will not display shadows of windows. +.RE +.\" ************************************************************************ .SH COMPATIBILITY You may want to write scripts which run with other \fBdialog\fP "clones". .SS ORIGINAL DIALOG |