Annotation of researchv9/X11/src/X.V11R1/clients/xwininfo/xwininfo.man, revision 1.1.1.1

1.1       root        1: .TH XWININFO 1 "1 July 1987" "X Version 11"
                      2: .SH NAME
                      3: xwininfo - X Window System window information summarizer.
                      4: .SH SYNOPSIS
                      5: .B "xwininfo"
                      6: [ -help ] [ -id \fIid\fP ] [ -root ] [ -name \fIname\fP ] [ -int ]
                      7: [ -tree ] [ -stats ]
                      8: [ -bits ] [ -events ] [ -size ] [ -wm  ] [ \fIhost\fP:\fIdisplay\fP ]
                      9: .SH DESCRIPTION
                     10: .PP
                     11: .I Xwininfo
                     12: is  a  utility  for  displaying  X  window information summaries.
                     13: Depending on what options are choosen, various information is displayed.
                     14: Refer to the various options for what information is available.
                     15: If no options are choosen, -stats is assumed.
                     16: .PP
                     17: The  user has the option of selecting the target window with
                     18: the mouse (by clicking any mouse button in the desired window)  or  by
                     19: specifying its window id on the command line with the \fB-id\fP argument.
                     20: In addition, if it is easier, instead of specifying
                     21: the window by its id number, the \fB-name\fP argument may be used to specify
                     22: which window is desired by name.
                     23: There is also a special \fB-root\fP argument to quickly obtain information
                     24: on X's root window.
                     25: .PP
                     26:   The following is a sample summary taken with
                     27: no arguments specified:
                     28: 
                     29: xwininfo ==> Please select the window you wish
                     30:          ==> information on by clicking the
                     31:          ==> mouse in that window.
                     32: 
                     33: xwininfo ==> Window id: 0x8006b (fred)
                     34: 
                     35:          ==> Upper left X: 0
                     36:          ==> Upper left Y: 0
                     37:          ==> Width: 1024
                     38:          ==> Height: 864
                     39:          ==> Depth: 1
                     40:          ==> Border width: 0
                     41:          ==> Window class: InputOutput
                     42:          ==> Window Map State: IsUnviewable
                     43: 
                     44: .SH ARGUMENT SUMMARY
                     45: .PP
                     46: .TP 8
                     47: .B "-help"
                     48: Print out the 'Usage:' command syntax summary.
                     49: .PP
                     50: .TP 8
                     51: .B "-id \fIid\fP"
                     52: This argument allows the user to specify a target  window  \fIid\fP  on  the
                     53: command  line rather than using the mouse to select the target window.
                     54: This is very useful in  debugging  X  applications  where  the  target
                     55: window is not mapped to the screen or where the use of the mouse might
                     56: be impossible or interfere with the application.
                     57: .PP
                     58: .TP 8
                     59: .B "-name \fIname\fP"
                     60: This argument allows the user to specify that the window named \fIname\fP
                     61: is the target window on the command line rather than using the mouse to
                     62: select the target window.
                     63: .PP
                     64: .TP 8
                     65: .B "-root"
                     66: This  argument  specifies  that  X's root window is the target window.
                     67: This is useful in situations  where  the  root  window  is  completely
                     68: obscured.
                     69: .PP
                     70: .TP 8
                     71: .B "-int"
                     72: This argument specifies that all X window ids should be  displayed  as
                     73: integer values.  The default is to display them as hexadecimal values.
                     74: .PP
                     75: .TP 8
                     76: .B -tree
                     77: This argument causes the root, parent, and children windows id's and name's of
                     78: the selected window to be displayed.
                     79: .PP
                     80: .TP 8
                     81: .B -stats
                     82: This argument causes various attributes of the selected window having
                     83: to do with its location and appearence to be displayed.
                     84: Information displayed includes the location of the window,
                     85: its width and height, its depth, border width, class, and map state.
                     86: .PP
                     87: .TP 8
                     88: .B -bits
                     89: This argument causes various attributes of the selected window having
                     90: to do with its raw bits and how it is to be stored to be displayed.
                     91: Information displayed includes the window's window and bit gravities,
                     92: the window's backing store hint and backing_planes value, its backing pixel,
                     93: and whether or not the window has save-under set.
                     94: .PP
                     95: .TP 8
                     96: .B -events
                     97: This argument causes the selected window's event masks to be displayed.
                     98: Both the event mask of events wanted by some client and the event mask of
                     99: events not to prograte are displayed.
                    100: .PP
                    101: .TP 8
                    102: .B -size
                    103: This argument causes the selected window's sizing hints to be displayed.
                    104: Information displayed includes for both the normal size hints and the
                    105: zoom size hints the user supplied location if any, the program supplied
                    106: location if any, the user supplied size if any, the program supplied size if
                    107: any, the minimum size if any, the maximum size if any, the resize increments
                    108: if any, and the minimum and maximum aspect ratios if any.
                    109: .PP
                    110: .TP 8
                    111: .B -wm
                    112: This argument causes the selected window's window manager hints to be
                    113: displayed.  Information displayed may include whether or not the application
                    114: accepts input, what the window's icon window # and name is, where the window's
                    115: icon should go, and what the window's initial state should be.
                    116: .PP
                    117: .TP 8
                    118: .B "\fIhost\fP:\fIdisplay\fP"
                    119: This  argument  allow  you  to  specify the host and display number on
                    120: which to find the target window.  For example `xwininfo orpheus:1'
                    121: would specify that the target window is on display `1' on the machine
                    122: `orpheus'.  By default,
                    123: .I xwininfo
                    124: uses  the  host  and display number stored in the environment variable
                    125: DISPLAY, and therefore this argument is not normally specified.
                    126: .SH ENVIRONMENT
                    127: .PP
                    128: .TP 8
                    129: .B DISPLAY
                    130: To get default host and display number.
                    131: .SH SEE ALSO
                    132: X(1)
                    133: .SH AUTHOR
                    134: Mark Lillibridge, MIT Project Athena
                    135: .br
                    136: Copyright 1987, Massachusetts Institute of Technology.
                    137: 

unix.superglobalmegacorp.com

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