Provided by: xviewg_3.2p1.4-28.1_amd64 bug

NAME

       xview - xview toolkit information

SYNOPSIS

       There  is  no  xview  command  per  se,  but  this manual page will briefly describe XView
       features and functions.

AVAILABILITY

       XView is available with the OpenWindows distribution.

DESCRIPTION

       XView (X Window-System-based Visual/Integrated Environment for Workstations)  is  an  Open
       Look  user-interface  toolkit  which  supports  development of interactive, graphics-based
       applications running under the X Window System.  For detailed information  see  the  XView
       Programming Manual and the XView Reference Manual.

USAGE

   Compiling XView Programs
       XView programs are compiled with the following command line:

       cc sourcefile.c -o outputfile -lxview -lolgx -lX11

   Generic XView Functions
       xv_init()      Establishes  the connection to the server, initializes the Notifier and the
                      Defaults/Resource-Manager  database,  loads  the  Server   Resource-Manager
                      database,   reads  any  passed  attributes,  and  installs  a  default  X11
                      Errorhandler.

                      Xv_Server
                      xv_init(attrs)
                          <attribute-value list> attrs;

                      Note: attrs is a NULL terminated attribute-value list.

       xv_create()    Creates an object.

                      Xv_object
                      xv_create(owner, package, attrs)
                          Xv_object      owner;
                          Xv_pkg         package;
                          <attribute-value list> attrs;

       xv_destroy()   Destroys an object.

                      int
                      xv_destroy(object)
                          Xv_opaque object;

       xv_find()      Finds an object that meets certain  criteria;  or  if  the  object  doesn't
                      exist,   creates   it   (default  behavior  which  can  be  defeated  using
                      XV_AUTO_CREATE, FALSE).

                      Xv_opaque
                      xv_find(owner, package, attrs)
                          Xv_object      owner;
                          Xv_pkg         package;
                          <attribute-value list> attrs;

       xv_get()       Gets the value of a single attribute.

                      Xv_opaque
                      xv_get(object, attrs)
                          Xv_object     object;
                          <attribute-value list> attrs;

       xv_set()       Sets the value of one or more attributes.

                      Xv_opaque
                      xv_set(object, attrs)
                          Xv_object     object;
                          <attribute-value list> attrs;

   Internationalized Support
       XView now has support for internationalization. This includes  locale  setting,  localized
       text handling, and dynamic object layout. See the XView Programming Manual for details.

   Command Line Resource Arguments
       XView-based  applications  display  characteristics can be controlled by supplying command
       line arguments to the applications at start-up.  The usage is as follows:

       % program -argument1 value1 -argument2 value2...

       In the tables below, Argument(s) shows the short argument followed by the  long  argument—
       either can be used.  Type describes the type of value the arguments can receive.  Resource
       describes the X resource name modified by the arguments.  Default is  the  default  value.
       Description  describes what the arguments do.  Example shows an example of a command using
       the argument.

       Argument(s):   -Wx, or -scale
       Type:          string ("small", "medium", "large", "extra_large")
       Resource:      Window.Scale
       Default:       medium
       Description:   Sets the initial scale of the application (larger or smaller).  small is 10
                      pixels,  medium  is  12  pixels,  large  is 14 pixels and extra_Large is 19
                      pixels.  The font.name resource will override the scale.
       Example:       cmdtool -scale extra_large

       Argument(s):   -Wt, -fn, or -font
       Type:          string
       Resource:      Font.Name
       Default:       lucidasans-12
       Description:   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  xlsfonts(1)
                      command.   If  the  font you specify cannot be found, you will see an error
                      message such as:

                      XView warning: Cannot load font 'galant-24' (Font package)
                      XView  warning:  Attempting  to  load  font   '-b&h-lucida-medium-r-normal-
                      sans-*-120-*-*-*-*-*-*' instead (Font package)

       Example:       cmdtool -fn fixed

       Argument(s):   -Ws, or -size
       Type:          integer integer
       Resource:      Window.Width and Window.Height
       Default:       depends on application
       Description:   Sets  the width and height of the application's base frame.  The values are
                      in pixels.
       Example:       cmdtool -Ws 400 500

       Argument(s):   -Ww, or -width
       Type:          int (number of columns)
       Resource:      window.columns
       Default:       None
       Description:   Specifies the width, in columns, of the application.
       Example:       cmdtool -width 40
                      (starts a command tool 40 columns wide)

       Argument(s):   -Wh, or -height
       Type:          int (number of columns)
       Resource:      window.rows
       Default:       None
       Description:   Specifies the height, in rows, of the application.
       Example:       cmdtool -height 40
                      (starts a command tool 40 rows high)

       Argument(s):   -Wp, or -position
       Type:          integer integer
       Resource:      Window.X and Window.Y
       Default:       depends on window manager
       Description:   Sets the initial position of the application's base frame in  pixels.   The
                      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 $HOME/.openwin-init file when using the Open Look Window Manager.
       Example:       cmdtool -Wp 100 200

       Argument(s):   -WG, or -geometry
       Type:          string of the format <width>x<height>{+-}<xoffset>{+-}<yoffset>
       Resource:      Window.Geometry
       Default:       depends on application and window manager
       Description:   This sets both the size and the placement of the application's base  frame.
                      This  option  has priority over the -size and -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 -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 bottom of the
                      screen instead of the top.
       Examples:
                      cmdtool -geometry 500x600
                      (will make the base frame 500x600 pixels, with  the  position  set  by  the
                      window manager)
                      cmdtool -WG +10+20
                      (will  make  the  base frame of default size with the left hand side of the
                      frame 10 pixels from the left hand side of the screen, and the top  of  the
                      frame 20 pixels from the top of the screen)
                      cmdtool -WG -10+20
                      (will  make  the base frame of default size with the right hand side of the
                      frame 10 pixels from the right hand side of the screen, and the top of  the
                      frame 20 pixels from the top of the screen)
                      cmdtool -geometry 400x300-0-0
                      (will  make  the  base frame 400x300 pixels with the right hand side of the
                      frame flush against the right hand side of the screen, and  the  bottom  of
                      the frame flush with the bottom of the screen)

       Argument(s):   -WP, -icon_position
       Type:          integer integer
       Resource:      Icon.X Icon.Y
       Default:       depends on window manager
       Description:   Sets  the  position  of  the  application's  icon in pixels.  Uses the same
                      semantics as -position for base frames.
       Example:       cmdtool -WP 400 20

       Argument(s):   -Wl, -label, or -title
       Type:          string
       Resource:      Window.Header
       Default:       N/A
       Description:   Sets a default label for the base frame's header.  However, the application
                      can overwrite this setting and display its own header.
       Example:       cmdtool -Wl "Header Text"

       Argument(s):   -Wi, and +Wi
       Type:          boolean
       Resource:      Window.Iconic
       Default:       +Wi
       Description:   Controls how an application will come up, open or closed (iconified).
       Examples:      cmdtool +Wi      (will make the cmdtool come up open)
                      cmdtool -Wi      (will make the cmdtool come up closed)

       Argument(s):   -depth
       Type:          integer
       Resource:      Window.Depth
       Default:       Depth of server's default visual
       Description:   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, then the exact visual will be used.
       Example:       cmdtool -depth 4

       Argument(s):   -visual
       Type:          string (one of the values: StaticGray, GrayScale, StaticColor, PseudoColor,
                      TrueColor, or DirectColor).
       Resource:      Window.Visual
       Default:       Server's default visual
       Description:   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, then the exact visual will be
                      used.
       Example:       cmdtool -visual StaticGray

       Argument(s):   -Wf, or -foreground_color
       Type:          integer integer integer
       Resource:      Window.Color.Foreground
       Default:       0 0 0
       Description    See Description in -Wb below.

       Argument(s):   -Wb, or -background
       Type:          integer integer integer
       Resource:      Window.Color.Background
       Default:       255 255 255
       Description:   These  options  allow  the  user to specify the foreground color (e.g., 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 -fg and -bg below for information on similar
                      functions.
       Example:       cmdtool -Wf 0 0 255 -Wb 100 100 100
                      (would come up with a blue foreground, with a gray background)

       Argument(s):   -fg, or -foreground
       Type:          string (color name, or hexadecimal color specification)
       Resource:      Window.Color.Foreground
       Default:       black
       Description:   See Description in -bg below.

       Argument(s):   -bg, or -background
       Type:          string (color name, or hexadecimal color specification)
       Resource:      Window.Color.Background
       Default:       white
       Description:   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.)   from   $OPENWINHOME/lib/rbg.txt,   or   a   hexadecimal
                      representation.   The  hexadecimal representation is of the form pound sign
                      (#) followed by the hexadecimal representation of the red, green  and  blue
                      aspects of the color.
       Examples:      cmdtool -fg blue -bg gray
                      (comes up with a blue foreground, with a gray background)
                      cmdtool -fg #d800ff -bg white
                      (comes up with a purple foreground, with a white background)

       Argument(s):   -WI, or -icon_image
       Type:          string
       Resource:      Icon.Pixmap
       Default:       depends on application
       Description:   Sets  the  default filename for the icon's image.  However, the application
                      can overwrite this setting and display its own icon image.  The  file  must
                      be  in XView icon format.  The program iconedit(1) will allow one to create
                      an image in the icon format.  Several  icons  have  been  provided  in  the
                      directory  $OPENWINHOME/include/images.   By  convention, icon format files
                      end with the suffix .icon.
       Example:       cmdtool -WI /usr/include/images/stop.icon

       Argument(s):   -WL, or -icon_label
       Type:          string
       Resource:      Icon.Footer
       Default:       depends on application
       Description:   Sets a default label for the base frame's icon.  However,  the  application
                      can overwrite this setting and display its own icon label.
       Example:       cmdtool -WL "Icon Label"

       Argument(s):   -WT, or -icon_font
       Type:          string
       Resource:      Icon.Font.Name
       Default:       depends
       Description:   Sets the name of the font used for the application's icon.
       Example:       cmdtool -WT '*century schoolbook*'

       Argument(s):   -Wd, or -default
       Type:          string string
       Resource:      given by the first string
       Default:       none
       Description:   This  option  allows the user to set resources that don't have command line
                      equivalents.  The format is  -default  resource-name  value  .   The  XView
                      resources  without  specific  command  line  arguments are discussed in the
                      following section.
       Example:       cmdtool -default OpenWindows.ScrollbarPlacement left

       Argument(s):   -xrm
       Type:          string
       Resource:      given in the string
       Default:       none
       Description:   This option allows the user to set resources that don't have  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.
       Example:       cmdtool -xrm OpenWindows.ScrollbarPlacement:right

       Argument(s):   -WH, or -help
       Type:          none
       Resource:      none
       Default:       none
       Description:   Prints a description of the valid xview  command  line  arguments  for  the
                      application.

       Argument(s):   -sync or -synchronous, and +sync or +synchronous
       Type:          boolean
       Resource:      Window.Synchronous
       Default:       +synchronous
       Description:   These  options  allow  you  to make the connection that the application has
                      with the X11 server either synchronous (-sync) or asynchronous (+sync).

       Argument(s):   -Wr, or -display
       Type:          string (host:display{.screen})
       Resource:      Server.Name
       Default:       taken from the DISPLAY environment variable
       Description:   Sets the name of the X11 server on which to connect.  host is the  name  or
                      address  of  the  machine  on  whose server you have permission to display.
                      display is a number corresponding to the server on  which  to  display  for
                      that  machine,  and screen corresponds to which screen for the server.  See
                      reference manual page on xhost(1) for more details on adding to permissions
                      list.
       Examples:      cmdtool -display foobar:0
                      (will  bring  up  a cmdtool on the default screen of the display #0 of host
                      foobar)
                      cmdtool -display foobar:0.1
                      (will bring up a cmdtool on screen #1 of display #0 of host foobar)

       Argument(s):   -Wdxio, or -disable_xio_error_handler
       Type:          boolean
       Resource:      none
       Default:       enable xio handler—this option disables it
       Description:   This option is useful for debugging an application.  Whenever  there  is  a
                      fatal  XIO  error,  the  server will print an error message before exiting.
                      XView installs a error handler to keep those messages from  appearing.   If
                      you would like to see these messages, use this option.

       Argument(s)    -rv (or -reverse), and +rv (or +reverse)
       Type:          boolean
       Resource:      Window.ReverseVideo
       Default:       False
       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 flag will set this to True, while the +rv
                      will set it to False.  This is really only useful on monochrome displays.

       Argument(s):   -name
       Type:          string
       Resource:      None
       Default:       argv[0]
       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 customizable attributes.

   Internationalized Command Line Resource Arguments
       The following command line arguments are relevant to internationalization.  Locale  refers
       to  the language and cultural conventions used in a program.  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.

       The  internationalization  features that XView now supports include locale setting. One of
       the ways locale can be set is with command line options. See the XView Programming  Manual
       for details on other methods.

       Argument(s):   -lc_basiclocale
       Type:          string
       Resource:      basicLocale
       Default:       "C"
       Description:   Specifies  the  basic  locale  category, which sets the country of the user
                      interface.

       Argument(s):   -lc_displaylang
       Type:          string
       Resource:      displayLang
       Default:       "C"
       Description:   Specifies the display language locale category, sets the language in  which
                      labels, messages, menu items, and help text are displayed.

       Argument(s):   -lc_inputlang
       Type:          string
       Resource:      inputLang
       Default:       "C"
       Description:   Specifies  the  input  language locale category, sets the language used for
                      keyboard input.

       Argument(s):   -lc_numeric
       Type:          string
       Resource:      numeric
       Default:       "C"
       Description:   Specifies the numeric locale category, which defines the language  used  to
                      format numeric quantities.

       Argument(s):   -lc_timeformat
       Type:          string
       Resource:      timeFormat
       Default:       "C"
       Description:   Specifies  the time format locale category, which defines the language used
                      to format time and date.

   Command Line Options/X Resources for Debugging
       The following switches/resources can be used during development to avoid the locking up of
       screens or other effects of X grabs that are done by XView.

       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.   Without  the  X  grabs,  certain features in XView (those that depend on X
       grabs) might not function properly.

       Argument(s):   -Wfsdb, or -fullscreendebug
       Type:          boolean
       Resource:      Fullscreen.Debug
       Default:       FALSE
       Description:   Enables/disables  fullscreen  debugging   mode   during   which   X   grabs
                      (XGrabServer(),  XGrabKeyboard(), XGrabPointer()) are not done.  When using
                      the fullscreen pkg, the X11 server will be  grabbed  which  prevents  other
                      windows  on  the server from responding until the grab has been released by
                      the one window which initiated the grab.  Refer to Appendix F in the  XView
                      Manual: Converting SunView Applications for further details.

       Argument(s):   -Wfsdbs, or -fullscreendebugserver
       Type:          boolean
       Resource:      Fullscreen.Debugserver
       Default:       FALSE
       Description:   Enables/disables  server  grabbing  (XGrabServer())  that  is  done via the
                      fullscreen pkg.  Refer to the Appendix F in the  XView  Manual:  Converting
                      SunView Applications for further details.

       Argument(s):   -Wfsdbk, or -fullscreendebugkbd
       Type:          boolean
       Resource:      Fullscreen.Debugkbd
       Default:       FALSE
       Description:   Enables/disables  keyboard  grabbing (XGrabKeyboard()) that is done via the
                      fullscreen pkg.  Refer to the Appendix F in the  XView  Manual:  Converting
                      SunView Applications for further details.

       Argument(s):   -Wfsdbp, or -fullscreendebugptr
       Type:          boolean
       Resource:      Fullscreen.Debugptr
       Default:       FALSE
       Description:   Enables/disables  pointer  grabbing  (XGrabPointer())  that is done via the
                      fullscreen pkg.  Refer to the Appendix F in the  XView  Manual:  Converting
                      SunView Applications for further details.

       Argument(s):   -Wdpgs, or -disable_pass_grab_select
       Type:          boolean
       Resource:      Window.PassiveGrab.Select
       Default:       TRUE
       Description:   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.
                      When  this  passive  grab  is  disabled, input focus race conditions may be
                      seen.
       Example:       % cmdtool -disable_pass_grab_select
                      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:
                      Window.PassiveGrab.Select:False

   .Xdefaults File
       The .Xdefaults file is used to  store  and  retrieve  resource  settings.   We  recommend,
       however,  that  you  use  the  command  line  arguments described above in order to change
       display characteristics. Changing the resources in the .Xdefaults  file  will  modify  the
       behaviour  of  the  user's  session.   Novice  users should not casually hand modify these
       settings. Before attempting edits to this file please read the appropriate sections of the
       Xlib  Programming  Manual  on  the  file  format and the specific properties you intend to
       change.

       Note that resources documented below do not have command  line  arguments.   It  is  still
       possible,  however,  to  change  them  without altering the .Xdefaults file.  Refer to the
       command line arguments -xrm and -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 XView Programming Manual.

       The resources are documented in the following format:

       Resource:      Resource Name ( If the resource can be modified by the OpenWindows Property
                      Sheet, the word Props will be present.)
       Values:        Possible  Values,  and/or  Format  of  Values  to  be  Assigned to Resource
                      (Default Value)
       Description    Description of Resource.

       Resource:      window.synchronous, +sync -sync
       Values:        True, False (False)
       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  to  run  significantly
                      slower.

       Resource:      mouse.modifier.button2
       Values:        Shift, Ctrl, any valid modifier keysym (Shift)
       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 xmodmap(1)
                      reference  manual  page,  Xlib  documentation,   and   the   include   file
                      $OPENWINHOME/include/X11/Xkeymap.h.

       Resource:      mouse.modifier.button3
       Values:        Shift, Ctrl, any valid modifier keysym (Ctrl)
       Description    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 xmodmap reference
                      manual    page,    Xlib    documentation,    and    the    include     file
                      $OPENWINHOME/include/X11/Xkeymap.h.

       Resource:      OpenWindows.beep (Props)
       Values:        never, notices, always (always)
       Description    When  the  value  is notices, the audible bell will ring only when a notice
                      pops up.  When the value is never, the audible bell will never ring.   When
                      the  value  is  always,  the  audible  bell  will always ring when the bell
                      function is called by a program.

       Resource:      alarm.visible
       Values:        True, False (True)
       Description    When ringing the bell in an XView program, flash  the  window  as  well  to
                      alert the user.

       OpenWindows.windowColor (Props)
       Values:        any valid X11 color specification (#cccccc—80% grey)
       Description    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
                      calculated values are done by the OLGX  library  to  provide  a  consistent
                      color  calculation  between XView and OLWM.  The desktop properties program
                      allows a full range of customization and previews what the chosen 3-D  look
                      will look like.  Does not apply to monochrome displays.

       Resource:      OpenWindows.workspaceColor (Props)
       Values:        any valid X11 color specification (#cccccc—80% grey)
       Description    Specifies  the color for the root window and the background color for icons
                      that blend into the desktop.

       Resource:      xview.icccmcompliant
       Values:        True, False (True)
       Description    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.

       Resource:      OpenWindows.3DLook.Color
       Values:        True, False (True on all but monochrome screens)
       Description    When False, do not use the 3-D look on a color or greyscale screen.

       Resource:      OpenWindows.dragRightDistance (Props)
       Values:        N (100)
       Description    Used  by  menus  to  determine  when a pullright submenu would display when
                      dragging over the menu item near a submenu.  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.

       Resource:      Selection.Timeout
       Values:        N (3)
       Description:   Selection timeout  value.   N  indicates  the  number  of  seconds  that  a
                      requestor or a selection owner waits for a response.

       Resource:      OpenWindows.GotoMenu.RecentCount
       Values:        integer between 0 and 15 (8)
       Description:   Specifies  the  number  of  recently visited directories shown in the Go To
                      Menu of a File Chooser.

       Resource:      OpenWindows.GotoMenu.UserDirs
       Values:        string-list (NULL)
       Description:   new-line (0 separated list of full-path names to directories that is  added
                      to the top of the Go To Menu of a File Chooser.

       Resource:      OpenWindows.KeyboardCommand.*
       Description:   These  resources  determine mouseless semantic action and its corresponding
                      key binding. Refer to the XView Reference Manual for a complete listing and
                      explanation  of the OpenWindows.KeyboardCommand.*  resources. Refer to  the
                      XView Programming Manual for information on the mouseless model.

       Resource:      OpenWindows.KeyboardCommands
       Values:        SunView1, Basic, or Full
       Description:   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 XView Programming Manual

       Resource:      OpenWindows.MenuAccelerators
       Values:        True or False (True)
       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.

       Resource:      OpenWindows.MouseChordMenu
       Values:        True, False (False)
       Description:   Turns  on  the mouse chording mechanism.  Mouse chording was implemented to
                      allow XView to work with two-button  mice.  Pressing  the  SELECT  and  the
                      ADJUST buttons at the same time will act as MENU button.

       Resource:      OpenWindows.MouseChordTimeout
       Values:        N (100)
       Description:   Mouse chording time-out value.  N is in micro-seconds.

       Resource:      OpenWindows.SelectDisplaysMenu (Props)
       Values:        True, False (False)
       Description    When  True, the SELECT button (usually left mouse) will display the menu as
                      well as the MENU button (usually right mouse).

       Resource:      OpenWindows.popupJumpCursor (Props)
       Values:        True, False (False)
       Description    When False, do not warp the mouse to the notice when it appears.

       Resource:      notice.beepCount
       Values:        N (1)
       Description    Where N is an integer to specify how many times to ring  the  bell  when  a
                      notice appears.

       Resource:      OpenWindows.scrollbarPlacement (Props)
       Values:        Left, Right (Right)
       Description    When  set to Left, put all scrollbars on the lefthand side of the window or
                      object.

       Resource:      OpenWindows.multiClickTimeout (Props)
       Values:        N (4)
       Description    Where N is an integer greater than 2.  Set the number of tenths of a second
                      between clicks for a multi-click.  A click is button-down, button-up pair.

       Resource:      text.delimiterChars
       Values:        string (' \011!\"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~')
       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 allows the
                      user to define the local delimiters for the character  set  that  is  being
                      used with the current keyboard and Sun workstation.

                      Note  that the octal characters can be scrambled by Xrm during a rewrite of
                      the value of text.delimiter.Chars.  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 Xrm causes the string to be stored
                      incorrectly  if the user saves the .Xdefaults file using the Xrm content of
                      the string. The specific problem(s) that occur are  the  stripping  of  the
                      backslash characters and the expansion of the tab character (\011).

                      To  correct  this problem, one can put the text.delimiterChar entry into an
                      .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 .Xdefaults file saves.

       Resource:      scrollbar.jumpCursor (Props)
       Values:        True, False (True)
       Description    When False, the scrollbar will not move the mouse pointer when scrolling.

       Resource:      scrollbar.repeatDelay
       Values:        N (100)
       Description    Where N is some integer greater than 2.  Specifies the time in milliseconds
                      when a click becomes a repeated action.

       Resource:      scrollbar.pageInterval
       Values:        N (100)
       Description    Where N is some integer greater than 2.  Specifies the time in milliseconds
                      between repeats of a single page scroll.

       Resource:      scrollbar.lineInterval
       Values:        N (1)
       Description    Where N is some integer greater than 0.  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.

       Resource:      text.maxDocumentSize
       Values:        N (2000)
       Description    Where N specifies the bytes used in memory before a text file is 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, then the limit does not apply.

       Resource:      text.retained
       Values:        True, False (False)
       Description    If True, retain text windows with server backing store.

       Resource:      text.extrasMenuFilename
       Values:        filename (/usr/lib/.text_extras_menu)
       Description    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 selection in the textsw window and then it  inserts
                      the results at the current insertion point.

       Resource:      text.enableScrollbar
       Values:        True, False (True)
       Description    When False, do not put a scrollbar on textsw objects.

       Resource:      text.againLimit
       Values:        N (1)
       Description    Where  N  is an integer between 0 and 500.  Number of operations the "again
                      history" remembers for a textsw.

       Resource:      text.autoIndent
       Values:        True, False (False)
       Description    When True, begin the next line at the same indentation as the previous line
                      as typing in text.

       Resource:      text.autoScrollBy
       Values:        N (1)
       Description    Where  N is an integer between 0 and 100.  Specifies the number of lines to
                      scroll when type-in moves insertion point below the view.

       Resource:      text.confirmOverwrite
       Values:        True, False (True)
       Description    When False, do not give user confirmation  if  a  save  will  overwrite  an
                      existing file.

       Resource:      text.displayControlChars
       Values:        True, False (True)
       Description    When  False, use an up arrow plus a letter to display the control character
                      instead of the character that is available for the current font.

       Resource:      Text.DeleteReplacesClipboard
       Values:        True, False (False)
       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 the
                      clipboard.  If the value is True, then the selected text will be copied  to
                      the  clipboard.  If  the  value  is  False, then the text selected does not
                      replace the clipboard.

                      This resource also applies to the text selected for  the  filter  function.
                      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.

       Resource:      text.undoLimit
       Values:        N  (50 maximum of 500)
       Description    Where  N  is  an integer between 0 and 500.  How many operations to save in
                      the undo history log.  These operations will be undone when you  press  the
                      "Undo" key in the text window.

       Resource:      text.insertMakesCaretVisible
       Values:        If_auto_scroll (Always)
       Description    Controls  whether  insertion  causes  repositioning  to  make inserted text
                      visible.

       Resource:      text.lineBreak
       Values:        Clip, Wrap_char, Wrap_word (Wrap_word)
       Description    Determines how the textsw treats file lines when they are too big to fit on
                      one display line.

       Resource:      text.margin.bottom
       Values:        N (0)
       Description    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.

       Resource:      mouse.multiclick.space
       Values:        N (4)
       Description    Where  N  is an integer between 2 and 500.  Specifies the maximum number of
                      pixels between successive mouse clicks to still have the clicks  considered
                      as a multi-click event.

       Resource:      text.storeChangesFile
       Values:        True, False (True)
       Description    When  False, do not change the name of the current file being edited to the
                      name of the file that is stored.  The name of the current file is reflected
                      in the titlebar of the textedit frame.

       Resource:      text.margin.top
       Values:        N (2)
       Description    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 normal actions.

       Resource:      text.margin.left
       Values:        N (8)
       Description    Where  N  is an integer between 0 and 2000.  Specifies the margin in pixels
                      that the text should maintain between the left hand border  of  the  window
                      and the first character on each line.

       Resource:      text.margin.right
       Values:        N (0)
       Description    Where  N  is an integer between 0 and 2000.  Specifies the margin in pixels
                      that the text should maintain between the right hand border of  the  window
                      and the last character on each line.

       Resource:      text.tabWidth
       Values:        N (8)
       Description    Where  N is an integer between 0 and 50.  Specifies the width in characters
                      of the tab character.

       Resource:      Text.LineSpacing
       Values:        N (0)
       Description    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.   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
                      greater.

       Resource:      term.boldStyle
       Values:        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)
       Description    Specify the text bolding style for a terminal based window.

       Resource:      term.inverseStyle
       Values:        Enable, Disable, Same_as_bold (Enable)
       Description    Specify the text inverting style for a terminal based window.

       Resource:      term.underlineStyle
       Values:        Enable, Disable, Same_as_bold (Enable)
       Description    Specify the text underlining style for a terminal based window.

       Resource:      term.useAlternateTtyswrc
       Values:        True, False (True)
       Description    When True, and a $HOME/.ttyswrc is not found, look for an alternate ttyswrc
                      file.  When False, do not look for an alternate file is one is not found in
                      the home directory, $HOME/.ttyswrc.

       Resource:      term.alternateTtyswrc
       Values:        filename ($XVIEWHOME/lib/.ttyswrc)
       Description    Where filename specifies a  complete  filename  and  absolute  path  of  an
                      alternate  ttyswrc file.  This is only used if a .ttyswrc file is not found
                      in $HOME/.ttyswrc and term.useAlternateTtyswrc is True.

       Resource:      term.enableEdit
       Values:        True, False (True)
       Description    When False, do not keep an editlog of what has been  typed  into  the  term
                      window.   This  is  set  to  false  automatically  when  switching  from  a
                      scrollable term to one that is not scrollable.

       Resource:      ttysw.eightBitOutput
       Values:        True, False (True)
       Description    This resource controls whether characters modified by the meta modifier are
                      encoded  as  eight-bit  characters  when  passed  to the ttysw's pty or are
                      delivered as seven-bit characters.

       Resource:      ttysw.yieldModifiers
       Values:
                       Meta, Alt (The default is to not remove  any  semantic  meaning  from  any
                      modifiers)
       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 a ttysw
                      or termsw would be removed.

ENVIRONMENT

       $OPENWINHOME is the directory in which the server's directory hierarchy is installed.
       $DISPLAY is the name of the server and screen to which applications should display.
       $LD_LIBRARY_PATH is the SunOS shared library search path.
       $HELPPATH is the path that applications will search for Open Look Help files.

FILES

       $OPENWINHOME/include/images
                           XView images

       $OPENWINHOME/lib    XView Libraries

       $OPENWINHOME/include
                           Include files

       $OPENWINHOME/bin    Binaries

       $OPENWINHOME/share/src/xview/demos
                           XView demo programs

       $OPENWINHOME/share/src/xview/examples
                           XView example programs

SEE ALSO

       openwin(1), xnews(1), xlsfonts(1), xmodmap(1), iconedit(1)

                                         24 December 1991                                xview(7)