home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / doc / CLX / s16.doc < prev    next >
Encoding:
Interleaf document  |  1989-10-18  |  30.1 KB  |  1,016 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,
  10.     F3 = Times 8 Italic,
  11.     F4 = Times 18 Bold,
  12.     F5 = Times 12 Bold,
  13.     F6 = Times 10 Bold,
  14.     F7 = Times 10 Italic,
  15.     F8 = Symbol_B 8>
  16.  
  17. <!Page,
  18.     Bottom Margin =        1 inches,
  19.     Left Margin =        1 inches,
  20.     Right Margin =        1.15 inches,
  21.     First Page =        Right,
  22.     Starting Page # =     Inherit,
  23.     Page # Prefix =        "16<#1e>",
  24.     Hyphenation =        on,
  25.     Consecutive Hyphens =    2,
  26.     Vert. Just. =        off>
  27.  
  28. <!Autonumber Stream, List, 2,
  29.     Level 2 Suffix =    ,
  30.     Level 2 Starting Value = 0,
  31.     Level 2 Show =        no>
  32.  
  33. <!Autonumber Stream, Outline, 3,
  34.     Level 1 Symbol Type =    UPPER ROMAN,
  35.     Level 2 Symbol Type =    UPPER ALPHA>
  36.  
  37. <!Autonumber Stream, figure, 2,
  38.     Level 1 Prefix =    "Figure ",
  39.     Level 1 Suffix =    "<#1e>",
  40.     Level 1 Show =        no,
  41.     Level 2 Suffix =    ,
  42.     Level 2 Starting Value = 0,
  43.     Level 2 Show =        no>
  44.  
  45. <!Autonumber Stream, figurelet, 2,
  46.     Level 1 Symbol Type =    UPPER ALPHA,
  47.     Level 1 Prefix =    "Figure ",
  48.     Level 1 Suffix =    "<#1e>",
  49.     Level 1 Show =        no,
  50.     Level 2 Suffix =    "<#04>">
  51.  
  52. <!Autonumber Stream, invisible, 1,
  53.     Level 1 Suffix =    ,
  54.     Level 1 Show =        no>
  55.  
  56. <!Autonumber Stream, item, 2,
  57.     Level 2 Symbol Type =    LOWER ALPHA,
  58.     Level 2 Trail =        yes>
  59.  
  60. <!Autonumber Stream, paralet, 4,
  61.     Level 1 Symbol Type =    UPPER ALPHA,
  62.     Level 1 Suffix =    ,
  63.     Level 1 Show =        no,
  64.     Level 2 Prefix =    .,
  65.     Level 2 Suffix =    ,
  66.     Level 3 Prefix =    .,
  67.     Level 3 Suffix =    ,
  68.     Level 4 Prefix =    .,
  69.     Level 4 Suffix =    >
  70.  
  71. <!Autonumber Stream, paranum, 4,
  72.     Level 1 Suffix =    ,
  73.     Level 1 Show =        no,
  74.     Level 2 Prefix =    .,
  75.     Level 2 Suffix =    ,
  76.     Level 3 Prefix =    .,
  77.     Level 3 Suffix =    ,
  78.     Level 4 Prefix =    .,
  79.     Level 4 Suffix =    >
  80.  
  81. <!Autonumber Stream, table, 2,
  82.     Level 1 Prefix =    "Table ",
  83.     Level 1 Suffix =    "<#1e>",
  84.     Level 1 Show =        no,
  85.     Level 2 Suffix =    >
  86.  
  87. <!Autonumber Stream, tablelet, 2,
  88.     Level 1 Symbol Type =    UPPER ALPHA,
  89.     Level 1 Prefix =    "Table ",
  90.     Level 1 Suffix =    "<#1e>",
  91.     Level 1 Show =        no,
  92.     Level 2 Suffix =    "<#04>">
  93.  
  94. <!Class, bullet,
  95.     Bottom Margin =        0.153 inches,
  96.     Left Margin =        1.85 inches,
  97.     First Indent =        -0.25 inches,
  98.     Line Spacing =        1.121 lines,
  99.     Font =            F2,
  100.     Allow Page Break Within = no,
  101.     Left Tab =        -0.50/0 inches>
  102.  
  103. <!Class, caption,
  104.     Top Margin =        0.07 inches,
  105.     Bottom Margin =        0.07 inches,
  106.     Line Spacing =        1.100 lines,
  107.     Font =            F3>
  108.  
  109. <!Class, fig,
  110.     Top Margin =        0.07 inches,
  111.     Bottom Margin =        0.07 inches,
  112.     Line Spacing =        1.100 lines,
  113.     Alignment =        Left,
  114.     Font =            F4>
  115.  
  116. <!Class, p1para,
  117.     Bottom Margin =        0.153 inches,
  118.     Left Margin =        1.60 inches,
  119.     First Indent =        -1.60 inches,
  120.     Line Spacing =        1.121 lines,
  121.     Alignment =        Left,
  122.     Font =            F5,
  123.     Allow Page Break Within = no,
  124.     Allow Page Break After = no,
  125.     Left Tab =        -1.70/0 inches>
  126.  
  127. <!Class, para,
  128.     Bottom Margin =        0.153 inches,
  129.     Left Margin =        1.60 inches,
  130.     Line Spacing =        1.121 lines,
  131.     Font =            F2,
  132.     Allow Page Break Within = no,
  133.     Left Tab =        0/0.75*13 inches>
  134.  
  135. <!Class, secno,
  136.     Top Margin =        0.07 inches,
  137.     Bottom Margin =        0.07 inches,
  138.     Line Spacing =        1.100 lines,
  139.     Alignment =        Left,
  140.     Font =            F4,
  141.     Autonumber Name =    paranum>
  142.  
  143. <!Class, secrule,
  144.     Bottom Margin =        0 inches,
  145.     Line Spacing =        1 lines,
  146.     Font =            F2,
  147.     Hyphenation =        off,
  148.     Allow Page Break After = no,
  149.     Left Tab =        0/0.75*13 inches,
  150.     Autonumber Name =    table>
  151.  
  152. <!Class, sectitle,
  153.     Bottom Margin =        0 inches,
  154.     Line Spacing =        1 lines,
  155.     Alignment =        Right,
  156.     Font =            F4,
  157.     Hyphenation =        off,
  158.     New Page =        yes,
  159.     Left Tab =        0/0.75*13 inches>
  160.  
  161. <!Class, syntax,
  162.     Bottom Margin =        0.077 inches,
  163.     Left Margin =        1.60 inches,
  164.     First Indent =        -0.90 inches,
  165.     Line Spacing =        1.121 lines,
  166.     Alignment =        Left,
  167.     Font =            F6,
  168.     Hyphenation =        off,
  169.     Allow Page Break Within = no,
  170.     Allow Page Break After = no,
  171.     Left Tab =        -0.90/0 inches,
  172.     Right Tab =        8 inches>
  173.  
  174. <!Class, "table",
  175.     Top Margin =        0.07 inches,
  176.     Bottom Margin =        0.07 inches,
  177.     Line Spacing =        1.100 lines,
  178.     Font =            F6,
  179.     Autonumber Name =    table>
  180.  
  181. <!Class, title,
  182.     Top Margin =        0.07 inches,
  183.     Bottom Margin =        0.07 inches,
  184.     Line Spacing =        1.100 lines,
  185.     Alignment =        Right,
  186.     Font =            F4,
  187.     TOC Doc Name =        TOC>
  188.  
  189. <!Master Frame,
  190.     Name =            "At Anchor",
  191.     Placement =        At Anchor,
  192.     Width =            0.41 inches,
  193.     Height =        0.137 inches,
  194.     Vertical Alignment =    0.03 inches,
  195.     Diagram =
  196. V4,
  197. (g9,32767,0
  198.  (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
  199.   667,6))>
  200.  
  201. <First Page Header, Frame =
  202. V4,
  203. (g9,0,0
  204.  (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
  205.   667,6))>
  206.  
  207. <Right Page Header, Frame =
  208. V4,
  209. (g9,1,0
  210.  (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,
  211.   102,1101,2,
  212. <caption,
  213.     Alignment =        Right>
  214.  
  215. Errors
  216.  
  217. <End Text>)
  218.  (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
  219.   667,6))>
  220.  
  221. <Left Page Header, Frame =
  222. V4,
  223. (g9,1,0
  224.  (T8,1,12,0,0.306667,2.4,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,102,110
  225.   1,2,
  226. <caption>
  227.  
  228. Errors
  229.  
  230. <End Text>)
  231.  (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
  232.   667,6))>
  233.  
  234. <Right Page Footer, Frame =
  235. V4,
  236. (g9,1,0
  237.  (t8,1,4,6.333333,0.266667,2,17,@nntimsps10b,\240)
  238.  (t8,2,4,0.006667,0.266667,0,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  239.  (v4,3,0,0,0.066667,6.333333,0.066554,17,2,0)
  240.  (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
  241.   667,6))>
  242.  
  243. <Left Page Footer, Frame =
  244. V4,
  245. (g9,1,0
  246.  (t8,1,4,0,0.266667,0,17,@nntimsps10b,\240)
  247.  (t8,2,4,6.333333,0.266667,2,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  248.  (v4,3,0,0.026667,0.066667,6.333333,0.066554,17,2,0)
  249.  (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
  250.   667,6))>
  251.  
  252. <sectitle,
  253.     Allow Page Break Within = no,
  254.     Allow Page Break After = no>
  255.  
  256. <|,"16<#1e>185">
  257. <Frame,
  258.     Name =            "At Anchor",
  259.     Placement =        At Anchor,
  260.     Width =            4.72 inches,
  261.     Height =        0.94 inches,
  262.     Vertical Alignment =    0.03 inches,
  263.     Diagram =
  264. V4,
  265. (g9,1,0
  266.  (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
  267.   ,102,1101,3,
  268. <title>
  269.  
  270. ERRORS
  271.  
  272. <End Text>)
  273.  (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
  274.   667,6))>
  275. <Frame,
  276.     Name =            "At Anchor",
  277.     Placement =        At Anchor,
  278.     Width =            1.626 inches,
  279.     Height =        0.938 inches,
  280.     Vertical Alignment =    0 inches,
  281.     Diagram =
  282. V4,
  283. (g9,1,0
  284.  (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
  285.   2,1101,3,
  286. <secno,
  287.     TOC Doc Name =        TOC>
  288.  
  289. <Autonum, paranum, 1, First = Yes>
  290.  
  291. <End Text>)
  292.  (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
  293.   2,1101,3,
  294. <"table">
  295.  
  296. <Autonum, table, 1, First = Yes>
  297.  
  298. <End Text>)
  299.  (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
  300.   1,3,
  301. <fig,
  302.     Alignment =        Both,
  303.     Font =            F6,
  304.     Autonumber Name =    figure>
  305.  
  306. <Autonum, figure, 1, First = Yes>
  307.  
  308. <End Text>)
  309.  (g9,5,0
  310.    (p7,5,8,19
  311.      (g9,5,0
  312.        (g9,5,0
  313.          (v4,5,0,0.266667,0,1.6,0,17,1,0)
  314.          (v4,6,0,1.6,0,1.6,0.933333,17,1,0)
  315.          (v4,7,0,1.6,0.933333,0.266667,0.933333,17,1,0)
  316.          (v4,8,0,0.266667,0.933333,0.266667,0,17,1,0))))
  317.    (g9,10,0
  318.      (g9,10,8
  319.        (g9,10,1032
  320.          (p7,10,8,13
  321.            (g9,10,0
  322.              (g9,10,0
  323.                (v4,10,32,1.135964,0.934816,1.190176,0.784694,17,0,0)
  324.                (v4,11,0,1.190176,0.784694,1.190176,0.615804,17,1,0)
  325.                (v4,12,32,1.190176,0.615804,1.190176,0.46568,17,0,0)
  326.                (v4,13,0,1.190176,0.46568,1.190176,0.296792,17,1,0)
  327.                (v4,14,0,1.190176,0.296792,1.334736,0.296792,17,1,0)
  328.                (v4,15,0,1.334736,0.296792,1.334736,0.371851,17,1,0)
  329.                (v4,16,0,1.334736,0.371851,1.497369,0.371851,17,1,0)
  330.                (v4,17,0,1.497369,0.371851,1.497369,0.259259,17,1,0)
  331.                (v4,18,0,1.497369,0.259259,1.388948,0.14667,17,1,0)
  332.                (v4,19,0,1.388948,0.14667,1.135964,0.14667,17,1,0)
  333.                (v4,20,0,1.135964,0.14667,1.027545,0.259259,17,1,0)
  334.                (v4,21,0,1.027545,0.259259,1.027545,0.822225,17,1,0)
  335.                (v4,22,0,1.027545,0.822225,1.135964,0.934816,17,1,0))))
  336.          (p7,24,8,13
  337.            (g9,24,0
  338.              (g9,24,0
  339.                (v4,24,0,1.388948,0.934816,1.135964,0.934816,17,1,0)
  340.                (v4,25,32,1.135964,0.934816,1.190176,0.784694,17,0,0)
  341.                (v4,26,0,1.190176,0.784694,1.334736,0.784694,17,1,0)
  342.                (v4,27,0,1.334736,0.784694,1.334736,0.615804,17,1,0)
  343.                (v4,28,0,1.334736,0.615804,1.190176,0.615804,17,1,0)
  344.                (v4,29,32,1.190176,0.615804,1.190176,0.46568,17,0,0)
  345.                (v4,30,0,1.190176,0.46568,1.388948,0.46568,17,1,0)
  346.                (v4,31,0,1.388948,0.46568,1.497369,0.578266,17,1,0)
  347.                (v4,32,0,1.497369,0.578266,1.497369,0.822225,17,1,0)
  348.                (v4,33,0,1.497369,0.822225,1.388948,0.934816,17,1,0)))))
  349.        (g9,34,2048
  350.          (v4,34,33,0.973333,0.14667,0.973333,0.14667,17,0,0)
  351.          (v4,35,33,0.973333,1.16,0.973333,1.16,17,0,0)
  352.          (v4,36,33,1.55158,1.16,1.55158,1.16,17,0,0)
  353.          (v4,37,33,1.55158,0.14667,1.55158,0.14667,17,0,0)))
  354.      (g9,39,8
  355.        (p7,39,1032,13
  356.          (g9,39,0
  357.            (g9,39,0
  358.              (v4,39,0,0.933861,0.934816,0.933861,0.14667,17,1,0)
  359.              (v4,40,0,0.933861,0.14667,0.789299,0.14667,17,1,0)
  360.              (v4,41,0,0.789299,0.14667,0.644737,0.296792,17,1,0)
  361.              (v4,42,0,0.644737,0.296792,0.644737,0.371851,17,1,0)
  362.              (v4,43,0,0.644737,0.371851,0.771229,0.371851,17,1,0)
  363.              (v4,44,0,0.771229,0.371851,0.771229,0.934816,17,1,0)
  364.              (v4,45,0,0.771229,0.934816,0.933861,0.934816,17,1,0))))
  365.        (g9,46,2048
  366.          (v4,46,33,0.626667,0.14667,0.626667,0.14667,17,0,0)
  367.          (v4,47,33,0.626667,1.16,0.626667,1.16,17,0,0)
  368.          (v4,48,33,1.006141,1.16,1.006141,1.16,17,0,0)
  369.          (v4,49,33,1.006141,0.14667,1.006141,0.14667,17,0,0)))))
  370.  (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
  371.   667,6))>
  372.  
  373. <secrule,
  374.     Allow Page Break Within = no,
  375.     Allow Page Break After = yes,
  376.     Autonumber Name =    >
  377.  
  378. <Index, "conditions", "CLX", Sort String = clx><Index, "CLX", Sort String = clx, "error conditions", To Named = sectitle><Index, "error conditions", "CLX", Sort String = clx, To Named = sectitle>
  379. <Frame,
  380.     Name =            "At Anchor",
  381.     Placement =        At Anchor,
  382.     Width =            6.35 inches,
  383.     Height =        0.153 inches,
  384.     Vertical Alignment =    0.007 inches,
  385.     Diagram =
  386. V4,
  387. (g9,1,0
  388.  (v4,1,0,0.006667,0.066723,6.333333,0.066611,17,2,0)
  389.  (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
  390.   667,6))>
  391.  
  392. <p1para,
  393.     Alignment =        Both,
  394.     Font =            F2,
  395.     Allow Page Break After = yes>
  396.  
  397. <F5>Introduction<Tab><F6>16.1<F0><#04>CLX error conditions are 
  398. hierarchial. The base error condition is<FJ>
  399. <F6>x<#1e>error<F0>, and all other conditions are built on top of <F6>x<#1e>
  400. error<F0>. <F6>x<#1e>error<F0> can be built on a lower<#1e>level 
  401. condition that is implementation dependent (this is probably the <F6>error
  402. <F0> condition).
  403.  
  404. <syntax,
  405.     Left Tab =        -0.90/0 inches,
  406.     Right Tab =        7.50 inches>
  407.  
  408. <Index, Doc = operations, "xlib:define<#1e>condition", Sort String = "define<#1e>condition">define<#1e>condition<F2> <F7>name<F2> (<F7>parent<#1e>t
  409. ypes<F2>*) [({<F7>slot<#1e>specifier<F2>*}) {<F7>option<F2>*}] <F0><Tab>
  410. <F2>Macro
  411.  
  412. <para>
  413.  
  414. Any new condition type must be defined with the <F6>define<#1e>condition<F0> 
  415. macro. A condition type has a name, parent types, report message, 
  416. and any number of slot items. See the <F7>Lisp Reference<F0> manual 
  417. for further information regarding <F6>define<#1e>condition<F0>.
  418.  
  419. The following are the predefined error conditions that can occur in 
  420. CLX.
  421.  
  422. <syntax,
  423.     Left Tab =        -0.90/0 inches,
  424.     Right Tab =        7.50 inches>
  425.  
  426. access<#1e>error<Tab><Tab> <F2>Condition<Index, Doc = conditions, "xlib:access<#1e>error", Sort String = "access<#1e>error">
  427.  
  428. <para>
  429.  
  430. An <F6>access<#1e>error<F0> can occur for several reasons:
  431.  
  432. <bullet>
  433.  
  434. <F8>w<Tab><F0>A client attempted to grab a key/button combination 
  435. already grabbed by another client
  436.  
  437. <F8>w<Tab><F0>A client attempted to free a colormap entry that it 
  438. did not already allocate
  439.  
  440. <F8>w<Tab><F0>A client attempted to store into a read<#1e>only colormap 
  441. entry
  442.  
  443. <F8>w<Tab><F0>A client attempted to modify the access control list 
  444. from other than the local (or otherwise authorized) host
  445.  
  446. <F8>w<Tab><F0>A client attempted to select an event type that another 
  447. client has already selected, and, that at most, one client can select 
  448. at a time
  449.  
  450. <para>
  451.  
  452. An <F6>access<#1e>error<F0> is a special case of the more general <F6>reques
  453. t<#1e>error<F0> (see page 16<#1e>189 for information on <F6>request<#1e>error
  454. <F0>).
  455.  
  456. <syntax,
  457.     Left Tab =        -0.90/0 inches,
  458.     Right Tab =        7.50 inches>
  459.  
  460. alloc<#1e>error<Tab><Tab><F2>Condition<Index, Doc = conditions, "xlib:alloc<#1e>error", Sort String = "alloc<#1e>error">
  461.  
  462. <para>
  463.  
  464. The server failed to allocate the requested resource or server memory. 
  465.  
  466. An <F6>alloc<#1e>error<F0> is a special case of the more general <F6>request
  467. <#1e>error<F0> (see page 16<#1e>189 for information on <F6>request<#1e>error
  468. <F0>).
  469.  
  470. <syntax,
  471.     Left Tab =        -0.90/0 inches,
  472.     Right Tab =        7.50 inches>
  473.  
  474. atom<#1e>error<Tab><Tab><F2>Condition<Index, Doc = conditions, "xlib:atom<#1e>error", Sort String = "atom<#1e>error">
  475.  
  476. <para>
  477.  
  478. A value for an <F7>atom<F0> argument does not name a defined atom. 
  479.  
  480. An <F6>atom<#1e>error<F0> is a special case of the more general <F6>request<#1e>
  481. error<F0> (see page 16<#1e>189 for information on <F6>request<#1e>error<F0>)
  482. .
  483.  
  484. <syntax,
  485.     Left Tab =        -0.90/0 inches,
  486.     Right Tab =        7.50 inches>
  487.  
  488. closed<#1e>display<Tab><F2>Condition<Index, Doc = conditions, "xlib:closed<#1e>display", Sort String = "closed<#1e>display">
  489.  
  490. <para>
  491.  
  492. The <F6>closed<#1e>display<F0> condition is signaled when trying 
  493. to read or write a closed display (that is, <F6>close<#1e>display<F0> 
  494. has been called on the <F6>display<F0> object, or a server<#1e>disconnect 
  495. occurred). The <F6>closed<#1e>display<F0> object is reported with 
  496. the error. 
  497.  
  498. <|,"16<#1e>186">A <F6>closed<#1e>display<F0> condition is a special case of 
  499. the more general <F6>x<#1e>error<F0> (see page 16<#1e>190 for information 
  500. on <F6>x<#1e>error<F0>).
  501.  
  502. <syntax,
  503.     Left Tab =        -0.90/0 inches,
  504.     Right Tab =        7.50 inches>
  505.  
  506. colormap<#1e>error<Tab><F2>Condition<Index, Doc = conditions, "xlib:colormap<#1e>error", Sort String = "colormap<#1e>error">
  507.  
  508. <para>
  509.  
  510. A value for a <F7>colormap<F0> argument does not name a defined 
  511. colormap. 
  512.  
  513. A <F6>colormap<#1e>error<F0> is a special case of the more general <F6>resou
  514. rce<#1e>error<F0> (see page <Ref, Page #, Tag = yBQXa1e0kc> for information 
  515. on <F6>resource<#1e>error<F0>).
  516.  
  517. <syntax,
  518.     Left Tab =        -0.90/0 inches,
  519.     Right Tab =        7.50 inches>
  520.  
  521. connection<#1e>failure<Tab><F2>Condition<Index, Doc = conditions, "xlib:connection<#1e>failure", Sort String = "connection<#1e>failure">
  522.  
  523. <para>
  524.  
  525. Signaled when an X11 server refuses a connection. The following items 
  526. are reported along with the error:
  527.  
  528. <bullet>
  529.  
  530. <F8>w<Tab><F7>major<#1e>version<F0> <#1f> The major version of 
  531. the X server code.
  532.  
  533. <F8>w<Tab><F7>minor<#1e>version<F0> <#1f> The minor version of 
  534. the X server code.
  535.  
  536. <F8>w<Tab><F7>host<F0> <#1f> The host name for the X server.
  537.  
  538. <F8>w<Tab><F7>display <#1f> <F0>The display on which the error 
  539. occurred.
  540.  
  541. <F8>w<Tab><F7>reason<F0> <#1f> A string indicating why the connection 
  542. failed.
  543.  
  544. <para>
  545.  
  546. A <F6>connection<#1e>failure<F0> is a special case of the more general <F6>x
  547. <#1e>error<F0> (see page 16<#1e>190 for information on <F6>x<#1e>error<F0>).
  548.  
  549. <syntax,
  550.     Left Tab =        -0.90/0 inches,
  551.     Right Tab =        7.50 inches>
  552.  
  553. cursor<#1e>error<F2> <Tab><F0><Tab><F2>Condition<Index, Doc = conditions, "xlib:cursor<#1e>error", Sort String = "cursor<#1e>error">
  554.  
  555. <para>
  556.  
  557. A value for a <F7>cursor<F0> argument does not name a defined cursor.
  558.  
  559. A <F6>cursor<#1e>error<F0> is a special case of the more general <F6>resourc
  560. e<#1e>error<F0> (see page 16<#1e>189 for information on <F6>resource<#1e>erro
  561. r<F0>).
  562.  
  563. <syntax,
  564.     Left Tab =        -0.90/0 inches,
  565.     Right Tab =        7.50 inches>
  566.  
  567. device<#1e>busy<F2> <F0><Tab><F2><Tab>Condition<Index, Doc = conditions, "xlib:device<#1e>busy", Sort String = "device<#1e>busy">
  568.  
  569. <para>
  570.  
  571. Signaled by (<F6>setf<F0> (<F6>pointer<#1e>mapping<F0> <F7>display<F0>) 
  572. <F6>mapping<F0>) when the <F6>set<#1e>pointer<#1e>mapping<F0> 
  573. request returns a busy status. A similar condition occurs in <F6>set<#1e>modif
  574. ier<#1e>mapping<F0>, but in this case, it returns a boolean indicating 
  575. success, rather than signaling an error. The <F6>device<#1e>busy<F0> 
  576. condition returns the display object as part of the error.
  577.  
  578. A <F6>device<#1e>busy<F0> condition is a special case of the more 
  579. general <F6>x<#1e>error<F0> (see page 16<#1e>190 for information 
  580. on <F6>x<#1e>error<F0>).
  581.  
  582. <syntax,
  583.     Left Tab =        -0.90/0 inches,
  584.     Right Tab =        7.50 inches>
  585.  
  586. drawable<#1e>error <Tab><F2>Condition<Index, Doc = conditions, "xlib:drawable<#1e>error", Sort String = "drawable<#1e>error">
  587.  
  588. <para>
  589.  
  590. A value for a <F7>drawable<F0> argument does not name a defined 
  591. window or pixmap. 
  592.  
  593. A <F6>drawable<#1e>error<F0> is a special case of the more general <F6>resou
  594. rce<#1e>error<F0> (see page 16<#1e>189 for information on <F6>resource<#1e>er
  595. ror<F0>).
  596.  
  597. <syntax,
  598.     Left Tab =        -0.90/0 inches,
  599.     Right Tab =        7.50 inches>
  600.  
  601. font<#1e>error <Tab><Tab><F2>Condition<Index, Doc = conditions, "xlib:font<#1e>error", Sort String = "font<#1e>error">
  602.  
  603. <para>
  604.  
  605. A value for a <F7>font<F0> or <F7>gcontext<F0> argument does not 
  606. name a defined font. 
  607.  
  608. A <F6>font<#1e>error<F0> is a special case of the more general <F6>resource<#1e>
  609. error<F0> (see page 16<#1e>189 for information on <F6>resource<#1e>error
  610. <F0>).
  611.  
  612. <syntax,
  613.     Left Tab =        -0.90/0 inches,
  614.     Right Tab =        7.50 inches>
  615.  
  616. <|,"16<#1e>187">gcontext<#1e>error<F2> <F0><Tab><F2>Condition<Index, Doc = conditions, "xlib:gcontext<#1e>error", Sort String = "gcontext<#1e>error">
  617.  
  618. <para>
  619.  
  620. A value for a <F7>gcontext<F0> argument does not name a defined 
  621. GContext. 
  622.  
  623. A <F6>gcontext<#1e>error<F0> is a special case of the more general <F6>resou
  624. rce<#1e>error<F0> (see page 16<#1e>189 for information on <F6>resource<#1e>er
  625. ror<F0>).
  626.  
  627. <syntax,
  628.     Left Tab =        -0.90/0 inches,
  629.     Right Tab =        7.50 inches>
  630.  
  631. id<#1e>choice<#1e>error <Tab><F2>Condition<Index, Doc = conditions, "xlib:id<#1e>choice<#1e>error", Sort String = "id<#1e>choice<#1e>error">
  632.  
  633. <para>
  634.  
  635. The value chosen for a resource identifier is either not included 
  636. in the range assigned to the client or is already in use. Under normal 
  637. circumstances, this cannot occur and should be considered a server 
  638. or CLX library error. 
  639.  
  640. An <F6>id<#1e>choice<#1e>error<F0> is a special case of the more 
  641. general <F6>resource<#1e>error<F0> (see page 16<#1e>189 for information 
  642. on <F6>resource<#1e>error<F0>).
  643.  
  644. <syntax,
  645.     Left Tab =        -0.90/0 inches,
  646.     Right Tab =        7.50 inches>
  647.  
  648. implementation<#1e>error <Tab><F2>Condition<Index, Doc = conditions, "xlib:implementation<#1e>error", Sort String = "implementation<#1e>error">
  649.  
  650. <para>
  651.  
  652. The server does not implement some aspect of the request. A server 
  653. that generates this error for a core request is deficient. As such, 
  654. this error is not listed for any of the requests. However, clients 
  655. should be prepared to receive such errors and either handle or discard 
  656. them. 
  657.  
  658. An <F6>implementation<#1e>error<F0> is a special case of the more 
  659. general <F6>resource<#1e>error<F0> (see page 16<#1e>189 for information 
  660. on <F6>resource<#1e>error<F0>).
  661.  
  662. <syntax,
  663.     Left Tab =        -0.90/0 inches,
  664.     Right Tab =        7.50 inches>
  665.  
  666. length<#1e>error <Tab><F2><Tab>Condition<Index, Doc = conditions, "xlib:length<#1e>error", Sort String = "length<#1e>error">
  667.  
  668. <para>
  669.  
  670. The length of a request is shorter or longer than that minimally required 
  671. to contain the arguments. This usually means an internal CLX error. 
  672.  
  673. A <F6>length<#1e>error<F0> is a special case of the more general <F6>resourc
  674. e<#1e>error<F0> (see page 16<#1e>189 for information on <F6>resource<#1e>erro
  675. r<F0>).
  676.  
  677. <syntax,
  678.     Left Tab =        -0.90/0 inches,
  679.     Right Tab =        7.50 inches>
  680.  
  681. lookup<#1e>error<F2> <F0><Tab><F2><Tab>Condition<Index, Doc = conditions, "xlib:lookup<#1e>error", Sort String = "lookup<#1e>error">
  682.  
  683. <para>
  684.  
  685. CLX has the option of caching different resource types (see <F6>*clx<#1e>cache
  686. d<#1e>types*<F0>) in a hash table by resource ID. When looking up 
  687. an object in the hash table, if the type of the object is wrong, a <F6>lookup<#1e>
  688. error<F0> is signaled. 
  689.  
  690. For example: The cursor with ID 123 is interned in the hash table. 
  691. An event is received with a field for window 123. When 123 is looked 
  692. up in the hash table, a cursor is found. Since a window was expected, 
  693. a <F6>lookup<#1e>error<F0> is signaled. This error indicates a problem 
  694. with the extension code being used. The following items are reported 
  695. along with the error:
  696.  
  697. <bullet>
  698.  
  699. <F8>w<Tab><F7>id<F0> <#1f> The resource ID.
  700.  
  701. <F8>w<Tab><F7>display<F0> <#1f> The display being used.
  702.  
  703. <F8>w<Tab><F7>type<F0> <#1f> The resource type.
  704.  
  705. <F8>w<Tab><F7>object<F0> <#1f> The <F6>resource<F0> object.
  706.  
  707. <para>
  708.  
  709. A <F6>lookup<#1e>error<F0> is a special case of the more general <F6>x<#1e>e
  710. rror<F0> (see page 16<#1e>190 for information on <F6>x<#1e>error<F0>).
  711.  
  712. <syntax,
  713.     Left Tab =        -0.90/0 inches,
  714.     Right Tab =        7.50 inches>
  715.  
  716. <|,"16<#1e>188">match<#1e>error <Tab><Tab><F2>Condition<Index, Doc = conditions, "xlib:match<#1e>error", Sort String = "match<#1e>error">
  717.  
  718. <para>
  719.  
  720. In a graphics request, the root and depth of the GContext does not 
  721. match that of the drawable. An <F6>:input<#1e>only<F0> window is 
  722. used as a drawable. Some argument or pair of arguments has the correct 
  723. type and range but fails to match in some other way required by the 
  724. request. An <F6>:input<#1e>only<F0> window locks this attribute. 
  725. The values do not exist for an <F6>:input<#1e>only<F0> window. 
  726.  
  727. A <F6>match<#1e>error<F0> is a special case of the more general <F6>request<#1e>
  728. error<F0> (see page 16<#1e>189 for information on <F6>request<#1e>error<F0>)
  729. .
  730.  
  731. <syntax,
  732.     Left Tab =        -0.90/0 inches,
  733.     Right Tab =        7.50 inches>
  734.  
  735. missing<#1e>parameter <Tab><F2>Condition<Index, Doc = conditions, "xlib:missing<#1e>parameter", Sort String = "missing<#1e>parameter">
  736.  
  737. <para>
  738.  
  739. One or more of the required keyword parameters is missing or <F6>nil<F0>. 
  740. The missing parameters are reported along with the error.
  741.  
  742. A <F6>missing<#1e>parameter<F0> condition is a special case of the 
  743. more general <F6>x<#1e>error<F0> (see page 16<#1e>190 for information 
  744. on <F6>x<#1e>error<F0>).
  745.  
  746. <syntax,
  747.     Left Tab =        -0.90/0 inches,
  748.     Right Tab =        7.50 inches>
  749.  
  750. name<#1e>error<F2> <Tab><F0><Tab><F2>Condition<Index, Doc = conditions, "xlib:name<#1e>error", Sort String = "name<#1e>error">
  751.  
  752. <para>
  753.  
  754. A font or color of the specified name does not exist. 
  755.  
  756. A <F6>name<#1e>error<F0> is a special case of the more general <F6>request<#1e>
  757. error<F0> (see page 16<#1e>189 for information on <F6>request<#1e>error<F0>)
  758. .
  759.  
  760. <syntax,
  761.     Left Tab =        -0.90/0 inches,
  762.     Right Tab =        7.50 inches>
  763.  
  764. pixmap<#1e>error<F2> <F0><Tab><F2>Condition<Index, Doc = conditions, "xlib:pixmap<#1e>error", Sort String = "pixmap<#1e>error">
  765.  
  766. <para>
  767.  
  768. A value for a <F7>pixmap<F0> argument does not name a defined pixmap. 
  769.  
  770. A <F6>pixmap<#1e>error<F0> is a special case of the more general <F6>resourc
  771. e<#1e>error<F0>. (See page 16<#1e>189 for information on <F6>resource<#1e>err
  772. or<F0>.)
  773.  
  774. <syntax,
  775.     Left Tab =        -0.90/0 inches,
  776.     Right Tab =        7.50 inches>
  777.  
  778. reply<#1e>length<#1e>error<F2> (<F0>x<#1e>error<F2>) (<F7>slots*<F2>)
  779. <F0><Tab><F2>Condition<Index, Doc = conditions, "xlib:reply<#1e>length<#1e>error", Sort String = "reply<#1e>length<#1e>error">
  780.  
  781. <para>
  782.  
  783. The reply to a request has an unexpected length. The following items 
  784. are reported along with the error:
  785.  
  786. <bullet>
  787.  
  788. <F8>w<Tab><F7>reply<#1e>length<F0> <#1f> The actual reply length.
  789.  
  790. <F8>w<Tab><F7>expected<#1e>length<F0> <#1f> The expected reply 
  791. length.
  792.  
  793. <F8>w<Tab><F7>display<F0> <#1f> The display on which the error 
  794. occurred.
  795.  
  796. <para>
  797.  
  798. A <F6>reply<#1e>length<#1e>error<F0> is a special case of the more 
  799. general <F6>x<#1e>error<F0> (see page 16<#1e>190 for information 
  800. on <F6>x<#1e>error<F0>).
  801.  
  802. <syntax,
  803.     Left Tab =        -0.90/0 inches,
  804.     Right Tab =        7.50 inches>
  805.  
  806. reply<#1e>timeout <Tab><F2>Condition<Index, Doc = conditions, "xlib:reply<#1e>timeout", Sort String = "reply<#1e>timeout">
  807.  
  808. <para>
  809.  
  810. The <F6>*reply<#1e>timeout*<F0> parameter specifies the maximum 
  811. number of seconds to wait for a request reply, or <F6>nil<F0> to 
  812. wait forever (the default). When a reply has not been received after 
  813. *<F6>reply<#1e>timeout<F0>* seconds, the <F6>reply<#1e>timeout<F0> 
  814. condition is signaled. The <F7>timeout period<F0> and <F7>display<F0> 
  815. are reported along with the error.
  816.  
  817. A <F6>reply<#1e>timeout<F0> condition is a special case of the more 
  818. general <F6>x<#1e>error<F0> (see page 16<#1e>190 for information 
  819. on <F6>x<#1e>error<F0>).
  820.  
  821. <syntax,
  822.     New Page =        yes,
  823.     Left Tab =        -0.90/0 inches,
  824.     Right Tab =        7.50 inches>
  825.  
  826. <|,"16<#1e>189"><Autonum, invisible, 1, First = Yes, Tagname = j1QXa17ckc>request<#1e>err
  827. or <Tab><F2>Condition<Index, Doc = conditions, "xlib:request<#1e>error", Sort String = "request<#1e>error">
  828.  
  829. <para>
  830.  
  831. The following items are reported along with the error:
  832.  
  833. The major or minor opcode does not specify a valid request. 
  834.  
  835. <bullet>
  836.  
  837. <F8>w<Tab><F7>display<F0> <#1f> The display on which the error 
  838. occurred.
  839.  
  840. <F8>w<Tab><F7>error<#1e>key<F0> <#1f> The error (sub)type.
  841.  
  842. <F8>w<Tab><F7>major<F0> <#1f> The major opcode.
  843.  
  844. <F8>w<Tab><F7>minor<F0> <#1f> The minor opcode.
  845.  
  846. <F8>w<Tab><F7>sequence<F0> <#1f> The actual sequence number.
  847.  
  848. <F8>w<Tab><F7>current<#1e>sequence<F0> <#1f> The current sequence 
  849. number.
  850.  
  851. <para>
  852.  
  853. A <F6><Autonum, invisible, 1>request<#1e>error<F0> condition is 
  854. a special case of the more general <F6>x<#1e>error<F0> (see page 
  855. 16<#1e>190 for information on <F6>x<#1e>error<F0>).
  856.  
  857. <syntax,
  858.     Left Tab =        -0.90/0 inches,
  859.     Right Tab =        7.50 inches>
  860.  
  861. <Autonum, invisible, 1, Tagname = yBQXa1e0kc>resource<#1e>error <Tab><F2>Condi
  862. tion<Index, Doc = conditions, "xlib:resource<#1e>error", Sort String = "resource<#1e>error">
  863.  
  864. <para>
  865.  
  866. All X11 errors for incorrect resource IDs are built on top of <F6>resource<#1e>
  867. error<F0>. These are <F6>colormap<#1e>error<F0>, <F6>cursor<#1e>error<F0>, 
  868. <F6>drawable<#1e>error<F0>, <F6>font<#1e>error<F0>, <F6>gcontext<#1e>error
  869. <F0>, <F6>id<#1e>choice<#1e>error<F0>, <F6>pixmap<#1e>error<F0> 
  870. and <F6>window<#1e>error<F0>. <F6>resource<#1e>error<F0> is never 
  871. signaled directly. 
  872.  
  873. A <F6><Autonum, invisible, 1>resource<#1e>error<F0> is a special 
  874. case of the more general <F6>request<#1e>error<F0> (see page 16<#1e>189 
  875. for information on <F6>request<#1e>error<F0>).
  876.  
  877. <syntax,
  878.     Left Tab =        -0.90/0 inches,
  879.     Right Tab =        7.50 inches>
  880.  
  881. sequence<#1e>error <Tab><F2>Condition<Index, Doc = conditions, "xlib:sequence<#1e>error", Sort String = "sequence<#1e>error">
  882.  
  883. <para>
  884.  
  885. All X11 request replies contain the sequence number of their request. 
  886. If a reply's sequence does not match the request count, a <F6>sequence<#1e>err
  887. or<F0> is signaled. A <F6>sequence<#1e>error<F0> usually indicates 
  888. a locking problem with a multi<#1e>processing Lisp. The following 
  889. items are reported along with the error:
  890.  
  891. <bullet>
  892.  
  893. <F8>w<Tab><F7>display<F0> <#1f> The display on which the error 
  894. occurred.
  895.  
  896. <F8>w<Tab><F7>req<#1e>sequence<F0> <#1f> The sequence number in 
  897. the reply.
  898.  
  899. <F8>w<Tab><F7>msg<#1e>sequence<F0> <#1f> The current sequence number.
  900.  
  901. <para>
  902.  
  903. A <F6>sequence<#1e>error<F0> condition is a special case of the 
  904. more general <F6>x<#1e>error<F0>. (See page 16<#1e>190 for information 
  905. on <F6>x<#1e>error<F0>.)
  906.  
  907. <syntax,
  908.     Left Tab =        -0.90/0 inches,
  909.     Right Tab =        7.50 inches>
  910.  
  911. server<#1e>disconnect <Tab><F2>Condition<Index, Doc = conditions, "xlib:server<#1e>disconnect", Sort String = "server<#1e>disconnect">
  912.  
  913. <para>
  914.  
  915. The connection to the server was lost. The display on which the error 
  916. occurred is reported along with the error.
  917.  
  918. A <F6>server<#1e>disconnect<F0> condition is a special case of the 
  919. more general <F6>x<#1e>error<F0>. (See page 16<#1e>190 for information 
  920. on <F6>x<#1e>error<F0>.)
  921.  
  922. <syntax,
  923.     New Page =        yes,
  924.     Left Tab =        -0.90/0 inches,
  925.     Right Tab =        7.50 inches>
  926.  
  927. <|,"16<#1e>190">unexpected<#1e>reply<F2> <F0><Tab><F2>Condition<Index, Doc = conditions, "xlib:unexpected<#1e>reply", Sort String = "unexpected<#1e>reply">
  928.  
  929. <para>
  930.  
  931. A reply was found when none was expected. This indicates a problem 
  932. with the extension code. The following items are reported along with 
  933. the error:
  934.  
  935. <bullet>
  936.  
  937. <F8>w<Tab><F7>display<F0> <#1f> The display on which the error 
  938. occurred.
  939.  
  940. <F8>w<Tab><F7>req<#1e>sequence<F0> <#1f> The sequence number in 
  941. the reply.
  942.  
  943. <F8>w<Tab><F7>msg<#1e>sequence<F0> <#1f> The current sequence number.
  944.  
  945. <F8>w<Tab><F7>length<F0> <#1f> The message length of the reply.
  946.  
  947. <para>
  948.  
  949. An <F6>unexpected<#1e>reply<F0> condition is a special case of the 
  950. more general<FJ>
  951. <F6>x<#1e>error<F0>. (See page 16<#1e>190 for information on <F6>x<#1e>error
  952. <F0>.)
  953.  
  954. <syntax,
  955.     Left Tab =        -0.90/0 inches,
  956.     Right Tab =        7.50 inches>
  957.  
  958. unknown<#1e>error <F2>(<F0>request<#1e>error<F2>) (<F0>error<#1e>code<F2>)
  959. <F0><Tab><F2>Condition<Index, Doc = conditions, "xlib:unknown<#1e>error", Sort String = "unknown<#1e>error">
  960.  
  961. <para>
  962.  
  963. An error was received from the server with an unknown error code. 
  964. This indicates a problem with the extension code. The undefined error 
  965. code is reported.
  966.  
  967. An <F6>unknown<#1e>error<F0> is a special case of the more general <F6>reque
  968. st<#1e>error<F0>. (See page 16<#1e>189 for information on <F6>request<#1e>err
  969. or<F0>.)
  970.  
  971. <syntax,
  972.     Left Tab =        -0.90/0 inches,
  973.     Right Tab =        7.50 inches>
  974.  
  975. value<#1e>error<F2> (<F0>request<#1e>error<F2>) (<F0>value<F2>)<F0><Tab>
  976. <F2>Condition<Index, Doc = conditions, "xlib:value<#1e>error", Sort String = "value<#1e>error">
  977.  
  978. <para>
  979.  
  980. Some numeric value falls outside the range of values accepted by the 
  981. request. Unless a specific range is specified for an argument, the 
  982. full range defined by the argument's type is accepted. Any argument 
  983. defined as a set of alternatives can generate this error. The erroneous 
  984. value is reported.
  985.  
  986. A <F6>value<#1e>error<F0> is a special case of the more general <F6>request<#1e>
  987. error<F0>. (See page 16<#1e>189 for information on <F6>request<#1e>error
  988. <F0>.)
  989.  
  990. <syntax,
  991.     Left Tab =        -0.90/0 inches,
  992.     Right Tab =        7.50 inches>
  993.  
  994. window<#1e>error<F2> (<F0>resource<#1e>error<F2>)<F0><Tab><F2>Condition<Index, Doc = conditions, "xlib:window<#1e>error", Sort String = "window<#1e>error">
  995.  
  996. <para>
  997.  
  998. A value for a <F7>window<F0> argument does not name a defined window. 
  999.  
  1000. A <F6>window<#1e>error<F0> is a special case of the more general <F6>resourc
  1001. e<#1e>error<F0>. (See page 16<#1e>189 for information on <F6>resource<#1e>err
  1002. or<F0>.)
  1003.  
  1004. <syntax,
  1005.     Left Tab =        -0.90/0 inches,
  1006.     Right Tab =        7.50 inches>
  1007.  
  1008. <Autonum, invisible, 1, Tagname = NAQXa244kc>x<#1e>error<Tab><Tab><F2>Conditio
  1009. n<Index, Doc = conditions, "xlib:x<#1e>error", Sort String = "x<#1e>error">
  1010.  
  1011. <para>
  1012.  
  1013. This is the most general error condition upon which all other conditions 
  1014. are defined.
  1015.  
  1016.