Documentation for -placeholder and -placeholderforeground options, from René Zaumseil. Does not compile and needs further work.

5 files changed, 24 insertions, 1 deletions

diff --git a/doc/entry.n b/doc/entry.n
index 40b45c7..7e52327 100644
--- a/doc/entry.n
+++ b/doc/entry.n
@@ -36,6 +36,14 @@ Specifies a script to eval when \fB\-validatecommand\fR returns 0.
 Setting it to {} disables this feature (the default).  The best use
 of this option is to set it to \fIbell\fR.  See \fBVALIDATION\fR
 below for more information.
+.OP \-placeholder placeHolder PlaceHolder
+Specifies an help text to display if no text is otherwise displayed.
+The displayed text will be displayed using the \fB\-font\fR and
+\fB\-justify\fR options.
+.OP \-placeholderforeground placeholderForeground PlaceholderForeground
+Specifies the foreground color to use when the placeholder text is displayed.
+If this option is the empty string, the normal placeholder foreground color
+is used.
 .OP \-readonlybackground readonlyBackground ReadonlyBackground
 Specifies the background color to use when the entry is readonly.  If
 this option is the empty string, the normal background color is used.
diff --git a/doc/spinbox.n b/doc/spinbox.n
index 638b726..e826713 100644
--- a/doc/spinbox.n
+++ b/doc/spinbox.n
@@ -67,6 +67,14 @@ A floating-point value specifying the increment.  When used with
 \fB\-from\fR and \fB\-to\fR, the value in the widget will be adjusted by
 \fB\-increment\fR when a spin button is pressed (up adds the value,
 down subtracts the value).
+.OP \-placeholder placeHolder PlaceHolder
+Specifies an help text to display if no text is otherwise displayed.
+The displayed text will be displayed using the \fB\-font\fR and
+\fB\-justify\fR options.
+.OP \-placeholderforeground placeholderForeground PlaceholderForeground
+Specifies the foreground color to use when the placeholder text is displayed.
+If this option is the empty string, the normal placeholder foreground color
+is used.
 .OP \-readonlybackground readonlyBackground ReadonlyBackground
 Specifies the background color to use when the spinbox is readonly.  If
 this option is the empty string, the normal background color is used.
diff --git a/doc/ttk_combobox.n b/doc/ttk_combobox.n
index 5e5b3fc..dad2e8b 100644
--- a/doc/ttk_combobox.n
+++ b/doc/ttk_combobox.n
@@ -20,6 +20,8 @@ values in the list.
 .SO ttk_widget
 \-class	\-cursor	\-takefocus
 \-style
+.SO ttk_entry
+\-placeholder
 .SE
 .\" ALSO: Other entry widget options
 .SH "WIDGET-SPECIFIC OPTIONS"
diff --git a/doc/ttk_entry.n b/doc/ttk_entry.n
index 5f72707..343d2f4 100644
--- a/doc/ttk_entry.n
+++ b/doc/ttk_entry.n
@@ -47,6 +47,11 @@ One of \fBleft\fR, \fBcenter\fR, or \fBright\fR.
 .\" MAYBE: .OP \-selectbackground selectBackground Foreground
 .\" MAYBE: .OP \-selectborderwidth selectBorderWidth BorderWidth
 .\" MAYBE: .OP \-selectforeground selectForeground Background
+.OP \-placeholder placeHolder PlaceHolder
+Specifies an help text to display if no text is otherwise displayed.
+The displayed text will be displayed using the \fB\-font\fR and
+\fB\-justify\fR options. The foreground color of the displayed text
+can be changed using the \fB\-placeholderforeground\fR style option.
 .OP \-show show Show
 If this option is specified, then the true contents of the entry
 are not displayed in the window.
diff --git a/doc/ttk_spinbox.n b/doc/ttk_spinbox.n
index b55d12e..fec726c 100644
--- a/doc/ttk_spinbox.n
+++ b/doc/ttk_spinbox.n
@@ -25,7 +25,7 @@ to a Tcl variable.
 \-takefocus	\-xscrollcommand
 .SE
 .SO ttk_entry
-\-validate	\-validatecommand
+\-placeholder	\-validate	\-validatecommand
 .SE
 .SH "WIDGET-SPECIFIC OPTIONS"
 .OP \-command command Command