SDK_53.24_graphics.doc not consistent with graphics.xml

A forum for general AmigaOS 4.x support questions that are not platform-specific
Post Reply
AlexBene
Posts: 5
Joined: Wed Dec 18, 2013 12:35 pm

SDK_53.24_graphics.doc not consistent with graphics.xml

Post by AlexBene »

================================================================================
SDK 53.24 graphics.doc
================================================================================
Report_2014.02.17.0006_SDK_53.24_graphics.doc
By: Alexander Benedictov
[email protected]
================================================================================
graphics.doc is not consistent with
graphics.xml (and its derivative graphics.h).

graphics.doc:

· Contains entry graphics/main/AllocBitMapTagList

· Does not contain entries for PixieIFace ("pixie")
interface.
================================================================================
User avatar
tonyw
AmigaOS Core Developer
AmigaOS Core Developer
Posts: 1483
Joined: Wed Mar 09, 2011 1:36 pm
Location: Sydney, Australia

Re: SDK_53.24_graphics.doc not consistent with graphics.xml

Post by tonyw »

It is quite normal (and common in all those components that support Tags and Tag Lists as parameters) to list only the XXX() function in the Contents, but to include the XXXXTags() and/or XXXTagList() functions under the XXX() function heading. See exec.doc and dos.doc for examples.

As to your complaint about PixieIFace, that has never been implemented, which is why it is not documented (refer to the releasenotes for graphics.library, where it is mentioned in the entry for V51.16 (23.2.2005).

The xml interface headers are not there for people to read - they exist only to provide formal definitions of the function calls for gcc. Just because there is an entry in the interface header does not mean that the entries actually exist.
cheers
tony
Post Reply