Re: Updating the documentation in the IDL files?

2012-04-12 Thread Noel Grandin
On 2012-04-12 11:23, Michael Meeks wrote: Trying to infer that structure from the interface documentation is (I suspect) an extremely irritating way to work out how to do what is needed :-) Perhaps we just need some links to the relevant docs on the libreoffice wiki from places like odk/

Re: Updating the documentation in the IDL files?

2012-04-12 Thread Michael Meeks
On Wed, 2012-04-11 at 20:52 +0300, Tor Lillqvist wrote: > > But if you have anything more specific about com/sun/star/lang I could > > probably have a > > look there. > > Well, starting with XComponent.idl, I don't see any high-level > description what a "component" *is* ;) I guess ther

Re: Updating the documentation in the IDL files?

2012-04-12 Thread Stephan Bergmann
On 04/11/2012 09:27 PM, Tor Lillqvist wrote: OK... Those indeed help. So XComponent is an interface to be added to types that might have circular references? Yes, see . (And, of course, the interface is badly named. Something like "XDi

Re: Updating the documentation in the IDL files?

2012-04-11 Thread Tor Lillqvist
> When for instance Frame.idl talks about "components", does it mean the > XComponent kind of component, or "component" in some other meaning? And then again we have XComponentLoader, which says "loads a component specified by an URL into the specified new or existing frame". But that "component"

Re: Updating the documentation in the IDL files?

2012-04-11 Thread Tor Lillqvist
> http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/ProUNO/The_XComponent_Interface > http://api.libreoffice.org/docs/common/ref/com/sun/star/lang/XComponent.html OK... Those indeed help. So XComponent is an interface to be added to types that might have circular references? When f

Re: Updating the documentation in the IDL files?

2012-04-11 Thread Michael Stahl
On 11/04/12 19:52, Tor Lillqvist wrote: >> But if you have anything more specific about com/sun/star/lang I could >> probably have a >> look there. > > Well, starting with XComponent.idl, I don't see any high-level > description what a "component" *is* ;) http://wiki.services.openoffice.org/wiki

Re: Updating the documentation in the IDL files?

2012-04-11 Thread Tor Lillqvist
> But if you have anything more specific about com/sun/star/lang I could > probably have a > look there. Well, starting with XComponent.idl, I don't see any high-level description what a "component" *is* ;) Or am I expecting too much from the documentation in the IDL files (and generated from th

Re: Updating the documentation in the IDL files?

2012-04-11 Thread Stephan Bergmann
On 04/11/2012 03:31 PM, Tor Lillqvist wrote: It would be nice if somebody with enough insight in these matters would spend some hours on updating some of the documentation in the "core" IDL files of the UNO ecosystem, like the most important ones in com/sun/star/lang and com/sun/star/frame . Tha

Updating the documentation in the IDL files?

2012-04-11 Thread Tor Lillqvist
It would be nice if somebody with enough insight in these matters would spend some hours on updating some of the documentation in the "core" IDL files of the UNO ecosystem, like the most important ones in com/sun/star/lang and com/sun/star/frame . That is, assuming I am correct in thinking that lo