home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #26 / NN_1992_26.iso / spool / comp / windows / x / 19126 < prev    next >
Encoding:
Text File  |  1992-11-14  |  3.4 KB  |  93 lines
  1. Newsgroups: comp.windows.x
  2. Path: sparky!uunet!snorkelwacker.mit.edu!bloom-beacon!INTERNET!dont-send-mail-to-path-lines
  3. From: adrian@ora.COM (adrian)
  4. Subject: Errata, Volume Two, Xlib Reference Manual
  5. Message-ID: <9211131749.AA00287@spike.ora.com>
  6. Sender: root@athena.mit.edu (Wizard A. Root)
  7. Organization: The Internet
  8. Date: Fri, 13 Nov 1992 12:49:01 GMT
  9. Lines: 82
  10.  
  11.  
  12. A few errors have been found in the latest edition of Volume Two
  13. (and some of them are also in earlier editions).
  14. You might want to take a few moments to go through your copy of
  15. the book and correct them.
  16.  
  17. Errata: Volume Two, Xlib Reference Manual.  6/92 printing.
  18.  
  19. XCopyGC (Page 211)
  20.     XCopyGC requires that both GC's exist before the call is made.
  21.     (This is a clarification; the book doesn't say anything to the contrary.)
  22.  
  23. XDrawRectangle and XDrawRectangles (page 299 and 301)
  24. XFillRectangle and XFillRectangles (page 332 and 334)
  25.     The figures have one less row of pixels than they should have, but
  26.     all the numbers shown are correct.
  27.  
  28. XGrabPointer() (page 451)
  29. XGrabButton()  (page 444)
  30.     Each currently says to see XSelectInput for the list of valid symbols for 
  31.     the event_mask argument.  This is incorrect because only 
  32.     pointer-related symbols are valid.    The valid symbols are listed 
  33.     under XChangeActivePointerGrab.  You can correct your book by
  34.     changing the reference from XSelectInput to XChangeActivePointerGrab, 
  35.     or by referring to the FIRST COLUMN of symbols listed on the 
  36.     XSelectInput page.
  37.  
  38. XSetIOErrorHandler (Page 558, top)
  39.    "If an XYBitmap format is used, then the depth of d must be 1,..."
  40.  
  41.      should be:
  42.  
  43.     "If an XYBitmap format is used, then the depth of image must be 1,..."
  44.                                                       ^^^^^
  45.     (The drawable may have a depth 1 or greater than one.)
  46.  
  47. XSetIOErrorHandler  (page 700)
  48.     At the top, it says "set a nonfatal error handler".  This 
  49.     should read "fatal".
  50.     
  51.     The second misprint is in the function prototype for the error handler that
  52.     is called when an IO error occurs.  It only takes a pointer to a Display,
  53.     not a pointer to the Display and a pointer to an XErrorEvent.  
  54.     The latest prototype should read:
  55.  
  56.     int (* handler)(Display *)
  57.  
  58. XVisualIdFromVisual (Page 808)
  59.     There are two XVisualIdFromVisual manpages.  Both are accurate.
  60.  
  61. Appendix C (pg 901)
  62.     claims the following functions are macros.  Each of them is 
  63.     documented correctly on manpages.
  64.  
  65.     XDisplayMotionBufferSize()
  66.     XMaxRequestSize()
  67.     XScreenNumberOfScreen()
  68.     XVisualIDFromVisual()
  69.  
  70. Event Reference (page 916)
  71.     It says: "Most event structures also have a window member.  The only
  72.     ones that don't are selection events (SelectionNotify, 
  73.     SelectionRequest, and SelectionClear) ..." But, SelectionClear does 
  74.     have a window member.
  75.  
  76. GC-at-a-glance-4 (page 1122)
  77.      cap_style is always used for XDrawRectangle and XDrawRectangles.
  78.  
  79. XAddExtension()
  80. XInitExtension() 
  81. XAddToExtensionList()
  82.     No manpages are provided for these.  They are documented only
  83.     in the Extension Writing appendix in Vol One.  The intention
  84.     is for these manpages to go in a separate volume on extensions.
  85.  
  86. *************************************************************
  87. Adrian Nye (314) 531-1231    Editor, The X Resource
  88. O'Reilly & Associates, Inc., Publishers of Nutshell Handbooks
  89. 4466 West Pine Blvd.  20-G   St. Louis MO 63108
  90. Internet:   adrian@ora.com        UUCP:   uunet!ora!adrian      
  91. *************************************************************
  92.  
  93.