[lazarus] Interface documentation

[Micha Nelissen]

Hi,

Currently in the win32 interface, every function in win32winapi.inc is 
documented. Is the text for each of the functions in the GTK the same? 
Shouldn't the documentation be in the interface base class? If we add 
another interface it should adhere to TInterfaceObject.function 
specification.

I am saying this because:
1) the documentation on the functions would be more centralized in 
tinterfaceobject.
2) for gtk CreateCaret does something different from the win32, so 
actually we should define what CreateCaret should actually do (for 
example use the GTK semantics) and then make the win32 interface adhere 
to it.

Regards,

Micha.