NAME

listres − list resources in widgets. 

SYNTAX

listres [options] [widget...]

DESCRIPTION

The listres client generates a list of each specified widget’s resource database.  The list includes the class in which each resource is first defined, the instance and class name, and the type of each resource. 

If no widgets are specified (or the -all option is used), a two-column list of known widget names and their class hierarchies is printed.  In the MIT distribution, this includes the intrinsics-defined widget classes Core, Composite, Constraint, and Shell (and Shell’s six subclasses), plus the Athena widgets. 

Case is not significant when specifying the name of the widget or widgets whose resources are to be printed.  For example: % listres Core is equivalent to: % listres CORE

OPTIONS

listres accepts the following application-specific options:

−allIndicates that listres should print information for all known widgets and objects. 

-format printf_string
Specifies the printf-style format string to be used to print out the name, instance, class, and type of each resource. 

−nosuper
Specifies that resources inherited from a superclass should not be listed.  This is useful for determining which resources are new to a subclass.

-top name
Specifies the name of the widget to be treated as the top of the hierarchy.  Case is not significant, and the name may match either the class variable name or the class name.  The default is core. 

-treeSpecifies that all widgets and objects be listed in a tree. 

-variable
Indicates that widgets should be identified by the names of the class record variables rather than the class name given in the variable.  This is useful for distinguishing subclasses that have the same class name as their superclasses.

listres also recognizes all of the standard X Toolkit options (i.e., the program will run); however, since listres is not a window-based application, it does not use them. 

RESOURCES

resourceFormat (class ResourceFormat)
Specifies the printf-style format string to be used to print out the name, instance, class, and type of each resource. 

showSuper (class ShowSuper)
If false, resources inherited from a superclass are not listed. This is useful for determining which resources are new to a subclass. The default is true.

showTree (class ShowTree)
If true, specifies that all widgets and objects be listed in a tree. The default is false.

showVariable (class ShowVariable)
If true, widgets are identified by the names of the class record variables rather than the class name given in the variable.  This is useful for distinguishing subclasses that have the same class name as their superclasses.  The default is false.

topObject (class TopObject)
Specifies the name of the widget to be treated as the top of the hierarchy.  Case is not significant, and the name may match either the class variable name or the class name.  The default is core. 

SEE ALSO

X, xrdb, appres, editres; Chapter 11, Setting Resources; Appendix G, Athena Widget Resources; Volume Four, X Toolkit Intrinsics Programming Manual; Volume Five, X Toolkit Intrinsics Reference Manual. 

BUGS

On operating systems that do not support dynamic linking of run-time routines, this program must have all of its known widgets compiled in.  The sources provide several tools for automating this process for various widget sets. 

AUTHOR

Jim Fulton, MIT X Consortium.