Annotation of 43BSD/contrib/X/man/xwininfo.1, revision 1.1.1.1

1.1       root        1: .TH XWININFO 1 "27 July 1985" "X Version 10"
                      2: .SH NAME
                      3: xwininfo - X Window System, window information summarizer.
                      4: .SH SYNOPSIS
                      5: .B "xwininfo"
                      6: [ -children ] [ -help ] [ -id \fIid\fP ] [ -int ] [ -root ] [ \fIhost\fP:\fIdisplay\fP ]
                      7: .SH DESCRIPTION
                      8: .PP
                      9: .I Xwininfo
                     10: is  a  utility  for  displaying  X  window information summaries.  All
                     11: pertinent window  information  is  displayed  in  an  easily  readable
                     12: format.   The  user has the option of selecting the target window with
                     13: the mouse (by clicking any mouse button in the desired window)  or  by
                     14: specifying its' window id on the command line with the \fB-id\fP argument.
                     15: There is also a special \fB-root\fP argument to quickly obtain information
                     16: on X's root window.  The following is a sample summary taken with
                     17: the \fB-children\fP argument specified.
                     18: 
                     19: xwininfo ==> Please select the window you wish
                     20:          ==> information on by clicking the
                     21:          ==> mouse in that window.
                     22: 
                     23: xwininfo ==> Window name: ' X Root Window '
                     24:          ==> Window id: 0x10031
                     25:          ==> Parent window id: 0x0
                     26:          ==> Number of children: 13
                     27:          ====> Child window id: 0xb00046
                     28:          ====> Child window id: 0xb2004f
                     29:          ====> Child window id: 0x630051
                     30:          ====> Child window id: 0x5f0055
                     31:          ====> Child window id: 0x5c0058
                     32:          ====> Child window id: 0x55005c
                     33:          ====> Child window id: 0x53005e
                     34:          ====> Child window id: 0x510060
                     35:          ====> Child window id: 0x42000c
                     36:          ====> Child window id: 0x43000b
                     37:          ====> Child window id: 0x3d0011
                     38:          ====> Child window id: 0xa0028
                     39:          ====> Child window id: 0x500061
                     40:          ==> Associated window id: 0x0
                     41:          ==> Window type: IsOpaque
                     42:          ==> Window state: IsMapped
                     43:          ==> Upper left X: 0
                     44:          ==> Upper left Y: 0
                     45:          ==> Width: 1088
                     46:          ==> Height: 864
                     47:          ==> Border width: 0
                     48:          ==> Resize base width: 0
                     49:          ==> Resize base height: 0
                     50:          ==> Resize width increment: 1
                     51:          ==> Resize height increment: 1
                     52:          ==> Root absolute mouse X Position: 691
                     53:          ==> Root absolute mouse Y Position: 261
                     54:          ==> Target relative mouse X Position: 691
                     55:          ==> Target relative mouse Y Position: 261
                     56: 
                     57: .SH ARGUMENT SUMMARY
                     58: .PP
                     59: .TP 8
                     60: .B "-children"
                     61: This  argument  specifies that
                     62: .I xwininfo
                     63: should list the window ids' of
                     64: target  window's  children.   Only  the  first  level  of  the  window
                     65: hierarchy is shown (i.e., immediate children of the target window).
                     66: .PP
                     67: .TP 8
                     68: .B "-help"
                     69: Print out the 'Usage:' command syntax summary.
                     70: .PP
                     71: .TP 8
                     72: .B "-id \fIid\fP"
                     73: This argument allows the user to specify a target  window  \fIid\fP  on  the
                     74: command  line rather than using the mouse to select the target window.
                     75: This is very useful in  debugging  X  applications  where  the  target
                     76: window is not mapped to the screen or where the use of the mouse might
                     77: be impossible or interfere with the application.
                     78: .PP
                     79: .TP 8
                     80: .B "-int"
                     81: This argument specifies that all X window ids should be  displayed  as
                     82: integer values.  The default is to display them as hexadecimal values.
                     83: .PP
                     84: .TP 8
                     85: .B "-root"
                     86: This  argument  specifies  that  X's root window is the target window.
                     87: This is useful in situations  where  the  root  window  is  completely
                     88: obscured.
                     89: .PP
                     90: .TP 8
                     91: .B "\fIhost\fP:\fIdisplay\fP"
                     92: This  argument  allow  you  to  specify the host and display number on
                     93: which to find the target window.  For example `xwininfo orpheus:1'
                     94: would specify that the target window is on display `1' on the machine
                     95: `orpheus'.  By default,
                     96: .I xwininfo
                     97: uses  the  host  and display number stored in the environment variable
                     98: DISPLAY, and therefore this argument is not normally specified.
                     99: .SH ENVIRONMENT
                    100: .PP
                    101: .TP 8
                    102: .B DISPLAY
                    103: To get default host and display number.
                    104: .SH SEE ALSO
                    105: X(1)
                    106: .SH FUTURE PLANS
                    107: If time ever presents itself...
                    108: .PP
                    109: .TP 8
                    110: .B 1.
                    111: Provide a `-geometry' argument that prints out the window's dimensions
                    112: in X window geometry format (i.e., =WxH+X+Y)
                    113: .PP
                    114: .TP 8
                    115: .B 2.
                    116: Provide a `-depth' argument that allows  recursive  traversal  of  the
                    117: window hierarchy to some arbitrary depth.
                    118: .SH AUTHOR
                    119: .PP
                    120: Copyright 1985, Massachusetts Institute of Technology.
                    121: .PP
                    122: Tony Della Fera, Digital Equipment Corp., MIT Project Athena

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.