--- xview.7 2012-11-08 19:56:02.489253688 +0000 +++ xview.7.new 2012-11-08 20:33:21.229282513 +0000 @@ -4,7 +4,7 @@ xview \- xview toolkit information .SH SYNOPSIS There is no -.B xview +.B xview command per se, but this manual page will briefly describe XView features and functions. .SH AVAILABILITY @@ -13,13 +13,13 @@ .B XView (X Window-System-based Visual/Integrated Environment for Workstations) is an Open Look user-interface toolkit which supports development of -interactive, graphics-based +interactive, graphics-based applications running under the X Window System. -For detailed information +For detailed information see the .I XView Programming Manual .\" .TZ OREILLY7 -and the +and the .I XView Reference Manual. .SH USAGE .sp @@ -28,11 +28,11 @@ .sp .B cc .I sourcefile.c -.B -o +.B \-o .I outputfile -.B -lxview -.B -lolgx -.B -lX11 +.B \-lxview +.B \-lolgx +.B \-lX11 .sp .SS Generic XView Functions .sp @@ -44,9 +44,9 @@ passed attributes, and installs a default X11 Errorhandler. .nf .sp -\fLXv_Server -xv_init(\f(LBattrs\fP) - <\fIattribute-value list\fP> \f(LBattrs;\fP +\fCXv_Server +xv_init(\f(CBattrs\fP) + <\fIattribute-value list\fP> \f(CBattrs;\fP .fi .sp \fPNote: @@ -57,18 +57,18 @@ Creates an object. .nf .sp -\fLXv_object -xv_create(owner, package, \f(LBattrs\fP) +\fCXv_object +xv_create(owner, package, \f(CBattrs\fP) Xv_object owner; Xv_pkg package; - <\fIattribute-value list\fP> \f(LBattrs;\fP + <\fIattribute-value list\fP> \f(CBattrs;\fP .fi .TP .B xv_destroy() Destroys an object. .nf .sp -\fLint +\fCint xv_destroy(object) Xv_opaque object;\fP .fi @@ -80,11 +80,11 @@ XV_AUTO_CREATE, FALSE). .nf .sp -\fLXv_opaque -xv_find(owner, package, \f(LBattrs\fP) +\fCXv_opaque +xv_find(owner, package, \f(CBattrs\fP) Xv_object owner; Xv_pkg package; - <\fIattribute-value list\fP> \f(LBattrs;\fP + <\fIattribute-value list\fP> \f(CBattrs;\fP .fi .TP .B xv_get() @@ -92,40 +92,40 @@ .ne 2i .nf .sp -\fLXv_opaque -xv_get(object, \f(LBattrs\fP) +\fCXv_opaque +xv_get(object, \f(CBattrs\fP) Xv_object object;\fP - <\fIattribute-value list\fP> \f(LBattrs;\fP + <\fIattribute-value list\fP> \f(CBattrs;\fP .fi .TP .B xv_set() Sets the value of one or more attributes. .nf .sp -\fLXv_opaque -xv_set(object, \f(LBattrs\fP) +\fCXv_opaque +xv_set(object, \f(CBattrs\fP) Xv_object object;\fP - <\fIattribute-value list\fP> \f(LBattrs;\fP + <\fIattribute-value list\fP> \f(CBattrs;\fP .fi .SS Internationalized Support XView now has support for internationalization. This includes locale -setting, localized text handling, and dynamic object layout. See the +setting, localized text handling, and dynamic object layout. See the .I XView Programming Manual .\" .TZ OREILLY7 -for details. +for details. .SS Command Line Resource Arguments XView-based applications display characteristics can be -controlled by supplying command line -arguments to the applications at start-up. +controlled by supplying command line +arguments to the applications at start-up. The usage is as follows: .sp -.I % program -argument1 value1 -argument2 value2... +.I % program \-argument1 value1 \-argument2 value2... .sp -In the tables below, +In the tables below, .B Argument(s) -shows the short argument followed by the long argument\(emeither can be used. +shows the short argument followed by the long argument\(emeither can be used. .B Type -describes the type of value the arguments can receive. +describes the type of value the arguments can receive. .B Resource describes the X resource name modified by the arguments. .B Default @@ -141,7 +141,7 @@ .TP 15 .PD 0 .B Argument(s): --Wx, or -scale +\-Wx, or \-scale .TP .B Type: string ("small", "medium", "large", "extra_large") @@ -154,21 +154,21 @@ .TP .B Description: Sets the initial scale of the application (larger or smaller). -.B small -is 10 pixels, +.B small +is 10 pixels, .B medium -is 12 pixels, -.B large -is 14 pixels and -.B extra_Large -is 19 pixels. The font.name resource will override the scale. +is 12 pixels, +.B large +is 14 pixels and +.B extra_Large +is 19 pixels. The font.name resource will override the scale. .TP .B Example: -cmdtool -scale extra_large +cmdtool \-scale extra_large .sp .TP .B Argument(s): --Wt, -fn, or -font +\-Wt, \-fn, or \-font .TP .B Type: string @@ -180,27 +180,27 @@ lucidasans-12 .TP .B Description: -Sets the name of the font used for the application. +Sets the name of the font used for the application. Does not set the font for frame header and frame menu header. These are controlled by the window manager. -To find out what fonts are available, use the +To find out what fonts are available, use the .BR xlsfonts (1) command. If the font you specify cannot be found, you will see an error message such as: .sp .nf -.I "XView warning: Cannot load font 'galant-24' (Font package)" +.I "XView warning: Cannot load font \&'galant-24' (Font package)" .fi -.I "XView warning: Attempting to load font '-b&h-lucida-medium-r-normal-sans-*-120-*-*-*-*-*-*' instead (Font package)" +.I "XView warning: Attempting to load font \&'-b&h-lucida-medium-r-normal-sans-*-120-*-*-*-*-*-*' instead (Font package)" .sp .TP .B Example: -cmdtool -fn fixed +cmdtool \-fn fixed .sp .TP .B Argument(s): --Ws, or -size +\-Ws, or \-size .TP .B Type: integer integer @@ -212,15 +212,15 @@ depends on application .TP .B Description: -Sets the width and height of the application's base frame. +Sets the width and height of the application's base frame. The values are in pixels. .TP .B Example: -cmdtool -Ws 400 500 +cmdtool \-Ws 400 500 .sp .TP .B Argument(s): --Ww, or -width +\-Ww, or \-width .TP .B Type: int (number of columns) @@ -235,13 +235,13 @@ Specifies the width, in columns, of the application. .TP .B Example: -cmdtool -width 40 +cmdtool \-width 40 .br (starts a command tool 40 columns wide) .sp .TP .B Argument(s): --Wh, or -height +\-Wh, or \-height .TP .B Type: int (number of columns) @@ -256,13 +256,13 @@ Specifies the height, in rows, of the application. .TP .B Example: -cmdtool -height 40 +cmdtool \-height 40 .br (starts a command tool 40 rows high) .sp .TP .B Argument(s): --Wp, or -position +\-Wp, or \-position .TP .B Type: integer integer @@ -278,16 +278,16 @@ upper left corner of the screen is at position (0,0), with the x-axis increasing to the left, and the y-axis increasing downward. -These values will also be generated -by the "Save Workspace" option on the root menu into the +These values will also be generated +by the "Save Workspace" option on the root menu into the \fB$HOME/.openwin-init\fP file when using the Open Look Window Manager. .TP .B Example: -cmdtool -Wp 100 200 +cmdtool \-Wp 100 200 .sp .TP .B Argument(s): --WG, or -geometry +\-WG, or \-geometry .TP .B Type: string of the format x{+-}{+-} @@ -300,30 +300,30 @@ .TP .B Description: This sets both the size and the placement of the application's -base frame. This option has priority over the -.B -size -and -.B -position +base frame. This option has priority over the +.B \-size +and +.B \-position arguments. The size and placement parts of the value are optional. You can set just the size, just the position, or both. The size values are measured in pixels, and the position values use the same semantics as -.B -position. -However, if you use the '-' +.B \-position. +However, if you use the \&'-' in front of an X value, it will be taken as relative to the right hand side of the screen, instead of the left. Likewise, if you -use the '-' with the Y value, it will be taken relative to the +use the \&'-' with the Y value, it will be taken relative to the bottom of the screen instead of the top. .TP .B Examples: .nf -.B "cmdtool -geometry 500x600" +.B "cmdtool \-geometry 500x600" .fi (will make the base frame 500x600 pixels, with the position set by the window manager) .IP .nf -.B "cmdtool -WG +10+20" +.B "cmdtool \-WG +10+20" .fi (will make the base frame of default size with the left hand side of the frame 10 pixels from the left @@ -331,7 +331,7 @@ 20 pixels from the top of the screen) .IP .nf -.B "cmdtool -WG -10+20" +.B "cmdtool \-WG \-10+20" .fi (will make the base frame of default size with the right hand side of the frame 10 pixels from the right @@ -339,7 +339,7 @@ 20 pixels from the top of the screen) .IP .nf -.B "cmdtool -geometry 400x300-0-0" +.B "cmdtool \-geometry 400x300-0-0" .fi (will make the base frame 400x300 pixels with the right hand side of the frame flush against the right @@ -348,7 +348,7 @@ .sp .TP .B Argument(s): --WP, -icon_position +\-WP, \-icon_position .TP .B Type: integer integer @@ -360,17 +360,17 @@ depends on window manager .TP .B Description: -Sets the position of the application's icon in pixels. Uses the -same semantics as -.B -position +Sets the position of the application's icon in pixels. Uses the +same semantics as +.B \-position for base frames. .TP .B Example: -cmdtool -WP 400 20 +cmdtool \-WP 400 20 .sp .TP .B Argument(s): --Wl, -label, or -title +\-Wl, \-label, or \-title .TP .B Type: string @@ -384,14 +384,14 @@ .B Description: Sets a default label for the base frame's header. However, the application can overwrite this setting and display its own -header. +header. .TP .B Example: -cmdtool -Wl "Header Text" +cmdtool \-Wl "Header Text" .sp .TP .B Argument(s): --Wi, and +Wi +\-Wi, and +Wi .TP .B Type: boolean @@ -409,11 +409,11 @@ .B Examples: cmdtool +Wi (will make the cmdtool come up open) .br -cmdtool -Wi (will make the cmdtool come up closed) +cmdtool \-Wi (will make the cmdtool come up closed) .sp .TP .B Argument(s): --depth +\-depth .TP .B Type: integer @@ -428,15 +428,15 @@ Specifies the depth of base frame. If this depth is not supported by the server, the default depth will be used instead. -If this is specified in conjunction with -visual, +If this is specified in conjunction with \-visual, then the exact visual will be used. .TP .B Example: -cmdtool -depth 4 +cmdtool \-depth 4 .sp .TP .B Argument(s): --visual +\-visual .TP .B Type: string (one of the values: StaticGray, GrayScale, @@ -452,15 +452,15 @@ Specifies the visual class of the base frame. If this visual class is not supported by the server, the default visual class will be used instead. -If this is specified in conjunction with -depth, +If this is specified in conjunction with \-depth, then the exact visual will be used. .TP .B Example: -cmdtool -visual StaticGray +cmdtool \-visual StaticGray .sp .TP .B Argument(s): --Wf, or -foreground_color +\-Wf, or \-foreground_color .TP .B Type: integer integer integer @@ -472,11 +472,11 @@ 0 0 0 .TP .B Description -See Description in -Wb below. +See Description in \-Wb below. .sp .TP .B Argument(s): --Wb, or -background +\-Wb, or \-background .TP .B Type: integer integer integer @@ -492,20 +492,20 @@ the color of the text in a textsw), or the background color (e.g., the color that the text is painted on) of an application. The three values should be integers between 0 and 255. They specify -the amount of red, green and blue that is in the color. See -.B -fg +the amount of red, green and blue that is in the color. See +.B \-fg and -.B -bg +.B \-bg below for information on similar functions. .TP .B Example: -cmdtool -Wf 0 0 255 -Wb 100 100 100 +cmdtool \-Wf 0 0 255 \-Wb 100 100 100 .br (would come up with a blue foreground, with a gray background) .sp .TP .B Argument(s): --fg, or -foreground +\-fg, or \-foreground .TP .B Type: string (color name, or hexadecimal color specification) @@ -517,11 +517,11 @@ black .TP .B Description: -See Description in -bg below. +See Description in \-bg below. .sp .TP .B Argument(s): --bg, or -background +\-bg, or \-background .TP .B Type: string (color name, or hexadecimal color specification) @@ -533,7 +533,7 @@ white .TP .B Description: -These options are similar to the -Wf and -Wb options, except +These options are similar to the \-Wf and \-Wb options, except that they take a color argument in the form of a predefined color name (lavender, grey, goldenrod, etc.) @@ -543,17 +543,17 @@ blue aspects of the color. .TP .B Examples: -cmdtool -fg blue -bg gray +cmdtool \-fg blue \-bg gray .br (comes up with a blue foreground, with a gray background) .IP -cmdtool -fg #d800ff -bg white +cmdtool \-fg #d800ff \-bg white .br (comes up with a purple foreground, with a white background) .sp .TP .B Argument(s): --WI, or -icon_image +\-WI, or \-icon_image .TP .B Type: string @@ -576,11 +576,11 @@ with the suffix \fB.icon\fP. .TP .B Example: -cmdtool -WI \fB/usr/include/images/stop.icon\fP +cmdtool \-WI \fB/usr/include/images/stop.icon\fP .sp .TP .B Argument(s): --WL, or -icon_label +\-WL, or \-icon_label .TP .B Type: string @@ -597,11 +597,11 @@ icon label. .TP .B Example: -cmdtool -WL "Icon Label" +cmdtool \-WL "Icon Label" .sp .TP .B Argument(s): --WT, or -icon_font +\-WT, or \-icon_font .TP .B Type: string @@ -616,11 +616,11 @@ Sets the name of the font used for the application's icon. .TP .B Example: -cmdtool -WT '*century schoolbook*' +cmdtool \-WT \&'*century schoolbook*' .sp .TP .B Argument(s): --Wd, or -default +\-Wd, or \-default .TP .B Type: string string @@ -633,17 +633,17 @@ .TP .B Description: This option allows the user to set resources that don't have command -line equivalents. The format is +line equivalents. The format is .B "-default resource-name value" . -The XView resources without specific command line arguments are +The XView resources without specific command line arguments are discussed in the following section. .TP .B Example: -cmdtool -default OpenWindows.ScrollbarPlacement left +cmdtool \-default OpenWindows.ScrollbarPlacement left .sp .TP .B Argument(s): --xrm +\-xrm .TP .B Type: string @@ -656,17 +656,17 @@ .TP .B Description: This option allows the user to set resources that don't have -command line equivalents. This is similar to the -default +command line equivalents. This is similar to the \-default option, but it takes only one argument, a string in the form of resource-name:value. .TP .B Example: -cmdtool -xrm OpenWindows.ScrollbarPlacement:right +cmdtool \-xrm OpenWindows.ScrollbarPlacement:right .sp .TP -.B +.B Argument(s): --WH, or -help +\-WH, or \-help .TP .B Type: none @@ -683,7 +683,7 @@ .sp .TP .B Argument(s): --sync or -synchronous, and +sync or +synchronous +\-sync or \-synchronous, and +sync or +synchronous .TP .B Type: boolean @@ -701,7 +701,7 @@ .sp .TP .B Argument(s): --Wr, or -display +\-Wr, or \-display .TP .B Type: string (host:display{.screen}) @@ -713,32 +713,32 @@ taken from the \fBDISPLAY\fP environment variable .TP .B Description: -Sets the name of the X11 server on which to connect. -.B host +Sets the name of the X11 server on which to connect. +.B host is the name or address of the machine on whose server you have permission to display. -.B display -is a number corresponding to the -server on which to display for that machine, and -.B screen +.B display +is a number corresponding to the +server on which to display for that machine, and +.B screen corresponds to which -screen for the server. See reference manual page on +screen for the server. See reference manual page on .BR xhost (1) for more details on adding to permissions list. .TP .B Examples: -cmdtool -display foobar:0 +cmdtool \-display foobar:0 .br -(will bring up a cmdtool on the default screen of the +(will bring up a cmdtool on the default screen of the display #0 of host foobar) .IP -cmdtool -display foobar:0.1 +cmdtool \-display foobar:0.1 .br (will bring up a cmdtool on screen #1 of display #0 of host foobar) .sp .TP .B Argument(s): --Wdxio, or -disable_xio_error_handler +\-Wdxio, or \-disable_xio_error_handler .TP .B Type: boolean @@ -758,7 +758,7 @@ .sp .TP .B Argument(s) --rv (or -reverse), and +rv (or +reverse) +\-rv (or \-reverse), and +rv (or +reverse) .TP .B Type: boolean @@ -772,27 +772,27 @@ .B Description: These options control whether the foreground and background colors of the application will be reversed. If True, the -foreground and background colors will be swapped. The -rv +foreground and background colors will be swapped. The \-rv flag will set this to True, while the +rv will set it to False. This is really only useful on monochrome displays. .sp .TP .B Argument(s): --name +\-name .TP .B Type: string .TP .B Resource: None -.TP +.TP .B Default: argv[0] .TP .B Description: -Specifies the instance name of the application. This name is -used to construct the resource name used to perform lookups -in the X11 Resource Manager to look for the values of +Specifies the instance name of the application. This name is +used to construct the resource name used to perform lookups +in the X11 Resource Manager to look for the values of customizable attributes. .sp .SS Internationalized Command Line Resource Arguments @@ -801,9 +801,9 @@ Locale setting is the method by which the language and cultural environment of a system is set. Locale setting affects the display and manipulation of language-dependent features. -.sp +.sp The internationalization features that XView now supports include -locale setting. One of the ways locale can be set is with command line +locale setting. One of the ways locale can be set is with command line options. See the .I XView Programming Manual .\" .TZ OREILLY7 @@ -811,7 +811,7 @@ .sp .TP 15 .B Argument(s): --lc_basiclocale +\-lc_basiclocale .TP .B Type: string @@ -823,12 +823,12 @@ "C" .TP .B Description: -Specifies the basic locale category, which sets the +Specifies the basic locale category, which sets the country of the user interface. .sp .TP .B Argument(s): --lc_displaylang +\-lc_displaylang .TP .B Type: string @@ -840,13 +840,13 @@ "C" .TP .B Description: -Specifies the display language locale category, sets -the language in which labels, messages, menu items, +Specifies the display language locale category, sets +the language in which labels, messages, menu items, and help text are displayed. .sp .TP .B Argument(s): --lc_inputlang +\-lc_inputlang .TP .B Type: string @@ -858,12 +858,12 @@ "C" .TP .B Description: -Specifies the input language locale category, sets +Specifies the input language locale category, sets the language used for keyboard input. .sp .TP .B Argument(s): --lc_numeric +\-lc_numeric .TP .B Type: string @@ -875,12 +875,12 @@ "C" .TP .B Description: -Specifies the numeric locale category, which defines +Specifies the numeric locale category, which defines the language used to format numeric quantities. .sp .TP .B Argument(s): --lc_timeformat +\-lc_timeformat .TP .B Type: string @@ -892,7 +892,7 @@ "C" .TP .B Description: -Specifies the time format locale category, which defines +Specifies the time format locale category, which defines the language used to format time and date. .sp .SS Command Line Options/X Resources for Debugging @@ -900,7 +900,7 @@ avoid the locking up of screens or other effects of X grabs that are done by XView. .sp -It should be noted that these options/resources should only be used by +It should be noted that these options/resources should only be used by developers and are not for normal usage. The X grabs are done for a specific reason, and are not meant to be customizable. @@ -909,7 +909,7 @@ .sp .TP 15 .B Argument(s): --Wfsdb, or -fullscreendebug +\-Wfsdb, or \-fullscreendebug .TP .B Type: boolean @@ -928,13 +928,13 @@ until the grab has been released by the one window which initiated the grab. Refer to Appendix F in the -.I XView Manual: Converting SunView Applications +.I XView Manual: Converting SunView Applications .\" .TZ SVCONVERT for further details. .sp .TP .B Argument(s): --Wfsdbs, or -fullscreendebugserver +\-Wfsdbs, or \-fullscreendebugserver .TP .B Type: boolean @@ -948,13 +948,13 @@ .B Description: Enables/disables server grabbing (XGrabServer()) that is done via the fullscreen pkg. Refer to the Appendix F in the -.I XView Manual: Converting SunView Applications +.I XView Manual: Converting SunView Applications .\" .TZ SVCONVERT for further details. .sp .TP .B Argument(s): --Wfsdbk, or -fullscreendebugkbd +\-Wfsdbk, or \-fullscreendebugkbd .TP .B Type: boolean @@ -975,7 +975,7 @@ .sp .TP .B Argument(s): --Wfsdbp, or -fullscreendebugptr +\-Wfsdbp, or \-fullscreendebugptr .TP .B Type: boolean @@ -996,7 +996,7 @@ .sp .TP 15 .B Argument(s): --Wdpgs, or -disable_pass_grab_select +\-Wdpgs, or \-disable_pass_grab_select .TP .B Type: boolean @@ -1008,7 +1008,7 @@ TRUE .TP .B Description: -Disables the passive grab that is done on the +Disables the passive grab that is done on the SELECT button. XView does a passive grab on the SELECT button to avoid input focus race conditions. @@ -1016,9 +1016,9 @@ conditions may be seen. .TP .B Example: -% cmdtool -disable_pass_grab_select +% cmdtool \-disable_pass_grab_select .br -This executes a cmdtool that does not perform any +This executes a cmdtool that does not perform any passive grabs on the SELECT button. To do the same thing using X resources, add the following entry to the X resource database: @@ -1040,11 +1040,11 @@ .sp Note that resources documented below do not have command line arguments. It is still possible, however, to change them without altering the \fB.Xdefaults\fP -file. Refer to the command line arguments -.B -xrm -and -.B -defaults -for instructions on how to to this. Additional resources that have +file. Refer to the command line arguments +.B \-xrm +and +.B \-defaults +for instructions on how to to this. Additional resources that have command line arguments are documented in the previous section. For mouseless resources refer to the .I XView Programming Manual. @@ -1057,12 +1057,12 @@ .B Resource: .I "Resource Name ( .I "If the resource can be modified by the OpenWindows Property Sheet, -.I the word +.I the word .B Props .I will be present.) .TP .B Values: -.I "Possible Values, and/or Format of Values to be Assigned to Resource +.I "Possible Values, and/or Format of Values to be Assigned to Resource .B (Default Value) .TP .B Description @@ -1071,7 +1071,7 @@ .TP 15 .PD 0 .B Resource: -window.synchronous, +sync -sync +window.synchronous, +sync \-sync .TP .B Values: True, False (False) @@ -1079,7 +1079,7 @@ .B Description Useful when debugging or tracking down a problem since the error codes emitted from Xlib will correspond to the immediate request -made. Running in a synchronous mode will cause the application +made. Running in a synchronous mode will cause the application to run significantly slower. .sp .TP @@ -1090,12 +1090,12 @@ Shift, Ctrl, any valid modifier keysym (Shift) .TP .B Description -When using a mouse with less than three buttons, this resource gets -an equivalent -mapping for the second button which is the ADJUST button on a three -button mouse. For more information on keysyms, see the +When using a mouse with less than three buttons, this resource gets +an equivalent +mapping for the second button which is the ADJUST button on a three +button mouse. For more information on keysyms, see the .BR xmodmap (1) -reference manual page, Xlib documentation, and the include file +reference manual page, Xlib documentation, and the include file \fB$OPENWINHOME/include/X11/Xkeymap.h\fP. .sp .TP @@ -1106,28 +1106,28 @@ Shift, Ctrl, any valid modifier keysym (Ctrl) .TP .B Description -When using a mouse with less than three buttons, this resource gets -an equivalent +When using a mouse with less than three buttons, this resource gets +an equivalent mapping for the third button which is the MENU button on a three button mouse. For more information on keysyms, see the \fBxmodmap\fP -reference manual page, Xlib documentation, and the include file +reference manual page, Xlib documentation, and the include file \fB$OPENWINHOME/include/X11/Xkeymap.h\fP. .sp .TP .B Resource: -OpenWindows.beep (Props) +OpenWindows.beep (Props) .TP .B Values: never, notices, always (always) .TP .B Description -When the value is -.B notices, -the audible bell will ring only -when a notice pops up. When the value is -.B never, -the audible bell will never ring. When the value is -.B always, +When the value is +.B notices, +the audible bell will ring only +when a notice pops up. When the value is +.B never, +the audible bell will never ring. When the value is +.B always, the audible bell will always ring when the bell function is called by a program. .sp @@ -1139,18 +1139,18 @@ True, False (True) .TP .B Description -When ringing the bell in an XView program, flash the window as +When ringing the bell in an XView program, flash the window as well to alert the user. .sp .TP -.B +.B OpenWindows.windowColor (Props) .TP .B Values: any valid X11 color specification (#cccccc\(em80% grey) .TP .B Description -Specify the base color for control areas for 3-D look. Takes hexadecimal +Specify the base color for control areas for 3-D look. Takes hexadecimal representation. Three other colors used for shading and highlighting are calculated based upon the value of the specified control color. The actual @@ -1181,7 +1181,7 @@ When False, tells XView to set window manager hints in a way that was used before the ICCCM was adopted. Useful for window managers that were released before X11R4. Not needed with the Open Look Window Manager -provided with Open Windows. +provided with Open Windows. .sp .TP .B Resource: @@ -1202,8 +1202,8 @@ .TP .B Description Used by menus to determine when a pullright submenu would display when -dragging over the menu item near a submenu. -.B N +dragging over the menu item near a submenu. +.B N is an integer greater than 0. A reasonable value might start at 20 and go to 200 or so. May need to try different values to see what feels best to each person. @@ -1216,9 +1216,9 @@ N (3) .TP .B Description: -Selection timeout value. +Selection timeout value. .B N -indicates the number of seconds that a requestor or a selection owner waits for a +indicates the number of seconds that a requester or a selection owner waits for a response. .sp .TP @@ -1241,7 +1241,7 @@ string-list (NULL) .TP .B Description: -new-line (\n) separated list of full-path names to +new-line (\\n) separated list of full-path names to directories that is added to the top of the Go To Menu of a File Chooser. .sp @@ -1250,7 +1250,7 @@ OpenWindows.KeyboardCommand.* .TP .B Description: -These resources determine mouseless semantic action and its corresponding key +These resources determine mouseless semantic action and its corresponding key binding. Refer to the .I XView Reference Manual for a complete listing and explanation of the OpenWindows.KeyboardCommand.* @@ -1267,7 +1267,7 @@ SunView1, Basic, or Full .TP .B Description: -Controls the level of mouseless operation. All of the +Controls the level of mouseless operation. All of the OpenWindows.KeyboardCommand resource mappings may be modified by users, or by specifying one the the three values for OpenWindows.KeyboardCommands. For detailed information see the @@ -1282,14 +1282,14 @@ True or False (True) .TP .B Description: -Specifies whether or not to activate all keyboard -menu acceleration defined by applications. Menu -accelerators are keystrokes that can be used to -invoke menu commands directly. They can be seen on -the right side of frequently used menu items as a -set of keyboard qualifiers (with a graphical diamond -mark representing the meta key) and an accelerator -key. +Specifies whether or not to activate all keyboard +menu acceleration defined by applications. Menu +accelerators are keystrokes that can be used to +invoke menu commands directly. They can be seen on +the right side of frequently used menu items as a +set of keyboard qualifiers (with a graphical diamond +mark representing the meta key) and an accelerator +key. .sp .TP .B Resource: @@ -1313,7 +1313,7 @@ N (100) .TP .B Description: -Mouse chording time-out value. +Mouse chording time-out value. .B N is in micro-seconds. .sp @@ -1325,7 +1325,7 @@ True, False (False) .TP .B Description -When True, the SELECT button (usually left mouse) will display the +When True, the SELECT button (usually left mouse) will display the menu as well as the MENU button (usually right mouse). .sp .TP @@ -1351,19 +1351,19 @@ .sp .TP .B Resource: -OpenWindows.scrollbarPlacement (Props) +OpenWindows.scrollbarPlacement (Props) .TP .B Values: Left, Right (Right) .TP .B Description -When set to -.B Left, +When set to +.B Left, put all scrollbars on the lefthand side of the window or object. .sp .TP .B Resource: -OpenWindows.multiClickTimeout (Props) +OpenWindows.multiClickTimeout (Props) .TP .B Values: N (4) @@ -1383,27 +1383,27 @@ .B Description This resource allows the user to select the delimiter characters that are used when doing word level selections in the XView package. It was -added because of the needs of the international marketplace, and it +added because of the needs of the international marketplace, and it allows the user to define the local delimiters for the character set that is being used with the current keyboard and Sun workstation. .sp -Note that the octal characters can be scrambled by -.B Xrm -during a rewrite of the value of text.delimiter.Chars. -.B Xrm -interprets the text.delimiterChar string when it is loaded. +Note that the octal characters can be scrambled by +.B Xrm +during a rewrite of the value of text.delimiter.Chars. +.B Xrm +interprets the text.delimiterChar string when it is loaded. Specifically it will decode the backslashed portions of the string and convert them to octal representations. When this is passed to the client application, -the logic will function correctly. However, this misbehavior of +the logic will function correctly. However, this misbehavior of .B Xrm causes the string to be stored incorrectly if the user saves the \fB.Xdefaults\fP file using the \fBXrm\fP content of the string. The specific problem(s) that occur are the stripping of the backslash characters and the expansion of the tab character (\e011). .sp -To correct this problem, one can put the text.delimiterChar entry into an -.B .Xdefaults +To correct this problem, one can put the text.delimiterChar entry into an +.B .Xdefaults file that will not be overwritten when saving the workspace properties (for example, a system wide defaults file). Or a copy of the text.delimiterChar entry can be inserted after \fB.Xdefaults\fP @@ -1453,7 +1453,7 @@ .TP .B Description Where N is some integer greater than 0. -Specifies the time in milliseconds between repeats of a single line +Specifies the time in milliseconds between repeats of a single line scroll. How long to pause scrolling when holding down the SELECT button on the scrollbar elevator. Scrollbar sets up a timer routine for repeats. @@ -1470,7 +1470,7 @@ saved to a file on disk. Once this limit is exceeded, the text package will send a notice to the user to tell them that no more insertions are possible. If the file -being edited is saved to a file, or it is a disk file being edited, +being edited is saved to a file, or it is a disk file being edited, then the limit does not apply. .sp .TP @@ -1491,7 +1491,7 @@ filename (\fB/usr/lib/.text_extras_menu\fP) .TP .B Description -Where filename is an absolute location to a file. Can also be +Where filename is an absolute location to a file. Can also be set via environment variable EXTRASMENU. This file is used for the text package's Extras menu. The commands specified in the extras menu are applied to the contents of the current @@ -1551,7 +1551,7 @@ .TP .B Description When False, do not give user confirmation if a save will overwrite an -existing file. +existing file. .sp .TP .B Resource: @@ -1566,13 +1566,13 @@ font. .sp .TP -.B Resource: +.B Resource: Text.DeleteReplacesClipboard -.TP -.B Values: -True, False (False) -.TP -.B Description +.TP +.B Values: +True, False (False) +.TP +.B Description This resource controls whether text that has been selected and then deleted by the delete key or replaced by any other keystroke will be copied to @@ -1584,7 +1584,7 @@ If the resource is True, then the text selected for a filter function will replace the clipboard when the filter successfully finishes. If the resource is False, then the text selected does not replace the -clipboard. +clipboard. .sp .TP .B Resource: @@ -1617,7 +1617,7 @@ Clip, Wrap_char, Wrap_word (Wrap_word) .TP .B Description -Determines how the textsw treats file lines when they are +Determines how the textsw treats file lines when they are too big to fit on one display line. .sp .TP @@ -1628,9 +1628,9 @@ N (0) .TP .B Description -Where N is an integer between -1 and 50. +Where N is an integer between \-1 and 50. Specifies the minimum number of lines to maintain between insertion -point and bottom of view. A value of -1 turns auto scrolling off. +point and bottom of view. A value of \-1 turns auto scrolling off. .sp .TP .B Resource: @@ -1664,9 +1664,9 @@ N (2) .TP .B Description -Where N is an integer between -1 and 50. +Where N is an integer between \-1 and 50. Specifies the minimum number of lines to maintain between the start -of the selection and the top of the view. A value of -1 means defeat +of the selection and the top of the view. A value of \-1 means defeat normal actions. .sp .TP @@ -1713,18 +1713,18 @@ N (0) .TP .B Description -Where N is an integer which is the percentage of the -maximum height of a character in the Textsw window +Where N is an integer which is the percentage of the +maximum height of a character in the Textsw window font to use as interline spacing. -Setting Text.LineSpacing to a nonzero positive number -will increase the size of a Textsw proportionally. +Setting Text.LineSpacing to a nonzero positive number +will increase the size of a Textsw proportionally. xv_set() of WIN_ROWS will still yield the correct number of rows. However, the window will be taller as compared to a Textsw with Text.LineSpacing set to 0. -This resource allows XView to conform to TUV requirements. -To meet TUV requirements, set Text.LineSpacing to 15 or +This resource allows XView to conform to TUV requirements. +To meet TUV requirements, set Text.LineSpacing to 15 or greater. .sp .TP @@ -1732,7 +1732,7 @@ term.boldStyle .TP .B Values: -None, Offset_X, Offset_Y, Offset_X_and_Y, Offset_XY, Offset_X_and_XY, +None, Offset_X, Offset_Y, Offset_X_and_Y, Offset_XY, Offset_X_and_XY, Offset_Y_and_XY, Offset_X_and_Y_and_XY, Invert (Invert) .TP .B Description @@ -1779,7 +1779,7 @@ filename (\fB$XVIEWHOME/lib/.ttyswrc\fP) .TP .B Description -Where filename specifies a complete filename and absolute path of +Where filename specifies a complete filename and absolute path of an alternate \fBttyswrc\fP file. This is only used if a \fB.ttyswrc\fP file is not found in \fB$HOME/.ttyswrc\fP and term.useAlternateTtyswrc is True. .sp @@ -1819,7 +1819,7 @@ .B Description This resource takes as a value a list of modifier keys. Any semantic meaning (mouseless command or keyboard accelerator) that would normally -be associated with the listed modifiers when the keyboard focus is in +be associated with the listed modifiers when the keyboard focus is in a ttysw or termsw would be removed. .sp .SH ENVIRONMENT @@ -1827,13 +1827,13 @@ is the directory in which the server's directory hierarchy is installed. .br -.B $DISPLAY +.B $DISPLAY is the name of the server and screen to which applications should display. .br -.B $LD_LIBRARY_PATH +.B $LD_LIBRARY_PATH is the SunOS shared library search path. .br -.B $HELPPATH +.B $HELPPATH is the path that applications will search for Open Look Help files. .sp .SH FILES