home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / doc / CLX / s02.doc < prev    next >
Encoding:
Interleaf document  |  1989-10-18  |  39.3 KB  |  1,336 lines
  1. <!OPS, Version = 5.2>
  2.  
  3. <!Document,
  4.     Print Rev Bars =    no,
  5.     Final Output Device =    "ps",
  6.     Default Printer =    "nearest-adps">
  7.  
  8. <!Font Definitions,
  9.     F2 = Times 10 Italic,
  10.     F3 = Times 10,
  11.     F4 = Times 8 Italic,
  12.     F5 = Times 18 Bold,
  13.     F6 = Times 10 Bold,
  14.     F7 = Times 12 Bold,
  15.     F8 = Symbol_B 8,
  16.     F9 = Courier 8>
  17.  
  18. <!Page,
  19.     Bottom Margin =        1 inches,
  20.     Left Margin =        1 inches,
  21.     Right Margin =        1.15 inches,
  22.     First Page =        Right,
  23.     Starting Page # =     Inherit,
  24.     Page # Prefix =        "2<#1e>",
  25.     Hyphenation =        on,
  26.     Consecutive Hyphens =    2,
  27.     Vert. Just. =        off>
  28.  
  29. <!Autonumber Stream, List, 2,
  30.     Level 2 Suffix =    ,
  31.     Level 2 Starting Value = 0,
  32.     Level 2 Show =        no>
  33.  
  34. <!Autonumber Stream, Outline, 3,
  35.     Level 1 Symbol Type =    UPPER ROMAN,
  36.     Level 2 Symbol Type =    UPPER ALPHA>
  37.  
  38. <!Autonumber Stream, figure, 2,
  39.     Level 1 Prefix =    "Figure ",
  40.     Level 1 Suffix =    "<#1e>",
  41.     Level 1 Show =        no,
  42.     Level 2 Suffix =    ,
  43.     Level 2 Starting Value = 0,
  44.     Level 2 Show =        no>
  45.  
  46. <!Autonumber Stream, figurelet, 2,
  47.     Level 1 Symbol Type =    UPPER ALPHA,
  48.     Level 1 Prefix =    "Figure ",
  49.     Level 1 Suffix =    "<#1e>",
  50.     Level 1 Show =        no,
  51.     Level 2 Suffix =    "<#04>">
  52.  
  53. <!Autonumber Stream, invisible, 1,
  54.     Level 1 Suffix =    ,
  55.     Level 1 Show =        no>
  56.  
  57. <!Autonumber Stream, item, 2,
  58.     Level 2 Symbol Type =    LOWER ALPHA,
  59.     Level 2 Trail =        yes>
  60.  
  61. <!Autonumber Stream, paralet, 4,
  62.     Level 1 Symbol Type =    UPPER ALPHA,
  63.     Level 1 Suffix =    ,
  64.     Level 1 Show =        no,
  65.     Level 2 Prefix =    .,
  66.     Level 2 Suffix =    ,
  67.     Level 3 Prefix =    .,
  68.     Level 3 Suffix =    ,
  69.     Level 4 Prefix =    .,
  70.     Level 4 Suffix =    >
  71.  
  72. <!Autonumber Stream, paranum, 4,
  73.     Level 1 Suffix =    ,
  74.     Level 1 Show =        no,
  75.     Level 2 Prefix =    .,
  76.     Level 2 Suffix =    ,
  77.     Level 3 Prefix =    .,
  78.     Level 3 Suffix =    ,
  79.     Level 4 Prefix =    .,
  80.     Level 4 Suffix =    >
  81.  
  82. <!Autonumber Stream, table, 2,
  83.     Level 1 Prefix =    "Table ",
  84.     Level 1 Suffix =    "<#1e>",
  85.     Level 1 Show =        no,
  86.     Level 2 Suffix =    >
  87.  
  88. <!Autonumber Stream, tablelet, 2,
  89.     Level 1 Symbol Type =    UPPER ALPHA,
  90.     Level 1 Prefix =    "Table ",
  91.     Level 1 Suffix =    "<#1e>",
  92.     Level 1 Show =        no,
  93.     Level 2 Suffix =    "<#04>">
  94.  
  95. <!Class, arg,
  96.     Bottom Margin =        0.08 inches,
  97.     Left Margin =        1.85 inches,
  98.     First Indent =        -0.25 inches,
  99.     Line Spacing =        1.121 lines,
  100.     Font =            F2,
  101.     Left Tab =        -0.25/0 inches>
  102.  
  103. <!Class, bullet,
  104.     Bottom Margin =        0.153 inches,
  105.     Left Margin =        1.85 inches,
  106.     First Indent =        -0.25 inches,
  107.     Line Spacing =        1.121 lines,
  108.     Font =            F3,
  109.     Allow Page Break Within = no,
  110.     Left Tab =        -0.50/0 inches>
  111.  
  112. <!Class, caption,
  113.     Top Margin =        0.07 inches,
  114.     Bottom Margin =        0.07 inches,
  115.     Line Spacing =        1.100 lines,
  116.     Font =            F4>
  117.  
  118. <!Class, cardlist,
  119.     Bottom Margin =        0.153 inches,
  120.     Left Margin =        1.60 inches,
  121.     Line Spacing =        1.121 lines,
  122.     Alignment =        Left,
  123.     Font =            F3,
  124.     Left Tab =        0/1.50/2.25/3.75/5.25/6 inches>
  125.  
  126. <!Class, fig,
  127.     Top Margin =        0.07 inches,
  128.     Bottom Margin =        0.07 inches,
  129.     Line Spacing =        1.100 lines,
  130.     Alignment =        Left,
  131.     Font =            F5>
  132.  
  133. <!Class, keyword2,
  134.     Bottom Margin =        0.153 inches,
  135.     Left Margin =        1.85 inches,
  136.     First Indent =        -0.25 inches,
  137.     Line Spacing =        1.121 lines,
  138.     Font =            F6,
  139.     Left Tab =        -0.50/0 inches>
  140.  
  141. <!Class, p1para,
  142.     Bottom Margin =        0.153 inches,
  143.     Left Margin =        1.60 inches,
  144.     First Indent =        -1.60 inches,
  145.     Line Spacing =        1.121 lines,
  146.     Alignment =        Left,
  147.     Font =            F7,
  148.     Allow Page Break Within = no,
  149.     Allow Page Break After = no,
  150.     Left Tab =        -1.70/0 inches>
  151.  
  152. <!Class, p1rule,
  153.     Bottom Margin =        0 inches,
  154.     Line Spacing =        1 lines,
  155.     Font =            F3,
  156.     Hyphenation =        off,
  157.     Allow Page Break After = no,
  158.     Left Tab =        0/0.75*13 inches>
  159.  
  160. <!Class, p1stacked,
  161.     Bottom Margin =        0 inches,
  162.     Left Margin =        1.60 inches,
  163.     First Indent =        -1.60 inches,
  164.     Line Spacing =        1 lines,
  165.     Font =            F6,
  166.     Allow Page Break Within = no,
  167.     Allow Page Break After = no,
  168.     Left Tab =        -1.60/-0.17/0 inches>
  169.  
  170. <!Class, para,
  171.     Bottom Margin =        0.153 inches,
  172.     Left Margin =        1.60 inches,
  173.     Line Spacing =        1.121 lines,
  174.     Font =            F3,
  175.     Allow Page Break Within = no,
  176.     Left Tab =        0/0.75*13 inches>
  177.  
  178. <!Class, return,
  179.     Bottom Margin =        0.077 inches,
  180.     Left Margin =        1.60 inches,
  181.     First Indent =        -0.90 inches,
  182.     Line Spacing =        1.121 lines,
  183.     Alignment =        Left,
  184.     Font =            F6,
  185.     Hyphenation =        off,
  186.     Allow Page Break Within = no,
  187.     Allow Page Break After = no,
  188.     Left Tab =        -0.90/0 inches,
  189.     Right Tab =        7.50 inches>
  190.  
  191. <!Class, return0,
  192.     Bottom Margin =        0 inches,
  193.     Left Margin =        1.60 inches,
  194.     First Indent =        -0.90 inches,
  195.     Line Spacing =        1.121 lines,
  196.     Alignment =        Left,
  197.     Font =            F6,
  198.     Hyphenation =        off,
  199.     Allow Page Break Within = no,
  200.     Allow Page Break After = no,
  201.     Left Tab =        -0.90/0 inches,
  202.     Right Tab =        7.50 inches>
  203.  
  204. <!Class, secno,
  205.     Top Margin =        0.07 inches,
  206.     Bottom Margin =        0.07 inches,
  207.     Line Spacing =        1.100 lines,
  208.     Alignment =        Left,
  209.     Font =            F5,
  210.     Autonumber Name =    paranum>
  211.  
  212. <!Class, secrule,
  213.     Bottom Margin =        0 inches,
  214.     Line Spacing =        1 lines,
  215.     Font =            F3,
  216.     Hyphenation =        off,
  217.     Allow Page Break After = no,
  218.     Left Tab =        0/0.75*13 inches,
  219.     Autonumber Name =    table>
  220.  
  221. <!Class, sectitle,
  222.     Bottom Margin =        0 inches,
  223.     Line Spacing =        1 lines,
  224.     Alignment =        Right,
  225.     Font =            F5,
  226.     Hyphenation =        off,
  227.     New Page =        yes,
  228.     Left Tab =        0/0.75*13 inches>
  229.  
  230. <!Class, syntax,
  231.     Bottom Margin =        0.077 inches,
  232.     Left Margin =        1.60 inches,
  233.     First Indent =        -0.90 inches,
  234.     Line Spacing =        1.121 lines,
  235.     Alignment =        Left,
  236.     Font =            F6,
  237.     Hyphenation =        off,
  238.     Allow Page Break Within = no,
  239.     Allow Page Break After = no,
  240.     Left Tab =        -0.90/0 inches,
  241.     Right Tab =        8 inches>
  242.  
  243. <!Class, syntax0,
  244.     Bottom Margin =        0 inches,
  245.     Left Margin =        1.60 inches,
  246.     First Indent =        -0.90 inches,
  247.     Line Spacing =        1.121 lines,
  248.     Alignment =        Left,
  249.     Font =            F6,
  250.     Hyphenation =        off,
  251.     Allow Page Break Within = no,
  252.     Allow Page Break After = no,
  253.     Left Tab =        -0.90/0 inches,
  254.     Right Tab =        8 inches>
  255.  
  256. <!Class, "table",
  257.     Top Margin =        0.07 inches,
  258.     Bottom Margin =        0.07 inches,
  259.     Line Spacing =        1.100 lines,
  260.     Font =            F6,
  261.     Autonumber Name =    table>
  262.  
  263. <!Class, title,
  264.     Top Margin =        0.07 inches,
  265.     Bottom Margin =        0.07 inches,
  266.     Line Spacing =        1.100 lines,
  267.     Alignment =        Right,
  268.     Font =            F5,
  269.     TOC Doc Name =        TOC>
  270.  
  271. <!Master Frame,
  272.     Name =            "At Anchor",
  273.     Placement =        At Anchor,
  274.     Width =            0.41 inches,
  275.     Height =        0.137 inches,
  276.     Vertical Alignment =    0.03 inches,
  277.     Diagram =
  278. V4,
  279. (g9,32767,0
  280.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066
  281.   667,6))>
  282.  
  283. <!Master Frame,
  284.     Name =            p1rule,
  285.     Placement =        At Anchor,
  286.     Width =            6.35 inches,
  287.     Height =        0.153 inches,
  288.     Vertical Alignment =    0.007 inches,
  289.     Shared Contents =    yes,
  290.     Diagram =
  291. V4,
  292. (g9,1,0
  293.  (v4,1,0,0.006667,0.066723,6.326667,0.066611,17,2,0)
  294.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,0,1,1,0.066667,0.066667,6,6,0,0.066
  295.   667,6))>
  296.  
  297. <First Page Header, Frame =
  298. V4,
  299. (g9,0,0
  300.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,1,1,1,1,0.066667,0.066667,6,6,0,0.066
  301.   667,6))>
  302.  
  303. <Right Page Header, Frame =
  304. V4,
  305. (g9,1,0
  306.  (T8,1,12,5.866667,0.293333,0.466667,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048
  307.   ,512,102,1101,2,
  308. <caption>
  309.  
  310. Displays
  311.  
  312. <End Text>)
  313.  (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,0,1,0,1,0.066667,0.066667,6,6,0,0.066
  314.   667,6))>
  315.  
  316. <Left Page Header, Frame =
  317. V4,
  318. (g9,1,0
  319.  (T8,1,12,0,0.333333,0.933333,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10
  320.   2,1101,2,
  321. <caption>
  322.  
  323. Displays
  324.  
  325. <End Text>)
  326.  (E10,0,0,0,1,1,0.053333,1,15,0,0,2,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066
  327.   667,6))>
  328.  
  329. <Right Page Footer, Frame =
  330. V4,
  331. (g9,1,0
  332.  (t8,1,4,6.333333,0.266667,2,17,@nntimsps10b,\240)
  333.  (t8,2,4,0.006667,0.266667,0,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  334.  (v4,3,0,0,0.066667,6.333333,0.066554,17,2,0)
  335.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066
  336.   667,6))>
  337.  
  338. <Left Page Footer, Frame =
  339. V4,
  340. (g9,1,0
  341.  (t8,1,4,0,0.266667,0,17,@nntimsps10b,\240)
  342.  (t8,2,4,6.333333,0.266667,2,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  343.  (v4,3,0,0.026667,0.066667,6.333333,0.066554,17,2,0)
  344.  (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,0,1,0,1,0.066667,0.066667,6,6,0,0.066
  345.   667,6))>
  346.  
  347. <sectitle,
  348.     Allow Page Break Within = no,
  349.     Allow Page Break After = no>
  350.  
  351. <|,"2<#1e>23">
  352. <Frame,
  353.     Name =            "At Anchor",
  354.     Placement =        At Anchor,
  355.     Width =            4.72 inches,
  356.     Height =        0.94 inches,
  357.     Vertical Alignment =    0.03 inches,
  358.     Diagram =
  359. V4,
  360. (g9,1,0
  361.  (T8,1,12,0.133333,0.72,4.563333,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512
  362.   ,102,1101,3,
  363. <title>
  364.  
  365. DISPLAYS<HR>
  366.  
  367. <End Text>)
  368.  (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,0,1,0,1,0.066667,0.066667,6,6,0,0.066
  369.   667,6))>
  370. <Frame,
  371.     Name =            "At Anchor",
  372.     Placement =        At Anchor,
  373.     Width =            1.626 inches,
  374.     Height =        0.938 inches,
  375.     Vertical Alignment =    0 inches,
  376.     Diagram =
  377. V4,
  378. (g9,1,0
  379.  (T8,1,12,0.066667,0.276667,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10
  380.   2,1101,3,
  381. <secno,
  382.     TOC Doc Name =        TOC>
  383.  
  384. <Autonum, paranum, 1, First = Yes>
  385.  
  386. <End Text>)
  387.  (T8,2,12,0.026667,0.733333,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10
  388.   2,1101,3,
  389. <"table">
  390.  
  391. <Autonum, table, 1, First = Yes>
  392.  
  393. <End Text>)
  394.  (T8,3,12,0.066667,0.6,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,102,110
  395.   1,3,
  396. <fig,
  397.     Alignment =        Both,
  398.     Font =            F6,
  399.     Autonumber Name =    figure>
  400.  
  401. <Autonum, figure, 1, First = Yes>
  402.  
  403. <End Text>)
  404.  (g9,5,0
  405.    (p7,5,8,19
  406.      (g9,5,0
  407.        (g9,5,0
  408.          (v4,5,0,0.266667,0,1.6,0,17,1,0)
  409.          (v4,6,0,1.6,0,1.6,0.933333,17,1,0)
  410.          (v4,7,0,1.6,0.933333,0.266667,0.933333,17,1,0)
  411.          (v4,8,0,0.266667,0.933333,0.266667,0,17,1,0))))
  412.    (g9,10,8
  413.      (p7,10,1032,13
  414.        (g9,10,0
  415.          (g9,10,0
  416.            (v4,10,0,1.461755,0.934813,1.461755,0.784691,17,1,0)
  417.            (v4,11,0,1.461755,0.784691,1.124914,0.784691,17,1,0)
  418.            (v4,12,0,1.124914,0.784691,1.461755,0.50321,17,1,0)
  419.            (v4,13,0,1.461755,0.50321,1.461755,0.259256,17,1,0)
  420.            (v4,14,0,1.461755,0.259256,1.327019,0.146667,17,1,0)
  421.            (v4,15,0,1.327019,0.146667,1.012632,0.146667,17,1,0)
  422.            (v4,16,0,1.012632,0.146667,0.877895,0.259256,17,1,0)
  423.            (v4,17,0,0.877895,0.259256,0.877895,0.371848,17,1,0)
  424.            (v4,18,0,0.877895,0.371848,1.08,0.371848,17,1,0)
  425.            (v4,19,0,1.08,0.371848,1.08,0.296789,17,1,0)
  426.            (v4,20,0,1.08,0.296789,1.25965,0.296789,17,1,0)
  427.            (v4,21,0,1.25965,0.296789,1.25965,0.465676,17,1,0)
  428.            (v4,22,0,1.25965,0.465676,0.877895,0.784691,17,1,0)
  429.            (v4,23,0,0.877895,0.784691,0.877895,0.934813,17,1,0)
  430.            (v4,24,0,0.877895,0.934813,1.461755,0.934813,17,1,0))))
  431.      (g9,25,2048
  432.        (v4,25,33,0.85544,1.159997,0.85544,1.159997,17,0,0)
  433.        (v4,26,33,0.85544,0.146667,0.85544,0.146667,17,0,0)
  434.        (v4,27,33,1.506667,0.146667,1.506667,0.146667,17,0,0)
  435.        (v4,28,33,1.506667,1.159997,1.506667,1.159997,17,0,0))))
  436.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066
  437.   667,6))>
  438.  
  439. <secrule,
  440.     Allow Page Break Within = no,
  441.     Allow Page Break After = yes,
  442.     Autonumber Name =    >
  443.  
  444. <Index, "display", To Named = sectitle>
  445. <Frame,
  446.     Name =            "At Anchor",
  447.     Placement =        At Anchor,
  448.     Width =            6.35 inches,
  449.     Height =        0.153 inches,
  450.     Vertical Alignment =    0.007 inches,
  451.     Diagram =
  452. V4,
  453. (g9,1,0
  454.  (v4,1,0,0.006667,0.066723,6.333333,0.066611,17,2,0)
  455.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,0,1,1,0.066667,0.066667,6,6,0,0.066
  456.   667,6))>
  457.  
  458. <p1para,
  459.     Alignment =        Both,
  460.     Font =            F3,
  461.     Allow Page Break After = yes>
  462.  
  463. <F7>Introduction<Tab><F6>2.1<F0><#04>A particular X server, together 
  464. with its screens and input devices, is called a <F2>display<F0>. 
  465. The CLX <F6>display<F0> object contains all the information about 
  466. the particular display and its screens, as well as the state that 
  467. is needed to communicate with the display over a particular connection.<F6><#04>
  468.  
  469. <para>
  470.  
  471. Before your program can use a display, you must establish a connection 
  472. to the X server driving your display. Once you have established a 
  473. connection, you then can use the CLX macros and functions discussed 
  474. in this section to return information about the display. This section 
  475. discusses how to: 
  476.  
  477. <bullet>
  478.  
  479. <F8>w<Tab><F0>Open (connect) a display 
  480.  
  481. <F8>w<Tab><F0>Obtain information about a display 
  482.  
  483. <F8>w<Tab><F0>Access and change display attributes 
  484.  
  485. <F8>w<Tab><F0>Close (disconnect) a display 
  486.  
  487. <p1rule>
  488.  
  489. <Index, "display", "opening", To Named = p1rule>
  490. <Frame,
  491.     Name =            p1rule,
  492.     Placement =        At Anchor,
  493.     Width =            6.35 inches,
  494.     Height =        0.153 inches,
  495.     Vertical Alignment =    0.007 inches,
  496.     Shared Contents =    yes>
  497.  
  498. <p1stacked,
  499.     Font =            F3,
  500.     Left Tab =        -1.70/0 inches>
  501.  
  502. <F7>Opening the<Tab><F6>2.2<F0><#04>The <F6>open<#1e>display<F0> 
  503. function is used to open a connection to an X server.
  504.  
  505. <p1para,
  506.     Alignment =        Both,
  507.     Font =            F3,
  508.     Allow Page Break After = yes>
  509.  
  510. <F7>Display<Tab><F0> 
  511.  
  512. <syntax0>
  513.  
  514. open<#1e>display <F2>host &<F3>key <F0>:display<F3> <F0>:protocol<Tab>
  515. <F3>Function<Index, Doc = operations, "xlib:open<#1e>display", Sort String = "open<#1e>display">
  516.  
  517. <return>
  518.  
  519. <Tab><F3>Returns: <F2><HR>
  520.   display <F3><#1f> Type <F0>display<F3>. 
  521.  
  522. <para>
  523.  
  524. Returns a <F6>display<F0> that serves as the connection to the X 
  525. server and contains all the information about that X server. 
  526.  
  527. <arg>
  528.  
  529. host <#1f> <F3>Specifies the name of the <F0>host<F3> machine on 
  530. which the server executes. A string must be acceptable as a <F0>host<F3>, 
  531. but otherwise the possible types are not constrained and will likely 
  532. be very system dependent. 
  533.  
  534. <keyword2>
  535.  
  536. :display<F3> <#1f> An integer that specifies which display device 
  537. on the <F2>host<F3> should be used for this connection. This is 
  538. needed since multiple displays can be controlled by a single X server. 
  539. The default is display 0 (zero). 
  540.  
  541. :protocol <F3><#1f><F0> <F3>A keyword argument that specifies which 
  542. network protocol should be used for connecting to the server (for 
  543. example, <F0>:tcp<F3>, <F0>:dna<F3>, or <F0>:chaos<F3>). The 
  544. set of possible values and the default value are implementation specific. 
  545.  
  546. <para>
  547.  
  548. Authorization, if any, is assumed to come from the environment. After 
  549. a successful call to <F6>open<#1e>display<F0>, all screens on the 
  550. display can be used by the client application. 
  551.  
  552. <p1rule,
  553.     New Page =        yes>
  554.  
  555. <|,"2<#1e>24"><Index, "display", "attributes", To Named = p1rule>
  556. <Frame,
  557.     Name =            p1rule,
  558.     Placement =        At Anchor,
  559.     Width =            6.35 inches,
  560.     Height =        0.153 inches,
  561.     Vertical Alignment =    0.007 inches,
  562.     Shared Contents =    yes>
  563.  
  564. <p1stacked,
  565.     Font =            F3,
  566.     Left Tab =        -1.70/0 inches>
  567.  
  568. <F7>Display <Tab><F6>2.3<F0><#04>The complete set of display attributes 
  569. is discussed in the following<F6><FJ>
  570.  
  571. <p1para,
  572.     Alignment =        Both,
  573.     Font =            F3,
  574.     Allow Page Break After = yes>
  575.  
  576. <F7>Attributes<Tab><F0>paragraphs.
  577.  
  578. <syntax0>
  579.  
  580. display<#1e>authorization<#1e>data<F3> <F2>display<F0><Tab><F3>Function
  581. <F0><Index, "authorization", "data of display"><Index, "display", "authorization", "data"><Index, Doc = operations, "xlib:display<#1e>authorization<#1e>data", Sort String = "display<#1e>authorization<#1e>data">
  582.  
  583. <return>
  584.  
  585. <Tab><F3>Returns: <F2><HR>
  586.   authorization<#1e>data <F3><#1f> Type <F0>string<F3>. 
  587.  
  588. <para>
  589.  
  590. Returns the authorization data string for <F2>display<F0> that was 
  591. transmitted to the server by <F6>open<#1e>display<F0> during connection 
  592. setup. The data is specific to the particular authorization protocol 
  593. that was used. The <F6>display<#1e>authorization<#1e>name<F0> function 
  594. returns the protocol used. 
  595.  
  596. <arg>
  597.  
  598. display <#1f> <F3>A <F6>display<F3> object.
  599.  
  600. <syntax0>
  601.  
  602. display<#1e>authorization<#1e>name<F3> <F2>display<F0><Tab><F3>Function
  603. <F0><Index, "authorization", "name of display"><Index, "display", "authorization", "name"><Index, Doc = operations, "xlib:display<#1e>authorization<#1e>name", Sort String = "display<#1e>authorization<#1e>name">
  604.  
  605. <return>
  606.  
  607. <Tab><F3>Returns: <F2><HR>
  608.   authorization<#1e>name <F3><#1f> Type <F0>string<F3>. 
  609.  
  610. <para>
  611.  
  612. Returns the authorization protocol namestring for <F2>display<F0> 
  613. that was transmitted by <F6>open<#1e>display<F0> to the server during 
  614. connection setup. The <F2>authorization<#1e>name<F0> indicates what 
  615. authorization protocol the client expects the server to use. Specification 
  616. of valid authorization mechanisms is not part of the X protocol. A 
  617. server that implements a different protocol than the client expects, 
  618. or a server that only implements the host<#1e>based mechanism, can 
  619. simply ignore this information. If both name and data strings are 
  620. empty, this is to be interpreted as <#7f>no explicit authorization."
  621.  
  622. <arg>
  623.  
  624. display <#1f> <F3>A <F6>display<F3> object. 
  625.  
  626. <syntax0>
  627.  
  628. display<#1e>bitmap<#1e>format<F9> <F2>display<F0><Tab><F3>Function<F0><Index, "bitmap", "format of display"><Index, "display", "bitmap format"><Index, Doc = operations, "xlib:display<#1e>bitmap<#1e>format", Sort String = "display<#1e>bitmap<#1e>format">
  629.  
  630. <return>
  631.  
  632. <Tab><F3>Returns: <F2><HR>
  633.   bitmap<#1e>format <F3><#1f> Type <F0>bitmap<#1e>format<F3>. 
  634.  
  635. <para>
  636.  
  637. Returns the <F2>bitmap<#1e>format<F0> information for the specified <F2>disp
  638. lay<F0>.
  639.  
  640. <arg>
  641.  
  642. display <#1f> <F3>A <F6>display<F3> object.
  643.  
  644. <syntax0>
  645.  
  646. display<#1e>byte<#1e>order<F3> <F2>display<F0><Tab><F3>Function<F0><Index, "byte order of display"><Index, "display", "byte order"><Index, Doc = operations, "xlib:display<#1e>byte<#1e>order", Sort String = "display<#1e>byte<#1e>order">
  647.  
  648. <return>
  649.  
  650. <Tab><F3>Returns: <F2><HR>
  651.   byte<#1e>order <F3><#1f> Either <F0>:lsbfirst<F3> or <F0>:msbfirst<F3>. 
  652.  
  653. <para>
  654.  
  655. Returns the <F2>byte<#1e>order<F0> to be employed in communication 
  656. with the server for the given <F2>display<F0>. The possible values 
  657. are as follows: 
  658.  
  659. <bullet>
  660.  
  661. <F8>w<Tab><F6>:lsbfirst<F0> <#1f> Values are transmitted least 
  662. significant byte first.
  663.  
  664. <F8>w<Tab><F6>:msbfirst<F0> <#1f> Values are transmitted most significant 
  665. byte first.
  666.  
  667. <para>
  668.  
  669. Except where explicitly noted in the protocol, all 16<#1e>bit and 
  670. 32<#1e>bit quantities sent by the client must be transmitted with 
  671. this <F2>byte<#1e>order<F0>, and all 16<#1e>bit and 32<#1e>bit quantities 
  672. returned by the server are transmitted with this <F2>byte<#1e>order<F0>. 
  673.  
  674. <arg>
  675.  
  676. display <#1f> <F3>A <F6>display<F3> object. 
  677.  
  678. <syntax0>
  679.  
  680. display<#1e>display<F3> <F2>display<F0><Tab><F3>Function<F0><Index, "number of display"><Index, "display", "number"><Index, Doc = operations, "xlib:display<#1e>display", Sort String = "display<#1e>display">
  681.  
  682. <return>
  683.  
  684. <Tab><F3>Returns: <F2><HR>
  685.   display<#1e>number <F3><#1f> Type <F0>integer<F3>. 
  686.  
  687. <para>
  688.  
  689. Returns the <F2>display<#1e>number<F0> for the host associated with <F2>disp
  690. lay<F0>. 
  691.  
  692. <arg>
  693.  
  694. display <#1f> <F3>A <F6>display<F3> object. 
  695.  
  696. <syntax0>
  697.  
  698. <|,"2<#1e>25">display<#1e>error<#1e>handler<F3> <F2>display<F0><Tab><F3>Function
  699. <F0><Index, "error handler of display"><Index, "display", "error handler"><Index, Doc = operations, "xlib:display<#1e>error<#1e>handler", Sort String = "display<#1e>error<#1e>handler">
  700.  
  701. <return0,
  702.     Bottom Margin =        0.08 inches>
  703.  
  704. <Tab><F3>Returns: <F2><HR>
  705.   error<#1e>handler <F3><#1f> Type <F0>function<F3> or <F0>sequence<F3>. 
  706.  
  707. <para>
  708.  
  709. Returns and (with <F6>setf<F0>) sets the <F2>error<#1e>handler<F0> 
  710. function for the given <F2>display<F0>. CLX calls (one of) the display 
  711. error handler functions to handle server errors returned to the connection. 
  712. The default error handler, <F6>default<#1e>error<#1e>handler<F0>, 
  713. signals conditions as they occur. See Section 16, Errors, for a list 
  714. of the conditions that CLX can signal. For more information about 
  715. errors and error handling, refer to the section entitled Common Lisp 
  716. Condition System in the <F2>Lisp Reference<F0> manual.
  717.  
  718. If the value of <F2>error<#1e>handler<F0> is a sequence, it is expected 
  719. to contain a handler function for each specific error. The error code 
  720. is used as an index into the sequence to fetch the appropriate handler 
  721. function. If this element is a function, it is called for all errors. 
  722. Any results returned by the handler are ignored since it is assumed 
  723. the handler either takes care of the error completely or else signals. 
  724. The arguments passed to the handler function are the <F6>display<F0> 
  725. object, a symbol naming the type of error, and a set of keyword<#1e>value 
  726. argument pairs that vary depending on the type of error. For all core 
  727. errors, the keyword<#1e>value argument pairs are: 
  728.  
  729. <cardlist>
  730.  
  731. <F6>:current<#1e>sequence<F0><Tab><F6>card16<F0><HR>
  732. <F6>:major<F0><Tab><F6>card8<F0><HR>
  733. <F6>:minor<F0><Tab><F6>card16<F0><HR>
  734. <F6>:sequence<F0><Tab><F6>card16<F0> 
  735.  
  736. <para>
  737.  
  738. For <F6>colormap<F0>, <F6>cursor<F0>, <F6>drawable<F0>, <F6>font<F0>, 
  739. <F6>gcontext<F0>, <F6>id<#1e>choice<F0>, <F6>pixmap<F0>, and <F6>window
  740. <F0> errors, the keyword<#1e>value pairs are the core error pairs 
  741. plus: 
  742.  
  743. <cardlist>
  744.  
  745. <F6>:resource<#1e>id<F0><Tab><F6>card32 
  746.  
  747. <para>
  748.  
  749. For <F6>:atom<F0> errors, the keyword<#1e>value pairs are the core 
  750. error pairs plus: 
  751.  
  752. <cardlist>
  753.  
  754. <F6>:atom<#1e>id<F0><Tab><F6>card32 
  755.  
  756. <para>
  757.  
  758. For <F6>:value<F0> errors, the keyword<#1e>value pairs are the core 
  759. error pairs plus: 
  760.  
  761. <cardlist>
  762.  
  763. <F6>:value<F0><Tab><F6>card32<F0> 
  764.  
  765. <arg>
  766.  
  767. display <#1f> <F3>A <F6>display<F3> object. 
  768.  
  769. <syntax0>
  770.  
  771. display<#1e>image<#1e>lsb<#1e>first<#1e>p<F3> <F2>display<F0><Tab><F3>Funct
  772. ion<F0><Index, "image", "leftmost bit of display"><Index, "display", "image leftmost bit"><Index, Doc = operations, "xlib:display<#1e>image<#1e>lsb<#1e>first<#1e>p", Sort String = "display<#1e>image<#1e>lsb<#1e>first<#1e>p">
  773.  
  774. <return>
  775.  
  776. <Tab><F3>Returns: <F2><HR>
  777.   image<#1e>lsb<#1e>first<#1e>p <F3><#1f> Type <F0>boolean<F3>. 
  778. <SP>
  779.  
  780. <para>
  781.  
  782. Although the server is generally responsible for byte swapping communication 
  783. data to match the client, images (pixmaps/bitmaps) are always transmitted 
  784. and received in formats (including byte order) specified by the server. 
  785. Within images for each scan<#1e>line unit in bitmaps or for each pixel 
  786. value in pixmaps, the leftmost bit in the image as displayed on the 
  787. screen is either the least or most significant bit in the unit. For 
  788. the given <F2>display<F0>, <F6>display<#1e>image<#1e>lsb<#1e>first<#1e>p
  789. <F0> returns non<#1e><F6>nil<F0> if the leftmost bit is the least 
  790. significant bit; otherwise, it returns <F6>nil<F0>. 
  791.  
  792. <arg>
  793.  
  794. display <#1f> <F3>A <F6>display<F3> object. 
  795.  
  796. <syntax0>
  797.  
  798. display<#1e>keycode<#1e>range <F2>display<F0><Tab><F3>Function<F0><Index, "keycode", "range of display"><Index, "display", "keycode", "range"><Index, Doc = operations, "xlib:display<#1e>keycode<#1e>range", Sort String = "display<#1e>keycode<#1e>range">
  799.  
  800. <return>
  801.  
  802. <Tab><F3>Returns: <F2><HR>
  803.   min<#1e>keycode<F3>, <F2>max<#1e>keycode <F3><#1f> Type <F0>card8<F3>. 
  804.  
  805. <para>
  806.  
  807. Returns <F2>min<#1e>keycode<F0> and <F2>max<#1e>keycode<F0> as 
  808. multiple values. See the <F6>display<#1e>max<#1e>keycode<F0> and <F6>display
  809. <#1e>min<#1e>keycode<F0> functions for additional information.
  810.  
  811. <arg>
  812.  
  813. <|,"2<#1e>26">display <#1f> <F3>A <F6>display<F3> object. 
  814.  
  815. <syntax0>
  816.  
  817. display<#1e>max<#1e>keycode <F2>display<F0><Tab><F3>Function<F0><Index, "keycode", "maximum value of display"><Index, "display", "keycode", "maximum value"><Index, Doc = operations, "xlib:display<#1e>max<#1e>keycode", Sort String = "display<#1e>max<#1e>keycode">
  818.  
  819. <return>
  820.  
  821. <Tab><F3>Returns: <F2><HR>
  822.   max<#1e>keycode <F3><#1f> Type <F0>card8<F3>. 
  823.  
  824. <para>
  825.  
  826. Returns the maximum keycode value for the specified <F2>display<F0>. 
  827. This value is never greater than 255. Not all keycodes in the allowed 
  828. range are required to have corresponding keys. 
  829.  
  830. <arg>
  831.  
  832. display <#1f> <F3>A <F6>display<F3> object. 
  833.  
  834. <syntax0>
  835.  
  836. display<#1e>max<#1e>request<#1e>length <F2>display<F0><Tab><F3>Function
  837. <F0><Index, "request maximum length of display"><Index, "display", "request maximum length"><Index, Doc = operations, "xlib:display<#1e>max<#1e>request<#1e>length", Sort String = "display<#1e>max<#1e>request<#1e>length">
  838.  
  839. <return>
  840.  
  841. <Tab><F3>Returns: <F2><HR>
  842.   max<#1e>request<#1e>length <F3><#1f> Type <F0>card16<F3>. 
  843.  
  844. <para>
  845.  
  846. Returns the maximum length of a request, in four<#1e>byte units, that 
  847. is accepted by the specified <F2>display<F0>. Requests larger than 
  848. this generate a length error, and the server will read and simply 
  849. discard the entire request. This length is always at least 4096 (that 
  850. is, requests of length up to and including 16384 bytes are accepted 
  851. by all servers).
  852.  
  853. <arg>
  854.  
  855. display <#1f> <F3>A <F6>display<F3> object. 
  856.  
  857. <syntax0>
  858.  
  859. display<#1e>min<#1e>keycode<F3> <F2>display<F0><Tab><F3>Function<F0><Index, "keycode", "minimum value of display"><Index, "display", "keycode", "minimum value"><Index, Doc = operations, "xlib:display<#1e>min<#1e>keycode", Sort String = "display<#1e>min<#1e>keycode">
  860.  
  861. <return>
  862.  
  863. <Tab><F3>Returns: <F2><HR>
  864.   min<#1e>keycode <F3><#1f> Type <F0>card8<F3>. 
  865.  
  866. <para>
  867.  
  868. Returns the minimum keycode value for the specified <F2>display<F0>. 
  869. This value is never less than eight. Not all keycodes in the allowed 
  870. range are required to have corresponding keys. 
  871.  
  872. <arg>
  873.  
  874. display <#1f> <F3>A <F6>display<F3> object. 
  875.  
  876. <syntax0>
  877.  
  878. display<#1e>motion<#1e>buffer<#1e>size<F9> <F2>display<F0><Tab><F3>Function
  879. <F0><Index, "motion buffer size of display"><Index, "display", "motion buffer size"><Index, Doc = operations, "xlib:display<#1e>motion<#1e>buffer<#1e>size", Sort String = "display<#1e>motion<#1e>buffer<#1e>size">
  880.  
  881. <return>
  882.  
  883. <Tab><F3>Returns: <F2><HR>
  884.   motion<#1e>buffer<#1e>size <F3><#1f> Type <F0>card32<F3>. 
  885.  
  886. <para>
  887.  
  888. Returns the approximate size of the motion buffer for the specified <F2>displa
  889. y<F0>. The server can retain the recent history of pointer motion 
  890. at a finer granularity than is reported by <F6>:motion<#1e>notify<F0> 
  891. events. Such history is available through the <F6>motion<#1e>events<F0> 
  892. function. 
  893.  
  894. <arg>
  895.  
  896. display <#1f> <F3>A <F6>display<F3> object. 
  897.  
  898. <syntax0>
  899.  
  900. display<#1e>p<F3> <F2>display<F0><Tab><F3>Function<Index, Doc = operations, "xlib:display<#1e>p", Sort String = "display<#1e>p">
  901.  
  902. <return>
  903.  
  904. <Tab><F3>Returns: <F2><HR>
  905.   display<#1e>p <F3><#1f> Type <F0>boolean<F3>.
  906.  
  907. <para>
  908.  
  909. Returns non<#1e><F6>nil<F0> if <F2>display<F0> is a <F6>display<F0> 
  910. object; otherwise, returns <F6>nil<F0>. 
  911.  
  912. <syntax0>
  913.  
  914. display<#1e>pixmap<#1e>formats<F3> <F2>display<F0><Tab><F3>Function<F0><Index, "pixmap", "formats of display"><Index, "display", "pixmap formats"><Index, Doc = operations, "xlib:display<#1e>pixmap<#1e>formats", Sort String = "display<#1e>pixmap<#1e>formats">
  915.  
  916. <return>
  917.  
  918. <Tab><F3>Returns: <F2><HR>
  919.   pixmap<#1e>formats <F3><#1f> Type <F0>list<F3>.
  920.  
  921. <para>
  922.  
  923. Returns the list of <F6>pixmap<#1e>format<F2> <F0>values for the 
  924. given <F2>display<F0>. This list contains one entry for each depth 
  925. value. The entry describes the format used to represent images of 
  926. that depth. An entry for a depth is included if any screen supports 
  927. that depth, and all screens supporting that depth must support (only) 
  928. the format for that depth. 
  929.  
  930. <arg>
  931.  
  932. display <#1f> <F3>A <F6>display<F3> object. 
  933.  
  934. <syntax0>
  935.  
  936. <|,"2<#1e>27">display<#1e>plist<F3> <F2>display<F0><Tab><F3>Function<F0><Index, "property list", "display"><Index, "display", "property list"><Index, Doc = operations, "xlib:display<#1e>plist", Sort String = "display<#1e>plist">
  937.  
  938. <return>
  939.  
  940. <Tab><F3>Returns: <F2><HR>
  941.   plist <F3><#1f> Type <F0>list<F3>. 
  942.  
  943. <para>
  944.  
  945. Returns and (with <F6>setf<F0>) sets the property list for the specified 
  946. <F2>display<F0>. This function provides a hook where extensions 
  947. can add data.
  948.  
  949. <arg>
  950.  
  951. display <#1f> <F3>A <F6>display<F3> object. 
  952.  
  953. <syntax0>
  954.  
  955. display<#1e>protocol<#1e>major<#1e>version <F2>display<F0><Tab><F3>Function
  956. <F0><Index, "protocol", "major version of display"><Index, "display", "protocol", "major version"><Index, Doc = operations, "xlib:display<#1e>protocol<#1e>major<#1e>version", Sort String = "display<#1e>protocol<#1e>major<#1e>version">
  957.  
  958. <return>
  959.  
  960. <Tab><F3>Returns: <F2><HR>
  961.   protocol<#1e>major<#1e>version <F3><#1f> Type <F0>card16<F3>. 
  962.  
  963. <para>
  964.  
  965. Returns the major version number of the X protocol associated with 
  966. the specified <F2>display<F0>. In general, the major version would 
  967. increment for incompatible changes. The returned protocol version 
  968. number indicates the protocol the server actually supports. This might 
  969. not equal the version supported by the client. The server can (but 
  970. need not) refuse connections from clients that offer a different version 
  971. than the server supports. A server can (but need not) support more 
  972. than one version simultaneously. 
  973.  
  974. <arg>
  975.  
  976. display <#1f> <F3>A <F6>display<F3> object.
  977.  
  978. <syntax0>
  979.  
  980. display<#1e>protocol<#1e>minor<#1e>version <F2>display<F0><Tab><F3>Function
  981. <F0><Index, "protocol", "minor version of display"><Index, "display", "protocol", "minor version"><Index, Doc = operations, "xlib:display<#1e>protocol<#1e>minor<#1e>version", Sort String = "display<#1e>protocol<#1e>minor<#1e>version">
  982.  
  983. <return>
  984.  
  985. <Tab><F3>Returns: <F2><HR>
  986.   protocol<#1e>minor<#1e>version <F3><#1f> Type <F0>card16<F3>. 
  987.  
  988. <para>
  989.  
  990. Returns the minor protocol revision number associated with the specified <F2>d
  991. isplay<F0>. In general, the minor version would increment for small 
  992. upward compatible changes in the X protocol. 
  993.  
  994. <arg>
  995.  
  996. display <#1f> <F3>A <F6>display<F3> object.
  997.  
  998. <syntax0>
  999.  
  1000. display<#1e>protocol<#1e>version <F2>display<F0><Tab><F3>Function<F0><Index, "protocol", "version of display"><Index, "display", "protocol", "version"><Index, Doc = operations, "xlib:display<#1e>protocol<#1e>version", Sort String = "display<#1e>protocol<#1e>version">
  1001.  
  1002. <return>
  1003.  
  1004. <Tab><F3>Returns:<HR>
  1005.   <F2>protocol<#1e>major<#1e>version<F3>,<F2> protocol<#1e>minor<#1e>version 
  1006. <F3><#1f> Type <F0>card16<F3>. 
  1007.  
  1008. <para>
  1009.  
  1010. Returns <F2>protocol<#1e>major<#1e>version <F0>and <F2>protocol<#1e>minor<#1e>
  1011. version<F0> as multiple values. See the <F6>display<#1e>protocol<#1e>major<#1e>
  1012. version<F0> and <F6>display<#1e>protocol<#1e>minor<#1e>version<F0> 
  1013. functions for additional information.
  1014.  
  1015. <arg>
  1016.  
  1017. display <#1f> <F3>A <F6>display<F3> object.
  1018.  
  1019. <syntax0>
  1020.  
  1021. display<#1e>resource<#1e>id<#1e>base <F2>display<F0><Tab><F3>Function<F0><Index, "resource<#1e>id", "base of display"><Index, "display", "resource<#1e>id", "base"><Index, Doc = operations, "xlib:display<#1e>resource<#1e>id<#1e>base", Sort String = "display<#1e>resource<#1e>id<#1e>base">
  1022.  
  1023. <return>
  1024.  
  1025. <Tab><F3>Returns: <F2><HR>
  1026.   resource<#1e>id<#1e>base <F3><#1f> Type <F0>resource<#1e>id<F3>. 
  1027.  
  1028. <para>
  1029.  
  1030. Returns the <F2>resource<#1e>id<#1e>base<F0> value that was returned 
  1031. from the server during connection setup for the specified <F2>display<F0>. 
  1032. This is used in combination with the <F2>resource<#1e>id<#1e>mask<F0> 
  1033. to construct valid IDs for this connection. 
  1034.  
  1035. <arg>
  1036.  
  1037. display <#1f> <F3>A <F6>display<F3> object. 
  1038.  
  1039. <syntax0>
  1040.  
  1041. <|,"2<#1e>28">display<#1e>resource<#1e>id<#1e>mask <F2>display<F0><Tab><F3>Function
  1042. <F0><Index, "resource<#1e>id", "mask of display"><Index, "display", "resource<#1e>id", "mask"><Index, Doc = operations, "xlib:display<#1e>resource<#1e>id<#1e>mask ", Sort String = "display<#1e>resource<#1e>id<#1e>mask ">
  1043.  
  1044. <return>
  1045.  
  1046. <Tab><F3>Returns: <F2><HR>
  1047.   resource<#1e>id<#1e>mask <F3><#1f> Type <F0>resource<#1e>id<F3>. 
  1048.  
  1049. <para>
  1050.  
  1051. Returns the <F2>resource<#1e>id<#1e>mask<F0> that was returned from 
  1052. the server during connection setup for the specified <F2>display<F0>. 
  1053. The <F2>resource<#1e>id<#1e>mask<F0> contains a single contiguous 
  1054. set of bits (at least 18) which the client uses to allocate resource 
  1055. IDs for types <F6>window<F0>, <F6>pixmap<F0>, <F6>cursor<F0>, <F6>font
  1056. <F0>, <F6>gcontext<F0>, and <F6>colormap<F0> by choosing a value 
  1057. with (only) some subset of these bits set, and <F6>or<F0>ing it 
  1058. with the <F2>resource<#1e>id<#1e>base<F0>. Only values constructed 
  1059. in this way can be used to name newly created server resources over 
  1060. this connection. Server resource IDs never have the top three bits 
  1061. set. The client is not restricted to linear or contiguous allocation 
  1062. of server resource IDs. Once an ID has been freed, it can be reused, 
  1063. but this should not be necessary. 
  1064.  
  1065. An ID must be unique with respect to the IDs of all other server resources, 
  1066. not just other server resources of the same type. However, note that 
  1067. the value spaces of server resource identifiers, atoms, visualids, 
  1068. and keysyms are distinguished by context, and as such are not required 
  1069. to be disjoint (for example, a given numeric value might be both a 
  1070. valid window ID, a valid atom, and a valid keysym.)
  1071.  
  1072. <arg>
  1073.  
  1074. display <#1f> <F3>A <F6>display<F3> object. 
  1075.  
  1076. <syntax0>
  1077.  
  1078. display<#1e>roots<F3> <F2>display<F0><Tab><F3>Function<F0><Index, "root", "display"><Index, "display", "roots"><Index, Doc = operations, "xlib:display<#1e>roots", Sort String = "display<#1e>roots">
  1079.  
  1080. <return>
  1081.  
  1082. <Tab><F3>Returns: <F2><HR>
  1083.   roots <F3><#1f> A list of screens. 
  1084.  
  1085. <para>
  1086.  
  1087. Returns a list of all the <F6>screen<F0> structures available for 
  1088. the given <F2>display<F0>. 
  1089.  
  1090. <arg>
  1091.  
  1092. display <#1f> <F3>A <F6>display<F3> object.
  1093.  
  1094. <syntax0>
  1095.  
  1096. display<#1e>vendor <F2>display<F0><Tab><F3>Function<F0><Index, "vendor", "display"><Index, "display", "vendor"><Index, Doc = operations, "xlib:display<#1e>vendor", Sort String = "display<#1e>vendor">
  1097.  
  1098. <return>
  1099.  
  1100. <Tab><F3>Returns: <F2><HR>
  1101.   vendor<#1e>name<F3>, <F2>release<#1e>number <F3><#1f> Type <F0>card32
  1102. <F3>. 
  1103.  
  1104. <para>
  1105.  
  1106. Returns <F2>vendor<#1e>name<F0> and <F2>release<#1e>number<F0> 
  1107. as multiple values. See the <F6>display<#1e>vendor<#1e>name<F0> 
  1108. and <F6>display<#1e>release<#1e>number<F0> functions for additional 
  1109. information.
  1110.  
  1111. <arg>
  1112.  
  1113. display <#1f> <F3>A <F6>display<F3> object. 
  1114.  
  1115. <syntax0>
  1116.  
  1117. display<#1e>vendor<#1e>name <F2>display<F0><Tab><F3>Function<F0><Index, "vendor", "name of display"><Index, "display", "vendor", "name"><Index, Doc = operations, "xlib:display<#1e>vendor<#1e>name", Sort String = "display<#1e>vendor<#1e>name">
  1118.  
  1119. <return>
  1120.  
  1121. <Tab><F3>Returns: <F2><HR>
  1122.   vendor<#1e>name <F3><#1f> Type <F0>string<F3>. 
  1123.  
  1124. <para>
  1125.  
  1126. Returns a string that provides some vendor identification of the X 
  1127. server implementation associated with the specified <F2>display<F0>. 
  1128.  
  1129. <arg>
  1130.  
  1131. display <#1f> <F3>A <F6>display<F3> object.
  1132.  
  1133. <syntax0>
  1134.  
  1135. display<#1e>version<#1e>number <F2>display<F0><Tab><F3>Function<F0><Index, "version number of display"><Index, "display", "version number"><Index, Doc = operations, "xlib:display<#1e>version<#1e>number", Sort String = "display<#1e>version<#1e>number">
  1136.  
  1137. <return>
  1138.  
  1139. <Tab><F3>Returns: <F2><HR>
  1140.   version<#1e>number <F3><#1f> Type <F0>card16<F3>. 
  1141.  
  1142. <para>
  1143.  
  1144. Returns the X protocol version number for this implementation of CLX. 
  1145.  
  1146. <arg>
  1147.  
  1148. display <#1f> <F3>A <F6>display<F3> object.
  1149.  
  1150. <syntax0>
  1151.  
  1152. display<#1e>xid <F2>display<F0><Tab><F3>Function<F0><Index, "server", "resource ID of display", Sort String = "resource id of display"><Index, "display", "server resource ID", Sort String = "server resource id"><Index, Doc = operations, "xlib:display<#1e>xid", Sort String = "display<#1e>xid">
  1153.  
  1154. <return>
  1155.  
  1156. <Tab><F3>Returns: <F2><HR>
  1157.   resource<#1e>allocator <F3><#1f> Type <F0>function<F3>. 
  1158.  
  1159. <para>
  1160.  
  1161. Returns the function that is used to allocate server resource IDs 
  1162. for this <F2>display<F0>. 
  1163.  
  1164. <arg>
  1165.  
  1166. display <#1f> <F3>A <F6>display<F3> object.
  1167.  
  1168. <syntax,
  1169.     Left Tab =        -0.90/0 inches,
  1170.     Right Tab =        7.50 inches>
  1171.  
  1172. <|,"2<#1e>29">with<#1e>display<F3> <F2>display<F3> &body <F2>body<F0><Tab><F3>Mac
  1173. ro<F0><Index, "window", "attributes", "batching"><Index, Doc = operations, "xlib:with<#1e>display", Sort String = "with<#1e>display">
  1174.  
  1175. <para>
  1176.  
  1177. This macro is for use in a multi<#1e>process environment. <F6>with<#1e>display
  1178. <F0> provides exclusive access to the local <F6>display<F0> object 
  1179. for multiple request generation. It need not provide immediate exclusive 
  1180. access for replies. That is, if another process is waiting for a reply 
  1181. (while not in a <F6>with<#1e>display<F0>), then synchronization 
  1182. need not (but can) occur immediately. Except where noted, all routines 
  1183. effectively contain an implicit <F6>with<#1e>display<F0> where needed, 
  1184. so that correct synchronization is always provided at the interface 
  1185. level on a per<#1e>call basis. Nested uses of this macro work correctly. 
  1186. This macro does not prevent concurrent event processing (see <F6>with<#1e>even
  1187. t<#1e>queue<F0>). 
  1188.  
  1189. <arg>
  1190.  
  1191. display <#1f> <F3>A <F6>display<F3>. 
  1192.  
  1193. <p1rule>
  1194.  
  1195. <Index, "output buffer management", To Named = p1rule><Index, "display", "output buffer management", To Named = p1rule>
  1196. <Frame,
  1197.     Name =            p1rule,
  1198.     Placement =        At Anchor,
  1199.     Width =            6.35 inches,
  1200.     Height =        0.153 inches,
  1201.     Vertical Alignment =    0.007 inches,
  1202.     Shared Contents =    yes>
  1203.  
  1204. <p1stacked,
  1205.     Font =            F3,
  1206.     Left Tab =        -1.70/0 inches>
  1207.  
  1208. <F7>Managing the <Tab><F6>2.4<F0><#04>Most CLX functions cause 
  1209. output requests to be generated to an X<FJ>
  1210.  
  1211. <p1para,
  1212.     Alignment =        Both,
  1213.     Font =            F3,
  1214.     Allow Page Break After = yes>
  1215.  
  1216. <F7>Output Buffer<Tab><F0>server. Output requests are not transmitted 
  1217. immediately but instead are stored in an <F2>output buffer<F0> for 
  1218. the appropriate display. Requests in the output buffer are typically 
  1219. sent only when the buffer is filled. Alternatively, buffered requests 
  1220. can be sent prior to processing an event in the input event queue 
  1221. (see paragraph 12.3, Processing Events). In either case, CLX sends 
  1222. the output buffer automatically without explicit instructions from 
  1223. the client application. 
  1224.  
  1225. <para>
  1226.  
  1227. However, in some cases, explicit control over the output buffer is 
  1228. needed, typically to ensure that the X server is in a consistent state 
  1229. before proceeding further. The <F6>display<#1e>force<#1e>output<F0> 
  1230. and <F6>display<#1e>finish<#1e>output<F0> functions allow a client 
  1231. program to synchronize with buffered output requests.
  1232.  
  1233. <syntax0>
  1234.  
  1235. display<#1e>after<#1e>function <F2>display<F0><Tab><F3>Function<Index, Doc = operations, "xlib:display<#1e>after<#1e>function", Sort String = "display<#1e>after<#1e>function">
  1236.  
  1237. <return0,
  1238.     Bottom Margin =        0.08 inches>
  1239.  
  1240. <Tab><F3>Returns: <F2><HR>
  1241.   after<#1e>function <F3><#1f> Type <F0>function<F3> or <F0>null<F3>.
  1242.  
  1243. <para>
  1244.  
  1245. Returns and (with <F6>setf<F0>) sets the <F2>after<#1e>function<F0> 
  1246. for the given <F2>display<F0>. If <F2>after<#1e>function<F0> is 
  1247. non<#1e><F6>nil<F0>, it is a function that is called after every 
  1248. protocol request is generated, even those inside an explicit <F6>with<#1e>disp
  1249. lay<F0>, but never called from inside the <F2>after<#1e>function<F0>. 
  1250. The function is called inside the effective <F6>with<#1e>display<F0> 
  1251. for the associated request. The default value is <F6>nil<F0>. This 
  1252. can be set, for example, to #'<F6>display<#1e>force<#1e>output<F0> 
  1253. or #'<F6>display<#1e>finish<#1e>outpu<F0>t. 
  1254.  
  1255. <arg>
  1256.  
  1257. display <F3><#1f> A <F6>display<F3> object.
  1258.  
  1259. <syntax,
  1260.     Left Tab =        -0.90/0 inches,
  1261.     Right Tab =        7.50 inches>
  1262.  
  1263. display<#1e>force<#1e>output<F3> <F2>display<F0><Tab><F3>Function<Index, Doc = operations, "xlib:display<#1e>force<#1e>output", Sort String = "display<#1e>force<#1e>output">
  1264.  
  1265. <para>
  1266.  
  1267. Forces any buffered output to be sent to the X server.
  1268.  
  1269. <arg>
  1270.  
  1271. display <F3><#1f> A <F6>display<F3> object.
  1272.  
  1273. <syntax,
  1274.     Left Tab =        -0.90/0 inches,
  1275.     Right Tab =        7.50 inches>
  1276.  
  1277. display<#1e>finish<#1e>output<F3> <F2>display<F0><Tab><F3>Function<Index, Doc = operations, "xlib:display<#1e>finish<#1e>output", Sort String = "display<#1e>finish<#1e>output">
  1278.  
  1279. <para>
  1280.  
  1281. Forces any buffered output to be sent to the X server and then waits 
  1282. until all requests have been received and processed. Any errors generated 
  1283. are read and handled by the display error handler. Any events generated 
  1284. by output requests are read and stored in the event queue.
  1285.  
  1286. <arg>
  1287.  
  1288. display <F3><#1f> A <F6>display<F3> object.
  1289.  
  1290. <p1rule>
  1291.  
  1292. <Index, "display", "closing">
  1293. <Frame,
  1294.     Name =            p1rule,
  1295.     Placement =        At Anchor,
  1296.     Width =            6.35 inches,
  1297.     Height =        0.153 inches,
  1298.     Vertical Alignment =    0.007 inches,
  1299.     Shared Contents =    yes>
  1300.  
  1301. <p1stacked,
  1302.     Font =            F3,
  1303.     Left Tab =        -1.70/0 inches>
  1304.  
  1305. <F7>Closing the<Tab><F6>2.5<F0><#04>To close or disconnect a display 
  1306. from the X server, use <F6>close<#1e>display<F0>. <F6><#04>
  1307.  
  1308. <p1para,
  1309.     Alignment =        Both,
  1310.     Font =            F3,
  1311.     Allow Page Break After = yes>
  1312.  
  1313. <F7>Display<Tab>
  1314.  
  1315. <syntax,
  1316.     Left Tab =        -0.90/0 inches,
  1317.     Right Tab =        7.50 inches>
  1318.  
  1319. <|,"2<#1e>30">close<#1e>display<F3> <F2>display<F0><Tab><F3>Function<Index, Doc = operations, "xlib:close<#1e>display", Sort String = "close<#1e>display">
  1320.  
  1321. <para>
  1322.  
  1323. Closes the connection to the X server for the specified <F2>display<F0>. 
  1324. It destroys all server resources (<F6>window<F0>, <F6>font<F0>, <F6>pixmap
  1325. <F0>, <F6>colormap<F0>, <F6>cursor<F0>, and <F6>gcontext<F0>), 
  1326. that the client application has created on this display, unless the 
  1327. close down mode of the server resource has been changed (see <F6>set<#1e>close
  1328. <#1e>down<#1e>mode<F0>). Therefore, these server resources should 
  1329. never be referenced again. In addition, this function discards any 
  1330. output requests that have been buffered but have not yet been sent. 
  1331.  
  1332. <arg>
  1333.  
  1334. display <#1f> <F3>A <F6>display<F3> object.
  1335.  
  1336.