summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2007-08-28 15:16:10 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2007-08-28 15:16:10 (GMT)
commit5397491a300effb666df74fee45b7ce334350586 (patch)
tree949a47d61ae43ae08199dc36040c6697e50fcba0 /doc
parent9fef5d810024d4e069a4792461495a17eda7d956 (diff)
downloadtk-5397491a300effb666df74fee45b7ce334350586.zip
tk-5397491a300effb666df74fee45b7ce334350586.tar.gz
tk-5397491a300effb666df74fee45b7ce334350586.tar.bz2
Assorted documentation improvements.
Diffstat (limited to 'doc')
-rw-r--r--doc/button.n20
-rw-r--r--doc/checkbutton.n15
-rw-r--r--doc/console.n8
-rw-r--r--doc/tk.n5
-rw-r--r--doc/ttk_combobox.n4
5 files changed, 41 insertions, 11 deletions
diff --git a/doc/button.n b/doc/button.n
index 333ff61..fcb44ff 100644
--- a/doc/button.n
+++ b/doc/button.n
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: button.n,v 1.11 2006/12/13 23:04:32 hobbs Exp $
+'\" RCS: @(#) $Id: button.n,v 1.12 2007/08/28 15:16:11 dkf Exp $
'\"
.so man.macros
.TH button n 4.4 Tk "Tk Built-In Commands"
@@ -177,8 +177,24 @@ actions occur: the button is completely non-responsive.
The behavior of buttons can be changed by defining new bindings for
individual widgets or by redefining the class bindings.
+.SH EXAMPLES
+This is the classic Tk "Hello, World!" demonstration:
+.PP
+.CS
+ \fBbutton\fR .b -text "Hello, World!" -command exit
+ pack .b
+.CE
+.PP
+This example demonstrates how to handle button accelerators:
+.PP
+.CS
+ \fBbutton\fR .b1 -text Hello -underline 0
+ \fBbutton\fR .b2 -text World -underline 0
+ bind . <Key-h> {.b1 flash; .b1 invoke}
+ bind . <Key-w> {.b2 flash; .b2 invoke}
+ pack .b1 .b2
+.CE
.SH "SEE ALSO"
ttk_button(n)
-
.SH KEYWORDS
button, widget
diff --git a/doc/checkbutton.n b/doc/checkbutton.n
index c22bbcb..1383513 100644
--- a/doc/checkbutton.n
+++ b/doc/checkbutton.n
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: checkbutton.n,v 1.12 2006/12/13 23:04:32 hobbs Exp $
+'\" RCS: @(#) $Id: checkbutton.n,v 1.13 2007/08/28 15:16:11 dkf Exp $
'\"
.so man.macros
.TH checkbutton n 4.4 Tk "Tk Built-In Commands"
@@ -262,8 +262,19 @@ actions occur: the checkbutton is completely non-responsive.
The behavior of checkbuttons can be changed by defining new bindings for
individual widgets or by redefining the class bindings.
+.SH EXAMPLE
+This example shows a group of uncoupled checkbuttons.
+.PP
+.CS
+ labelframe .lbl -text "Steps:"
+ \fBcheckbutton\fR .c1 -text Lights -variable lights
+ \fBcheckbutton\fR .c2 -text Cameras -variable cameras
+ \fBcheckbutton\fR .c3 -text Action! -variable action
+ pack .c1 .c2 .c3 -in .lbl
+ pack .lbl
+.CE
+
.SH "SEE ALSO"
button(n), options(n), radiobutton(n), ttk_checkbutton(n)
-
.SH KEYWORDS
checkbutton, widget
diff --git a/doc/console.n b/doc/console.n
index 7992457..d7a1cf2 100644
--- a/doc/console.n
+++ b/doc/console.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: console.n,v 1.7 2004/10/28 10:22:51 dkf Exp $
+'\" RCS: @(#) $Id: console.n,v 1.8 2007/08/28 15:16:11 dkf Exp $
'\"
.so man.macros
.TH console n 8.4 Tk "Tk Built-In Commands"
@@ -132,9 +132,7 @@ often has the following code fragment in it so output produced by
.CS
catch {\fBconsole show\fR}
.CE
-
-.SH KEYWORDS
-console, interpreter, window, interactive, output channels
-
.SH "SEE ALSO"
destroy(n), fconfigure(n), history(n), interp(n), puts(n), text(n), wm(n)
+.SH KEYWORDS
+console, interpreter, window, interactive, output channels
diff --git a/doc/tk.n b/doc/tk.n
index b3bbbca..fe9a78d 100644
--- a/doc/tk.n
+++ b/doc/tk.n
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: tk.n,v 1.12 2007/05/03 23:55:29 dkf Exp $
+'\" RCS: @(#) $Id: tk.n,v 1.13 2007/08/28 15:16:11 dkf Exp $
'\"
.so man.macros
.TH tk n 8.4 Tk "Tk Built-In Commands"
@@ -28,6 +28,7 @@ The command can take any of a number of different forms
depending on the \fIoption\fR argument. The legal forms are:
.TP
\fBtk appname \fR?\fInewName\fR?
+.
If \fInewName\fR isn't specified, this command returns the name
of the application (the name that may be used in \fBsend\fR
commands to communicate with the application).
@@ -110,5 +111,7 @@ state is returned. This is turned on by default for the main display.
Returns the current Tk windowing system, one of
\fBx11\fR (X11-based), \fBwin32\fR (MS Windows),
or \fBaqua\fR (Mac OS X Aqua).
+.SH "SEE ALSO"
+send(n), winfo(n)
.SH KEYWORDS
application name, send
diff --git a/doc/ttk_combobox.n b/doc/ttk_combobox.n
index eaa3f69..85b2a24 100644
--- a/doc/ttk_combobox.n
+++ b/doc/ttk_combobox.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: ttk_combobox.n,v 1.4 2006/12/17 21:09:46 jenglish Exp $
+'\" RCS: @(#) $Id: ttk_combobox.n,v 1.5 2007/08/28 15:16:11 dkf Exp $
'\"
.so man.macros
.TH ttk_combobox n 8.5 Tk "Tk Themed Widget"
@@ -108,3 +108,5 @@ This event is generated after the listbox is unposted.
.SH "SEE ALSO"
ttk_widget(n), ttk_entry(n)
+.SH KEYWORDS
+choice, entry, list box, text box, widget