Which Developer's Guide is authorative?

[Kai Backman]

Hi everyone,

I just started hacking OOo using UNO and ran into conflicting information in the different versions of the Developer's Guide. I filed two specific issues already, but wanted to post here before filing more of them, in case this is a larger known problem.

So my question is, which version of the DevGuide is the authorative source for information: the PDF version or the HTML version? The PDF guide was missing information on activating the urp port and the HTML guide isn't linked to on the DevGuide entrace page.

So what's the story, why are the guides different? Which one should I trust? Is it any good filing issues against the guides, ie. are they produced from the same source, but the PDF build is just lagging the HTML one?

Thanks in advance and let me know if I can help out somehow.

[LarsB]

Hi Kai,

the current online IDL Reference which is located here
http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html
is up to date. Normally most of the methods and classes
are down compatible. It only could be that there will be new
classes and methods, but these youl will find in the
IDL reference above. If something isn't up to date and
changed in the new version it is mostly marked as
depricated.

Cheers
Lars B
_________________
AODC - A free OpenDocument Converter
AODL - An independent OpenDocument Library C#
EmbeddedOpenOffice .net UserControl C#
EmbeddedOpenOffice Visual Studio .net Add In
http://www.OpenDocument4all.com/

[Cybb20]

[Kai Backman]

Thanks Lars and Christian, I'll follow the HTML one. I still have one question: Should I submit bug reports on Dev Guide errors I find? And if yes, then can I do it using the normal bug submit process (even if it's a Sun internal module)?

[Cybb20]

Kai:
Yes, yes absolutely. File every bug you find, there is even a SDK module in the Issuezilla system.

Christian
_________________
- Knowledge is Power -