Mail_IMAP versioning.
| From: | Richard York | 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 :::::::::::::::::::::::::::::::::::::::::