The city of Detroit is being allowed to shed billions in debt in the largest public bankruptcy in US history.