This has the same end result as just tagging 2.1.1 to the same commit as 2.1.0 for non-iOS platforms :) the only work is "git tag 2.1.1"
On 9/26/12 10:04 AM, "Jesse MacFadyen" <purplecabb...@gmail.com> wrote: >I think we should allow some latitude in the point releases to avoid >the cascade of meaningless tags, and extra work. > >Can we release 2.1.1 and just say that it contains 2.1.1 for iOS and >2.1.0 for the rest? There are no API changes right? > > >Cheers, > Jesse > >Sent from my iPhone6 > >On 2012-09-26, at 9:54 AM, Michael Brooks <mich...@michaelbrooks.ca> >wrote: > >> As Becky mentioned, there's some big issues for iOS and our user's would >> really like to see a quick patch. >> >> I'd be in favour of tagging 2.1.1, where iOS tags master and every other >> platform tags 2.1.1 on the same commit as 2.1.0. >> >> Michael >> >> On Wed, Sep 26, 2012 at 8:59 AM, Brian LeRoux <b...@brian.io> wrote: >> >>> I'd rather we point 2.1.1 at the 2.1 tag as suggested for Android, >>> continue work on 2.2 as planned, and ship a fresh release for iOS >>> wherein the big showstopper type problems exist. >>> >>> On Wed, Sep 26, 2012 at 5:48 PM, Joe Bowser <bows...@gmail.com> wrote: >>>> I think we should just start cutting a 2.2.0 release. This change log >>>> looks too big for a point release and there's enough improvements to >>> merit >>>> it. >>>> >>>> That being said, Cordova 2.1.0 still isn't officially out, which >>>> complicates things. Any word on that? >>>> On Sep 26, 2012 6:33 AM, "Andrew Grieve" <agri...@chromium.org> wrote: >>>> >>>>> Another breakage that has been coming up a lot is that the new XHR >>> bridge >>>>> didn't work on non file:/// hosted paged. It's fixed now, so would be >>> good >>>>> to get it out there. >>>>> >>>>> Are you proposing we patch just the bad bugs into the 2.1 branch? Or >>> cut a >>>>> new branch from head? >>>>> >>>>> >>>>> On Wed, Sep 26, 2012 at 8:51 AM, Becky Gibson <gibson.be...@gmail.com >>>>>> wrote: >>>>> >>>>>> Well, since there alot of other things broken on iOS 6 or iPhone 5, >>>>>>a >>>>> point >>>>>> release is probably a good idea. >>>>>> Here are some of the recent iOS 6 related fixes: >>>>>> >>>>>> *3 days ago*Becky >>>>>> Gibson< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Becky+Gibson;st=author >>>>>>> Fixes >>>>>> CB-1511 force portrait in >>>>>> captureAudio< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=d0488e3be4261ad9742afea6c60c3087e1312df8 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=d0488e3be4261ad9742afea6c60c3087e1312df8 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=d0488e3be4261ad9742afea6c60c3087e1312df8 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=d0488e3be4261ad9742afea6c60c3087e1312df8;hb=d0488e3be4261ad9742afea >>>6c60c3087e1312df8 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=d0488e3be4261ad9742afea6c60c3087e1312df8;sf=tgz >>>>>> *3 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> [CB-1514] >>>>>> Xcode 4.5 - Static Analyzer Issues in >>>>>> Cordova...< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=c573953b7e3de06676a9854973143d4d3ff5cc55 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=c573953b7e3de06676a9854973143d4d3ff5cc55 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=c573953b7e3de06676a9854973143d4d3ff5cc55 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=c573953b7e3de06676a9854973143d4d3ff5cc55;hb=c573953b7e3de06676a9854 >>>973143d4d3ff5cc55 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=c573953b7e3de06676a9854973143d4d3ff5cc55;sf=tgz >>>>>> *3 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> [CB-1520] >>>>>> InvalidArgumentException when >>>>>> EnableLocation...< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=31797a7020cbd2d0997382667ff8e3adc19c2ad3 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=31797a7020cbd2d0997382667ff8e3adc19c2ad3 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=31797a7020cbd2d0997382667ff8e3adc19c2ad3 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=31797a7020cbd2d0997382667ff8e3adc19c2ad3;hb=31797a7020cbd2d09973826 >>>67ff8e3adc19c2ad3 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=31797a7020cbd2d0997382667ff8e3adc19c2ad3;sf=tgz >>>>>> *4 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> [CB-1502] >>>>>> Re-fix - rename asset for @2x, remove >>>>>> scaling< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=4f75831520f0429baebd6e2d6bef9cbe44fbea1f >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=4f75831520f0429baebd6e2d6bef9cbe44fbea1f >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=4f75831520f0429baebd6e2d6bef9cbe44fbea1f >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=4f75831520f0429baebd6e2d6bef9cbe44fbea1f;hb=4f75831520f0429baebd6e2 >>>d6bef9cbe44fbea1f >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=4f75831520f0429baebd6e2d6bef9cbe44fbea1f;sf=tgz >>>>>> *5 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> [CB-1502] >>>>>> Update Capture Audio images for iPhone >>>>>> 5...< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=1dd9b330c4f7e613e93525b21a10e4ee20984cc4 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=1dd9b330c4f7e613e93525b21a10e4ee20984cc4 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=1dd9b330c4f7e613e93525b21a10e4ee20984cc4 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=1dd9b330c4f7e613e93525b21a10e4ee20984cc4;hb=1dd9b330c4f7e613e93525b >>>21a10e4ee20984cc4 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=1dd9b330c4f7e613e93525b21a10e4ee20984cc4;sf=tgz >>>>>> *5 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> Added >>>>>> CDV_IsIPhone5 macro< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=5bbae2c4689aaa8fa5b66359db35576d24fc2830 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=5bbae2c4689aaa8fa5b66359db35576d24fc2830 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=5bbae2c4689aaa8fa5b66359db35576d24fc2830 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=5bbae2c4689aaa8fa5b66359db35576d24fc2830;hb=5bbae2c4689aaa8fa5b6635 >>>9db35576d24fc2830 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=5bbae2c4689aaa8fa5b66359db35576d24fc2830;sf=tgz >>>>>> *5 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> [CB-1479] >>>>>> Cordova 2.1 Capture Problem if no >>>>>> options...< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=5c5297504b899459c50e21e8420922b84f58dea0 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=5c5297504b899459c50e21e8420922b84f58dea0 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=5c5297504b899459c50e21e8420922b84f58dea0 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=5c5297504b899459c50e21e8420922b84f58dea0;hb=5c5297504b899459c50e21e >>>8420922b84f58dea0 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=5c5297504b899459c50e21e8420922b84f58dea0;sf=tgz >>>>>> *5 days ago*Brion >>>>>> Vibber< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Brion+Vibber;st=author >>>>>>> For >>>>>> JIRA CB-1482: Add splash screen image for >>>>>> iPhone...< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=ca705097d8b299d2d45814f19defa626c991d0bf >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=ca705097d8b299d2d45814f19defa626c991d0bf >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=ca705097d8b299d2d45814f19defa626c991d0bf >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=ca705097d8b299d2d45814f19defa626c991d0bf;hb=ca705097d8b299d2d45814f >>>19defa626c991d0bf >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=ca705097d8b299d2d45814f19defa626c991d0bf;sf=tgz >>>>>> *5 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> [CB-1461] >>>>>> UIWebView property check for compiling >>>>>> on...< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=2d4251745445772f1bbb213d8ddf7010d9b6f71a >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=2d4251745445772f1bbb213d8ddf7010d9b6f71a >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=2d4251745445772f1bbb213d8ddf7010d9b6f71a >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=2d4251745445772f1bbb213d8ddf7010d9b6f71a;hb=2d4251745445772f1bbb213 >>>d8ddf7010d9b6f71a >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=2d4251745445772f1bbb213d8ddf7010d9b6f71a;sf=tgz >>>>>> *5 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> [CB-1461] >>>>>> Added plist settings to default >>>>>> template< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=2bbf168ed40268b37c31e1bf6afda14e7a10e45e >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=2bbf168ed40268b37c31e1bf6afda14e7a10e45e >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=2bbf168ed40268b37c31e1bf6afda14e7a10e45e >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=2bbf168ed40268b37c31e1bf6afda14e7a10e45e;hb=2bbf168ed40268b37c31e1b >>>f6afda14e7a10e45e >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=2bbf168ed40268b37c31e1bf6afda14e7a10e45e;sf=tgz >>>>>> *5 days ago*hermwong< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=hermwong;st=author >>>>>>> additional >>>>>> changes for CB-1461< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=6351d49c78c3d49b56d7ff330c5bf259b0917424 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=6351d49c78c3d49b56d7ff330c5bf259b0917424 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=6351d49c78c3d49b56d7ff330c5bf259b0917424 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=6351d49c78c3d49b56d7ff330c5bf259b0917424;hb=6351d49c78c3d49b56d7ff3 >>>30c5bf259b0917424 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=6351d49c78c3d49b56d7ff330c5bf259b0917424;sf=tgz >>>>>> *5 days ago*hermwong< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=hermwong;st=author >>>>>>> CB-1461 >>>>>> Add the two new iOS 6 UIWebView >>>>>> properties...< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=916c4079481fc1fcbf8c6d18aa80c715aba3ee51 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=916c4079481fc1fcbf8c6d18aa80c715aba3ee51 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=916c4079481fc1fcbf8c6d18aa80c715aba3ee51 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=916c4079481fc1fcbf8c6d18aa80c715aba3ee51;hb=916c4079481fc1fcbf8c6d1 >>>8aa80c715aba3ee51 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=916c4079481fc1fcbf8c6d18aa80c715aba3ee51;sf=tgz >>>>>> *5 days ago*hermwong< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=hermwong;st=author >>>>>>> CB-1461 >>>>>> added new iOS 6 UIWebView >>>>>> properties< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=3368777fec7a835ee2a8a8771e1872c9a6649278 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=3368777fec7a835ee2a8a8771e1872c9a6649278 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=3368777fec7a835ee2a8a8771e1872c9a6649278 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=3368777fec7a835ee2a8a8771e1872c9a6649278;hb=3368777fec7a835ee2a8a87 >>>71e1872c9a6649278 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=3368777fec7a835ee2a8a8771e1872c9a6649278;sf=tgz >>>>>> *6 days ago*Shazron >>>>>> Abdullah< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=se >>>arch;s=Shazron+Abdullah;st=author >>>>>>> [CB-1360] >>>>>> Conditionally add architectures based >>>>>> on...< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=07b54f14951af57906a25f041f8c1ccb497006e9 >>>>>> commit< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmit;h=07b54f14951af57906a25f041f8c1ccb497006e9 >>>>>> | commitdiff< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=co >>>mmitdiff;h=07b54f14951af57906a25f041f8c1ccb497006e9 >>>>>> | tree< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=tr >>>ee;h=07b54f14951af57906a25f041f8c1ccb497006e9;hb=07b54f14951af57906a25f0 >>>41f8c1ccb497006e9 >>>>>> | snapshot< >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-ios.git;a=sn >>>apshot;h=07b54f14951af57906a25f041f8c1ccb497006e9;sf=tgz >>>>>> And the following are open tickets: >>>>>> 1502 Update Capture Audio images for iPhone >>>>>> 5<https://issues.apache.org/jira/browse/CB-1502> >>>>>> 902 iOS 6 - deal with new Privacy functionality in Contacts >>>>>> (ABAddressBook:: >>>>>> ABAddressBookCreateWithOptions)< >>>>>> https://issues.apache.org/jira/browse/CB-902> >>>>>> 1476 Failed to load resource: >>>>>> file:///!gap_exec<https://issues.apache.org/jira/browse/CB-1476> >>>>>> 1478 FileReader vs XHR bench < >>>>>> https://issues.apache.org/jira/browse/CB-1478> >>>>>> >>>>>> Definitely hard to have a Cordova release right around the time of a >>> new >>>>>> iOS release. Everyone expects the "latest" Cordova to just work, >>>>>>even >>>>>> though we didn't have actual devices and couldn't talk publically >>> about >>>>> the >>>>>> code / api changes! >>>>>> >>>>>> -becky >>>>>> >>>>>> On Wed, Sep 26, 2012 at 3:07 AM, Brian LeRoux <b...@brian.io> wrote: >>>>>> >>>>>>> How major do you guys feel this is? >>>>>>> >>>>>>> https://issues.apache.org/jira/browse/CB-1535 >>>>>>> >>>>>>> There is a workaround but a month is a long time to have a broken >>> web >>>>>>> storage api. >>>