Documentation suggestion

To: oskit-users@cs.utah.edu
Subject: Documentation suggestion
From: Umar Saif <Umar.Saif@cl.cam.ac.uk>
Date: Thu, 31 Aug 2000 14:13:24 +0100
In-Reply-To: Your message of "Mon, 28 Aug 2000 13:59:36 MDT." <200008281959.NAA23238@wrath.cs.utah.edu>
Sender: owner-oskit-users@fast.cs.utah.edu

Hi,
	Section 4.4.1 of the oskit manual describes the COM interface structure, 
which does not give a representative picture of the oskit implementation -- 
and can be quite misleading.

All of the oskit code assumes the function table pointer is the first thing in 
the COM object implementing the COM interface e.g. services.c ; whereas the 
diagram in 4.4.1 shows it somewhere in the middle. Although it is possible to 
figure out the offset of this function table pointer (by deferencing a 0 
memory cast), that solution would have been very messy and has not been used 
by oskit people.

It would be helpful to make that comment explicitly in this section, to avoid 
any confusion regarding the "convenient way you can access the COM object 
state".

Hope this helps,
----------------------------------------------------------
Computo Ergo Sum
----------------

UMAR SAIF

Ph.D. Student
                        
Systems Research Group      Office Phone:  01223-(3) 34643  
Computer Laboratory	    Mobile Phone : 07780 - 687037  
University of Cambridge     http://www.cl.cam.ac.uk/~us204	      
----------------------------------------------------------

Follow-Ups:

Re: Documentation suggestion

From: Godmar Back <gback@cs.utah.edu>

References:

Re: OSKit directory structure

From: Alastair Reid <reid@cs.utah.edu>