home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / doc / CLX / s15.doc < prev    next >
Encoding:
Interleaf document  |  1989-10-18  |  13.2 KB  |  505 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 18,
  14.     F7 = Times 12 Bold,
  15.     F8 = Times 10 Bold,
  16.     F9 = Symbol_B 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 =        "15<#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, fig,
  119.     Top Margin =        0.07 inches,
  120.     Bottom Margin =        0.07 inches,
  121.     Line Spacing =        1.100 lines,
  122.     Alignment =        Left,
  123.     Font =            F5>
  124.  
  125. <!Class, newpage,
  126.     Bottom Margin =        0 inches,
  127.     Line Spacing =        1 lines,
  128.     Alignment =        Left,
  129.     Font =            F6,
  130.     Hyphenation =        off,
  131.     New Page =        yes,
  132.     Left Tab =        >
  133.  
  134. <!Class, p1para,
  135.     Bottom Margin =        0.153 inches,
  136.     Left Margin =        1.60 inches,
  137.     First Indent =        -1.60 inches,
  138.     Line Spacing =        1.121 lines,
  139.     Alignment =        Left,
  140.     Font =            F7,
  141.     Allow Page Break Within = no,
  142.     Allow Page Break After = no,
  143.     Left Tab =        -1.70/0 inches>
  144.  
  145. <!Class, para,
  146.     Bottom Margin =        0.153 inches,
  147.     Left Margin =        1.60 inches,
  148.     Line Spacing =        1.121 lines,
  149.     Font =            F3,
  150.     Allow Page Break Within = no,
  151.     Left Tab =        0/0.75*13 inches>
  152.  
  153. <!Class, return,
  154.     Bottom Margin =        0.077 inches,
  155.     Left Margin =        1.60 inches,
  156.     First Indent =        -0.90 inches,
  157.     Line Spacing =        1.121 lines,
  158.     Alignment =        Left,
  159.     Font =            F8,
  160.     Hyphenation =        off,
  161.     Allow Page Break Within = no,
  162.     Allow Page Break After = no,
  163.     Left Tab =        -0.90/0 inches,
  164.     Right Tab =        7.50 inches>
  165.  
  166. <!Class, secno,
  167.     Top Margin =        0.07 inches,
  168.     Bottom Margin =        0.07 inches,
  169.     Line Spacing =        1.100 lines,
  170.     Alignment =        Left,
  171.     Font =            F5,
  172.     Autonumber Name =    paranum>
  173.  
  174. <!Class, secrule,
  175.     Bottom Margin =        0 inches,
  176.     Line Spacing =        1 lines,
  177.     Font =            F3,
  178.     Hyphenation =        off,
  179.     Allow Page Break After = no,
  180.     Left Tab =        0/0.75*13 inches,
  181.     Autonumber Name =    table>
  182.  
  183. <!Class, sectitle,
  184.     Bottom Margin =        0 inches,
  185.     Line Spacing =        1 lines,
  186.     Alignment =        Right,
  187.     Font =            F5,
  188.     Hyphenation =        off,
  189.     New Page =        yes,
  190.     Left Tab =        0/0.75*13 inches>
  191.  
  192. <!Class, syntax0,
  193.     Bottom Margin =        0 inches,
  194.     Left Margin =        1.60 inches,
  195.     First Indent =        -0.90 inches,
  196.     Line Spacing =        1.121 lines,
  197.     Alignment =        Left,
  198.     Font =            F8,
  199.     Hyphenation =        off,
  200.     Allow Page Break Within = no,
  201.     Allow Page Break After = no,
  202.     Left Tab =        -0.90/0 inches,
  203.     Right Tab =        8 inches>
  204.  
  205. <!Class, "table",
  206.     Top Margin =        0.07 inches,
  207.     Bottom Margin =        0.07 inches,
  208.     Line Spacing =        1.100 lines,
  209.     Font =            F8,
  210.     Autonumber Name =    table>
  211.  
  212. <!Class, title,
  213.     Top Margin =        0.07 inches,
  214.     Bottom Margin =        0.07 inches,
  215.     Line Spacing =        1.100 lines,
  216.     Alignment =        Right,
  217.     Font =            F5,
  218.     TOC Doc Name =        TOC>
  219.  
  220. <!Master Frame,
  221.     Name =            "At Anchor",
  222.     Placement =        At Anchor,
  223.     Width =            0.41 inches,
  224.     Height =        0.137 inches,
  225.     Vertical Alignment =    0.03 inches,
  226.     Diagram =
  227. V4,
  228. (g9,32767,0
  229.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,1,0,1,1,0.066667,0.066667,6,6,0,0.066
  230.   667,6))>
  231.  
  232. <First Page Header, Frame =
  233. V4,
  234. (g9,0,0
  235.  (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
  236.   667,6))>
  237.  
  238. <Right Page Header, Frame =
  239. V4,
  240. (g9,1,0
  241.  (T8,1,12,4.533333,0.306667,1.8,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,
  242.   102,1101,2,
  243. <caption,
  244.     Alignment =        Right>
  245.  
  246. Window Manager Functions
  247.  
  248. <End Text>)
  249.  (T8,7,12,1.426667,0.413333,3.306667,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048
  250.   ,512,102,1101,2,
  251. <caption>
  252.  
  253. <End Text>)
  254.  (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
  255.   667,6))>
  256.  
  257. <Left Page Header, Frame =
  258. V4,
  259. (g9,1,0
  260.  (T8,1,12,0,0.293333,0.533333,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10
  261.   2,1101,2,
  262. <caption>
  263.  
  264. Extensions
  265.  
  266. <End Text>)
  267.  (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
  268.   667,6))>
  269.  
  270. <Right Page Footer, Frame =
  271. V4,
  272. (g9,1,0
  273.  (t8,1,4,6.333333,0.266667,2,17,@nntimsps10b,\240)
  274.  (t8,2,4,0.006667,0.266667,0,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  275.  (v4,3,0,0,0.066667,6.333333,0.066554,17,2,0)
  276.  (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
  277.   667,6))>
  278.  
  279. <Left Page Footer, Frame =
  280. V4,
  281. (g9,1,0
  282.  (t8,1,4,0,0.266667,0,17,@nntimsps10b,\240)
  283.  (v4,2,0,0.026667,0.066667,6.333333,0.066554,17,2,0)
  284.  (t8,3,4,6.333333,0.253333,2,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  285.  (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,1,1,0,1,0.066667,0.066667,6,6,0,0.066
  286.   667,6))>
  287.  
  288. <sectitle,
  289.     Allow Page Break Within = no,
  290.     Allow Page Break After = no>
  291.  
  292. <|,"15<#1e>183">
  293. <Frame,
  294.     Name =            "At Anchor",
  295.     Placement =        At Anchor,
  296.     Width =            4.72 inches,
  297.     Height =        0.94 inches,
  298.     Vertical Alignment =    0.03 inches,
  299.     Diagram =
  300. V4,
  301. (g9,1,0
  302.  (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
  303.   ,102,1101,3,
  304. <title>
  305.  
  306. EXTENSIONS
  307.  
  308. <End Text>)
  309.  (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
  310.   667,6))>
  311. <Frame,
  312.     Name =            "At Anchor",
  313.     Placement =        At Anchor,
  314.     Width =            1.626 inches,
  315.     Height =        0.938 inches,
  316.     Vertical Alignment =    0 inches,
  317.     Diagram =
  318. V4,
  319. (g9,1,0
  320.  (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
  321.   2,1101,3,
  322. <secno,
  323.     TOC Doc Name =        TOC>
  324.  
  325. <Autonum, paranum, 1, First = Yes>
  326.  
  327. <End Text>)
  328.  (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
  329.   2,1101,3,
  330. <"table">
  331.  
  332. <Autonum, table, 1, First = Yes>
  333.  
  334. <End Text>)
  335.  (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
  336.   1,3,
  337. <fig,
  338.     Alignment =        Both,
  339.     Font =            F8,
  340.     Autonumber Name =    figure>
  341.  
  342. <Autonum, figure, 1, First = Yes>
  343.  
  344. <End Text>)
  345.  (g9,5,0
  346.    (p7,5,8,19
  347.      (g9,5,0
  348.        (g9,5,0
  349.          (v4,5,0,0.266667,0,1.6,0,17,1,0)
  350.          (v4,6,0,1.6,0,1.6,0.933333,17,1,0)
  351.          (v4,7,0,1.6,0.933333,0.266667,0.933333,17,1,0)
  352.          (v4,8,0,0.266667,0.933333,0.266667,0,17,1,0))))
  353.    (g9,10,8
  354.      (p7,10,1032,13
  355.        (g9,10,0
  356.          (g9,10,0
  357.            (v4,10,0,1.375439,0.934816,1.122458,0.934816,17,1,0)
  358.            (v4,11,0,1.122458,0.934816,1.014035,0.822225,17,1,0)
  359.            (v4,12,0,1.014035,0.822225,1.014035,0.709631,17,1,0)
  360.            (v4,13,0,1.014035,0.709631,1.176666,0.709631,17,1,0)
  361.            (v4,14,0,1.176666,0.709631,1.176666,0.784694,17,1,0)
  362.            (v4,15,0,1.176666,0.784694,1.321229,0.784694,17,1,0)
  363.            (v4,16,0,1.321229,0.784694,1.321229,0.597039,17,1,0)
  364.            (v4,17,0,1.321229,0.597039,1.068246,0.597039,17,1,0)
  365.            (v4,18,0,1.068246,0.597039,1.014035,0.540743,17,1,0)
  366.            (v4,19,0,1.014035,0.540743,1.014035,0.14667,17,1,0)
  367.            (v4,20,0,1.014035,0.14667,1.465791,0.14667,17,1,0)
  368.            (v4,21,0,1.465791,0.14667,1.465791,0.296792,17,1,0)
  369.            (v4,22,0,1.465791,0.296792,1.176666,0.296792,17,1,0)
  370.            (v4,23,0,1.176666,0.296792,1.176666,0.446915,17,1,0)
  371.            (v4,24,0,1.176666,0.446915,1.375439,0.446915,17,1,0)
  372.            (v4,25,0,1.375439,0.446915,1.48386,0.559508,17,1,0)
  373.            (v4,26,0,1.48386,0.559508,1.48386,0.822225,17,1,0)
  374.            (v4,27,0,1.48386,0.822225,1.375439,0.934816,17,1,0))))
  375.      (g9,28,2048
  376.        (v4,28,33,0.977895,1.16,0.977895,1.16,17,0,0)
  377.        (v4,29,33,0.977895,0.14667,0.977895,0.14667,17,0,0)
  378.        (v4,30,33,1.52,0.14667,1.52,0.14667,17,0,0)
  379.        (v4,31,33,1.52,1.16,1.52,1.16,17,0,0)))
  380.    (g9,33,8
  381.      (p7,33,1032,13
  382.        (g9,33,0
  383.          (g9,33,0
  384.            (v4,33,0,0.914386,0.934813,0.914386,0.146667,17,1,0)
  385.            (v4,34,0,0.914386,0.146667,0.769824,0.146667,17,1,0)
  386.            (v4,35,0,0.769824,0.146667,0.625263,0.296789,17,1,0)
  387.            (v4,36,0,0.625263,0.296789,0.625263,0.371848,17,1,0)
  388.            (v4,37,0,0.625263,0.371848,0.751755,0.371848,17,1,0)
  389.            (v4,38,0,0.751755,0.371848,0.751755,0.934813,17,1,0)
  390.            (v4,39,0,0.751755,0.934813,0.914386,0.934813,17,1,0))))
  391.      (g9,40,2048
  392.        (v4,40,33,0.607192,0.146667,0.607192,0.146667,17,0,0)
  393.        (v4,41,33,0.607192,1.159997,0.607192,1.159997,17,0,0)
  394.        (v4,42,33,0.986667,1.159997,0.986667,1.159997,17,0,0)
  395.        (v4,43,33,0.986667,0.146667,0.986667,0.146667,17,0,0))))
  396.  (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
  397.   667,6))>
  398.  
  399. <secrule,
  400.     Allow Page Break Within = no,
  401.     Allow Page Break After = yes,
  402.     Autonumber Name =    >
  403.  
  404. <Index, "extensions", To Named = sectitle>
  405. <Frame,
  406.     Name =            "At Anchor",
  407.     Placement =        At Anchor,
  408.     Width =            6.35 inches,
  409.     Height =        0.153 inches,
  410.     Vertical Alignment =    0.007 inches,
  411.     Diagram =
  412. V4,
  413. (g9,1,0
  414.  (v4,1,0,0.006667,0.066723,6.333333,0.066611,17,2,0)
  415.  (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
  416.   667,6))>
  417.  
  418. <p1para,
  419.     Alignment =        Both,
  420.     Font =            F3,
  421.     Allow Page Break After = yes>
  422.  
  423. <F7>Extensions<Tab><F8>15.1<F0><#04>The X Window System is based 
  424. on a core protocol which can be extended to<SP>provide new functionality.  
  425. An extension is generally represented by an<SP>additional set of requests 
  426. or event types that are implemented by an X<SP>server supporting the 
  427. extension. By definition, a client program using an<SP>extension may 
  428. not be portable to other servers. However, extensions allow<SP>different 
  429. server implementations and different sites to add their own<SP>special 
  430. features to X, without disrupting clients that rely only on the<SP>core 
  431. protocol.
  432.  
  433. <para>
  434.  
  435. Extensions are identified by assigning them unique name strings and 
  436. major<SP>protocol numbers. A client program can request an X server 
  437. to use a<SP>protocol extension by furnishing the extension protocol 
  438. number<FJ>
  439. as an<SP>argument to <F8>open<#1e>display<F0>. The X Consortium 
  440. maintains a registry of<SP>standard extension names and protocol numbers.
  441.  
  442. The following paragraphs describe the CLX functions used to:
  443.  
  444. <bullet>
  445.  
  446. <F9>w<Tab><F0>List all supported extensions.
  447.  
  448. <F9>w<Tab><F0>Find out if a given extension is supported.
  449.  
  450. <syntax0>
  451.  
  452. list<#1e>extensions<F3> <F2>display<F3> &key (<F0>:result<#1e>type<F3> 
  453. <F0>'list<F3>)<F0><Tab><F3>Function<Index, Doc = operations, "xlib:list<#1e>extensions", Sort String = "list<#1e>extensions">
  454.  
  455. <return>
  456.  
  457. <Tab><F3>Returns:<HR>
  458.   <F2>names<F3> <#1f> Type <F0>sequence<F3> of <F0>string<F3>.
  459.  
  460. <para>
  461.  
  462. Returns a sequence containing the <F2>names<F0> of all extensions 
  463. supported by the <F2>display<F0> server.
  464.  
  465. <arg>
  466.  
  467. display<F3> <#1f> A <F8>display<F3>.
  468.  
  469. <F8>:result<#1e>type<F3> <#1f> The type of name sequence to return.
  470.  
  471. <syntax0>
  472.  
  473. query<#1e>extension <F2>display name<F0><Tab><F3>Function<Index, Doc = operations, "xlib:query<#1e>extension", Sort String = "query<#1e>extension">
  474.  
  475. <return>
  476.  
  477. <Tab><F3>Returns:<HR>
  478.   <F2>major<#1e>opcode<F3>,<F2> <F3> <F2>first<#1e>event<F3>,<F2> 
  479. first<#1e>error<F3> <#1f> Type <F0>card8<F3> or <F0>null<F3>.
  480.  
  481. <para>
  482.  
  483. Returns the <F2>major<#1e>opcode<F0> for the given extension <F2>name<F0> 
  484. support by the<SP><F2>display<F0> server. If the extension is not 
  485. supported, only <F8>nil<F0> values are<SP>returned. The extension <F2>name
  486. <F0> must contain only ISO Latin<#1e>1 characters;<SP>case is significant.
  487.  
  488. If the extension involves additional event types, the <F2>first<#1e>event
  489. <F0><SP>returned is the base event type code for new events; otherwise, 
  490. the<SP><F2>first<#1e>event<F0> is <F8>nil<F0>. If the extension 
  491. involves additional error codes,<SP>the <F2>first<#1e>error<F0> 
  492. returned is the base code for new errors;<SP>otherwise, the <F2>first<#1e>erro
  493. r<F0> is <F8>nil<F0>. The formats of error and event<SP>messages 
  494. sent by the server are completely defined by the extension.
  495.  
  496. <arg>
  497.  
  498. display<F3> <#1f> A <F8>display<F3>.
  499.  
  500. name<F3> <#1f> An extension name string.
  501.  
  502. <newpage>
  503.  
  504. <|,"15<#1e>184">
  505.