Two-letter codes not unique

[croaky]

Alberta, British Columbia, South Carolina are all problematic.

Carmen::state_name('BC')
=> nil
Carmen::state_name('MA')
=> "Massachusetts"
Carmen::state_name('AB')
=> nil

Not sure how state_name is supposed to be used if so many examples return bad results.

[jim]

You'll need to specify the country to use anything other than the default, which is the US:

>> Carmen::state_name('AB', 'CA') => 'Alberta'

Or you can set Canada to the default, and omit the second argument:

>> Carmen.default_country = 'CA'
>> Carmen::state_name('AB') => "Alberta"

The docs aren't the best, but I think they cover this pretty well. Suggestions obviously welcomed!