Provided by: x11-utils_7.7+5_amd64 bug

NAME

       viewres - graphical class browser for Xt

SYNOPSIS

       viewres [-option ...]

DESCRIPTION

       The  viewres  program  displays a tree showing the widget class hierarchy of the Athena Widget Set.  Each
       node in the tree can be expanded to show the resources that the corresponding class adds (i.e.  does  not
       inherit  from its parent) when a widget is created.  This application allows the user to visually examine
       the structure and inherited resources for the Athena Widget Set.

OPTIONS

       Viewres accepts all of the standard toolkit command line options as well as the following:

       -top name
               This option specifies the name of the highest widget  in  the  hierarchy  to  display.   This  is
               typically used to limit the display to a subset of the tree.  The default is Object.

       -variable
               This  option  indicates  that  the  widget variable names (as declared in header files) should be
               displayed in the nodes  rather  than  the  widget  class  name.   This  is  sometimes  useful  to
               distinguish widget classes that share the same name (such as Text).

       -vertical
               This option indicates that the tree should be displayed top to bottom rather left to right.

VIEW MENU

       The way in which the tree is displayed may be changed through the entries in the View menu:

       Show Variable Names
               This  entry  causes  the  node  labels  to  be  set  to  the  variable  names used to declare the
               corresponding widget class.  This operation may also be performed with the SetLabelType(variable)
               translation.

       Show Class Names
               This  entry  causes  the node labels to be set to the class names used when specifying resources.
               This operation may also be performed with the SetLabelType(class) translation.

       Layout Horizontal
               This entry causes the tree to be laid out from  left  to  right.   This  operation  may  also  be
               performed with the SetOrientation(West) translation.

       Layout Vertical
               This  entry  causes  the  tree  to  be  laid  out from top to bottom.  This operation may also be
               performed with the SetOrientation(North) translation.

       Show Resource Boxes
               This entry expands the selected nodes (see next section) to show the new  widget  and  constraint
               resources.  This operation may also be performed with the Resources(on) translation.

       Hide Resource Boxes
               This  entry  removes  the  resource displays from the selected nodes (usually to conserve space).
               This operation may also be performed with the Resources(off) translation.

SELECT MENU

       Resources for a single widget class can be displayed by clicking Button2 on the corresponding node, or by
       adding  the  node  to the selection list with Button1 and using the Show Resource Boxes entry in the View
       menu.  Since Button1 actually toggles the selection state of a node, clicking on  a  selected  node  will
       cause it to be removed from the selected list.

       Collections of nodes may also be selected through the various entries in the Select menu:

       Unselect All
               This  entry removes all nodes from the selection list.  This operation may also be performed with
               the Select(nothing) translation.

       Select All
               This entry adds all nodes to the selection list.  This operation may also be performed  with  the
               Select(all) translation.

       Invert All
               This  entry  adds unselected nodes to, and removes selected nodes from, the selection list.  This
               operation may also be performed with the Select(invert) translation.

       Select Parent
               This entry selects the immediate parents of all selected  nodes.   This  operation  may  also  be
               performed with the Select(parent) translation.

       Select Ancestors
               This  entry  recursively  selects  all parents of all selected nodes.  This operation may also be
               performed with the Select(ancestors) translation.

       Select Children
               This entry selects the immediate children of all selected nodes.   This  operation  may  also  be
               performed with the Select(children) translation.

       Select Descendants
               This  entry  recursively  selects all children of all selected nodes.  This operation may also be
               performed with the Select(descendants) translation.

       Select Has Resources
               This  entry  selects  all  nodes  that  add  new  resources  (regular  or  constraint)  to  their
               corresponding  widget  classes.   This operation may also be performed with the Select(resources)
               translation.

       Select Shown Resource Boxes
               This entry selects all nodes whose resource boxes are currently expanded (usually  so  that  they
               can  be  closed  with  Hide  Resource  Boxes).   This  operation  may  also be performed with the
               Select(shown) translation.

ACTIONS

       The following application actions are provided:

       Quit()
               This action causes viewres to exit.

       SetLabelType(type)
               This action sets the node labels to display the widget variable or class names, according to  the
               argument type.

       SetOrientation(direction)
               This  action  sets  the  root  of the tree to be one of the following areas of the window:  West,
               North, East, or South.

       Select(what)
               This action selects the  indicated  nodes,  as  described  in  the  VIEW  MENU  section:  nothing
               (unselects all nodes), invert, parent, ancestors, children, descendants, resources, shown.

       Resources(op)
               This action turns on, off, or toggles the resource boxes for the selected nodes.  If invoked from
               within one of the nodes (through the keyboard or pointer), only that node is used.

WIDGET HIERARCHY

       Resources may be specified for the following widgets:

       Viewres viewres
               Paned pane
                       Box buttonbox
                               Command quit
                               MenuButton view
                                       SimpleMenu viewMenu
                                               SmeBSB layoutHorizontal
                                               SmeBSB layoutVertical
                                               SmeLine line1
                                               SmeBSB namesVariable
                                               SmeBSB namesClass
                                               SmeLine line2
                                               SmeBSB viewResources
                                               SmeBSB viewNoResources
                               MenuButton select
                                       SimpleMenu selectMenu
                                               SmeBSB unselect
                                               SmeBSB selectAll
                                               SmeBSB selectInvert
                                               SmeLine line1
                                               SmeBSB selectParent
                                               SmeBSB selectAncestors
                                               SmeBSB selectChildren
                                               SmeBSB selectDescendants
                                               SmeLine line2
                                               SmeBSB selectHasResources
                                               SmeBSB selectShownResources
                       Form treeform
                               Porthole porthole
                                       Tree tree
                                               Box variable-name
                                                       Toggle variable-name
                                                       List variable-name
                               Panner panner

       where variable-name is the widget variable name of each node.

SEE ALSO

       X(7), xrdb(1), listres(1), editres(1), appres(1), appropriate widget documents

COPYRIGHT

       Copyright 1994 X Consortium
       See X(7) for a full statement of rights and permissions.

AUTHOR

       Jim Fulton, MIT X Consortium