[MERGE] LockDir.lock_write() shouldn't require an email address

[Richard Wilbur]

On Thu, 2006-10-05 at 10:42 +1000, John Arbash Meinel wrote:
> Richard Wilbur wrote:
> > 
> > <entry>
> > <a href="/DeprecationPhase">deprecation phase</a> - Period during which
> > an interface declared obsolete is being discouraged from use in the code
> > by run time warnings.
> > </entry>
> > 
> > <page>DeprecationPhase
> > An interface that is deemed obsolete will . . .
> > 1.  have its references in the code refactored to use other interfaces.
> > 2.  generate warnings when used.
> > 3.  be declared so on the development mailing list and in notes for one
> > or two releases.
> > 
> > This time period is known as the "deprecation phase" for that interface,
> > after which its implementation will be removed from the code.
> > </page>
> > 
> > Sincerely,
> > 
> > Richard
> 
> I would change it slightly to read:
> 
> A public interface that is deemed obsolete will
> 
> ...
> 
> 2. Generate warnings when used. When possible, the warning will include
> information about what should be done to avoid using this interface.
> (Alternative interface, etc)
> 
> 3. All public interfaces will be preserved for at least one full release
> since they have been deprecated. Often they will be preserved for much
> longer.
> 
> 4. Disk formats will be supported for at least 6 months after they have
> been deprecated.
> 
> Otherwise, go ahead and update the wiki.
> 
> John
> =:->

It's up there http://bazaar-vcs.org/BzrGlossary and
http://bazaar-vcs.org/DeprecationPhase

Further adjustments?

Richard
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 191 bytes
Desc: This is a digitally signed message part
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20061005/b6e545ed/attachment.pgp