Hi Frank,
Frank Schönheit - Sun Microsystems Germany escribió:
Hi Ariel,
[Side comment: why is this service OfficeDatabaseDocument still
"unplubished"? interface publishing policy is a mystery I do not
understand yet; looks like a question to [EMAIL PROTECTED]
Well .... once I declare a service "published", I am forbidden to add
more interfaces or properties to them, except I declare them "optional".
This leaves me with a problem: When I add new functionality to the
implementation, I want to document it. Adding it as "optional" does not
capture the fact that this functionality *has* to be (and always is)
present. Adding prosa like "Though this is declared as optional, it
really isn't." is not a solution, IMO. Thus, I simply don't like the
"published" concept, in the form it is right now. More precise, I think
it does not capture some aspects of an evolving, living API.
There are different opinions on this, of course :)
For instance, some people claim I should add a OfficeDatabaseDocument2,
OfficeDatabaseDocument3, and so on, with every change I do. Not really
feasible IMO.
oh no, please, do not do this: from an API-client point of view, this
may be confusing... although there are already some Something2 /
XSomething2 in the API :-(
Artificial hurdles as the current - immature, IMO - "published" concept
are one (though not the major) reason why people pay way too little
attention to API design.
There is at least some thing in which you developers should get to some
consensus : means "unpublished" some kind of warning like
"DO-NOT-USE-IT, IT'S NOT SAFE!" , or "this may be improved in the future
by *adding* extra functionality, but you can begin to use it safely in
your code"?
By reading http://wiki.services.openoffice.org/wiki/Chart
"[...] UNO API of the new Chart (chart2) (version of OOG680.m2, August
2007) Note, that the new API is not published yet. Do not use it for
your regular work! For macros, use the API in namespace chart. "
a developer not initiated in these "mysteries" may consider all API with
the "unpublished" attr. as NOT SAFE.
Regards,
Ariel.
--
Ariel Constenla-Haile
La Plata, Argentina
[EMAIL PROTECTED]
[EMAIL PROTECTED]
http://www.ArielConstenlaHaile.com.ar/ooo/
"Aus der Kriegsschule des Lebens
- Was mich nicht umbringt,
macht mich härter."
Nietzsche Götzendämmerung, Sprüche und Pfeile, 8.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
