summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas E. Dickey <dickey@invisible-island.net>2024-02-29 17:54:04 -0500
committerThomas E. Dickey <dickey@his.com>2024-03-02 16:40:07 +0000
commitd696cf912efb884af1a73952f3bd70bd28a9a942 (patch)
tree5005589146db1ffc3c9527867d13c3e9d01f7087
parent6ded4c0487220253a2cb2fefc4983ff31e486dd4 (diff)
manpage: adjust line-breaks to avoid embedded full-stops
Signed-off-by: Thomas E. Dickey <dickey@invisible-island.net>
-rw-r--r--man/Xaw.man372
1 files changed, 237 insertions, 135 deletions
diff --git a/man/Xaw.man b/man/Xaw.man
index dc65378..098d33b 100644
--- a/man/Xaw.man
+++ b/man/Xaw.man
@@ -46,9 +46,10 @@
Xaw \- X Athena Widgets
.SH DESCRIPTION
.B Xaw
-is a widget set based on the X Toolkit Intrinsics (Xt) Library. This
-release by the X.Org Foundation includes additions and modifications
-originally made for The XFree86 Project, Inc. This manual page describes
+is a widget set based on the X Toolkit Intrinsics (Xt) Library.
+This release by the X.Org Foundation includes additions and modifications
+originally made for The XFree86 Project, Inc.
+This manual page describes
these changes as well as some of the common interfaces between its version
and the previous X Consortium release (Xaw6).
.PP
@@ -65,7 +66,8 @@ and \fBset-values\fP. The syntax for these actions is:
\fIget-values\fP or \fIset-values\fP.
.PP
\fBBoolean-expression\fP is composed with the operators \fI|\fR (or), \fI&\fR
-(and), \fI^\fR (xor), and \fI~\fR (not). The operands can be a variable name,
+(and), \fI^\fR (xor), and \fI~\fR (not).
+The operands can be a variable name,
which starts with a \fI$\fR; a resource name without the bindings \fI.\fP
or \fI*\fP; or a constant name, including \fImine\fP (event->xany.window
== XtWindow(widget)), \fIfaked\fP (event->xany.send_event != 0), \fItrue\fP (1)
@@ -76,29 +78,34 @@ a variable, otherwise, they indicate a resource name.
.TP 8
.B call-proc \fP(\fIboolean-expression\fP, \fIprocedure-name\fP)
This action allows the evaluation of a boolean expression in the first
-parameter before calling a action procedure. The procedure is only called
-if the expression evaluates as true. Example:
+parameter before calling a action procedure.
+The procedure is only called if the expression evaluates as true.
+Example:
.EX
call-proc("$inside & $pressed", notify)
.EE
.TP 8
.B declare \fP(\fIboolean-expression\fP, \fIvariable\fP, \fIvalue\fP, ...)
-This action is used to create new variables or change their values. Any
-number of variable-value tuples may be specified. Example:
+This action is used to create new variables or change their values.
+Any number of variable-value tuples may be specified.
+Example:
.EX
declare(1, $pressed, 1)
.EE
.TP 8
.B get-values \fP(\fIboolean-expression\fP, \fIvariable\fP, \fIvalue\fP, ...)
-This action reads a widget resource value into a variable. Any number of
-variable-value tuples may be specified. Example:
+This action reads a widget resource value into a variable.
+Any number of variable-value tuples may be specified.
+Example:
.EX
get-values(1, $fg, foreground, $bg, background)
.EE
.TP 8
.B set-values \fP(\fIboolean-expression\fP, \fIvariable\fP, \fIvalue\fP, ...)
This action sets a widget resource to the given value, which may be a
-variable. Any number of variable-value tuples may be specified. Example:
+variable.
+Any number of variable-value tuples may be specified.
+Example:
.EX
set-values(1, foreground, $bg, background, $fg)
.EE
@@ -112,9 +119,10 @@ Here is a sample translation to make a label widget behave like a button:
.fi
.SH DISPLAY LISTS
All of the \fBXaw\fP widgets have now the additional resource
-\fIdisplayList\fP. This resource allows drawing the widget decorations
-using commands embedded in a resource string. The displayList resource has
-the syntax:
+\fIdisplayList\fP.
+This resource allows drawing the widget decorations
+using commands embedded in a resource string.
+The displayList resource has the syntax:
.PP
\fI[class-name:]function-name arguments[[{;\en}]...]\fP
.PP
@@ -126,7 +134,8 @@ the Xlib drawing primitives.
described below.
.PP
\fBArguments\fP may be anything suitable to the displayList function being
-called. When the function requires a coordinate, the syntax is
+called.
+When the function requires a coordinate, the syntax is
\fI{+-}<integer>\fP or \fI<integer>/<integer>\fP. Examples:
.nf
+0,+0 top, left
@@ -136,8 +145,10 @@ called. When the function requires a coordinate, the syntax is
.fi
.TP 8
.B arc-mode \fPmode
-Sets the arc mode. Accepted \fImode\fPs are "pieslice" and "chord", which
-set the arc to ArcPieSlice or ArcChord, respectively. Example:
+Sets the arc mode.
+Accepted \fImode\fPs are "pieslice" and "chord", which
+set the arc to ArcPieSlice or ArcChord, respectively.
+Example:
.EX
arc-mode chord
.EE
@@ -145,30 +156,36 @@ arc-mode chord
.B bg \fPcolor-spec
.TQ
.B background \fPcolor-spec
-Sets the background color. \fIcolor-spec\fP must a valid color
-specification. Example:
+Sets the background color.
+\fIcolor-spec\fP must a valid color
+specification.
+Example:
.EX
background red
.EE
.TP 8
.B cap-style \fPstyle
-Sets the cap style. Accepted \fIstyle\fPs are "notlast", "butt", "round",
+Sets the cap style.
+Accepted \fIstyle\fPs are "notlast", "butt", "round",
and "projecting", which set the cap style to CapNotLast, CapBut, CapRound
-or CapProjecting, respectively. Example:
+or CapProjecting, respectively.
+Example:
.EX
cap-style round
.EE
.TP 8
.B clip-mask \fPpixmap-spec
-Sets the pixmap for the clip mask. Requires a pixmap parameter, as
-described in the \fBPIXMAPS\fP section below. Example:
+Sets the pixmap for the clip mask.
+Requires a pixmap parameter, as described in the \fBPIXMAPS\fP section below.
+Example:
.EX
clip-mask xlogo11
.EE
.TP 8
.B clip-origin \fPx,y
-Sets the clip x and y origin. Requires two arguments, the x and y
-coordinates. Example:
+Sets the clip x and y origin.
+Requires two arguments, the x and y coordinates.
+Example:
.EX
clip-origin 10,10
.EE
@@ -176,52 +193,66 @@ clip-origin 10,10
.B clip-rects \fPx1,y1,x2,y2 [...,xn,yn]
.TQ
.B clip-rectangles \fPx1,y1,x2,y2 [...,xn,yn]
-Sets a list of rectangles to the clip mask. The number of arguments must
-be a multiple of four. The arguments are coordinates. The parser
-calculates the width and height of the rectangles. Example:
+Sets a list of rectangles to the clip mask.
+The number of arguments must be a multiple of four.
+The arguments are coordinates.
+The parser calculates the width and height of the rectangles.
+Example:
.EX
clip-rects 0,0,10,20, 20,10,30,30
.EE
.TP 8
.B coord-mode \fPmode
Changes the coord mode for \fIfill-polygon\fP, \fIdraw-lines\fP, and
-\fIdraw-points\fP. Accepted parameters are "modeorigin" and "previous",
-that sets the coord mode to CoordModeOrigin or CoordModePrevious,
-respectively. Example:
+\fIdraw-points\fP.
+Accepted parameters are "modeorigin" and "previous",
+that sets the coord mode to CoordModeOrigin or CoordModePrevious, respectively.
+Example:
.EX
coord-mode previous
.EE
.TP 8
.B copy-area \fP{pixmap-spec|.},dstx,dsty[,x2,y2,srcx,srcy]
-Calls XCopyArea. The character \fI.\fP means copy the window contents;
-pixmap-spec is as defined in the \fBPIXMAPS\fP section below. \fIX2\fP and
-\fIy2\fP are the coordinates of the end copy, not the width and height; if
-not defined, the parser calculates them. \fIsrc_x\fP and \fIsrc_y\fP
-default to zero. Example:
+Calls XCopyArea.
+The character \fI.\fP means copy the window contents;
+pixmap-spec is as defined in the \fBPIXMAPS\fP section below.
+\fIX2\fP and
+\fIy2\fP are the coordinates of the end copy, not the width and height;
+if not defined, the parser calculates them.
+\fIsrc_x\fP and \fIsrc_y\fP default to zero.
+Example:
.EX
copy-area Term,10,10
.EE
.TP 8
.B copy-plane \fP{pixmap-spec|.},dstx,dsty[,x2,y2,srcx,srcy,plane]
-Calls XCopyPlane. The character \fI.\fP means copy the window contents;
-pixmap-spec is as defined in the \fBPIXMAPS\fP section below. \fIX2\fP and
-\fIy2\fP are the coordinates of the end copy, not the width and height; if
-not defined, the parser calculates them. \fIsrc_x\fP and \fIsrc_y\fP
-default to zero. \fIPlane\fP defaults to one. Example:
+Calls XCopyPlane.
+The character \fI.\fP means copy the window contents;
+pixmap-spec is as defined in the \fBPIXMAPS\fP section below.
+\fIX2\fP and
+\fIy2\fP are the coordinates of the end copy, not the width and height;
+if not defined, the parser calculates them.
+\fIsrc_x\fP and \fIsrc_y\fP default to zero.
+\fIPlane\fP defaults to one.
+Example:
.EX
copy-plane star,10,10
.EE
.TP 8
.B dashes \fPi1[...,in]
-Sets the dashes for line drawing. Accepts up to 127 arguments. Example:
+Sets the dashes for line drawing.
+Accepts up to 127 arguments.
+Example:
.EX
dashes 3,7 9,10
.EE
.TP 8
.B draw-arc \fPx1,y1,x2,y2[,start-angle,end-angle]
-Draws an arc. The four first arguments are the rectangle enclosing the
-arc. The two remaining arguments, if specified, are the start and end
-angle, in degrees. Example:
+Draws an arc.
+The four first arguments are the rectangle enclosing the arc.
+The two remaining arguments, if specified,
+are the start and end angle, in degrees.
+Example:
.EX
draw-arc +0,+0,-1,-1,0,90
.EE
@@ -229,31 +260,37 @@ draw-arc +0,+0,-1,-1,0,90
.B draw-rect \fPx1,y1,x2,y2
.TQ
.B draw-rectangle \fPx1,y1,x2,y2
-Draws a rectangle. Requires four arguments, which are the start and end
-coordinate pairs. Example:
+Draws a rectangle.
+Requires four arguments, which are the start and end coordinate pairs.
+Example:
.EX
draw-rect +1,+1,-5,-5
.EE
.TP 8
.B draw-string \fPx,y,"string"
-Draws a text string. Requires three arguments, a x coordinate, a y
-coordinate, and a string. Strings that have white space can be quoted with
+Draws a text string.
+Requires three arguments, a x coordinate, a y coordinate, and a string.
+Strings that have white space can be quoted with
the \fI"\fP character; the backslash character \fI\e\fP can also be used,
-but it will be necessary escape it twice. Example:
+but it will be necessary escape it twice.
+Example:
.EX
draw-string 10,10, "Hello world!"\fP
.EE
.TP 8
.B exposures \fPboolean
-Sets graphics exposures in the GC. Allowed parameters are a integer or the
-strings "true", "false", "on" and "off". Example:
+Sets graphics exposures in the GC.
+Allowed parameters are a integer
+or the strings "true", "false", "on" and "off".
+Example:
.EX
exposures true
.EE
.TP 8
.B fill-arc \fPx1,y1,x2,y2[,start-angle,end-angle]
Like \fIdraw-arc\fP, but fills the contents of the arc with the currently
-selected foreground. Example:
+selected foreground.
+Example:
.EX
fill-arc +0,+0,-1,-1,0,180
.EE
@@ -262,7 +299,8 @@ fill-arc +0,+0,-1,-1,0,180
.TQ
.B fill-polygon \fPx1,y1 [...,xn,yn]
Like \fIdraw-lines\fP, but fills the enclosed polygon and joins the first
-and last point, if they are not at the same position. Example:
+and last point, if they are not at the same position.
+Example:
.EX
fill-poly +0,+10, +10,+20, +30,+0
.EE
@@ -271,28 +309,34 @@ fill-poly +0,+10, +10,+20, +30,+0
.TQ
.B fill-rectangle \fPx1,y1,x2,y2
Like \fIdraw-rect\fP, but fills the contents of the rectangle with the
-selected foreground color. Example:
+selected foreground color.
+Example:
.EX
fill-rect +10,+10,-20,-20
.EE
.TP 8
.B fill-rule \fPrule
-Sets the fill rule. Accepted parameters are "evenodd" and "winding", which
-set the fill rule to EvenOddRule or WindingRule, respectively. Example:
+Sets the fill rule.
+Accepted parameters are "evenodd" and "winding", which
+set the fill rule to EvenOddRule or WindingRule, respectively.
+Example:
.EX
fill-rule winding
.EE
.TP 8
.B fill-style \fPstyle
-Sets the fill style. Allowed parameters are "solid", "tiled", "stippled" and
+Sets the fill style.
+Allowed parameters are "solid", "tiled", "stippled" and
"opaquestippled", which set the fill style to FillSolid, FillTiled,
-FillStippled or FillOpaqueStippled, respectively. Example:
+FillStippled or FillOpaqueStippled, respectively.
+Example:
.EX
fill-style tiled
.EE
.TP 8
.B font \fPfont-spec
-Sets the font for text functions. Example:
+Sets the font for text functions.
+Example:
.EX
font -*-*-*-R-*-*-*-120-*-*-*-*-ISO8859-1
.EE
@@ -300,41 +344,50 @@ font -*-*-*-R-*-*-*-120-*-*-*-*-ISO8859-1
.B fg \fPcolor-spec
.TQ
.B foreground \fPcolor-spec
-Like \fIbackground\fP, but sets the current foreground color. Example:
+Like \fIbackground\fP, but sets the current foreground color.
+Example:
.EX
foreground blue
.EE
.TP 8
.B mask
This command is useful when you want to draw only in the region that really
-needs to be repainted. Requires no arguments.
+needs to be repainted.
+Requires no arguments.
.TP 8
.B function \fPfunction-spec
-Sets the specific GC function. Allowed parameters are "set", "clear", "and",
+Sets the specific GC function.
+Allowed parameters are "set", "clear", "and",
"andreverse", "copy", "andinverted", "noop", "xor", "or", "nor", "equiv",
"invert", "orreverse", "copyinverted" and "nand", which set the function to
GXset, GXclear, GXand, GXandReverse, GXcopy, GXandInverted, GXnoop, GXxor,
GXor, GXnor, GXequiv, GXinvert, GXorReverse, GXcopyInverted or GXnand,
-respectively. Example:
+respectively.
+Example:
.EX
function xor
.EE
.TP 8
.B join-style \fPstyle
-Sets the join style. Allowed parameters are "miter", "round" and "bevel",
+Sets the join style.
+Allowed parameters are "miter", "round" and "bevel",
which set the join style to JoinMiter, JoinRound and JoinBevel,
-respectively. Example:
+respectively.
+Example:
.EX
join-style round
.EE
.TP 8
.B image \fP{pixmap-spec},xs,ys,[xe,ye]
This function is implemented as a way to quickly compose complex
-decorations in widgets. \fIPixmap-spec\fP is as defined in the
-\fBPIXMAPS\fP section below. \fIxs\fP and \fIys\fP are the coordinates from
-where to start copying the pixmap; \fIxe\fP and \fIye\fP are optional (they
-default to xs + pixmap.width and ys + pixmap.height, respectively). If the
-pixmap has a mask, the copy is masked accordingly. Example:
+decorations in widgets.
+\fIPixmap-spec\fP is as defined in the
+\fBPIXMAPS\fP section below.
+\fIxs\fP and \fIys\fP are the coordinates from
+where to start copying the pixmap; \fIxe\fP and \fIye\fP are optional
+(they default to xs + pixmap.width and ys + pixmap.height, respectively).
+If the pixmap has a mask, the copy is masked accordingly.
+Example:
.EX
image pixmap.xpm,0,0,20,20
.EE
@@ -342,22 +395,26 @@ image pixmap.xpm,0,0,20,20
.B line \fPx1,y1,x2,y2
.TQ
.B draw-line \fPx1,y1,x2,y2
-Draws a line with the current foreground color. Requires four arguments,
-the starting and ending coordinate pairs. Example:
+Draws a line with the current foreground color.
+Requires four arguments, the starting and ending coordinate pairs.
+Example:
.EX
line +0,+0, -1,-1
.EE
.TP 8
.B line-width \fPinteger
-Selects a line width for drawing. Example:
+Selects a line width for drawing.
+Example:
.EX
line-width 2
.EE
.TP 8
.B line-style \fPstyle
-Sets the line style. Accepted parameters are "solid", "onoffdash" and
+Sets the line style.
+Accepted parameters are "solid", "onoffdash" and
"doubledash", which set the line style to LineSolid, LineOnOffDash or
-LineDoubleDash, respectively. Example:
+LineDoubleDash, respectively.
+Example:
.EX
line-style onoffdash
.EE
@@ -365,14 +422,16 @@ line-style onoffdash
.B lines \fPx1,y1,x2,y2 [...,xn,yn]
.TQ
.B draw-lines \fPx1,y1,x2,y2 [...,xn,yn]
-Draws a list of lines. Any number of argument pairs may be supplied.
+Draws a list of lines.
+Any number of argument pairs may be supplied.
Example:
.EX
lines +0,-1, -1,-1, -1,+0
.EE
.TP 8
.B paint-string \fPx,y,"string"
-Identical to draw-string, but also uses the background color. Example:
+Identical to draw-string, but also uses the background color.
+Example:
.EX
paint-string 10,20, "Sample text"\fP
.EE
@@ -380,13 +439,17 @@ Identical to draw-string, but also uses the background color. Example:
.B point \fPx,y
.TQ
.B draw-point \fPx,y
-Draws a point. Requires two arguments, a coordinate pair. Example:
+Draws a point.
+Requires two arguments, a coordinate pair.
+Example:
.EX
point +10,+10
.EE
.TP 8
.B plane-mask \fPinteger
-Sets the plane mask. Requires an integer parameter. Example:
+Sets the plane mask.
+Requires an integer parameter.
+Example:
.EX
plane-mask -1
.EE
@@ -394,7 +457,8 @@ plane-mask -1
.B points \fPx1,y1 [...,xn,yn]
.TQ
.B draw-points \fPx1,y1 [...,xn,yn]
-Draws a list of points at the specified coordinates. Example:
+Draws a list of points at the specified coordinates.
+Example:
.EX
points +1,+2, +1,+4, +1,+6
.EE
@@ -402,45 +466,55 @@ points +1,+2, +1,+4, +1,+6
.B segments \fPx1,y1,x2,y2 [...,xn,yn]
.TQ
.B draw-segments \fPx1,y1,x2,y2 [...,xn,yn]
-Draws a list of segment lines. The number of parameters must be multiple
-of 4. Example:
+Draws a list of segment lines.
+The number of parameters must be multiple of 4.
+Example:
.EX
segments +1,+2,+1,-3, +2,-2,-3,-2
.EE
.TP 8
.B shape-mode \fPmode
-Sets the shape mode used in \fIfill-polygon\fP. Accepted parameters are
+Sets the shape mode used in \fIfill-polygon\fP.
+Accepted parameters are
"complex", "convex" or "nonconvex", which set the shape mode to Complex,
-Convex or Nonconvex, accordingly. Example:
+Convex or Nonconvex, accordingly.
+Example:
.EX
shape-mode convex
.EE
.TP 8
.B stipple \fPpixmap-spec
-Sets the pixmap for a stipple. Requires a pixmap parameter, as described
-in the \fBPIXMAPS\fP section below. Example:
+Sets the pixmap for a stipple.
+Requires a pixmap parameter, as described in the \fBPIXMAPS\fP section below.
+Example:
.EX
stipple plaid
.EE
.TP 8
.B subwindow-mode \fPmode
-Sets the subwindow mode in the GC. Accepted parameters are
-"includeinferiors" and "clipbychildren", which set the subwindow mode to
-IncludeInferiors or ClipByChildren, respectively. Example:
+Sets the subwindow mode in the GC.
+Accepted parameters are
+"includeinferiors" and "clipbychildren",
+which set the subwindow mode to
+IncludeInferiors or ClipByChildren, respectively.
+Example:
.EX
subwindow-mode includeinferiors
.EE
.TP 8
.B tile \fPpixmap-spec
-Sets the pixmap for a tile. Requires a pixmap parameter, as described
-in the \fBPIXMAPS\fP section below. Example:
+Sets the pixmap for a tile.
+Requires a pixmap parameter, as described
+in the \fBPIXMAPS\fP section below.
+Example:
.EX
tile xlogo11?foreground=red&background=gray80
.EE
.TP 8
.B ts-origin \fPx,y
-Sets the tile stipple x and y origin. Requires two arguments, a x and y
-coordinate. Example:
+Sets the tile stipple x and y origin.
+Requires two arguments, a x and y coordinate.
+Example:
.EX
ts-origin 10,10
.EE
@@ -457,10 +531,10 @@ foreground gray85;\e
draw-lines -1,+0,+0,+0,+0,-1
.EE
.SH PIXMAPS
-A String to Pixmap converter has been added to \fBXaw\fP. This converter
-is meant to be extended, and has enough abstraction to allow loading
-several image formats. It uses a format that resembles a \fIURL\fP, with
-the syntax:
+A String to Pixmap converter has been added to \fBXaw\fP.
+This converter is meant to be extended,
+and has enough abstraction to allow loading several image formats.
+It uses a format that resembles a \fIURL\fP, with the syntax:
.PP
.I [type:]name[?arg=val[{&}...]]
.PP
@@ -469,13 +543,15 @@ the syntax:
\fBName\fP may be a file name, or, in the case of type \fIgradient\fP, may be
either \fIvertical\fP or \fIhorizontal\fP.
.PP
-\fBArg=val\fP is a list of arguments to the converter. An argument list is
-preceded by a question mark, and multiple arguments are separated by
-ampersands. The most common arguments are \fIforeground\fP and
-\fIbackground\fP. Gradients also support the arguments \fIstart\fP and
-\fIend\fP (colors with which to start and end the gradient); the
-\fPsteps\fP argument, to allow using less colors; and the \fIdimension\fP
-argument to specify the size of the gradient. The \fIxpm\fP converter
+\fBArg=val\fP is a list of arguments to the converter.
+An argument list is preceded by a question mark,
+and multiple arguments are separated by ampersands.
+The most common arguments are \fIforeground\fP and \fIbackground\fP.
+Gradients also support the arguments \fIstart\fP and \fIend\fP
+(colors with which to start and end the gradient);
+the \fPsteps\fP argument, to allow using less colors;
+and the \fIdimension\fP argument to specify the size of the gradient.
+The \fIxpm\fP converter
understands the \fIcloseness\fP argument, which aids in using fewer colors
(useful if you have a limited colormap).
.SH TEXT WIDGET
@@ -486,63 +562,79 @@ A couple of highly visible changes in the Text widget are due to many bugs
in the Xaw6 implementation involving scrollbars and auto-resizing.
Scrollbars being added or removed caused several problems in keeping the
text cursor visible, and in Xaw6 it was very easy to have a widget thinking
-the cursor was visible, when it was not. Also, permitting automatic
+the cursor was visible, when it was not.
+Also, permitting automatic
resizing of the widget to a larger geometry created other problems, making
it difficult to have a consistent layout in the application, and, if the
window manager did not interfere, windows larger than the screen could
-result. Therefore, some functionality involving scrollbars and
+result.
+Therefore, some functionality involving scrollbars and
auto-resizing has been disabled; see the section on new and modified
Text widget resources below.
.PP
The Text widget's default key bindings were originally based on the Emacs
-text editor. In this release, even more operations familiar to Emacs users
-have been added. New text actions include:
+text editor.
+In this release, even more operations familiar to Emacs users have been added.
+New text actions include:
.TP 8
.B indent
-Indents text blocks. Not bound by default. The Text widget also does not
+Indents text blocks.
+Not bound by default.
+The Text widget also does not
attempt to perform auto-indentation of its source object by default.
.TP 8
.B keyboard-reset
-Resets the keyboard state. Reverts the action multiplier to 1, and if undo
-is enabled, toggles between undo and redo. Bound by default to
+Resets the keyboard state.
+Reverts the action multiplier to 1, and if undo
+is enabled, toggles between undo and redo.
+Bound by default to
\fIControl<Key>G\fP.
.TP 8
.B kill-ring-yank
In this version of Xaw, text killed in any text field is kept in memory,
allowing cut and paste operations internally to the program between text
-fields. Bound by default to \fIMeta<Key>Y\fP.
+fields.
+Bound by default to \fIMeta<Key>Y\fP.
.TP 8
.B numeric
-Listed here only for purposes of documentation. Called by default when one
+Listed here only for purposes of documentation.
+Called by default when one
of the characters \fI1, 2, 3, 4, 5, 6, 7, 8, 9, 0,\fP or \fI-\fP is typed,
allowing composition of the multiplication number of text actions.
.TP 8
.B set-keyboard-focus
-Sets the input focus of the top level widget to the text field. Not
+Sets the input focus of the top level widget to the text field.
+Not
enabled by default, but bound to the \fI<Btn1Down>\fP event.
.TP 8
.B toggle-overwrite
-Toggles overwrite mode. In overwrite mode, any text inserted in a text
-field will replace existing text. Bound by default to \fI<Key>Insert\fP.
+Toggles overwrite mode.
+In overwrite mode, any text inserted in a text field will replace existing text.
+Bound by default to \fI<Key>Insert\fP.
.TP 8
.B undo
-Sets the \fIenableUndo\fP resource of the textSrcObject. Not enabled by
+Sets the \fIenableUndo\fP resource of the textSrcObject.
+Not enabled by
default, but bound to \fIControl<Key>_\fP.
.PP
New and modified Text widget resources include:
.TP 8
.B justify (\fPClass\fB Justify)
-Sets the text justification. Can be one of \fIleft, right, center\fP, or
-\fIfull\fP. Only enabled when the \fIautoFill\fP resource is set, and the
+Sets the text justification.
+Can be one of \fIleft, right, center\fP, or
+\fIfull\fP.
+Only enabled when the \fIautoFill\fP resource is set, and the
resources \fIleftColumn\fP and \fIrightColumn\fP are correctly set.
.TP 8
.B leftColumn (\fPClass\fB Column)
-Specifies the left column at which to break text. Text lines started with
+Specifies the left column at which to break text.
+Text lines started with
an alphanumeric character will automatically start at this column.
.TP 8
.B positionCallback (\fPClass\fB Callback)
Allows installation of a callback to be called every time the cursor is
-moved, and/or the file changes its size. The callback is called with a
+moved, and/or the file changes its size.
+The callback is called with a
pointer to a structure containing the following data:
.nf
typedef struct {
@@ -561,46 +653,54 @@ No longer supported, but recognized for backward compatibility with
resource specifications written for the Xaw6 Text widget.
.TP 8
.B rightColumn (\fPClass\fB Column)
-Specifies the right column at which to break text. Text lines started with
+Specifies the right column at which to break text.
+Text lines started with
an alphanumeric character will automatically end at this column.
.TP 8
.B scrollHorizontal (\fPClass\fB Scroll)
.TQ
.B scrollVertical (\fPClass\fB Scroll)
These resources control the placement of scrollbars on the left and bottom
-edges of the Text widget. They accept the values \fIXawtextScrollAlways\fP
-and \fIXawtextScrollNever\fP. A converter is registered for this resource
-that will convert the following strings: \fIalways\fP and \fInever\fP. The
+edges of the Text widget.
+They accept the values \fIXawtextScrollAlways\fP and \fIXawtextScrollNever\fP.
+A converter is registered for this resource
+that will convert the following strings: \fIalways\fP and \fInever\fP.
+The
value \fIXawtextScrollWhenNeeded\fP (and \fIwhenNeeded\fP, recognized by
the converter), is accepted for backwards compatibility with resource
specifications written for the Xaw6 Text widget, but ignored (effectively
treated as \fIXawtextScrollNever\fP).
.SH TEXT SOURCE OBJECT
The textSrcObject allows display of its contents to more than one window,
-and also stores undo information. The new resources for the textSrcObject
+and also stores undo information.
+The new resources for the textSrcObject
are:
.TP 8
.B callback (\fPClass\fB Callback)
Previous versions of Xaw had this resource in subclasses of the TextSource
-object. This was changed to make it possible to tell the callback the
+object.
+This was changed to make it possible to tell the callback the
state of the text when undo is enabled.
.TP 8
.B enableUndo (\fPClass\fB Undo)
-A boolean resource that enables or disables the undo function. The default
-value is False.
+A boolean resource that enables or disables the undo function.
+The default value is False.
.TP 8
.B sourceChanged (\fPClass\fB Changed)
Like the callback resource, this resource was previously in subclasses of
-the TextSource object. It is now in the textSrcObject to control the
+the TextSource object.
+It is now in the textSrcObject to control the
changed/unchanged state when undo is enabled.
.SH TEXT SINK OBJECT
The textSinkObject subclasses asciiSinkObject and multiSinkObject have been
changed slightly to use a new cursor shape (no longer a caret at the
baseline) that indicates the input focus of the text widget, and allow
-specification of the cursor color. The new resource is:
+specification of the cursor color.
+The new resource is:
.TP 8
.B cursorColor (\fPClass\fB Color)
-Sets the cursor color of the text. This color is also used to draw
+Sets the cursor color of the text.
+This color is also used to draw
selected text.
.SH SIMPLE MENU WIDGET
The simpleMenuWidget algorithm to lay out menu entries has been changed to
@@ -608,11 +708,13 @@ enable multiple columns when a single column does not fit on the screen.
It was also modified to enable submenus.
.SH SME BSB OBJECT
A new resource has been added to the smeBSBObject to allow binding submenus
-to it. The new resource is:
+to it.
+The new resource is:
.TP 8
.B menuName (\fPClass\fB MenuName)
Specifies the name of the popup widget to be popped up when the pointer is
-over the menu entry, or NULL. Note that the named menu must be a child of
+over the menu entry, or NULL.
+Note that the named menu must be a child of
the popup parent of the smeBSBObject.
.SH AUTHORS
The original X Consortium version of the Athena Widget Set and its