Mail_IMAP versioning.

From: Date: Sat, 08 May 2004 17:39:31 +0000
Subject: Mail_IMAP versioning.
Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-29035@lists.php.net to get a copy of this message
Hi all, I've been working on a new release of Mail_IMAP that includes some API changes from the last one. These changes are not BC breaking, however I jumped the gun a while back going from alpha to RC, when I really should have gone to just beta (had RC and beta confused). I have not yet reached a "stable" release, I feel the package is still a couple of steps away from being stable, given recent bug reports. How should I handle the versioning? I thought I would goto 1.1.0RC1, or 1.1.0beta1 since this incorporates API changes, but I didn't know how skipping 1.0.0 stable would be perceived. Anyone wanting to see what the next version looks like can see it here: http://www.spicypeanut.net/index.html?content=373 Comments and critism on the API welcomed too, BTW. I am planning creating a PHP5 version that uses PEAR_ErrorStack so BC-breaking API improvements can be made for that release. Here's the CHANGELOG: This release primarily focuses on feature requests. Bug #1350 multipart/related messages containing attachments not parsed correctly. Added debug functions, Mail_IMAP::debug and Mail_IMAP::dump. Fallback pids added for Mail_IMAP::getBody, Mail_IMAP::getRawHeaders,
     Mail_IMAP::getHeaders. Mail_IMAP::getBody will fallback on pid = '1' or the first message part. Mail_IMAP::getRawHeaders and Mail_IMAP::getHeaders will fallback on pid = '0', or the top-level headers.
$option member variable added, replaces and deprecates various $options
       arguments used in the various methods (These will be removed in 2.0.0).
Mail_IMAP::setOptions method added to set-up some default usages of optional arguments. Mail_IMAP::getRawHeaders now returns the headers by default and has a new $rtn argument that toggles between returning the headers and not returning them. Mail_IMAP::getHeaders now returns the header array (no toggle here). Expanded embedded docs. Regards, Richard York -- ::::::::::::::::::::::::::::::::::::::::: The Spicy Peanut Project http://www.spicypeanut.net :::::::::::::::::::::::::::::::::::::::::

« previous php.pear.dev (#29035) next »