'\" .UL arg1 arg2
'\" Print arg1 underlined, then print arg2 normally.
'\"
-'\" RCS: @(#) $Id: man.macros,v 1.3 2001/02/17 07:46:19 ghowlett Exp $
+'\" RCS: @(#) $Id: man.macros,v 1.1.1.1 2009/05/09 16:27:42 pcmacdon Exp $
'\"
'\" # Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
.if t .wh -1.3i ^B
.de UL
\\$1\l'|0\(ul'\\$2
..
-.TH htext n 2.4 BLT "BLT Built-In Commands"
+.TH htext n 2.5 BLT "BLT Built-In Commands"
.BS
'\" Note: do not modify the .SH NAME line immediately below!
.SH NAME
is interpreted and executed as Tcl commands.
The special character may be specified by the \fB\-specialchar\fP option.
In the following example of a \fBhtext\fP file, a button widget
-is appended to the text between the words "\f(CWa\fP" and "\f(CWwhich\fP".
-The \fIpathName\fR of the \fBhtext\fP widget is "\f(CW.ht\fP".
+is appended to the text between the words "\fBa\fP" and "\fBwhich\fP".
+The \fIpathName\fR of the \fBhtext\fP widget is "\fB.ht\fP".
.CS
-\f(CWThis will be displayed as normal text.
+\fBThis will be displayed as normal text.
But this will become a %%
button .ht.button -text "button" -fg red
.ht append .ht.button
\fIanchorPos\fR is \fBcenter\fR then the window is centered in the
cavity; if \fIanchorPos\fR is \fBw\fR then the window will be drawn
such it touches the leftmost edge of the cavity. The default
-is \f(CWcenter\fR.
+is \fBcenter\fR.
.TP
\fB\-fill \fIstyle\fR
Specifies how the \fIwindow\fR should be stretched to occupy the extra
space in the cavity surrounding it (if any exists). \fIStyle\fR is
-\f(CWnone\fR, \f(CWx\fR, \f(CWy\fR, \f(CWboth\fR. If \fIstyle\fR is \f(CWx\fR,
+\fBnone\fR, \fBx\fR, \fBy\fR, \fBboth\fR. If \fIstyle\fR is \fBx\fR,
the width of \fIwindow\fR is expanded to fill the cavity. If
\fIstyle\fR is \fBy\fR, the height is expanded. The default is
-\f(CWnone\fR.
+\fBnone\fR.
.TP
\fB\-height \fIpixels\fR
Sets the height of the cavity surrounding \fIwindow\fR. If
\fIpixels\fP is zero, the height of the cavity will be the same as the
requested height of \fIwindow\fR. If \fIpixels\fR is less than the
requested height of \fIwindow\fR, \fIwindow\fR will be reduced to fit
-the cavity. The default is \f(CW0\fR.
+the cavity. The default is \fB0\fR.
.TP
\fB\-ipadx \fIpad\fR
Sets the amount of internal padding to be added to the width
\fIpad\fR has two elements, the left side of \fIwindow\fR is extended
by the first value and the right side by the second value. If
\fIpad\fR is just one value, both the left and right sides are padded
-by evenly by the value. The default is \f(CW0\fR.
+by evenly by the value. The default is \fB0\fR.
.TP
\fB\-ipady \fIpad\fR
Sets an amount of internal padding to be added to the height of
\fIpad\fR has two elements, the top of \fIwindow\fR is padded by the
first value and the bottom by the second value. If \fIpad\fR is just
one number, both the top and bottom are padded evenly by the value.
-The default is \f(CW0\fR.
+The default is \fB0\fR.
.TP
\fB\-justify \fIjustify\fR
Justifies \fIwindow\fR vertically within the cavity containing it
in relation to the line of text. \fIJustify\fR is \fBtop\fP,
-\fBbottom\fR, or \fBcenter\fR. If \fIjustify\fR is \f(CWcenter\fR the
+\fBbottom\fR, or \fBcenter\fR. If \fIjustify\fR is \fBcenter\fR the
widget is centered along the baseline of the line of text. The
-default is \f(CWcenter\fR.
+default is \fBcenter\fR.
.TP
\fB\-padx \fIpad\fR
Sets the padding on the left and right sides of \fIwindow\fR.
elements, the left side of \fIwindow\fR is padded by the first value
and the right side by the second value. If \fIpad\fR has just one
value, both the left and right sides are padded evenly by the value.
-The default is \f(CW0\fR.
+The default is \fB0\fR.
.TP
\fB\-pady \fIpad\fR
Sets the padding above and below \fIwindow\fR. \fIPad\fR can be a
list of one or two numbers. If \fIpad\fR has two elements, the area
above \fIwindow\fR is padded by the first value and the area below by
the second value. If \fIpad\fR is just one number, both the top and
-bottom are padded by the value. The default is \f(CW0\fR.
+bottom are padded by the value. The default is \fB0\fR.
.TP
\fB\-relheight \fIvalue\fR
Specifies the height of the cavity containing \fIwindow\fR relative to
the ratio of the height of the cavity to the height of \fIpathName\fR.
As the height of \fIpathName\fR changes, so will the height of \fIwindow\fR.
If \fIvalue\fR is 0.0 or less, the height of the cavity is the requested
-height \fIwindow\fR. The default is \f(CW0.0\fR.
+height \fIwindow\fR. The default is \fB0.0\fR.
.TP
\fB\-relwidth \fIvalue\fR
Specifies the width of the cavity containing \fIwindow\fR relative to
the ratio of the width of the cavity to the width of \IpathName\fR.
As the height of \fIpathName\fR changes, so will the height of \fIwindow\fR.
If \fIvalue\fR is 0.0 or less, the width of the cavity is the
-requested width of \fIwindow\fR. The default is \f(CW0.0\fR.
+requested width of \fIwindow\fR. The default is \fB0.0\fR.
.TP
\fB\-width \fIvalue\fR
Species the width of the cavity containing the child window.
.TP
\fB\-background\fR \fIcolor\fI
Sets the background of the htext widget to \fIcolor\fR. This default is
-\f(CWwhite\fR.
+\fBwhite\fR.
.TP
\fB\-cursor\fR \fIcursor\fR
Specifies the cursor for the htext widget. The default cursor is
-\f(CWpencil\fR.
+\fBpencil\fR.
.TP
\fB\-filename\fR \fIfileName\fR
Specifies a \fBhtext\fP file to be displayed in the window.
.TP
\fB\-font\fR \fIfontName\fR
Sets the font of the text in the htext widget to \fIfontName\fR. The
-default is \f(CW*-Helvetica-Bold-R-Normal-*-12-120-*\fR.
+default is \fB*-Helvetica-Bold-R-Normal-*-12-120-*\fR.
.TP
\fB\-foreground\fR \fIcolor\fR
Sets the foreground of the htext widget to \fIcolor\fR. This is
-the color of the text. This default is \f(CWblack\fR.
+the color of the text. This default is \fBblack\fR.
.TP
\fB\-height\fR \fIpixels\fR
Specifies the height of the htext widget window.
Specifies the ASCII value of the special double character delimiters.
In \fBhtext\fP files, the text between these special characters is
evaluated as a block of Tcl commands. The default special character
-is the \f(CW0x25\fR (percent sign).
+is the \fB0x25\fR (percent sign).
.TP
\fB\-text\fR \fItext\fR
Specifies the text to be displayed in the htext widget. \fIText\fR