I like the points Adam makes. I'd go further and point out that, rather than avoiding changing a public (frozen) interface at all costs, it's downright illegal; can't be done. The bottom line is that such a statement is COM rule #1, we shouldn't break it; period.

Here are some of my comments/suggestions.

Your first line:

"This document explains the different ways to update a frozen interface."

You might want to talk about what a frozen iface literally is. "An interface is frozen when "@status FROZEN" appears in the interface's top level javadoc comment."


I like the graphic.

Under the "Providing an alternate interface" section you ask "encapsulation???." What you want there is "aggregation."

Jud


Alec Flett wrote:
[EMAIL PROTECTED]">
A bunch of folks on the embedding team had a discussion about rev'ing a frozen interface. I whipped up a quick document describing the 4 ways that I saw you could "rev" an interface.

Check it out:
http://www.mozilla.org/projects/embedding/rev-interfaces.html

(the flowchart image is broken right now because I forgot to check it in as binary - I've re-checked it in but it will probably be an hour or so before www.mozilla.org picks it up)

Please post comments/questions to the newsgroup.

Alec


Reply via email to