summaryrefslogtreecommitdiffstats
path: root/doc/text.n
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2007-10-30 21:29:58 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2007-10-30 21:29:58 (GMT)
commitf9705d9d3162582585108a3e60dc8164e5e73d74 (patch)
tree7090d93b57cff685ebe7ccea984672560fa3b271 /doc/text.n
parente3d080ec8d965eb9ad0e606c90f01b9af73facb3 (diff)
downloadtk-f9705d9d3162582585108a3e60dc8164e5e73d74.zip
tk-f9705d9d3162582585108a3e60dc8164e5e73d74.tar.gz
tk-f9705d9d3162582585108a3e60dc8164e5e73d74.tar.bz2
More documentation improvements
Diffstat (limited to 'doc/text.n')
-rw-r--r--doc/text.n15
1 files changed, 11 insertions, 4 deletions
diff --git a/doc/text.n b/doc/text.n
index d9f5cb0..05bfbee 100644
--- a/doc/text.n
+++ b/doc/text.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: text.n,v 1.50 2007/10/30 19:39:26 hobbs Exp $
+'\" RCS: @(#) $Id: text.n,v 1.51 2007/10/30 21:29:59 dkf Exp $
'\"
.so man.macros
.TH text n 8.5 Tk "Tk Built-In Commands"
@@ -115,9 +115,12 @@ at the tab position; if there is no decimal point then the least
significant digit of the number is positioned just to the left of the
tab position; if there is no number in the text then the text is
right-justified at the tab position.
-For example, \fB\-tabs {2c left 4c 6c center}\fR creates three
-tab stops at two-centimeter intervals; the first two use left
+For example,
+.QW "\fB\-tabs {2c left 4c 6c center}\fR"
+creates three tab stops at two-centimeter intervals; the first two use left
justification and the third uses center justification.
+.RS
+.PP
If the list of tab stops does not have enough elements to cover all
of the tabs in a text line, then Tk extrapolates new tab stops using
the spacing and alignment from the last tab stop in the list. Tab
@@ -125,11 +128,13 @@ distances must be strictly positive, and must always increase from one
tab stop to the next (if not, an error is thrown).
The value of the \fBtabs\fR option may be overridden by \fB\-tabs\fR
options in tags.
+.PP
If no \fB\-tabs\fR option is specified, or if it is specified as
an empty list, then Tk uses default tabs spaced every eight
(average size) characters. To achieve a different standard spacing,
for example every 4 characters, simply configure the widget with
.QW "\fB\-tabs \N'34'[expr {4 * [font measure $font 0]}] left\N'34' \-tabstyle wordprocessor\fR" .
+.RE
.OP \-tabstyle tabStyle TabStyle
Specifies how to interpret the relationship between tab stops on a line
and tabs in the text of that line. The value must be \fBtabular\fR (the
@@ -1488,11 +1493,13 @@ arguments, and the section on \fIpathName
\fBdelete\fR for an explanation of the handling of the indices. If
\fIindex2\fR corresponds to an index earlier in the text than
\fIindex1\fR, an error will be generated.
-.br
+.RS
+.PP
The deletion and insertion are arranged so that no unnecessary
scrolling of the window or movement of insertion cursor occurs. In
addition the undo/redo stack are correctly modified, if undo operations
are active in the text widget. The command returns an empty string.
+.RE
.VE 8.5
.TP
\fIpathName \fBscan\fR \fIoption args\fR