Basket.Package() Function - What does it do?

[michael.p.larsen]

I'm trying to add in some custom shipping logic and am having trouble figuring out exactly what the Package() method does, and WHEN i need to call it.
I'm adding this functionality to the Cart page.

Anyone have any idea?

[s_ismail]

I think it arranges the current basket items in packages before shipments to checkout.

[michael.p.larsen]

Whats the difference between a package and a shipment?

[s_ismail]

Shipment is a process to transporting shippable items from one place to another while package is a quantity of items(goods) are shipped together.

[sohaib]

Well there is no such thing as 'Package' in AbleCommerce except the name of the function Basket.Package.
The purpose of this function is to organize the basket items into default shipments in preparation for checkout.

The system only understands 'shipments'. There is no such thing as 'package'.